작업 파일

Shotgun Workfiles

이 앱을 사용하여 작업 파일 및 게시를 찾고, 열고, 저장할 수 있습니다.
최신 버전: v0.11.8(prod)
버전 번호의 경우 유의적 버전 표준을 따릅니다.
시스템 이름: tk-multi-workfiles2

참고: 이 문서에서는 툴킷 구성에 대한 제어 권한이 있는 경우에만 사용할 수 있는 기능에 대해 설명합니다. 자세한 정보는 Shotgun 통합 사용자 안내서를 참조하십시오.
개요 요약
설명서
            파일 열기 대화상자
                  작업 영역 탐색
                  파일 찾기
                  이전 버전 액세스
                  사용자 샌드박스
                  결과 범위 축소
            파일 저장 대화상자
                  다른 컨텍스트에 저장
                  파일 확장자 드롭다운 추가
            단계 필터링
            유예 쿼리
            알려진 문제
설치, 업데이트 및 개발
구성 옵션

이 응용프로그램은 Shotgun Pipeline Toolkit에서 파일 관리의 기초를 형성합니다. 이를 통해 여러 Shotgun 엔티티 사이를 빠르게 이동하고 작업을 신속하게 시작할 수 있습니다. 응용프로그램이 백그라운드에서 관리해 주기 때문에 경로를 지정할 필요가 없습니다. 이 응용프로그램을 사용하면 작업 영역 내에서 작업 파일을 관리하고 다른 사람들과 작업을 쉽게 공유할 수 있습니다.

설명서

파일 열기 대화상자

작업 영역 탐색

기본 대화상자는 두 부분으로 나뉩니다. 왼쪽에는 일련의 탭이 있습니다. 첫 번째 탭은 "내 태스크(My Tasks)"이며 현재 사용자에게 할당된 모든 태스크를 표시합니다. Shotgun 웹 사이트의 "내 태스크(My Tasks)" 페이지를 연상케 합니다.

또는 엔티티 탭을 사용하여 Shotgun 엔티티를 탐색할 수도 있습니다. 기본적으로 작업 파일 응용프로그램은 해당 탭을 확인하여 샷 또는 에셋과 관련된 모든 태스크를 검색할 수 있습니다.

탭 세트는 환경 파일의 entities 설정을 통해 완전히 구성할 수 있습니다.

파일 찾기

오른쪽에는 왼쪽의 선택 항목과 관련된 작업 파일 및 게시가 표시됩니다. 작업 파일 및 게시는 "전체(All)", "작업(Working)" 및 "게시(Publishes)" 탭을 사용하여 함께 또는 각각 볼 수 있습니다.

이전 버전에 액세스

이전 버전에 액세스하는 방법에는 두 가지가 있습니다. 먼저 브라우저 상단에 있는 "모든 버전(All versions)" 상자를 클릭하면 버전을 확장하여 브라우저에 개별적으로 모두 나열할 수 있습니다. 또 다른 옵션으로는, 파일을 마우스 오른쪽 버튼으로 클릭하여 마지막 10개 버전에 액세스할 수 있습니다.

사용자 샌드박스

파이프라인 구성에서 사용자 샌드박스를 사용하는 경우 기본적으로 현재 사용자의 파일만 표시됩니다. 사용자가 다른 사용자 샌드박스의 파일을 보려면 맨 위에 있는 버튼을 사용하여 파일을 표시할 샌드박스를 선택할 수 있습니다.

결과 좁히기

텍스트를 입력하여 모든 뷰의 결과를 좁힐 수 있습니다. 검색은 항목의 이름과 일치합니다.

파일 저장 대화상자

기본적으로 "파일 저장(File Save)" 대화상자를 통해 사용자는 현재 컨텍스트에 파일을 저장할 수 있습니다. 씬 이름, 버전 번호 및 선택적 파일 확장자(사용 가능한 경우)를 묻는 메시지가 표시되고 "저장(Save)" 버튼이 회색으로 표시됩니다. 응용프로그램이 씬 이름에 대한 사용 가능한 다음 버전 번호를 확인한 후에야 오른쪽 하단에 있는 저장(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는 드롭다운에 표시될 파일 형식 사전입니다. 키(mamb)는 이 템플릿 토큰이 가질 수 있는 가능한 값입니다. 값(Maya Ascii (.ma)Maya Binary (.mb))은 툴킷 응용프로그램에서 사용할 수 있는 UI 설명입니다. alias는 작업 파일 응용프로그램에 필요한 힌트입니다. 응용프로그램에 이 토큰은 확장자이며 드롭다운 위젯에 표시되어야 함을 알려 줍니다.

그런 다음 이 토큰을 Maya 특정 템플릿에 추가할 수 있습니다.

maya_shot_work:
    definition: '@shot_root/work/maya/{name}.v{version}.{maya_extension}'
    root_name: 'primary'

단계 필터링

태스크를 검색할 때 step이 계층에 포함되어 있으면 파이프라인 단계 필터링을 사용하면 선택한 단계 목록에 링크된 태스크만 검색되므로 Shotgun에서 검색한 데이터의 양을 줄일 수 있습니다.

탭에 표시되는 단계 목록은 step_filter_on 설정으로 제어됩니다. 설정하지 않을 경우 기존의 모든 파이프라인 단계가 표시됩니다.

아래 예는 에셋 및 샷에 대한 태스크를 각각 표시하는 두 개의 탭을 정의합니다.

  - 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]

유예 쿼리

성능 향상을 위해 엔티티 트리를 빌드하는 과정을 두 단계의 쿼리로 나눌 수 있습니다. 첫 번째 쿼리를 사용하여 Shotgun에서 레코드를 검색하여 트리의 맨 위에 입력합니다. 두 번째 쿼리를 사용하여 사용자가 트리를 확장할 때 하위를 검색합니다.

다음 설정을 사용하면 앱이 시작될 때 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 지원 - Windows에서 이러한 DCC의 파일 성능은 Maya 및 Nuke에 비해 느립니다.
  • Perforce 파일/버전이 없는 파일 - 응용프로그램은 Perforce 워크플로우로 테스트를 계속해야 하므로 제대로 작동하지 않을 가능성이 높습니다.

관련 앱 및 문서

로더

Shotgun Loader를 사용하면 Shotgun에 게시한 파일을 신속하게 확인하고 탐색할 수 있습니다. 검색 가능한 트리 뷰 네비게이션 시스템 덕분에 원하는 태스크, 샷 또는 에셋을 빠르고 쉽게 찾을 수 있고, 찾고 나면 로더가 해당 항목의 모든 게시에 대한 개요를 기반으로 썸네일을 보여 줍니다. 그러면 구성 가능한 후크를 통해 쉽게 게시를 참조하거나 현재 씬으로 가져올 수 있습니다.

게시

아티스트는 Publish 앱을 통해 아티스트 다운스트림에서 사용할 수 있도록 작업물을 게시할 수 있습니다. 아티스트의 컨텐츠 생성 소프트웨어 내에서 기존 게시 워크플로우를 지원하고 디스크상의 파일을 독립 실행형으로 게시할 수 있습니다. 컨텐츠 생성 소프트웨어에서 작업하거나 기본 Shotgun 통합을 사용하여 작업할 때 이 앱은 아티스트가 게시할 수 있는 항목을 자동으로 검색해 표시해 줍니다. 보다 정교한 프로덕션이 필요한 경우 스튜디오는 커스텀 게시 플러그인을 작성하여 아티스트 워크플로우를 진행할 수 있습니다.

씬 스냅샷

Shotgun 스냅샷은 다른 사람과 공유하지 않고 작업의 버전을 만들고 증분을 관리할 수 있는 빠른 증분 백업입니다. 스냅샷을 만들고 설명과 썸네일을 추가하여 나중에 언제든지 다시 돌아가서 복원할 수 있도록 특정 시점 이미지를 생성합니다. 씬을 많이 변경할 때와 이전 버전의 씬을 확실히 백업해 두려는 경우 유용합니다.

Shotgun 파이프라인 튜토리얼

이 문서에서는 Shotgun 통합 및 툴킷 플랫폼을 사용하여 단순한 전체 파이프라인을 설정하려는 TD(기술 디렉터)를 위해 단계별 튜토리얼을 제공합니다. 이 튜토리얼의 목표는 사용자가 스튜디오의 요구 사항에 맞게 Shotgun 기본 파이프라인을 빌드하고 커스터마이즈하는 방법을 익히고 통합 및 플랫폼의 기본 특성을 이해할 수 있도록 지원하는 것입니다.

설치 및 업데이트

Shotgun Pipeline Toolkit에 이 앱 추가

이 앱을 이름이 asset인 환경에 있는 프로젝트 XYZ에 추가하고 싶다면 다음 명령을 실행합니다.

> 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에서 그 소스 코드에도 액세스할 수 있습니다. 이러한 항목을 자유롭게 개선하여 향후 독립적인 개발을 위한 기반으로 사용하고 변경 후 다시 풀 리퀘스트를 제출하거나, 아니면 그냥 조금만 손을 보고 어떻게 빌드되었는지, 툴킷이 어떻게 작동하는지 확인해 보십시오. https://github.com/shotgunsoftware/tk-multi-workfiles2에서 이 코드 리포지토리에 액세스할 수 있습니다.

특별 요구 사항

  • 이 기능을 이용하려면 Shotgun Pipeline Toolkit Core API 버전 v0.17.0 이상이 필요합니다.

구성

아래는 사용되는 모든 구성 설정을 요약한 것입니다. 해당 설정은 이 앱 또는 엔진을 활성화하려는 환경 파일에서 정의해야 합니다.

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

설명: 트리 뷰의 루트 레벨을 자동으로 확장합니다.

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 쿼리를 나타냅니다. 이 설정은 사전 목록입니다. 목록의 각 사전은 하나의 탭을 정의하며, 다음 키가 있어야 합니다. caption은 탭의 이름을 지정하고, entity_type은 표시할 Shotgun 엔티티 유형을 지정합니다. filters는 표준 형식 또는 복잡한 형식의 표준 API Shotgun 필터 목록입니다. hierarchy는 엔티티 유형에 대한 Shotgun 필드 목록으로 트리의 그룹 지정을 정의합니다. 선택적 sub_query 키는 트리 뷰에서 엔티티가 확장될 때 하위(일반적으로 샷 또는 에셋의 태스크)를 수집하기 위해 실행되는 유예 쿼리를 정의하는 데 사용할 수 있습니다. 이는 다음 키가 있는 사전입니다. 수집할 하위 엔티티 유형을 지정하는 entity_type 키, 엔티티를 해당 상위에 링크하는 데 사용되는 Shotgun 필드 이름인 link_field, 표준 Shotgun API 필터 목록인 filters, 하위 트리의 그룹 지정을 정의하는 필드 목록인 hierarchy입니다. 선택적 step_filter_on 설정은 엔티티 유형이며 필터링에 사용된 단계 목록을 지정된 엔티티 유형에 대한 단계로만 제한하는 데 사용할 수 있습니다.

template_work_area

유형: template

설명: 디스크에서 작업 디렉토리를 찾는 템플릿에 대한 참조입니다.

hook_scene_operation

유형: hook

기본값: {self}/scene_operation_{engine_name}.py

설명: 앱이 수행해야 하는 모든 응용프로그램별 씬 작업(열기, 저장 등)은 이 후크에서 함께 수집됩니다.

my_tasks_filters

유형: list

기본값: [[u'task_assignees', u'is', u'{context.user}']]

설명: My Tasks 탭의 태스크에 적용할 필터 목록입니다.

allow_task_creation

유형: bool

기본값: True

설명: 앱에서 새 태스크를 만들 수 있는지 여부를 제어합니다.

version_compare_ignore_fields

유형: list

설명: 파일을 비교할 때 무시해야 하는 필드 목록으로, 동일한 파일의 다른 버전인지 확인합니다. 이 필드가 비어 있으면 버전 필드만 무시됩니다. 툴킷은 해당 필드에 대해 다른 값을 갖는 파일에서 버전이 고유할 것으로 예상하므로 무시할 필드를 지정할 때는 주의를 기울여야 하며 그렇지 않은 경우에는 오류가 발생합니다.

template_publish

유형: template

설명: 디스크에서 게시 파일을 찾는 템플릿에 대한 참조입니다.

template_publish_area

유형: template

설명: 디스크에서 게시 디렉토리를 찾는 템플릿에 대한 참조입니다.

hook_filter_work_files

유형: hook

기본값: {self}/filter_work_files.py

설명: 필요한 경우 현재 작업 영역에서 찾은 작업 파일의 로우 목록을 필터링할 수 있는 후크를 지정합니다.

file_extensions

유형: list

설명: 작업 파일 뷰에 표시할 파일 확장자 목록입니다. 비어 있으면 템플릿과 일치하는 모든 파일이 표시됩니다.

template_work

유형: template

설명: 디스크에서 작업 파일을 찾는 템플릿에 대한 참조입니다.

hook_filter_publishes

유형: hook

기본값: {self}/filter_publishes.py

설명: 필요한 경우 현재 작업 영역에 대해 Shotgun에서 반환된 게시의 로우 목록을 필터링할 수 있는 후크를 지정합니다.

my_tasks_extra_display_fields

유형: list

설명: My Tasks 목록의 태스크와 함께 표시할 추가 필드 목록입니다.

팔로우

0 댓글

댓글을 남기려면 로그인하세요.