Custom Action Menu Items

Action Menu Items 주요 필드

1. Title (title): 메뉴 항목의 표시 이름.
2. Entity Type (entity_type): 메뉴 항목이 표시될 엔터티 유형. 설정하지 않으면 모든 엔터티에서 표시됨.
3. URL (url): 스크립트를 실행할 URL.
4. Order (list_order): 메뉴 항목의 순서.
5. Light Payload: 커스텀 프로토콜을 사용하는 경우 스크립트가 전체 페이로드 대신 페이로드 정보를 보관하는 이벤트 로그 항목 레코드의 ID를 수신합니다.
6. 메뉴 옵션 구성:
   • 엔터티 우클릭 메뉴에 포함.
   • "엔터티 추가(Add Entity)" 드롭다운 메뉴에 포함.
   • "엔터티 추가" 버튼 재정의.
   • 사용자 메뉴에서 내부 리소스로 포함.
7. Folder: 컨텍스트 메뉴 내에서 폴더로 그룹화.
8. Open in Modal Overlay: 새 탭 대신 iframe 창에서 AMI 열기.
9. Poll for Data Updates: 데이터 업데이트를 위한 폴링 활성화.
10. Restrict to Permission Groups: 특정 권한 그룹에만 AMI 표시.
11. Restrict to Projects: 특정 프로젝트에서만 AMI 활성화.
12. Secret Token: AMI 보안을 위한 비밀 토큰.
13. Selection Required: 행이 선택되지 않은 경우 비활성화 여부.

---

Action Menu Items 유형

• HTTP URL: 스크립트를 HTTP/HTTPS URL로 연결.
• 커스텀 프로토콜: customProtocol://action 형식으로 로컬 애플리케이션 실행 가능.

---

AMI 동작 방식

HTTP URL 예제: "PDF 보고서 생성"

1. 사용자 워크플로우:
   • 버전(Version) 페이지로 이동.
   • 하나 이상의 버전을 선택.
   • 우클릭 메뉴에서 "PDF 보고서 생성" 클릭.
   • ShotGrid는 선택된 데이터와 함께 POST 요청을 URL로 보냄.
   • 스크립트는 데이터를 처리하고, PDF 보고서를 생성해 반환.

커스텀 프로토콜 예제

• ShotGrid에서 데이터가 GET 요청을 통해 전송됨.
• Maya, RV, Cinesync 등 애플리케이션과 통합 가능.

---

페이로드 내용

사용자 데이터

• user_id: 현재 로그인한 사용자의 ID.
• user_login: 사용자 로그인 이름.

엔터티 데이터

• entity_type: 현재 페이지의 엔터티 유형.
• selected_ids: 선택된 엔터티 ID 리스트.
• ids: 현재 페이지의 모든 엔터티 ID.

페이지 데이터

• title: 페이지 제목.
• page_id: 클릭한 AMI가 포함된 페이지의 ID.
• cols: 페이지에 표시된 열의 시스템 이름.
• sort_column 및 sort_direction: 정렬 기준과 방향.

프로젝트 데이터

• project_name: 프로젝트 이름.
• project_id: 프로젝트 ID.

---

AMI 생성 방법

1. 설정 메뉴에서 Action Menu Items를 선택해 AMI 관리 페이지로 이동.
2. "새 메뉴 항목 추가" 버튼을 클릭.
3. 제목 및 필수 필드를 입력한 후 Create Action Menu Item 클릭.
4. 필요한 경우 "URL"에 스크립트 경로를 설정하여 처리.

https://help.autodesk.com/view/SGDEV/ENU/?guid=SGD_ami_action_menu_items_create_html#action-menu-item-fields

Help