사용자 지정 플레이북 작업

버튼, 드롭다운, 목록 항목 및 클릭 가능한 아이콘을 추가하는 조건을 설정하여 Playbook 상호작용을 사용자 지정합니다. 이 커스터마이제이션을 통해 모든 플레이북 경험에서 양식을 제출하고, 기록을 열고, 활동을 완료하고 건너뛸 수 있습니다.

개요

Playbook 작업은 서버 스크립트를 실행하거나, 클라이언트 작업을 디스패치하거나, 트리거될 때 UI 구성요소를 렌더링할 수 있습니다. 서버 스크립트를 실행할 때 현재 변수는 활동과 연관된 기록에 연결됩니다. 클라이언트 작업이 다음 내에서 UI 빌더이벤트를 트리거하도록 하려면 을 참조하십시오 Playbook에 대한 UXF 클라이언트 작업 구성.

플로우 데이터 기록(sys_flow_data)은 작업 서버 스크립트를 통해 플로우 구성을 제어하기 위한 연관된 기록으로 자주 사용됩니다. 이러한 서버 스크립트는 플로우의 상태를 완료 또는 건너뜀으로 설정하여 에이전트가 플로우 내의 논리에 직접 영향을 줄 수 있도록 합니다.

플로우 데이터 기록은 플로우 내에서 사용할 에이전트로부터 사용자 데이터를 수집할 수도 있습니다.

연결된 기록은 모든 테이블에 연결할 수 있습니다. 이러한 기본 작업 외에 사용자 고유의 작업을 정의하여 원하는 비즈니스 프로세스 워크플로우 논리를 구현할 수 있습니다.

양식 필드 필요 확인란을 선택하여 서버가 아닌 스크립트 작업에서 저장 후 저장 후 기능을 활성화할 수 있습니다. 저장 후 저장 기능이 있는 작업은 양식을 제출하고, 클라이언트 스크립트와 비즈니스 규칙 확인을 수행하며, 기록이 성공적으로 저장되면 작업을 실행합니다. 확인 또는 비즈니스 규칙으로 인해 기록을 저장할 수 없는 경우 작업이 실행되지 않습니다. 기본적으로 이렇게 하면 sysverb_ws_save UI 작업이 트리거되어 양식을 제출하지만 클라이언트 작업 페이로드의 uiActionName 속성에서 다른 UI 작업을 지정하여 재정의할 수 있습니다.

기본 작업

플레이북에서 지원되는 기본 작업은 다음과 같습니다.

작업 이름	설명
건너뛰기 skip_instructional	지침 프로세스 단계를 건너뜁니다.
건너뛰기 skip_email	이메일 보내기 건너뛰기
건너뛰기 skip_knowledge	지식 프로세스 단계를 건너뜁니다.
건너뛰기 skip_update	기록 업데이트 프로세스 단계를 건너뜁니다.
건너뛰기 skip_list	목록 프로세스 단계를 건너뜁니다.
건너뛰기 skip_create	기록 생성 프로세스 단계를 건너뜁니다.
완료됨 표시 complete_activity	활동을 완료로 표시
기록 작성 create_record	새 기록 양식에서 새 기록 생성
이메일 보내기 send_email	프로세스 자동화에 이메일을 보내도록 알림
재시작 restart_activity	활동을 다시 시작합니다.
건너뛰기 skip_activity	경험 상태 기록을 사용하는 활동을 건너뜀으로 표시합니다.
기록 보기 기록 보기	현재 기록 보기
저장 save_record	현재 기록 저장
승인자 보기 플레이북 뷰 승인자	이 기록에 대한 승인자 보기
완료 표시 mark_complete_knowledge	지식 프로세스 단계를 완료로 표시
완료 표시 mark_complete_instructional	지침 프로세스 단계를 완료로 표시
완료 표시 mark_complete_list	목록 프로세스 단계를 완료로 표시
완료 표시 mark_complete	현재 프로세스를 완료로 표시
완료 표시 save_and_complete_activity	현재 기록을 저장하고 프로세스를 완료로 표시

플레이북 작업 사용자 지정

양식, 조건 및 스크립트, 구성요소 또는 클라이언트 작업을 사용하여 Playbook 작업을 사용자 지정합니다. 이 커스터마이제이션을 통해 사용자는 양식을 제출하고, 기록을 열고, 활동을 완료하거나 건너뛸 수 있습니다.

시작하기 전에

필요한 역할: playbook_experience.admin

이 태스크 정보

• 기본 작업은 편집할 수 없습니다. 이러한 작업은 읽기 전용으로 표시됩니다.
• 작업은 하나의 기록에 대해서만 작동할 수 있습니다.

프로시저

1. 작업을 생성하고 상세 정보를 지정합니다.
   1. 다음으로 이동 플레이북 경험 > 작업 플레이북 작업, 스테이지 작업 또는 활동 작업.
   2. 작업 할당을 선택하거나 새로 만들기 를 클릭하여 새 작업을 만듭니다.
      주:

      기본 작업 목록은 플레이북 작업 섹션을 참조하세요.
   3. 양식의 필드에 내용을 입력합니다.

      표 1. 작업 할당 양식

      필드	설명
      작업 레이블	작업을 통해 생성된 버튼에 나타나는 레이블입니다.
      작업 이름	작업 할당 목록에 나타나는 작업의 이름입니다. 작업 할당은 이름이 같은 다른 작업 할당을 재정의합니다.
      다음으로 구현됨	구현되는 작업의 유형입니다. 예를 들어 UI 구성요소가 있습니다.
      UI 구성요소 지정	다음으로 구현됨 필드가 UI 구성요소로 설정되면 이 필드는 작업이 트리거될 때 표시되는 UI 구성요소를 지정합니다.
      도구 설명	에이전트가 커서를 버튼 또는 아이콘 위로 가리킬 때 표시되는 텍스트입니다.
      아이콘	활동 카드에 표시되는 아이콘입니다.
      모드 렌더링	플레이북 카드의 렌더링 모드. 플레이북 카드에서 작업이 렌더링되는 방식을 지정합니다. 버튼, 헤더 드롭다운 또는 헤더 아이콘을 선택합니다.
      단추 유형	플레이북 UI에 표시되는 버튼 유형입니다. 1차, 2차 또는 3차를 선택합니다.
      양식 필드 필요함	작업을 계속하려면 사용자의 데이터가 필요함을 전달하는 옵션입니다. 이 필드는 다음과 같은 방식으로 플레이북 경험 UI에서 사용됩니다. 활동에 너무 커서 카드에 넣을 수 없는 양식이 포함되어 있으면 양식이 모달에서 숨겨집니다. 활동에 양식이 포함되어 있지만 양식 필드가 필요한 작업이 없으면 양식이 렌더링되지 않습니다. 대신 양식의 필드는 레이블-값 쌍의 누적 컬렉션으로 렌더링됩니다. 사용자 지정 활동 렌더러를 만들어 이 필드를 재정의할 수 있습니다.
      설명	작업 할당 목록에 표시되는 작업에 대한 설명입니다.
      애플리케이션	작업 할당을 위한 애플리케이션입니다.
      작업 공간	플레이북 작업과 관련된 워크플레이스입니다. 예: ServiceNow® ITSM HR. 주: 이 필드는 필수가 아닙니다.
      테이블	이 작업을 이 연결된 테이블이 있는 활동으로 제한하는 필드입니다.
      뷰	이 작업을 이 양식 뷰의 활동으로 제한하는 필드입니다.
      활성	작업을 활성화하는 옵션입니다.
      주문	이름이 같은 일치하는 작업과 관련하여 이 작업의 우선순위를 결정하는 정수입니다. 숫자가 낮을수록 다른 작업에 대해 선택될 가능성이 높습니다. 이 순서를 사용하면 다른 작업을 자신의 작업으로 재정의할 수 있습니다. 일반적인 방법은 백 단위의 숫자를 사용하는 것입니다. 예를 들어 100, 200, 300 또는 400입니다.

2. 작업에 대한 조건을 설정합니다.
   1. 조건 탭을 클릭합니다.
   2. 양식의 필드에 내용을 입력합니다.

      표 2. 조건 양식

      필드	설명
      스크립트 조건	작업 할당에 대한 스크립트 조건입니다. sn_playbook 입력합니다. PlaybookExperience.parentRecordContainsPlaybook(현재). 이 스크립트를 사용하면 기록이 프로세스 실행을 트리거한 경우에만 Playbook을 표시할 수 있습니다. 주: 여러 조인과 관련된 쿼리를 추가하면 성능이 저하될 수 있습니다.
      클라이언트 조건	사용 사례에 따라 충돌을 제한하는 조건을 선택합니다.
      기록 조건	사용 사례에 따라 충돌을 제한하는 조건을 선택합니다.
      필요한 역할	플레이북 액세스를 제한하는 역할입니다.
      작성 접근 권한 필요	생성 액세스 권한을 요구하는 옵션입니다.
      읽기 접근 권한 필요	읽기 액세스를 요구하는 옵션입니다.
      쓰기 접근 권한 필요	쓰기 액세스 권한을 요구하는 옵션입니다.
      삭제 접근 권한 필요	삭제 액세스를 요구하는 옵션입니다.

3. 다음으로 구현됨 필드에서 서버 스크립트를 선택한 경우 작업에 대한 스크립트를 제공합니다.
   • 서버 스크립트는 Current 변수를 사용하여 활동의 관련 기록을 참조할 수 있습니다.
   • 호출 current.update() 하면 사용자가 플레이북 카드의 포함된 양식에서 제공하는 값으로 관련 기록이 업데이트됩니다.
4. 다음으로 구현됨 필드에서 클라이언트 작업을 선택한 경우 필요에 따라 작업 속성 탭에서 페이로드 매핑을 지정합니다.

   페이로드 매핑을 사용하면 클라이언트 작업에 의해 디스패치된 페이로드의 일부를 재정의할 수 있습니다. 예를 들어 기록 미리 보기 클라이언트 작업을 사용하면 새 작업 공간 탭에서 기록을 열 수 있습니다. 페이로드 매핑을 사용하여 양식이 열릴 때 표시되는 관련 항목 탭을 지정할 수 있습니다. 이렇게 하려면 defaultTab 을 설정합니다.

5. 다음으로 구현됨 필드에서 UI 구성요소가 선택된 경우 구성요소 속성 탭에서 구성요소의 속성을 선택적으로 지정합니다.
6. 제출을 클릭합니다.

플레이북 경험을 위해 플레이북 작업 적용

기본 또는 사용자 지정 Playbook 작업을 Playbook Experience에 적용합니다.

시작하기 전에

필요한 역할: playbook_experience_admin

프로시저

1. 다음으로 이동 모두 > 플레이북 경험 > 플레이북 경험.
2. 플레이북 경험을 선택합니다.
3. 작업 매핑 관련 목록을 클릭합니다.
4. 새로 만들기를 클릭합니다.
5. 양식의 필드에 내용을 입력합니다.

   표 3. 플레이북 경험 작업 할당 맵

   필드	설명
   작업 할당	선언적 작업 할당 선택
   플레이북 경험	작업을 적용할 플레이북 경험 선택
   애플리케이션	동작이 적용되는 애플리케이션
   활동 정의	작업을 적용할 활동 정의를 선택합니다.

6. 제출을 클릭합니다.
7. 관련 링크 섹션에서 플레이북 경험 매핑 탭을 선택합니다.
8. 플레이북 경험이 테이블에 추가되었는지 확인합니다.

다음에 수행할 작업

플레이북 경험을작업 공간와 통합합니다.