THE SAMPLE CODE ON THIS REPOSITORY IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR NON-INFRINGEMENT.
THE USAGE OF THIS SAMPLE IS AT YOUR OWN RISK AND THERE IS NO SUPPORT RELATED TO IT.
This repository provides automated job workflows for the COOLORANGE powerAPS ecosystem, enabling seamless publishing of Autodesk Vault files to Autodesk Construction Cloud (ACC) through coolOrange powerJobs Processor.
The powerAPS-Jobs component handles Vault Job Processor automation that translates, converts, and publishes CAD files from Vault to ACC in multiple formats including native files, PDFs, and DWF models. It includes both the job submission interface (Vault Client side) and the processing workflows (Job Processor side).
Note: powerJobs Processor version 26.0.4 or greater and powerEvents version 26.0.7 or greater are required.
This component requires:
- powerAPS-Modules - Core PowerShell modules for APS communication
- powerJobs Processor installed on the Autodesk Vault Job Processor machine
- powerEvents (powerJobs Client) installed on each Autodesk Vault Client machine
- Autodesk Vault Professional 2023 or later
- AutoCAD or Inventor for file translation (depending on file types)
- powerAPS-Modules - Core PowerShell modules for APS API communication
- powerAPS-UI - User interface dialogs and menu extensions
The powerAPS-Jobs component depends on powerAPS-Modules for APS connectivity and works with powerAPS-UI for user configuration.
Important: Files downloaded from GitHub may be blocked by Windows. You must unblock all files before installation:
- Right-click each downloaded file → Properties
- Check "Unblock" at the bottom → Apply → OK
- Or use PowerShell:
Get-ChildItem -Recurse | Unblock-File
Note: This installation assumes that Vault Explorer and the Vault Job Processor run on the same machine.
- Close Autodesk Vault Explorer and powerJobs Processor
- Download or clone this repository
- Unblock all downloaded files (see important note above)
- Install powerAPS-Modules first (required dependency)
- Copy all files from this repository to:
C:\ProgramData\coolOrange\ - Restart powerJobs Processor and Vault Explorer
For distributed environments where Vault clients and Job Processor are on different machines:
On Job Processor machine:
- Copy files from
powerJobs/directory to:C:\ProgramData\coolOrange\powerJobs\
On each Vault Client machine:
- Copy files from
Client Extensions/directory to:C:\ProgramData\coolOrange\Client Customizations\
The powerAPS-Jobs component provides automated publishing workflows that transform and deliver Vault files to Autodesk Construction Cloud.
The following publishing options are available in the File Context Menu under "ACC":
- Converts CAD drawings (IDW, DWG) to PDF format
- Uploads PDF files to configured ACC project location
- Maintains folder structure from Vault to ACC
- Optional file locking in ACC after upload
- Supported formats: AutoCAD DWG, Autodesk Inventor IDW
- Translates 3D models to DWF format for model viewing
- Supports multiple CAD formats: Inventor (IAM, IPT), AutoCAD (DWG), SolidWorks (SLDASM, SLDPRT)
- Generates viewer-optimized DWF files
- Preserves model hierarchy and metadata
- Uploads original CAD files without conversion
- Includes file dependencies and references automatically
- Maintains native format for cloud-based editing
- Supports all file types managed in Vault
The powerJobs Processor executes three specialized jobs:
Automated PDF Generation and Publishing
Configuration Options:
# Include file revision in PDF name
$pdfFileNameWithRevision = $false
# Revision separator character
$pdfFileNameRevisionSeparator = "_"
# Include file extension in PDF name
$pdfFileNameWithExtension = $true
# Lock files in ACC after upload
$lockAccFiles = $trueWorkflow Process:
- File Validation: Verifies IDW/DWG file types
- Application Launch: Opens appropriate CAD application
- PDF Export: Generates high-quality PDF output
- APS Authentication: Connects using job submitter's credentials
- Project Resolution: Locates target ACC project and folder
- File Upload: Publishes PDF to ACC with metadata
- Optional Locking: Secures file in ACC if configured
3D Model Translation and Publishing
Key Features:
- Multi-format support: Handles various 3D file types
- Reference resolution: Processes assembly dependencies
- Viewer optimization: Generates DWF for model viewing
- Metadata preservation: Maintains properties and attributes
- Quality control: Validates successful translation
Native File Publishing with References
Key Features:
- Dependency tracking: Automatically includes referenced files
- Folder structure: Recreates Vault hierarchy in ACC
- Version synchronization: Maintains file version consistency
- Reference integrity: Preserves file relationships
- Metadata mapping: Transfers custom properties to ACC
- User context preservation: Jobs run with submitter's APS credentials
- Token management: Automatic authentication and refresh
- Permission validation: Ensures user has required access rights
- Secure credential storage: Leverages Vault's authentication system
- Comprehensive logging: Detailed progress and error reporting
- File validation: Pre-processing checks for supported formats
- Graceful degradation: Continues processing remaining files on partial failures
- Performance monitoring: Execution timing and statistics
- Vault folder association: Links Vault folders to ACC projects
- Dynamic path resolution: Calculates ACC folder paths from Vault structure
- Regional awareness: Automatically routes to correct ACC region
- Hub and project validation: Verifies target locations exist
Before publishing files, Vault folders must be configured with ACC project mappings:
- Use powerAPS-UI to assign ACC projects to Vault folders
| Job Type | Supported Formats | Output Format |
|---|---|---|
| PDF Publishing | IDW, DWG | |
| DWF Publishing | IAM, IPT, DWG, SLDASM, SLDPRT | DWF |
| Native Publishing | All Vault-managed files | Original format |
- User selects files in Vault Explorer and chooses publishing option
- Client extension validates permissions and folder configuration
- Job submission creates powerJobs job with file and user context
- Job processor picks up tasks and begins automated workflow
- File translation converts to target format if needed
- APS authentication establishes connection using submitter credentials
- Project resolution locates target ACC project and folder structure
- File upload transfers content to ACC with metadata
For additional information:
- COOLORANGE Documentation: https://doc.coolorange.com
- powerAPS Reference: https://doc.coolorange.com/projects/poweraps/en/stable/
- APS Developer Portal: https://aps.autodesk.com/