| Support Note |
|---|
| This topic is not relevant to all Bluescape members and may not apply to all Teams. If you’re unsure whether your Team 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:
-
A Bluescape instance admin must turn on the ShotGrid integration feature. This allows the ShotGrid option to appear in the Integrations page of Bluescape Home for the team admin to interact with.
-
The ShotGrid admin must configure the script that manages security controls and allows the Bluescape integration to access ShotGrid APIs.
-
A ShotGrid admin must configure the action menu item that sends ShotGrid content to Bluescape.
-
A Bluescape team admin must enable the integration in Bluescape Home.
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:
-
As a ShotGrid admin, select your member avatar in the top-right corner of the screen in ShotGrid.
-
A context menu opens. Select Scripts in the Admin section.
-
The Scripts page opens. Select Add Script.
-
The Create a new Script window opens. Enter the desired Script Name. You will need to provide this to the Bluescape team admin later to enable the integration. Note that the script name is case-sensitive.
-
Enter an optional Description.
-
Enter your email address in the Maintainer email field.
-
Set the Permission Group to the desired permission level.
-
An Application Key is automatically generated. Select Copy to Clipboard, as you will need to provide this key to the Bluescape team admin. This will provide OAuth authentication for the integration.
-
When finished, select 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:
-
As a ShotGrid admin, select your member avatar in the top-right corner of the screen in ShotGrid.
-
A context menu opens. Select Action Menu Items in the Admin section.
-
The Action Menu Items page opens. Select Add Action Menu.
-
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.”
-
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.
-
Enter the URL for the destination where you will send the ShotGrid content in Bluescape.
-
If you use the standard Bluescape SaaS offering, enter this URL: https://transfer.apps.us.bluescape.com/api/v3/ami.
-
If you use Bluescape on a Private Instance, contact your IT department and request URLs. For more information, see Bluescape Architecture.
-
Leave the Light Payload checkbox deselected; selecting it causes errors from not sending sufficient data to process the upload.
-
Select More fields.
-
Select Selection Required from the field list.
-
The Selection Required field appears. Ensure the adjacent checkbox is selected.
-
Select More fields again.
-
Select Secret Token from the field list.
-
The Secret Token field appears. Enter your secret token and provide it to the Bluescape team admin.
Enabling the ShotGrid integration in Bluescape Home
After an instance admin has turned on the ShotGrid setting, a Bluescape team admin can configure the integration.
To configure the ShotGrid integration in Bluescape:
-
As a Bluescape team admin, log into Bluescape and select the Team you want to configure the ShotGrid integration with. Select Team Settings and then the Integrations tab.
-
You should see the ShotGrid icon. Select
(settings). If you do not see the ShotGrid icon, reply to this topic, and Bluescape Support will assist.
-
The Enable ShotGrid Integration window opens. Enter your unique ShotGrid instance URL in the ShotGrid Instance field.
-
Enter your Script Name. You can receive that value from the ShotGrid admin from step 5 in the instructions to configure the ShotGrid script (see above).
-
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).
-
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.
-
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).
-
When you are finished, select Save.
Identifying your ShotGrid version attribute
To find your ShotGrid Version information for the ShotGrid integration:
-
Navigate to the Assets page in ShotGrid.
-
Select one of the assets in the list.
-
A list of Versions within the Asset displays. Select Fields to add a field to the list.
-
A context menu opens. Scroll down and select Uploaded Movie.
-
Scroll over to the new Uploaded Movie column and hover your mouse over the i (information).
-
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 team owner or admin will enter into the ShotGrid Version field in the Bluescape Home when enabling the integration.
If you have any questions or need assistance from our team, reply below. 
