사용자 지정 플레이북 작업

  • 릴리스 버전: Yokohama
  • 업데이트 날짜 2025년 01월 30일
  • 읽기7분

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

    개요

    플레이북 작업은 서버 스크립트를 실행하거나, 클라이언트 작업을 디스패치하거나, 트리거 시 UI 구성요소를 렌더링할 수 있습니다. 서버 스크립트를 실행할 때 현재 변수는 활동의 관련 기록에 연결됩니다. 클라이언트 동작이 내에서 UI 빌더이벤트를 트리거하도록 하려면 을 참조하십시오 플레이북에 대한 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_experience.admin

    이 태스크 정보

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

    프로시저

    1. 작업을 생성하고 상세 정보를 지정합니다.
      1. 다음으로 이동 플레이북 경험 > 작업 플레이북 작업, 스테이지 작업 또는 활동 작업.
      2. 작업 할당을 선택하거나 신규 를 클릭하여 새 작업 할당을 생성합니다.
        주:
        기본 작업 목록은 플레이북 작업을 참조하십시오.
      3. 양식의 필드에 내용을 입력합니다.
        표 1. 작업 할당 양식
        필드 설명
        작업 레이블 작업을 통해 생성된 버튼에 나타나는 레이블입니다.
        작업 이름 작업 할당 목록에 나타나는 작업의 이름입니다. 작업 할당은 동일한 이름을 가진 다른 작업을 재정의합니다.
        다음으로 구현됨 구현되는 작업의 유형입니다. 예: UI 구성요소.
        UI 구성요소 지정 구현 형식 필드가 UI 구성요소로 설정되면 이 필드는 작업이 트리거될 때 표시되는 UI 구성요소를 지정합니다.
        도구 설명 에이전트가 버튼 또는 아이콘 위에 커서를 놓을 때 표시되는 텍스트입니다.
        아이콘 활동 카드에 표시되는 아이콘입니다.
        모드 렌더링 플레이북 카드의 렌더링 모드입니다. 플레이북 카드에서 작업이 렌더링되는 방식을 지정합니다. 버튼, 헤더 드롭다운 또는 헤더 아이콘을 선택합니다.
        단추 유형 플레이북 UI에 표시되는 버튼 유형입니다. 기본, 보조 또는 3차 선택
        양식 필드 필요함 작업을 계속하려면 사용자의 데이터가 필요하다는 것을 전달하는 옵션입니다.
        이 필드는 다음과 같은 방법으로 플레이북 경험 UI에서 사용됩니다.
        1. 활동에 너무 커서 카드에 담을 수 없는 양식이 포함되어 있으면 양식이 모달에서 숨겨집니다.
        2. 활동에 양식이 포함되어 있지만 양식 필드가 필요한 작업이 없는 경우 양식이 렌더링되지 않습니다. 대신 양식의 필드가 레이블-값 쌍의 누적 컬렉션으로 렌더링됩니다.
        사용자 지정 활동 렌더러를 만들어 이 필드를 재정의할 수 있습니다.
        설명 작업 할당 목록에 표시되는 작업에 대한 설명입니다.
        애플리케이션 작업 할당을 위한 애플리케이션입니다.
        작업 공간 플레이북 작업과 연결된 작업 공간입니다. 예를 들어 HR 또는 HR입니다 ServiceNow® ITSM .
        주:
        이 필드는 필수가 아닙니다.
        테이블 이 작업을 이 관련 테이블과의 활동으로 제한하는 필드입니다.
        뷰 이 작업을 이 양식 뷰의 활동으로 제한하는 필드입니다.
        활성 작업을 활성화하는 옵션입니다.
        순서 이름이 같은 일치하는 작업과 관련하여 이 작업의 우선순위를 결정하는 정수입니다. 숫자가 낮을수록 다른 행동에 대해 선택될 가능성이 높습니다. 이 순서를 지정하면 다른 작업을 사용자 고유의 작업으로 재정의할 수 있습니다. 일반적인 방법은 백 단위의 숫자를 사용하는 것입니다. 예를 들어 100, 200, 300 또는 400입니다.
    2. 작업에 대한 조건을 설정합니다.
      1. 조건 탭을 클릭합니다.
      2. 양식의 필드에 내용을 입력합니다.
        표 2. 조건 양식
        필드 설명
        스크립트 조건 작업 할당에 대한 스크립트 조건입니다. sn_playbook 입력합니다. PlaybookExperience.parentRecordContainsPlaybook(current)입니다. 이 스크립트를 사용하면 기록이 프로세스 실행을 트리거한 경우에만 플레이북을 표시할 수 있습니다.
        주:
        여러 조인을 포함하는 쿼리를 추가하면 성능이 저하될 수 있습니다.
        클라이언트 조건 사용 사례에 따라 충돌을 제한하는 조건을 선택합니다.
        기록 조건 사용 사례에 따라 충돌을 제한하는 조건을 선택합니다.
        필요한 역할 플레이북 액세스를 제한하는 역할입니다.
        작성 접근 권한 필요 생성 권한을 요구하는 옵션입니다.
        읽기 접근 권한 필요 읽기 권한을 요구하는 옵션입니다.
        쓰기 접근 권한 필요 쓰기 권한을 요구하는 옵션입니다.
        삭제 접근 권한 필요 삭제 권한을 요구하는 옵션입니다.
    3. 구현됨 필드에서서버 스크립트가 선택된 경우 작업에 대한 스크립트를 제공합니다.
      • 서버 스크립트는 변수를 사용하여 활동의 연결된 기록을 참조할 수 있습니다 Current .
      • 호출 current.update() 은 플레이북 카드의 포함된 양식에서 사용자가 제공하는 값으로 연결된 기록을 업데이트합니다.
    4. 다음으로 구현됨 필드에서 클라이언트 작업을 선택한 경우 선택적으로 작업 속성 탭에서 페이로드 매핑을 지정합니다.

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

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

    플레이북 경험을 플레이북 경험에 플레이북 작업 적용

    기본 또는 사용자 지정 플레이북 작업을 플레이북 경험에 적용합니다.

    시작하기 전에

    필요한 역할: playbook_experience_admin

    프로시저

    1. 다음으로 이동 모두 > 플레이북 경험 > 플레이북 경험.
    2. 플레이북 경험을 선택합니다.
    3. 작업 매핑 관련 목록을 클릭합니다.
    4. 새로 만들기를 클릭합니다.
    5. 양식의 필드에 내용을 입력합니다.
      표 3. 플레이북 경험 작업 할당 맵
      필드 설명
      작업 할당 선언적 작업 할당 선택
      플레이북 경험 작업을 적용할 플레이북 경험 선택
      애플리케이션 작업이 적용되는 애플리케이션
      활동 정의 작업을 적용할 활동 정의를 선택합니다.
    6. 제출을 클릭합니다.
    7. 관련 링크 섹션에서 플레이북 경험 매핑 탭을 선택합니다.
    8. 플레이북 경험이 테이블에 추가되었는지 확인합니다.

    다음에 수행할 작업

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