필드 데코레이터 작업을 위해 ITSM 에이전트 작업 공간에서 서비스 운영 작업 공간으로 UI 구성요소 마이그레이션

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

    • 필드 데코레이터 작업을 ITSM 에이전트 작업 공간에서 서비스 운영 작업 공간으로 마이그레이션하도록 UI 구성요소를 구성합니다.

    시작하기 전에

    필요한 역할: 관리자

    프로시저

    1. 다음으로 이동 모두 > Now Experience 프레임워크 > 선언적 작업 > 필드 데코레이터.
    2. 다음 에 따라 구현됨을 기반으로 기록을 필터링합니다. UI 구성요소로 설정됩니다.
    3. 마이그레이션 프로세스에서 실패한 기록의 로그를 확인한 후 관련 목록 작업 목록에서 기록의 로그 sys_Id 를 찾습니다.
    4. 해당 sys_id과 함께 실패한 기록을 선택합니다.
    5. 헤더를 마우스 오른쪽 버튼으로 클릭하고 삽입 및 유지를 선택합니다.
    6. 작업 공간 및 뷰 필드를 지웁니다.
    7. 경험 제한됨 확인란을 선택합니다.
    8. 다음 으로 구현됨 필드의 값을 UXF 클라이언트 작업으로 업데이트합니다.
    9. 작업 구성 관련 목록에서 편집을 선택한 다음 컬렉션에서 작업 구성 목록으로 SOW 작업을 선택합니다.
    10. 저장을 선택하여 작업 구성 관련 목록을 저장합니다.
      주:
      필드에 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. 테이블을 필터링하고 마이그레이션된 테이블 이름 및 대상 페이로드 매핑 을 사용하여 mra 또는 인터셉터 경로를 포함합니다.
      3. 기록이 발견되면 선언적 작업 sys_id을 반환합니다.

        발견된 DA의 모든 추가 기능 이벤트 매핑을 반복하여 마이그레이션된 DA에 추가합니다.

      4. 테이블에서 기록을 찾을 수 없는 경우, 테이블 필터를 제거하고 targetPayload contains route=mra 또는 interceptor를 검색합니다.
        목록 및 필드 데코레이터의 경우 mra 및 인터셉터 추가 기능 이벤트 매핑을 수동으로 추가해야 합니다. 자세한 내용은 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 테이블의 경우, SOW에서 ITSM 에이전트 작업 공간 기록을 마이그레이션하면 활성이 False로 설정됩니다.