플레이북UI 빌더에서 사용자 지정

  • 릴리스 버전: Australia
  • 업데이트 날짜 2026년 03월 12일
  • 소요 시간: 5분

    • 사용자 지정 플레이북 레이아웃에 페이지와 모듈식 구성요소를 사용하여 UI 빌더 구성 가능한 작업 공간, 서비스 포털 페이지 또는 모바일 웹 페이지에서 최종 사용자의 모습 플레이북 경험 을 사용자 지정합니다.

    시작하기 전에

    • 사용자 지정 레이아웃을 적용할 UI 플레이북 가 없는 경우 플레이북을 빌드합니다. 자세한 내용은 건물 플레이북 문서를 참조하십시오.
    • 에서 최신 버전의 플레이북 경험 플레이북 경험 구성요소 앱을 설치합니다.ServiceNow Store 플레이북 경험 앱을 참조하십시오.

    필요한 역할: ui_builder_admin, admin

    이 태스크 정보

    페이지를 만든 UI 빌더 후에는 필요에 따라 페이지를 사용자 지정할 플레이북 경험 수 있습니다. 페이지 템플릿에는 템플릿을 포함한 구성요소 사전 설정과 함께 사용할 수 있는 컨트롤러가 포함되어 있습니다.플레이북 자세한 내용은 Bind data to UI Builder pages using controllers (advanced feature) 문서를 참조하십시오.

    프로시저

    1. 다음으로 이동 모두 > Now Experience 프레임워크 > UI 빌더.
    2. 작업하려는 UI 빌더 환경을 열거나 새 경험을 생성합니다.
      플레이북 경험 작성기 경험은 사용자 지정할 플레이북 경험수 있도록 구축되었습니다. 환경을 생성하는 방법에 대한 자세한 내용은UI 빌더에서 사용자가 애플리케이션과 상호 작용하는 방법 구성을 참조하세요
    3. UI 빌더 환경에서 다음을 수행할 수 있습니다.
      템플릿을 플레이북 경험 사용하면 버전 25.2부터 기록 생성기를 포함하여 플레이북 사용자 지정 레이아웃 UI 컨트롤러와 구성요소가 모든 페이지에 이미 추가되어 있기 때문에 개발 프로세스의 속도가 빨라집니다. 컨트롤러는 제공된 모든 구성요소를 데이터로 자동으로 채웁니다.
      주:
      템플릿을 사용하면 사용자 지정 구성요소를 계속 만들고 추가할 수 있습니다.

      템플릿을 플레이북 선택합니다.
    4. 템플릿을 플레이북 경험 사용하는 경우 페이지를 생성합니다 .
      1. 페이지 상세 정보를 설정합니다.
        이름 페이지의 이름입니다.
        URL 경로 사용자가 페이지에 액세스하기 위해 탐색하는 URL 경로입니다.
      2. 페이지의 테스트 매개변수를 검토합니다.
        테이블 플레이북의 상위 테이블 이름입니다.
        sysID 기록의 Sys_id입니다. 존재하지 않는 기록의 경우 값은 -1입니다.
        경험 로드하려는 경험입니다.
        selectedPlaybook 에이전트 또는 이행자가 속한 플레이북입니다.
        selectedStage 에이전트 또는 이행자가 있는 스테이지입니다.
        selectedActivity 에이전트 또는 이행자가 속한 활동입니다.
      3. 기본 페이지 및기준을 설정하십시오.
        이름 페이지 변형의 이름입니다.
        대상 그룹 페이지 변형을 볼 수 있는 사용자입니다. 이는 다음과 같이 정의할 수 있습니다.
        • 역할
        • 그룹
        • 사용자
        • 회사
        • 부서
        • 위치
        • 스크립트
        조건 페이지 변형이 표시되는 시기를 결정하는 조건입니다.
      4. 방금 생성한 기본 페이지 변형을 엽니다.
      새 플레이북 경험 레이아웃에는 데이터로 채워진 컨트롤러와 구성요소가 이미 포함되어 있지만 몇 가지 구성을 더 수행해야 합니다. 나머지 구성을 수행하려면 6단계로 이동합니다.
    5. 표준 기록 템플릿을 사용했거나 페이지를 처음부터 새로 만든 경우 플레이북 사용자 지정 레이아웃 UI 컨트롤러를 페이지에 추가합니다.
      1. 새 페이지의 하단에서 데이터 아이콘( 데이터 아이콘)을 선택합니다.
      2. + 추가를 선택합니다.
      3. "플레이북"을 검색합니다.
      4. 데이터 자원에서 플레이북 사용자 지정 레이아웃 UI 컨트롤러를 선택하고 추가를 클릭합니다.
      5. 데이터 자원 패널을 종료합니다.
    6. 방금 추가한 플레이북 사용자 지정 레이아웃 UI 컨트롤러 를 구성합니다.
      1. 사용자가 표준 새 기록 양식 대신 이 사용자 지정 플레이북 경험 양식에서 새 기록을 생성할 수 있도록 하려면 왼쪽 상단에 있는 테스트 값 알약을 선택합니다.
        테스트 값 팝오버가 열립니다.
      2. sysID 테스트 값이 -1로 설정되어 있는지 확인하고 적용을 선택합니다.
        테이블 및 sysID를 사용하여 플레이북 경험에 대한 값을 테스트합니다.
        미리 보기를 열면 기록 생성기 양식을 사용할 수 있습니다. 기록 생성기 양식을 테스트하고 새 기록이 생성되는지 확인할 수 있어야 합니다.
      3. 테이블 이름 또는 선택적 매개변수를 업데이트할 수도 있습니다.
      4. 옵션: 대신 테스트 값을 하드 코딩하려면 데이터 > 데이터 자원 패널 > 로컬 데이터 자원 인스턴스, UI 컨트롤러 기록 페이지를 선택합니다.
      5. 컨트롤러의 구성 탭에서 상위 SysID 또는 상위 테이블을 추가합니다.

        테스트 값 팝오버에서 sysID 및 테이블 필드는 다음과 같습니다.

        상위 테이블 필드에 context.props.table을 입력하고 상위 SysID 필드에 context.props.sysId를 입력할 수 있습니다.
        주:
        입력 플레이북하는 테이블이나 기록에 .
      6. 사용하려는 플레이북 경험을 추가합니다.
      7. 옵션: 필요한 경우 다른 필드에 대한 값을 입력합니다.
        활동 뷰 모드 스택 또는 집중 모드에서 플레이북 활동을 렌더링하는 데 사용되는 뷰 모드
        기록 생산자 쿼리 기록 생성기에서 제공된 쿼리를 선택적으로 겹쳐쓰기 위해 인코딩된 쿼리 문자열
        선택한 플레이북 컨텍스트 ID 딥 링크에 대해 선택한 플레이북의 선택적 컨텍스트 ID
        선택한 스테이지 컨텍스트 ID 딥 링크에 대해 선택한 스테이지의 선택적 컨텍스트 ID
        선택한 활동 컨텍스트 ID 딥 링크에 대해 선택한 활동의 선택적 컨텍스트 ID
      8. 옵션: 출력 열에서 하드 코딩할 값을 선택할 수 있습니다.
      컨트롤러가 구성되었으며 구성요소를 추가할 플레이북 준비가 되었습니다.
    7. 구성요소를 추가합니다 플레이북 .
      1. 구성요소 트리에서 기본 탭을 선택합니다.
        오른쪽에 메인 탭 패널이 열립니다.
      2. 메인 탭 패널에서 + 추가를 선택합니다.
        "이 탭을 어떻게 빌드하시겠습니까?"라는 모달이 표시됩니다.
      3. 빈 컨테이너에서 시작 을 선택하고 다음을 클릭합니다.
        탭 설정 모달이 표시됩니다.
      4. 탭에 이름과 아이콘을 지정하고 생성을 클릭합니다.
        탭이 구성요소 트리에 추가되고 빈 캔버스가 표시됩니다.
      5. 구성요소 트리의 새 탭 아래에서 + 구성요소 추가 를 선택하고 "크기 조정 가능"을 검색합니다.
      6. 크기 조정 가능한 창 구성요소를 선택하고 이름을 지정한 다음 만들기를 클릭합니다.
      7. 구성요소 트리에서 방금 생성한 새 크기 조정 가능한 창 구성요소를 엽니다.
        새 크기 조정 가능한 창 의 패널이 오른쪽에 열립니다.
      8. 필요에 따라 구성하고 오른쪽 상단 모서리에 있는 저장 을 클릭합니다.
      9. 스테이지 선택기를 추가하려면 구성요소 트리에서 새 크기 조정 가능한 창구성요소를 찾은 후 왼쪽 아래에서 + 구성요소 추가를 선택합니다.
      10. 구성요소 트리에서 새 스테이지 선택기를 선택합니다.
        새 스테이지 선택기 패널이 오른쪽에 열립니다.
      11. 플레이북 사용자 지정 레이아웃 UI 컨트롤러에서 이 구성요소에 대한 사전 설정을 선택하고 오른쪽 상단 모서리에 있는 저장을 클릭합니다.
        구성요소에 대한 사전 설정을 선택합니다.
        확인 메시지가 표시되고 스테이지 선택기 패널의 이벤트 탭에 있는 구성 요소 입력과 이벤트가 자동으로 채워집니다.
        구성요소 구성입니다.
      12. 플레이북 활동 뷰어를 추가하려면 구성요소 트리에서 크기 조정 가능한 창구성요소를 찾은 후 오른쪽에서 + 구성요소 추가를 선택합니다.
      13. 7j단계와 7k단계를 반복합니다.
      14. 플레이북 모달을 추가하려면 구성요소 트리의 메인 탭에서 생성한 탭을 찾아 + 구성요소 추가를 선택합니다.
      15. 플레이북 모달에 대해 7j 및 7k 단계를 반복합니다.
      16. 플레이북 스테이지 선택기로 다시 이동하여 스테이지 선택기의 방향을 결정합니다.
      17. 오른쪽 상단 모서리에서 열기 를 클릭하여 레이아웃을 플레이북 미리 봅니다.
      18. 로 돌아가십시오 UI 빌더.
      19. 구성요소 트리의 스테이지 선택기로 다시 이동하여 오른쪽에 열리는 패널에서 스테이지 선택기의 방향을 결정합니다.