Configuring the ShotGrid-Bluescape Integration

Support Note
This topic is not relevant to all Bluescape members and may not apply to all Organizations. If you’re unsure whether your Organization has this integration, please reach out to your IT department.

Your workflows in ShotGrid (formerly Shotgun) are now integrated with Bluescape! ShotGrid is an Autodesk application for creative project management of film, TV, and games. The integration enables you to send ShotGrid versions, assets, playlists, and shots to a Bluescape workspace.

The Bluescape integration with ShotGrid must be configured by administrative members of both Bluescape and ShotGrid. If this feature is not visible, contact your IT department. The installation flow is as follows:

  1. A Bluescape Instance Admin must turn on the ShotGrid integration feature. This allows the ShotGrid option to appear in the Integrations page of the Configuration Center for the Bluescape Organization Admin to interact with.

  2. The ShotGrid Admin must configure the script that manages security controls and allows the Bluescape integration to access ShotGrid APIs.

  3. A ShotGrid Admin must configure the Action Menu item that sends ShotGrid content to Bluescape.

  4. A Bluescape Organization Admin must enable the integration in the Configuration Center.

Configuring the ShotGrid Script

The ShotGrid Admin must create a new script in ShotGrid. This manages security controls and allows Bluescape to access ShotGrid APIs for the integration.

To configure the ShotGrid script:

  1. As a ShotGrid Admin, select your member avatar in the top-right corner of the screen in ShotGrid.

  2. A context menu opens. Select Scripts in the Admin section.

  3. The Scripts page opens. Select Add Script.

  4. The Create a new Script window opens. Enter the desired Script Name. You will need to provide this to the Bluescape Organization Admin later to enable the integration. Note that the script name is case-sensitive.

  1. Enter an optional Description.

  2. Enter your email address in the Maintainer email field.

  3. Set the Permission Group to the desired permission level.

  4. An Application Key is automatically generated. Select Copy to Clipboard, as you will need to provide this key to the Bluescape Organization Admin. This will provide OAuth authentication for the integration.

  5. When finished, click Create Script.

Configuring the ShotGrid Action Menu

An action menu is available when you right-click ShotGrid content (such as playlists, assets, versions, and shots). The options in this action menu can be configured by a ShotGrid Admin. In this case, the admin must set Bluescape as the endpoint.

To configure the right-click Action Menu item for Bluescape from ShotGrid:

  1. As a ShotGrid Admin, select your member avatar in the top-right corner of the screen in ShotGrid.

  2. A context menu opens. Select Action Menu Items in the Admin section.

  3. The Action Menu Items page opens. Select Add Action Menu.

  4. The Create a new Action Menu Item window opens. Type the desired name for the menu item in the Title field. We suggest “Send < ShotGrid entity type > to Bluescape.” For example: “Send Asset to Bluescape.”

  1. Select Entity Type. Select the desired ShotGrid entity from the drop-down menu (such as Asset, Version, Playlist, or Shot). Ensure that it matches the entity type in the title you typed above.

  2. Enter the URL for the destination where you will send the ShotGrid content in Bluescape.

  1. Leave the Light Payload checkbox deselected; selecting it causes errors from not sending sufficient data to process the upload.

  2. Select More fields.

  3. Select Selection Required from the field list.

  4. The Selection Required field appears. Ensure the adjacent checkbox is selected.

  5. Select More fields again.

  6. Select Secret Token from the field list.

  7. The Secret Token field appears. Enter your secret token and provide it to the Bluescape Organization Admin.

Enabling the ShotGrid Integration in the Configuration Center

After an Instance Admin has turned on the ShotGrid setting, a Bluescape Organization Admin can configure the integration.

To configure the ShotGrid integration in Bluescape:

  1. As a Bluescape Organization Admin, navigate to the Integrations page of the Configuration Center.

  2. You should see the ShotGrid icon. Select Enable under the ShotGrid icon. If you do not see the ShotGrid icon, reply to this topic, and Bluescape Support will assist.

  1. The Enable ShotGrid Integration window opens. Enter your unique ShotGrid instance URL in the ShotGrid Instance field.

  2. Enter your Script Name. You can receive that value from the ShotGrid Admin from step 5 in the instructions to configure the ShotGrid script (above).

  3. Enter the Application Key. The ShotGrid Admin can provide that to you from the value they copied in step 9 in the instructions to configure the ShotGrid script (see above).

  4. Enter the ShotGrid Version attribute you want to use to pull ShotGrid content from to push into Bluescape. For example, “sg_uploaded_movie” or “sg_uploaded_movie_mp4.” For more information on how to find this value, see below.

  5. Enter the Action Menu Secret Token. The ShotGrid Admin can provide it from step 9 in the instructions to configure the Action Menu item (see above).

  6. When you are finished, select OK.

Identifying Your ShotGrid Version Attribute

To find your ShotGrid Version information for the ShotGrid integration:

  1. Navigate to the Assets page in ShotGrid.

  2. Select one of the assets in the list.

  3. A list of Versions within the Asset displays. Select Fields to add a field to the list.

  4. A context menu opens. Scroll down and select Uploaded Movie.

  1. Scroll over to the new Uploaded Movie column and hover your mouse over the i (information).

  2. A text box appears with the ShotGrid Version value displayed at the top. In the example below, it is sg_uploaded_movie.

This is the value that the Bluescape Organization Owner or Admin will enter into the ShotGrid Version field in the Bluescape Configuration Center when enabling the integration.

If you have any questions or need assistance from our team, reply below. :slight_smile:

Where to Next?

Not what you were looking for? Reply below or Search the community and discover more Bluescape.