ITSM 에이전트 작업 공간에서 ITSM용 서비스 운영 작업 공간으로 UI 구성요소 마이그레이션

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

    • 목록 작업을 ITSM 에이전트 작업 공간에서 ITSM용 서비스 운영 작업 공간(SOW)으로 마이그레이션하도록 UI 구성요소를 구성합니다.

    시작하기 전에

    마이그레이션을 수행할 경우 ITSM 에이전트 작업 공간 기능에 대해 목록 작업 옵션을 선택해야 합니다. 목록에 대한 목록 작업 옵션을 예로 들 수 있습니다. 마이그레이션 프로세스에 대한 자세한 내용은 ITSM 에이전트 작업 공간에서 ITSM용 서비스 운영 작업 공간으로 마이그레이션 문서를 참조하십시오.

    필요한 역할: admin

    이 태스크 정보

    마이그레이션 프로세스가 끝나면 마이그레이션의 성공 여부를 지정하는 확인 메시지가 나타납니다. 마이그레이션 정보를 검토하고 마이그레이션 후 단계를 수행하여 구성 또는 커스터마이제이션의 마이그레이션이 성공적으로 이루어졌는지 확인할 수 있습니다.

    프로시저

    1. 다음으로 이동 모두 > Now Experience 프레임워크 > 선언적 작업 > 목록 작업.
    2. 다음으로 구현됨이 UI 구성요소로 설정된 상태에서 기록을 필터링합니다.
    3. 마이그레이션 프로세스에서 실패한 기록의 로그를 확인한 후 목록 작업 목록에서 해당 기록의 sys_Id를 찾습니다.
    4. 해당 sys_id가 있는 실패한 기록을 선택합니다.
    5. 헤더를 선택하고 길게 누르거나 마우스 오른쪽 버튼으로 클릭하고 삽입 및 유지를 선택합니다.
    6. 작업 공간 및 뷰 필드를 지웁니다.
    7. 경험이 제한됨 확인란을 선택합니다.
    8. 다음으로 구현됨 필드의 값을 UXF 클라이언트 작업으로 업데이트합니다.
    9. 작업 구성 관련 목록에서 편집을 선택한 다음, 수집 목록에서 작업 구성 목록으로 SOW 작업을 선택합니다.
    10. 저장을 선택하여 작업 구성 목록을 저장합니다.
      주:

      목록에 MRA(Multiple Record Associator) 또는 인터셉터를 추가하는 것은 유효한 시나리오가 아닙니다. MRA 또는 인터셉터를 사용하여 커스터마이제이션을 마이그레이션하는 경우, 기본 시스템 기록에 대한 추가 기능 이벤트 매핑을 확인해야 합니다. 기본 시스템에서는 목록 선언적 작업에 대한 추가 기능 이벤트 매핑이 지정되지 않습니다.

    11. 업데이트를 선택합니다.

      마이그레이션 유틸리티는 UI 구성요소 유형의 MRA 및 인터셉터 선언적 작업만 지원합니다.

    12. MRA의 경우 코드 블록에 언급된 대로 작업 페이로드를 생성한 후 작업 속성의 값을 ITSM 에이전트 작업 공간 선언적 작업의 구성요소 속성으로 업데이트합니다.

      ITSM 에이전트 작업 공간 선언적 작업 기록에 값이 없으면 {{ key }}를 사용하여 값을 채웁니다. 예를 들어 구성요소 속성 테이블이 비어 있으면 페이로드에서 값이 {{table}}이어야 합니다.

      { 
"label": "label", 
                "extensionPoint": "extensionPoint", 
                "userGivenTable": "userGivenTable", 
                "hideSelectAll": "hideSelectAll", 
                "parentRecordSysId": "parentRecordSysId", 
                "table": "table", 
                "referencedFieldName": "referencedFieldName", 
                "type": "type", 
                "parentFieldName": "parentFieldName", 
                "columns": "columns", 
                "view": "view", 
                "relatedListName": "relatedListName" 
        }
    13. 인터셉터의 경우 코드 블록에 언급된 대로 작업 페이로드 정의 [sys_declarative_action_payload_definition] 테이블에 작업 페이로드를 생성합니다. 
      { 
    "table": "target", 
                "sysId": "-1", 
                "parentTable": "{{parentTable}}", 
                "parentSysId": "{{parentRecordSysId}}", 
                "referencedFieldName": "", 
                "pageTitle": "Create " + tableLabel, 
                "pageSubTitle": "Choose one of the following " + tableLabel + " types", 
                "useDomain": false 
}
    14. 마이그레이션된 선언적 작업에 추가 기능 이벤트 매핑을 추가합니다.

      SOW에서 일치하는 선언적 작업을 찾은 후 마이그레이션된 선언적 작업에 모든 추가 기능 이벤트 매핑을 추가합니다. 다음 단계를 사용하여 SOW에서 동등한 선언적 작업을 찾습니다.

      1. 다음으로 이동 모두 > sys_ux_addon_event_mapping.list
      2. 테이블을 필터링하고 마이그레이션된 tablename 및 대상 페이로드 매핑을 사용하면 mra 또는 인터셉터 경로가 포함됩니다.
      3. 기록이 발견되면 선언적 작업 sys_id를 반환합니다.

        필터링된 선언적 작업에 대한 모든 추가 기능 이벤트 매핑을 반복하여 마이그레이션된 선언적 작업에 추가합니다.

      4. 테이블에서 기록을 찾을 수 없는 경우, 테이블 필터를 제거하고 targetPayload contains route=mra 또는 interceptor를 검색합니다.
        목록 및 필드 데코레이터의 경우 MRA 및 interceptor 추가 기능 이벤트 매핑을 수동으로 추가해야 합니다. 자세한 내용은 Create a UX add-on event mapping 문서를 참조하십시오.
      주:

      ITSM 에이전트 작업 공간의 변경 요청 [change_request] 인터셉터 기록은 SOW에 있습니다.

      선언적 작업의 인터셉터 유형에 대한 작업 공간 기록 유형 선택기를 마이그레이션하는 작업은 다음과 같습니다.
      • ITSM 에이전트 작업 공간 테이블: 작업 공간 기록 유형 선택기 [aw_record_type_selector]
      • SOW 테이블: 기록 유형 선택기 [sn_sow_interceptor_record_type_selector]

      표준으로 값이 있는 변경 요청 [change_request] 테이블의 경우, ITSM 에이전트 작업 공간에서 SOW로 기록을 마이그레이션하면 Active가 False로 설정됩니다.