Prerequisites

• An Autodesk Construction Cloud® account
• An ACC or Autodesk® BIM 360® Project
• The URL of the project that you want to connect
• If this is a first-time connection between Gryps and any project on your account:
• The ability to grant Gryps permission to read from this account (Account Admin)

Creating the Connection

1. Provision Access To Gryps

This step is only needed if this is the first time any projects on this account are being connected to Gryps. If you have prior connections to Gryps on this account, you can skip to step 2. Don’t know? If you are an Account Admin continue with this step to see if you have already given Gryps access; if not, continue with connection setup, and we will reach out if there is an issue with our access.

• Login to Autodesk Construction Cloud, navigate to the Account Admin > Custom Integrations tab, and select Add custom integration
  
• Enter NcU7YKJcb2wOkAAsIt3dcisgpq5aVrPMbH7DC4NLKUJCLFTF as the Autodesk Platform Services Client ID and Gryps as the Custom Integration Name. Then click Add.
• You should see the Gryps integration in the custom integrations list
  

2. Configure the connection

• Name: Provide a unique name for this connection.
• Description: Provide a summary of this connection.
• Schedule: How often would you like the connection to fetch new data? The default is for the connection to run once a day.
• Collection Cutoff: How far back in time should the connection fetch data? The default is to get all historical data.

3. Add Credentials

For Gryps to connect your data, we need your credentials and authorization.

• Select existing credentials or select “new” and complete the following:
• Credential Name: Provide a name for your credentials. This name should be descriptive enough to be used again. Example: Jerry's login
• Authorize: Click the “Authorize” button to begin the authorization process using OAuth. You will be redirected to input your login and authorize access to Gryps. Once complete, return to this page. The button will show a checkmark if the process was successful.

4. Provide Details

• Account ID: Provide the account ID of the project. To get the account ID -
• The account ID is shown to Autodesk Construction Cloud site administrators in the Account Admin module in the Settings Menu. (Contact your Autodesk Construction Cloud Account Admin if you are a Project Admin, or project member without Account Admin permissions.)
  
  
• Sign in to acc.autodesk.com/account-admin as an Account Admin.
  
• From the Project List page, use the "Account Administration" on the upper right-hand side of the page. (If you cannot see this module, contact one of your company's account admins.)
  
• Click the Settings menu on the left
• Look in the Advanced section for the Account ID.
  
• Project ID: Provide the ID of the project for which data will be collected. To get the project ID.
• Open the project in the Autodesk Construction Cloud Platform
• Switch to the Project Admin Module
• In the browser address bar, copy the string of letters and characters behind /projects/: 

• Modules: Select the modules you would like to collect data for. If you do not select any modules nothing will be collected. You will only collect information for data that is visible for the user you have completed the OAuth process with. This instance will fail if you select a module that your project does not have access to. Detailed descriptions of the entities each module collects are as follows (files are downloaded unless specified) -
  
• Project, Users, Companies, & Roles (recommended for all instances)
• Project Metadata
• Companies
• Project Users
• Project Roles
• Sheets
• Sheet Version Sets
• Sheets (files are not downloaded)
• Assets
• Assets (including custom attributes)
• Asset Categories
• Asset Statuses
• Asset Custom Attribute Definitions
• Issues
• Issues (including custom attributes)
• Issue Comments
• Issue Root Cause Categories
• Issue Types
• Issue Custom Attribute Definitions
• Submittals
• Submittal Items
• Submittal Item Relationships
• Submittal Item Attachments
• Submittal Specs
• Submittal Packages
• Submittal Metadata
• RFIs
• RFIs
• RFI Comments
• RFI Attachments
• RFI Relationships
• Document Module
• Folders
• Files
• Cost Management
• Budgets (including attachments, documents, and relationships)
• Cost Items (including attachments, documents, and relationships)
• Contracts (including attachments, documents, and relationships)
• Main Contracts (including attachments, documents, and relationships)
• Main Contract Items
• PCO, RFQ, RCO, OCO, SCO Change Orders (including attachments, documents, and relationships)