사용자 지정 레이아웃 시작하기

  • 릴리스 버전: Zurich
  • 업데이트 날짜 2025년 07월 31일
  • 소요 시간: 5분

    • UI 빌더 페이지를 설정하고 에서 사용자 지정 레이아웃플레이북 경험에 대한 모듈식 플레이북 사용자 지정 레이아웃 구성요소 구성을 시작합니다.

    시작하기 전에

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

    필요한 역할: ui_builder_admin, admin

    이 태스크 정보

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

    프로시저

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

      플레이북 템플릿을 선택합니다.
    4. 템플릿을 사용하는 플레이북 경험 경우 페이지를 생성합니다 .
      1. 페이지 상세 정보를 설정합니다.
        이름 페이지의 이름입니다.
        URL 경로 사용자가 페이지에 액세스하기 위해 이동하는 URL 경로입니다.
      2. 페이지의 테스트 매개변수를 검토합니다.
        table 플레이북의 상위 테이블 이름입니다.
        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. 구성요소 트리에서 스테이지 선택기로 다시 이동하고 오른쪽에 열리는 패널에서 스테이지 선택기의 방향을 결정합니다.