关于Design Automation API上传装配包及获取Zip结果的技术咨询

一、装配文件（IAM）/Zip包上传格式验证与修正步骤 #

如果上传IAM或Zip装配包持续报错，先按以下要点核对输入格式：

• LocalName匹配规则：上传单个IAM时，输入参数的LocalName必须与上传的文件名完全一致（例如上传MainAssem.iam，则LocalName需设为MainAssem.iam）；上传Zip包时，LocalName需设为Zip文件名，同时在Activity的输入配置中开启Uncompress: true。
• 依赖文件结构：IAM依赖的所有子零件（IPT、次级IAM）必须和主装配一起打包进Zip，且Zip内的文件路径要与本地装配的相对路径完全一致，避免多余的文件夹嵌套（比如不要把所有文件放在/assem子目录下，直接放在Zip根目录）。
• 请求头与方法：上传时确保使用Put请求，Content-Type设置正确——IAM文件对应application/vnd.autodesk.inventor.assembly，Zip包对应application/zip。

二、Zip包上传并获取修改结果的完整流程 #

1. 规范打包装配文件
   将主IAM文件、所有依赖的子零件按本地项目的相对路径打包成Zip，确保Zip根目录直接包含所有必要文件，不要嵌套额外文件夹。

2. 配置Workitem输入参数

   • 定义输入参数时，设置LocalName为你的Zip文件名，Uncompress设为true，Url填写Zip文件上传至Autodesk OSS的存储地址，Verb设为Get。
   • 如果你的处理逻辑需要指定主装配文件，需在Workitem的自定义参数中传递主IAM的文件名（例如"MainAssembly": "MainAssem.iam"），让Worker进程能定位到要处理的核心文件。

3. 配置输出参数

   • 若需输出修改后的完整装配包：定义输出参数，设置LocalName为目标Zip文件名，Compress设为true，Url填写OSS上的目标存储地址，Verb设为Put。
   • 若只需输出单个修改后的文件：直接在输出参数中指定该文件的LocalName即可，无需压缩。

4. 提交并获取结果
   调用API提交Workitem后，通过轮询Workitem的状态字段确认处理完成，之后从输出参数指定的Url地址下载修改后的文件或Zip包。

内容的提问来源于stack exchange，提问作者Umar waqar