importX

C# services for Autodesk Construction Cloud. One service imports submittals from Excel into the Submittals API. The other stores a project's form-naming system and returns form types as a tree.

These classes depend on the surrounding WebImportX data layer, Autodesk HTTP client, and token refresh service. They are not a standalone app.

Submittal import

SubmittalService talks to https://developer.api.autodesk.com/construction/submittals/v2.

Method	What it does
GetItemsAsync	Lists submittal items for a project, following pagination.
GetItemsTypesAsync	Lists item types.
GetSpecsAsync	Lists specs.
GetTemplatesAsync	Lists templates.
GetSubmittalsItemsNextCustomIdAsync	Reads the next custom item id.
GetSubmittalsProfileAsync	Reads the current submittals user (users/me).
CreateSubmittalItemAsync	Creates one item.
ImportFromExcelAsync	Reads the first worksheet and creates one item per data row.
TransitionItemAsync	Moves an item to a new stateId.

Excel import requires columns Title, TypeId, and SpecId. Optional columns are Subcontractor, SubcontractorType, SubmitterDueDate, and TemplateId. Blank titles are skipped. Dates are sent as yyyy-MM-dd. New items are created with state sbc-1, up to three at a time. Each row returns an ImportResultDto with success or the error message.

Form naming systems

FormTypingSystemsController is mounted at systems and calls FormNamingSystemsService.

Route	What it does
GET /systems/systems?projectId=	Lists naming systems for an Autodesk project id.
GET /systems/system-types?systemId=	Returns that system's form types as a parent/child tree.
POST /systems/system	Creates a system and its form-type hierarchy.

Creating a system looks up the Autodesk project id, inserts the project row if it is missing, and rejects a duplicate system name on that project. Form types are saved recursively from the request tree, with each child pointing at its parent.