ACC Issue API Tutorial (.Net)

Autodesk Platform Services application built by following the ACC Issue tutorial from https://get-started.aps.autodesk.com/.

Description

APS application that allows the authenticated user in Autodesk Construction Cloud to extract project issues and issues settings: sub types, root causes, custom attribute of a given ACC project. This application renders these data in a tabular view. The data can also be exported to CSV file easily. With the data from a CSV, the application demos the scenario that imports them to create new issues or modify the existing issues.

Development

Prerequisites

• APS credentials
• Autodesk Construction Cloud
• Provisioned access to Autodesk Construction Cloud
• .NET 8
• Terminal (for example, Windows Command Prompt or macOS Terminal)

Setup & Run

• Clone this repository
• Install dependencies: dotnet restore
• Setup environment variables.
  • APS_CLIENT_ID - your APS application client ID
  • APS_CLIENT_SECRET - your APS application client secret
  • APS_CALLBACK_URL - URL for your users to be redirected to after they successfully log in with their Autodesk account
    • For local development, the callback URL is http://localhost:8080/api/auth/callback
    • For applications deployed to a custom domain, the callback URL is http://<your-domain>/api/auth/callback or https://<your-domain>/api/auth/callback
    • Do not forget to update the callback URL for your application in https://aps.autodesk.com/myapps as well
• Input these variables to appsettings.json
• Run the server: dotnet run
• If Debugging the application, input the variables to appsettings.Development.json and start debug.

When using Visual Studio Code, you can specify the env. variables listed above in a .env file in this folder, and run & debug the application directly from the editor.

Main Functionalities

• Export Issue Records: The application can extract all issues data from a project and render them in a table view. It also allows the user to save as the data to a csv file

1. login with a valid user of this ACC project.
2. in the left tree panel, nagivate to the project to inspect
3. click this project, the application will start to dump the issue data. Finally it renders the data in the table view. By default, the rows are sorted by displayId. The complicated objects (array, json, json array) will be converted to string
4. It also extracts the records of Issue SubTypes, Root Causes and Custom Attributes Definitions of this project.
5. click the toolbar button of table view, the issues view can be saved to a csv file. Because it is hard to manage the complicated objects (array, json, json array) in csv, they will be hard-coded with the string ''.

• Import Records from CSV to Create or Modify Issues: The application allows the user to import a csv file, with that it creates the new issue or modify the existing issues.

1. login with a valid user of this ACC project.

2. in the left tree panel, nagivate to the project to inspect

3. click this project, the application will start to dump the issue data. Finally it renders the data in the table view.

4. ensure the issue tab is activated, click the toolbar button of table view, it will ask to select a csv file. Then process the records accordingly. Finally, the table view will be refreshed with the updated issues.

   It is strongly recommended to use the same pattern of the csv that is exported in the previous function (Export Issue Records).

   To add new issue, leave the column id empty

   To modify the existing issue, keep the column id with the issue id, update other fields with new values.

   A few fields are required when working with creating issues(POST). A few fields are supported when working with modifying issues (PATCH). Please check API references for more details.

   to make it clearer, this application narrow down with some supported fields.

   the row number of the records is not used with these scenarios, but will be used when tracking the status.

   the status of created/modified/failed are tracked and will be printed out in the browser console after the process.

Limitations

• document issues (pushpin issue) is not demoed in this version
• The sample doesn't cover all the supported fields for creating or updating issues.
• values that are complex objects (such as arrays or JSON objects) are not saved to the CSV file. Th value is marked as Complicated Objects

Troubleshooting

Please contact us via https://aps.autodesk.com/en/support/get-help.

License

This sample is licensed under the terms of the MIT License. Please see the LICENSE file for more details.

Change Log

• April 18, 2025: First version