![]() |
Shotgun Workfilesこのアプリを使用すると、作業ファイルとパブリッシュの閲覧、表示、保存が可能です。 |

ドキュメント
File Open ダイアログ
作業領域を移動する
ファイルを検索する
以前のバージョンにアクセスする
ユーザ サンドボックス
結果を絞り込む
File Save ダイアログ
異なるコンテキストで保存する
ファイル拡張子ドロップダウンを追加する
[コンテキスト変更](Context Change)ダイアログ
ステップ フィルタ
遅延クエリー
既知の問題
インストール、更新、開発
設定オプション
このアプリケーションは、Shotgun Pipeline Toolkit でファイルを管理する場合の基礎部分を構成します。これにより、さまざまな Shotgun エンティティ間をすばやく移動し、作業をすばやく開始することが可能になります。アプリケーションがシーンの裏でパスを管理するため、パスを指定する必要はありません。このアプリケーションを使用すると、作業領域内の作業ファイルを管理し、他のユーザと作業を簡単に共有できます。
ドキュメント
File Open ダイアログ
作業領域を移動する

メイン ダイアログは半分ずつに分かれています。左側には一連のタブがあります。最初のタブは「My Tasks」と呼ばれ、現在のユーザに割り当てられているすべてのタスクが表示されます。Shotgun の Web サイトの[マイ タスク](My Tasks)ページに非常によく似ています。
エンティティのタブを使用して Shotgun エンティティを参照することもできます。既定では、作業ファイル アプリケーションにより、それぞれのタブを確認することでショットまたはアセットに関連したタスクを参照できます。
一連のタブは、環境ファイルの entities
設定を利用して完全に設定可能です。
アプリ設定で show_file_open: true/false
を設定すると、このダイアログを無効または有効にできます。
ファイルを検索する

右側には、左側で選択した内容に関連する作業ファイルとパブリッシュが表示されます。作業ファイルとパブリッシュは、「All」、「Working」、「Publishes」の各タブを使用して一緒に表示したり、別々に表示したりできます。
以前のバージョンにアクセスする

以前のバージョンにアクセスする方法は 2 つあります。1 つ目の方法では、ブラウザ上部の「All versions」ボックスをクリックしてバージョンを展開し、ブラウザですべてのバージョンを個別に表示します。もう 1 つの方法では、ファイルを右クリックし、最新 10 件のバージョンにアクセスします。
ユーザ サンドボックス

パイプライン設定でユーザ サンドボックスを使用する場合、既定で表示されるのは現在のユーザのファイルのみです。他のユーザのサンドボックスにあるファイルを表示する場合は、上部のボタンをクリックすると、サンドボックスを選択して元のファイルを表示できます。
結果を絞り込む

文字を入力すると、表示の結果を絞り込むことができます。検索は項目の名前と一致します。
File Save ダイアログ
既定では、「File Save」ダイアログを使用すると、現在のコンテキストでファイルを保存できます。シーン名、バージョン番号、およびオプションのファイル拡張子(該当する場合)の入力が要求されます。「Save」ボタンはグレー表示されます。いったんアプリケーションでシーン名として次に利用可能なバージョン番号が確認されると、右下の「Save」ボタンが有効になります。
アプリ設定で show_file_save: true/false
を設定すると、このダイアログを無効または有効にできます。
異なるコンテキストで保存する

異なるコンテキストでファイルを保存するためにダイアログの左上にある展開ボタンをクリックすると、「File Save」ダイアログが展開し、保存先として別のコンテキストを選択できます。
ファイル拡張子ドロップダウンを追加する

新しい File Save ダイアログで、保存するファイルの拡張子を選択できます。これを有効にするためには、パイプライン設定の templates.yml
ファイルを調整する必要があります。最初に、templates.yml
内のトークン リストでトークンを定義する必要があります。
maya_extension: type: str choices: ma: Maya Ascii (.ma) mb: Maya Binary (.mb) default: ma alias: extension
maya_extension
はトークン名です。choices
は、ドロップダウンに表示されるファイル タイプのディクショナリです。キー(ma
と mb
)は、このテンプレート トークンに指定できる有効な値です。値(Maya Ascii (.ma)
と Maya Binary (.mb)
)は、Toolkit アプリケーションで使用できる UI に適した説明です。alias
は作業ファイル アプリケーションで必要なヒントです。このトークンが拡張子であり、ドロップダウン ウィジェットに表示されるということがアプリケーションに通知されます。
その後、このトークンは Maya 固有のテンプレートに追加できます。
maya_shot_work: definition: '@shot_root/work/maya/{name}.v{version}.{maya_extension}' root_name: 'primary'
[コンテキスト変更](Context Change)ダイアログ

[コンテキスト変更](Context Change)ダイアログは、右側にファイルを参照する領域がないことを除けば、[開く](Open)ダイアログと同様です。[コンテキスト変更](Context Change)ボタンを押すと、タスクまたはエンティティを選択して、現在のエンジンのコンテキストを変更できます。
アプリ設定で show_change_context: true/false
を設定すると、このダイアログを無効または有効にできます。
ステップ フィルタ
タスクを取得するときに、階層に step
が含まれている場合は、パイプライン ステップのフィルタを使用して、Shotgun から取得されるデータの量を減らすことができます。取得されるのは、選択したステップ リストにリンクされているタスクのみです。
タブに表示されるステップのリストは、step_filter_on
設定によってコントロールされます。設定しない場合は、すべての既存のパイプライン ステップが表示されます。
次の例では、アセットおよびショットのタスクをそれぞれ表示する 2 つのタブを定義します。
- caption: Assets Tasks entity_type: Task step_filter_on: Asset filters: - [entity, type_is, Asset] hierarchy: [entity.Asset.sg_asset_type, entity, step, content] - caption: Shots Tasks entity_type: Task step_filter_on: Shot filters: - [entity, type_is, Shot] hierarchy: [entity.Shot.sg_sequence, entity, step, content]

遅延クエリー
パフォーマンスを高めるために、エンティティ ツリーの構築を 2 つのステップ クエリーに分割して行うことができます。最初のクエリーは、Shotgun からレコードを取得して、ツリーの最上部に入力するために使用します。2 番目のクエリーは、ユーザがツリーを展開するときに子を取得するために使用します。
次の設定では、アプリを起動するときに Shotgun からアセットおよびショットを取得します。特定のアセットまたはショットを選択した場合、またはツリー ビューで展開した場合は、このアセットまたはショットにリンクされたタスクのみが取得されます。
entities: - caption: Assets entity_type: Asset hierarchy: [sg_asset_type, code] filters: sub_hierarchy: entity_type: Task filters: link_field: entity hierarchy: [step] - caption: Shots entity_type: Shot filters: hierarchy: [sg_sequence, code] sub_hierarchy: entity_type: Task filters: link_field: entity hierarchy: [step]

既知の問題
- 3ds Max と Motionbuilder サポート: Maya や Nuke と比較すると、Windows の DCC ではファイル パフォーマンスが低下します。
- Perforce/バージョンレス ファイル: アプリケーションで Perforce ワークフローを使用したテストをまだ実行する必要があるため、適切に動作しない可能性が高いです。
関連するアプリとドキュメント
![]() |
LoaderShotgun の Loader を使用すると、Shotgun にパブリッシュしたファイルの概要確認と参照をすばやく行うことができます。検索可能なツリー ビュー ナビゲーション システムを採用しているため、探しているタスク、ショット、またはアセットにすばやく、簡単にアクセスできます。ローダーには、その項目のパブリッシュすべてについてサムネイル ベースの概要が表示されます。その後は、設定可能なフックを利用して、パブリッシュを参照したり、現在のシーンに簡単に読み込んだりできます。 |
![]() |
Publishアーティストは Publish アプリを使用して作品をパブリッシュすることにより、下流工程に関わるアーティストが自分の作品を使用できるようにすることができます。アーティストのコンテンツ作成ソフトウェア内における従来のパブリッシュ ワークフローと、ディスク上にある任意のファイルのスタンドアロン パブリッシュがサポートされます。コンテンツ作成ソフトウェアで作業し、基本的な Shotgun の統合を使用すると、このアプリはアーティストがパブリッシュする項目を自動的に探して表示します。さらに高度な制作上のニーズがある場合は、アーティストのワークフローを操作するカスタム パブリッシュ プラグインを作成することもできます。 |
![]() |
シーンのスナップショットShotgun Snapshot は簡単な差分バックアップ機能であるため、他のユーザと共有しなくても、作業の差分をバージョン付けしたり、管理することができます。スナップショットの作成、説明やサムネイルの追加、後でいつでも復帰できるポイントの作成、および復元が可能です。これは、大きな変更を行う際に以前のバージョンのシーンをバックアップしておく必要がある場合に役立ちます。 |
![]() |
Shotgun パイプラインのチュートリアルこのドキュメントには、Shotgun 統合および Toolkit プラットフォームを使用してシンプルなエンドツーエンドのパイプラインをセットアップするテクニカル ディレクタ(TD)を対象とした、段階的なチュートリアルを用意しています。このチュートリアルの目標は、統合およびプラットフォームの基本的な側面や、スタジオの具体的なニーズに合わせて Shotgun ベースのパイプラインを作成およびカスタマイズする方法について理解できるようにすることです。 |
インストールと更新
Shotgun Pipeline Toolkit にこのアプリを追加する
Project XYZ にこのアプリを追加するには、asset という名前の環境で次のコマンドを実行します。
> tank Project XYZ install_app asset tk-maya tk-multi-workfiles2
最新バージョンに更新する
この項目が既にプロジェクトにインストールされている場合に最新バージョンを取得するには、update
コマンドを実行します。特定のプロジェクトに含まれている tank コマンドに移動し、そこでこのコマンドを実行します。
> cd /my_tank_configs/project_xyz > ./tank updates
または、tank
コマンドを実行し、プロジェクトの名前を指定して、更新チェックを実行するプロジェクトを指定します。
> tank Project XYZ updates
コラボレーションと発展
![]() |
Shotgun Pipeline Toolkit にアクセスできる場合は、すべてのアプリ、エンジン、およびフレームワークのソース コードにも Github からアクセスできます。これらは Github を使用して格納および管理しています。これらの項目は自由に発展させてください。さらなる独立した開発用の基盤として使用したり、変更を加えたり(その際はプル リクエストを送信してください)、 いろいろと研究してビルドの方法やツールキットの動作を確認してください。このコード リポジトリには、https://github.com/shotgunsoftware/tk-multi-workfiles2 からアクセスできます。 |
特殊な要件
- 上記の操作を行うには、Shotgun Pipeline Toolkit Core API バージョン v0.19.18 以降が必要です。
環境設定
以下に、使用するすべての環境設定の概要を示します。これらの設定は、このアプリまたはエンジンを有効にするための環境設定ファイルで定義する必要があります。
launch_at_startup
タイプ: bool
説明: アプリケーションの開始時に UI を起動するかどうかを決めるフラグです。一部のプラットフォームでは起動方法が異なるため、このオプションはすべてのエンジンでサポートされているわけではありません。現在、Maya Nuke と 3ds Max のみでこのオプションがサポートされています。
create_new_task_hook
タイプ: hook
既定値: {self}/create_new_task.py
説明: タスクを作成して必要な入力の検証を行うフックを指定します。
show_my_tasks
タイプ: bool
既定値: True
説明: [マイ タスク](My Tasks)ビューが表示されるかどうかを定義します。
file_browser_tabs
タイプ: list
既定値: [u'All', u'Working', u'Publishes']
説明: メイン ブラウザに表示されるタブ名のリストです。「All」、「Working」、および「Publishes」のタブ名を任意に組み合わせた値を指定できます。指定した値の順序で、アプリに表示されるタブの順番が決まります。
custom_actions_hook
タイプ: hook
既定値: {self}/custom_actions.py
説明: すべてのカスタム アクション メソッドが含まれるフックです。
auto_expand_tree
タイプ: bool
説明: ツリービューのルート レベルを自動的に展開します。
show_file_save
タイプ: bool
既定値: True
説明: [ファイルを保存](Save File)ダイアログを有効にするためのフラグです。[ファイルを保存](Save File)ウィンドウが表示され、ユーザは現在の作業ファイルを Toolkit テンプレート フォルダ構造に保存できます。
saveas_default_name
タイプ: str
既定値: scene
説明: save-as コマンドを使用して作業ファイルを保存する場合に使用される既定の名前です。
saveas_prefer_version_up
タイプ: bool
説明: save-as コマンドが使用する既定の名前を決定する方法を制御します。True に設定すると、現在のシーンの名前が使用され、バージョンが増分されます。False の場合は、新しい固有の名前が使用され、バージョンがリセットされます。
hook_copy_file
タイプ: hook
既定値: {self}/copy_file.py
説明: 「source_path」から「target_path」にファイルをコピーするのに使用されるフックを指定します。
entities
タイプ: list
既定値: [{u'hierarchy': [u'entity.Asset.sg_asset_type', u'entity', u'step', u'content'], u'caption': u'Assets', u'step_filter_on': u'Asset', u'filters': [[u'entity', u'type_is', u'Asset']], u'entity_type': u'Task'}, {u'hierarchy': [u'entity.Shot.sg_sequence', u'entity', u'step', u'content'], u'caption': u'Shots', u'step_filter_on': u'Shot', u'filters': [[u'entity', u'type_is', u'Shot']], u'entity_type': u'Task'}]
説明: この設定は左側に表示されるさまざまなタブを定義します。各タブは、ツリーを形成するいくつかの Shotgun フィールドでグループ化された Shotgun クエリーを表します。この設定はディクショナリのリストです。リスト内の各ディクショナリで 1 つのタブを定義し、次のキーを指定する必要があります。caption はタブの名前を指定し、entity_type は表示する Shotgun のエンティティ タイプを指定します。 filters は、標準フォーマットまたは複雑なフォーマットによる標準的な API Shotgun フィルタのリストです。hierarchy はエンティティ タイプに関連する Shotgun フィールドのリストで、ツリー グループを定義します。 オプションの sub_query キーは、遅延クエリーを定義する場合に使用できます。遅延クエリーは、ツリー ビューでエンティティ(通常はショットまたはアセットのタスク)を展開するときに、子を収集するために実行されます。これは、entity_type キー(収集する子エンティティのタイプを指定する)、link_field (エンティティを親にリンクするために使用される Shotgun フィールド名)、filters (標準 Shotgun API フィルタのリスト)、hierarchy (サブツリー内のグループ化を定義するフィールドのリスト)を含むディクショナリです。オプションの step_filter_on 設定はエンティティ タイプです。ステップのリストを制限して、指定したエンティティ タイプのステップのみが表示されるようフィルタする場合に使用できます。
template_work_area
タイプ: template
説明: ディスク上の作業ディレクトリを特定するテンプレートのリファレンスです。
hook_scene_operation
タイプ: hook
既定値: {self}/scene_operation_{engine_name}.py
説明: アプリケーションが実行する必要があるアプリケーション固有のすべてのシーン操作(表示や保存など)は、このフックにすべて集約されています。
hook_get_badge
タイプ: hook
既定値: {self}/get_badge.py
説明: 必要に応じて、パブリッシュ ファイルまたは作業ファイルを表示するときにユーザ インタフェースに含めるバッジ アイコンを提供するフックを指定します。
my_tasks_filters
タイプ: list
既定値: [[u'task_assignees', u'is', u'{context.user}']]
説明: [マイ タスク](My Tasks)タブのタスクに適用するフィルタのリストです。
show_change_context
タイプ: bool
説明: [コンテキスト変更](Context Change)ダイアログを有効にするためのフラグです。[コンテキスト変更](Context Change)ウィンドウが表示され、ユーザはファイルを開かなくても、コンテキストを変更するエンティティを選択できます。
allow_task_creation
タイプ: bool
既定値: True
説明: アプリから新しいタスクを作成できるかどうかを制御します。
version_compare_ignore_fields
タイプ: list
説明: 同一ファイルの別バージョンであるかどうかを判断するためにファイルを比較するときに無視する必要のあるフィールドのリストです。空の場合は、バージョン フィールドのみが無視されます。Toolkit はフィールドの値が異なるファイル間のバージョンは固有であると考えており、これに該当しない場合はエラーになるため、無視するフィールドを指定する場合には注意が必要です。
template_publish
タイプ: template
説明: ディスク上のパブリッシュ ファイルを特定するテンプレートのリファレンスです。
template_publish_area
タイプ: template
説明: ディスク上のパブリッシュ ディレクトリを特定するテンプレートのリファレンスです。
hook_filter_work_files
タイプ: hook
既定値: {self}/filter_work_files.py
説明: 必要に応じて、現在の作業領域で見つけた作業ファイルの未修正のリストをフィルタリングできるフックを指定します。
file_extensions
タイプ: list
説明: 作業ファイル ビューで表示されるファイル拡張子のリストです。空の場合は、テンプレートと一致するすべてのファイルが表示されます。
show_file_open
タイプ: bool
既定値: True
説明: [ファイルを開く](Open File)ダイアログを有効にするためのフラグです。[ファイルを開く](Open File)ウィンドウが表示され、ユーザはエンティティを選択し、そのコンテキストに関連付けられているファイルを選択して開き、他のアクションを実行することができます。
template_work
タイプ: template
説明: ディスク上の作業ファイルを特定するテンプレートのリファレンスです。
hook_filter_publishes
タイプ: hook
既定値: {self}/filter_publishes.py
説明: 必要に応じて、現在の作業領域で Shotgun から返されたパブリッシュの未修正のリストをフィルタリングできるフックを指定します。
my_tasks_extra_display_fields
タイプ: list
説明: [マイ タスク](My Tasks)リストのタスクに表示する追加フィールドのリストです。