【问题场景】
今天升级了postman版本之后(升级为9.19.0),导入.json文件提示"convert your collection to Format v2",看来之前版本的.json文件默认为v1,不再适用当前版本。
按照【官网】的说法:
Postman 不再支持集合 v1 格式,如果您导入此格式的集合,则会返回错误。您可以将收藏的格式从 v1 转换为 v2 以将其导入 Postman。
【官网】给出的解决方案:
- 在您选择的终端中,输入以下命令以安装 Postman Collection Transformer
sudonpminstall -g postman-collection-transformer
- 通过输入以下命令将单个 Postman 集合从 v1 转换为 v2,生成的集合将以 v2 格式下载到您的目标文件路径。
postman-collection-transformer convert -i <path to the input Postman Collection file> -o <path to the downloaded Postman file> -j 1.0.0 -p 2.0.0 -P
【补充说明】
对于上面在命令行执行的语句,官网省略的一些执行细节,文章还原一下,记录的同时希望对大家有帮助。
- 检查电脑是否下载了nodejs,没有的话先下载,下载地址:https://nodejs.org/en/download/
查看是否下载成功:在cmd输入node -v,控制台会显示版本号
- 打开cmd命令行窗口,安装postman转换器
npminstall -g postman-collection-transformer
记住安装路径,下一步有用。本地postman转换器安装路径为:D:\nodejs\node_global\
- 转换postman脚本文件的版本。转换命令:postman-collection-transformer convert -i “转换文件路径” -o “转换后文件路径” -j 1.0.0 -p 2.0.0 -P
【举例】:将文件test_v1转换为test_v2,文件路径我这里是"D:\test"
postman-collection-transformer convert -i "D:\test\test_v1.postman_collection.json" -o "D:\test\test_v2.postman_collection.json" -j 1.0.0 -p 2.0.0 -P
【可能遇到的问题】
在执行上述第三步的时候,cmd控制台报错:
‘postman-collection-transformer’ 不是内部或外部命令,也不是可运行的程序
两种解决办法:
- 还记得上面我们安装postman转换器的路径吧,把它添加到环境变量
- 切换到postman转换器安装的路径,再执行。比如由C:\用户\用户名>切换到D:\nodejs\node_global>
解释
因为我们打开cmd命令行窗口,默认路径指向C:\用户\用户名;
而在C:\用户\用户名>下并没有postman-collection-transformer可执行文件,所有肯定会报错的。所有要么选择方案二切换路径;要么不切换选择方案一。
这里顺便补充一下,环境变量的知识点
把某一路径A配置成环境变量是为了在任意路径B下都能访问到A下的资源。这也是为什么把postman转换器的路径配置到环境变量,就能在C:\用户\用户名>下执行postman-collection-transformer的原因了。
版权归原作者 周里奥 所有, 如有侵权,请联系我们删除。