Elementgroup Validation Sample Workflow

1. If you do not have an app registered, follow the procedure outlined in Create an App to sign up for an APS account (if required) and obtain a Client ID for your app.
   • Make sure that you add the following as the Callback URL: http://localhost:8080/api/auth/callback
   • Contact us to enable AEC Data Model API for your app and ACC hub.
2. Install .NET 6
3. Clone or download the Git Repository. It’s recommended to install GitHub desktop. To clone it via command line, use the following command (Terminal on MacOSX/Linux, Git Shell on Windows):

    git clone https://github.com/autodesk-platform-services/aps-aecdatamodel-samples.git
   

Define the following environment variables:

  Mac OSX/Linux (Terminal)

    dotnet restore
    export APS_CLIENT_ID=<<YOUR CLIENT ID FROM DEVELOPER PORTAL>>
    export APS_CLIENT_SECRET=<<YOUR CLIENT SECRET>>
    export APS_CALLBACK_URL=http://localhost:8080/api/auth/callback

  Windows

    dotnet restore
    set APS_CLIENT_ID =<<YOUR CLIENT ID FROM DEVELOPER PORTAL>>
    set APS_CLIENT_SECRET =<<YOUR CLIENT SECRET>>
    set APS_CALLBACK_URL=http://localhost:8080/api/auth/callback

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

In Microsoft Visual Studio, you can set the variables through Debug > aps-aecdatamodel-samples Properties and add the three Environment variables as follows: APS_CLIENT_ID=<>,APS_CLIENT_SECRET=<>,APS_CALLBACK_URL=http://localhost:8080/api/auth/callback

To run the sample, you need to execute the following command in the terminal:

 dotnet run

Go to http://localhost:8080, and then select Go to sample for Elementgroups Validation Sample Workflow.

Afterwards, you’ll need to login with your Autodesk (ACC) account before proceeding with the next steps.

1. List all hubs

   After login (top-right), click on List Hubs and take note of the hubId (id). See C# code.

   

2. List all projects

   Use the HubId from step 1 to list all projects and take note of the projectId (id). See C# code.

   

3. List all properties

   This step uses projectId. Click on List all properties. See C# code.

   

   Query used in case no cursor is provided:

   
    elementGroupsByProject(projectId: $projectId) {
      pagination{
        pageSize
        cursor
      }
      results{
        name
        id
        propertyDefinitions{
          results{
            id
            name
            description
            specification
          }
        }
      }
    }
   

   Show More

   Query used in case a valid cursor is provided:

   
    elementGroupsByProject(projectId: $projectId, pagination:{cursor:"cursor string here"}) {
      pagination{
        pageSize
        cursor
      }
      results{
        name
        id
        propertyDefinitions{
          results{
            id
            name
            description
            specification
          }
        }
      }
    }
   

   Show More

   The variables are the same in both cases:

   {
     projectId = "Your project ID"
   }