Skip to content
Permalink
Branch: master
Find file Copy path
Find file Copy path
8 contributors

Users who have contributed to this file

@alandann @manneohrstrom @jfboismenu @sgsteph @pscadding @robblau @thebeeland @ireuben
258 lines (222 sloc) 9.8 KB
# Copyright (c) 2015 Shotgun Software Inc.
#
# CONFIDENTIAL AND PROPRIETARY
#
# This work is provided "AS IS" and subject to the Shotgun Pipeline Toolkit
# Source Code License included in this distribution package. See LICENSE.
# By accessing, using, copying or modifying this work you indicate your
# agreement to the Shotgun Pipeline Toolkit Source Code License. All rights
# not expressly granted therein are reserved by Shotgun Software Inc.
# Metadata defining the behaviour and requirements for this app
# expected fields in the configuration file for this app
configuration:
# Startup options
#
launch_at_startup:
type: bool
description: A flag whether to launch the UI at application startup.
This option is not supported on all engines because of
differences in the way some platforms start up. Currently, only maya
nuke and 3ds Max support this option.
default_value: False
# templates
#
template_work:
type: template
fields: context, [name], [version], [extension], *
description: A reference to a template which locates a work file on disk.
allows_empty: True
template_work_area:
type: template
description: A reference to a template which locates the work directory on
disk
allows_empty: True
template_publish:
type: template
fields: context, [name], [version], [extension], *
description: A reference to a template which locates a publish file on disk.
allows_empty: True
template_publish_area:
type: template
description: A reference to a template which locates the publish directory on
disk
allows_empty: True
# Hooks
#
hook_scene_operation:
type: hook
default_value: "{self}/scene_operation_{engine_name}.py"
description: All the application specific scene operations (open, save etc) that
the app needs to carry out are collected together in this hook.
hook_copy_file:
type: hook
default_value: "{self}/copy_file.py"
description: Specify a hook that will be used to copy the file 'source_path'
to 'target_path'.
hook_filter_work_files:
type: hook
default_value: "{self}/filter_work_files.py"
description: Specify a hook that, if needed, can filter the raw list of work files found
for the current work area
hook_filter_publishes:
type: hook
default_value: "{self}/filter_publishes.py"
description: Specify a hook that, if needed, can filter the raw list of publishes returned
from Shotgun for the current Work area.
custom_actions_hook:
type: hook
default_value: "{self}/custom_actions.py"
description: Hook which contains all custom action methods.
create_new_task_hook:
type: hook
default_value: "{self}/create_new_task.py"
description: Specify a hook that will create the task and do any input validation that is
required.
# General preferences
#
entities:
type: list
description: "This setting defines the different tabs that will show up on the left hand side.
Each tab represents a Shotgun query, grouped by some shotgun fields to form a tree.
This setting is a list of dictionaries. Each dictionary in the list defines one tab,
and should have the following keys: *caption* specifies the name of the tab, *entity_type*
specifies the Shotgun Entity type to display. *filters* is a list of standard API Shotgun
filters either in the standard or complex format. *hierarchy* is a list of Shotgun fields
relative to the entity type, defining the grouping of the tree. An optional *sub_query*
key can be used to define a deferred query which will be run to collect children when
an Entity is expanded in the tree view, typically Tasks for a Shot or an Asset.
It is a dictionary with the following keys: *entity_type* key to specify the child Entity
type to collect, *link_field* the Shotgun field name used to link the Entity to its parent,
*filters* a list of standard Shotgun API filters, *hierarchy* a list of fields defining
the grouping in the sub-tree.
The optional *step_filter_on* setting is an Entity type and can be used to restrict
the list of Steps used for filtering to only the Steps for the specified Entity type.
"
# For backward compatibility reasons we don't use the new deferred queries
# by default. Using deferred queries, an Asset/Shot setup could be:
# - caption: Assets (deferred)
# entity_type: Asset
# hierarchy: [sg_asset_type, code]
# sub_hierarchy:
# entity_type: Task
# filters:
# link_field: entity
# hierarchy: [step]
# - caption: Shots (deferred)
# entity_type: Shot
# hierarchy: [sg_sequence, code]
# sub_hierarchy:
# entity_type: Task
# filters:
# link_field: entity
# hierarchy: [step]
allows_empty: True
values:
type: dict
default_value:
- caption: Assets
entity_type: Task
step_filter_on: Asset
filters:
- [entity, type_is, Asset]
hierarchy: [entity.Asset.sg_asset_type, entity, step, content]
- caption: Shots
entity_type: Task
step_filter_on: Shot
filters:
- [entity, type_is, Shot]
hierarchy: [entity.Shot.sg_sequence, entity, step, content]
default_value_tk-hiero:
- caption: Projects
entity_type: Project
filters: []
hierarchy: [name]
show_my_tasks:
type: bool
description: Define if the My Tasks view should be visible or not.
default_value: True
default_value_tk-hiero: False
auto_expand_tree:
type: bool
description: Automatically expands the root level of the treeviews.
default_value: False
my_tasks_extra_display_fields:
type: list
description: List of additional fields to display with the task in the My Tasks list.
values:
type: str
allows_empty: True
default_value: []
my_tasks_filters:
type: list
description: List of filters to apply to the tasks in the My Tasks tab.
values:
type: shotgun_filter
allows_empty: True
default_value:
- [task_assignees, is, '{context.user}']
file_extensions:
type: list
description: List of file extensions to be shown in the work files view. If
empty then all files that match the template will be shown.
values:
type: str
allows_empty: True
default_value: []
version_compare_ignore_fields:
type: list
description: A list of fields that should be ignored when comparing files to
determine if they are different versions of the same file. If
this is left empty then only the version field will be ignored.
Care should be taken when specifying fields to ignore as Toolkit
will expect the version to be unique across files that have
different values for those fields and will error if this isn't the
case.
values:
type: str
allows_empty: True
default_value: []
allow_task_creation:
type: bool
description: Controls whether new tasks can be created from the app.
default_value: True
file_browser_tabs:
type: list
description: "A list of tab names that are visible in the main browser. Values
can be any combination of the following tab names: 'All',
'Working', and 'Publishes'. The order of the specified
values determines the order of the tabs in the app."
allows_empty: False
values:
type: str
default_value: ['All', 'Working', 'Publishes']
# Save specific options
#
saveas_default_name:
type: str
description: The default name that gets used by when saving a work file using the
save-as command
default_value: scene
saveas_prefer_version_up:
type: bool
description: Control how the save-as command determines the inital name to be used. If
set to True then the name from the current scene will be used and the version
incremented. If False then a new unique name will be used and the version
reset
default_value: False
# the Shotgun fields that this app needs in order to operate correctly
requires_shotgun_fields:
# More verbose description of this item
display_name: "Shotgun Workfiles"
description: "Using this app you can browse, open and save your Work Files and Publishes."
# Required minimum versions for this item to run
requires_shotgun_version:
requires_core_version: "v0.17.0"
requires_engine_version:
# the engines that this app can operate in:
supported_engines:
# the frameworks required to run this app
frameworks:
# We need a version of tk-framework-shotgunutils with a fix for deleting items.
- {"name": "tk-framework-shotgunutils", "version": "v5.x.x", "minimum_version": "v5.3.5"}
- {"name": "tk-framework-qtwidgets", "version": "v2.x.x"}
You can’t perform that action at this time.