-
Notifications
You must be signed in to change notification settings - Fork 73
Documentation
Jean-François Boismenu edited this page Mar 1, 2016
·
38 revisions
Every time the application is configured for an engine in a given environment, it needs to know which entities can be displayed in the tabs. This can be configured through the entities
property. The default setting for the entities
looks like this:
entities:
- caption: Assets
entity_type: Task
filters:
- [entity, type_is, Asset]
hierarchy: [entity.Asset.sg_asset_type, entity, step, content]
- caption: Shots
entity_type: Task
filters:
- [entity, type_is, Shot]
hierarchy: [entity.Shot.sg_sequence, entity, step, content]
Entities is an array of settings to configure each tab. Each tab can be configured via four settings:
-
caption
is simply the title that will be displayed at the top of the tab. -
entity_type
denotes the kind of entities to be able to 'Open', 'Save' or 'Create' from that tab. -
filters
is a list of filters that will trim the number of results returned from Shotgun. The results are always filtered by project regardless of this setting. In the above scenario, we are splitting tasks into two tabs, one for shots and one for asset. This is done via thefilters
setting. It uses the standard Shotgun query syntax. -
hierarchy
is a list of fields from the entity specified in theentity_type
setting. It will be used to create the hierarchical view. In theShots
tab for example, we will end up with a list of sequences (Task.entity.Shot.sg_sequence
) at the root of the view. Opening a sequence will reveal a list of shots (task.entity
). Opening a shot will reveal a list of steps (task.step
) and clicking on the step will reveal the tasks (task.content
). There is no limit to how deep the hierarchy can be.
There are currently a few use-cases that aren't fully supported by this app yet. We do intend to add support for them in the near future so if you are affected by any of these then please let us know and we'll make sure we contact you when support is added.
- 3ds Max and Motionbuilder Support - File performance is slower in these DCCs under Windows compared to Maya and Nuke.
- Perforce/Versionless files - The app is still to go through testing with the Perforce workflow so it is very likely that it won't work.