Troubleshooting
Common
Requesting support for failed WorkItems
Please provide the following information when requesting support for failed WorkItems:
- WorkItem Ids for WorkItems created less than 30 days ago.
- Report(s) for WorkItems.
If the issue cannot be identified by the above information, a further diagnosis will need the following information:
- AppBundles’ zip file: the minimal code reproducing the issue is preferred.
- Payloads for Activity and WorkItem.
- The inputs, including json string passed in WorkItem payload. For example:
"countItParams": { "url": "data:application/json,{'walls': true, 'floors': true, 'doors': true, 'windows': true}"
“Cannot parse id” error on alias creation for AppBundle/Activity
There are the following limitations on alias names:
- Maximum alias length is 40 characters.
- Only alphanumeric characters are allowed.
- You need to use unqualified or fully qualified ids depending on the context.
Note that there is a limit on the number of aliases. For more details check the Rate Limits and Quotas page. For more details on unqualified / fully qualified ids, check the Aliases and IDs page.
“Failed to prepare app package(s)” error when executing a work item
If you encounter this error, it might be caused by something that went wrong when uploading the AppBundle zip file.
Check the following things:
- Make sure the file structure in your AppBundle zip file is correct (e.g. PackageContents.xml must be at the same level as Contents directory)
- If the AppBundle zip file is correct, make sure it was uploaded correctly (e.g. when doing the requests in Postman, the ‘file’ key must be of type ‘File’, not ‘Text’)
Non-English filenames in ZIP files
By default, most ZIP archivers do not use UTF-8 encoding to store filenames, and ZIP archives created from them do not store a code page for filenames. As a result, Design Automation needs a hint to extract filenames from the archive correctly. Use one of the following workarounds if filenames in your ZIP archive are not in the ASCII code page:
- Force UTF-8 usage in your archiver. For example: 7-Zip accepts the “cu” parameter to use UTF-8 for filenames.
- Add a hint file to the ZIP. A hint file is an empty “XYZ.codepage” file, where “XYZ” is either a code page name or a code page number. For example: for Cyrillic it can be “CP866.codepage” or “866.codepage”.
504 gateway timeout issue
If you encounter “504 gateway timeout issue”, often it is enough to retry the request to solve it.
413 Payload too large error
If you encounter a “413 Payload too large” error when posting a workitem, it may be due to one of the following reasons:
- Check how many presigned urls you are using to specify a workitem’s downloads. Some presigned urls tend to be quite lengthy. If this is the case for you, pack the inputs into a single zip file and specify only one presigned url for the zip file in the workitem’s payload.
- Check your input arguments. If you have a long section of inputs for a single argument in the payload, consider saving this as a single downloadable json file and provide only a presigned url to that file in the workitem’s payload.
For permitted size of json payload, check the Rate Limits and Quotas page.
Revit
RevitServerUnauthenticatedUserException error when executing on a published RCW file or incorrect execution on a central or local model
If you encounter this error, your file is most likely not opening with the correct options.
To open the file properly, you must specify the correct behavior by opening the file within your addin.
Implement the following:
- Make sure the /i command line option is not set. This will prevent Design Automation from opening the file and throwing an exception.
- Verify that you have hardcoded a localName within your activity - this will allow you to open the file with the same relative/path/to/file regardless of the name of the file downloaded.
- Open the file with the correct options and filepath:
Application rvtApp = data.RevitApp; OpenOptions openOptions = new OpenOptions(); FilePath modelFilePath = new FilePath("relative/path/to/file"); openOptions.DetachFromCentralOption = DetachFromCentralOption.DetachAndPreserveWorksets; Document doc = rvtApp.OpenDocumentFile(modelFilePath, openOptions);
To access and modify both Revit workshared cloud models and non-workshared cloud models, please refer to Revit Cloud Models Integration page.
Inventor
“FailedExecution” error when executing an Inventor WorkItem
If you encounter this error, it might be some problems in opening IPT/IAM, iLogic error, etc.
Check the following things:
- Make sure the IPT/IAM can be opened in Inventor with the same version as the definition in the Activity.
- Make sure the iLogic rule can run in Inventor.
Error when trying to save an Inventor IDW document to Inventor DWG format using Document.SaveAs()
This is a known issue in Inventor engines. It is recommended that you use the function DrawingDocument.SaveAsInventorDWG() instead: DrawingDocument.SaveAsInventorDWG(sPath + “xxx.dwg”, true)
Error when trying to export an Inventor document to Revit family file (RFA) and industry foundation classes file (IFC) using functions ExportBuildingComponent and ExportBuildingComponentWithOptions
This is a known issue in Inventor engines. The error “Unspecified error (Exception from HRESULT: 0x80004005 (E_FAIL))” shows when trying to export building components using Inventor engines. It is recommended that you can use the Design Automation API for Revit together with Design Automation API for Inventor to convert the RFA and IFC file. Please check the inventor2revit sample for reference.
Inventor functions requiring installed Excel
On Design Automation, some functions that work with Excel formats are not supported.
This includes:
- Weld Bead Report
- Import Points
- Export BOM
- Insert Object
- Positional Representation
- Exporting tables in drawings
Starting from the Sample Plugin
It is recommended that you start with the sample plugin to build your own plugin bundle and to upload the bundle to the Design Automation Service.
Error when trying to save an Inventor document trough an iLogic rule
If you need to save your document we recommend that you do that in your plug-in instead of your iLogic rule. Do not use ThisDoc.Save() command in iLogic rules.