ETL 변환 맵 생성

  • 릴리스 버전: Yokohama
  • 업데이트 날짜 2025년 01월 30일
  • 읽기43분
  • 통합 허브 ETL은 특정 통합을 위한 ETL 변환 맵을 작성하는 데 필요한 모든 작업을 완료하는 과정을 안내하는 안내 설정을 제공합니다.

    안내 설정

    안내 설정은 모든 작업을 올바른 순서로 구성하고, 작업 완료를 추적하고, 작업 의존성을 적용합니다. 다른 작업의 완료 여부에 따라 달라지는 작업은 도구를 단계별로 실행하고 작업을 완료할 때 활성화되거나 비활성화됩니다.

    ETL 변환 맵 도우미 페이지의 안내 설정을 사용하여 다음 작업을 완료합니다.

    소스 데이터 임포트 및 기본 상세 정보 지정

    CMDB에 통합하려는 데이터의 소스와 같은 통합에 대한 기본 상세 정보를 제공하고 소스 데이터를 임포트합니다.

    시작하기 전에

    ETL 변환 맵에 대해 선택하려는 데이터 소스는 현재 세션에서 사용 중인 것과 동일한 애플리케이션 범위에 있어야 합니다.

    ETL 변환 맵을 열면 기본적으로 맵의 유효성이 검사되지 않습니다. 시스템 속성 [sys_properties] 테이블에 시스템 속성을 추가한 sn_int_studio.validation.enabled 다음 이를 true로 설정하여 이 확인 단계를 사용하도록 설정할 수 있습니다. 유효성 검사가 완료되면 유효성 검사 오류를 처리하는 방법을 선택합니다.

    필요한 역할: cmdb_inst_admin

    프로시저

    1. 다음으로 이동 모두 > 구성 > 통합 허브 ETL.
      통합 허브 ETL의 방문 페이지에는 에서 ServiceNow Store다운로드한 통합을 포함하여 시스템에 존재하는 모든 통합이 나열됩니다. 통합 허브 ETL v3.2부터 통합은 값별로 CMDB Application 그룹화되며, 이 경우 해당 그룹을 확장하여 통합을 찾습니다.
    2. 보거나 수정할 통합의 이름을 클릭하거나 새로 만들기를 클릭합니다.
      시스템 속성이 sn_int_studio.validation.enabledtrue로 설정되면 통합 허브 ETL은 로드하는 ETL 변환 맵의 유효성을 확인합니다. 유효성 검사 오류가 있는 경우 감지된 모든 특정 오류를 나열하는 잘못된 매핑 데이터 탐지 대화 상자가 나타납니다. 잘못된 매핑을 삭제하고 유효한 매핑만 계속 사용하거나 잘못된 매핑을 유지하도록 선택할 수 있습니다. 그러나 통합 작업을 계속하는 동안 잘못된 매핑에 대한 알림은 계속 표시됩니다.
      시스템은 다음과 같은 오류를 감지합니다.
      • 해당 RTE(강력한 변환 엔진) 필드 매핑 기록에서 소스 또는 대상 필드 누락
      • 임포트 세트에서 누락된 테이블 열
        주:
        이 경우 RTE의 해당 메타데이터 레코드는 더 이상 유효하지 않으며 자동으로 삭제됩니다. 임포트 세트의 누락된 테이블 열과 관련된 필드 매핑 및 변환 작업과 같은 기록이 삭제됩니다.
      • 조회 클래스에 대한 IRE(식별 및 조정 엔진) 조회 규칙 누락
    3. ETL 변환 맵 도우미 페이지의 안내 설정의 기본 상세 정보 지정 섹션에서 소스 데이터 임포트 및 기본 상세 정보 제공 작업을 선택합니다.
    4. 양식을 작성합니다.
      필드 설명
      CMDB 애플리케이션

      ETL 변환 맵과 연결된 CMDB 애플리케이션입니다.

      새로 추가를 선택하여 새 CMDB 애플리케이션에 대한 CMDB 애플리케이션검색 소스 필드를 추가할 수 있습니다.

      이름 ETL 변환 맵의 이름입니다.
      설명 통합에 대한 설명입니다.
      데이터 소스 시스템의 모든 데이터 소스 목록입니다.
      주:
      데이터 통합이 크게 변경될 수 있으므로 이후에 데이터 소스를 수정할 때는 주의해야 합니다. 새 데이터 소스의 임포트 세트 테이블에 맞추려면 열 및 관련 변환을 제거하거나 새 열을 추가해야 할 수 있습니다. 통합 허브 ETL 확인 프로세스는 필요한 업데이트를 탐지하고 사용자가 이러한 업데이트에 동의하거나 거부할 수 있도록 합니다.
      샘플 임포트 세트

      지정된 데이터 소스와 연결된 임포트 세트입니다.

      해당 임포트 세트 데이터의 하위 집합은 소스 데이터를 미리 보는 데 사용됩니다.

      새 임포트 세트 자동 끌어오기 옵션을 선택하여 연결된 데이터 소스의 새 임포트 세트를 가져옵니다.

      통합 허브 ETL v3.2부터 임포트 세트를 지정하지 않으면 맵이 로드되고 읽기 전용 모드로 자동 설정됩니다. 맵에서 구성을 검토할 수 있지만 매핑 또는 변환을 편집할 수는 없습니다.

      미리 보기 크기 재정의

      이 변환 맵의 미리 보기에 대한 샘플로 로드되어 사용되는 데이터 기록 수입니다. 설정된 경우 이 사용자 지정 설정은 시스템 속성의 값을 sn_int_studio.preview.size 재정의하고 현재 변환 맵에만 적용됩니다.

      전체 스키마 로드가 비활성화된 경우 로드된 지정된 레코드 수만을 기반으로 맵에 대한 중첩된 데이터 구조가 생성됩니다.

      통합 허브 ETL v3.2부터 사용할 수 있는 필드입니다.

      전체 스키마 로드

      맵의 데이터 구조를 생성하기 위해 전체 데이터 스키마 로드를 활성화하거나 비활성화합니다.

      사용하지 않도록 설정하면 맵에 대한 중첩된 데이터 구조가 미리 볼 샘플 기록으로 로드된 기록 수 또는 기록만을 기반으로 생성됩니다. 로드되는 기록 수는 미리 보기 크기 재정의 설정 또는 전역 시스템 속성에 sn_int_studio.preview.size의해 결정됩니다.

      통합 허브 ETL v3.2부터 사용할 수 있는 필드입니다.

      CMDB 애플리케이션 CMDB 애플리케이션의 이름입니다. CMDB 애플리케이션을새로 추가로 설정한 경우에 나타납니다.
      디스커버리 소스

      CMDB 애플리케이션과 연결된 검색 소스입니다. CMDB 애플리케이션을새로 추가로 설정한 경우에 나타납니다.

    5. 저장을 클릭하여 현재 변경 내용을 저장하거나 완료로 표시를 클릭합니다.

      저장을 클릭하면 헤더에 타임 스탬프가 나타나며, 이 타임 스탬프는 ETL 변환 맵에 대한 통합 허브 ETL 세션 동안 유지됩니다. 세션에 다시 들어가거나 ETL 맵 간에 전환하면 타임스탬프가 사라집니다.

    데이터 미리 보기 및 준비

    CMDB에 통합될 원시 소스 데이터의 샘플 기록을 검토합니다. 필요한 경우 대상 클래스 및 속성에 맞게 데이터를 변환하고 준비합니다.

    시작하기 전에

    샘플 데이터의 기록 수는 기본적으로 100으로 설정된 시스템 속성에 sn_int_studio.preview.size의해 전역적으로 결정됩니다. 통합 허브 ETL이 처리할 수 있는 샘플 데이터의 최대 기록 수는 10,000개입니다. 해당 속성을 10,000개 한도 이상으로 설정하면 통합 허브 ETL은 최대 10,000개의 기록만 처리하고 그 효과에 대한 메시지가 표시됩니다.

    통합 허브 ETL v3.2부터는 맵당 임포트 소스 데이터 및 기본 상세 정보 제공 양식에서 미리 보기 크기 재정의 필드를 설정하여 속성 값을 sn_int_studio.preview.size 재정의할 수 있습니다.

    중첩된 페이로드에서 중첩된 데이터를 처리하려면 Data in single column(단일 열의 데이터 ) 옵션을 사용하여 해당 데이터 소스를 설정해야 합니다.

    필요한 역할: cmdb_inst_admin

    이 태스크 정보

    샘플 데이터의 데이터 열에 있는 값을 검토하고 원하는 대상 클래스 및 속성의 요구 사항에 맞지 않는 열을 식별합니다. 예를 들어, 데이터 형식을 변환하고, 값을 바꾸고, 데이터 열을 연결하여 데이터를 변환할 수 있습니다. 변환을 다른 변환 위에 적용하여 데이터 변환 체인을 만들 수 있습니다. 매핑 및 통합 프로세스에서 무시할 데이터 열을 설정할 수도 있습니다.
    주:
    CMDB 속성을 비워 두려면 문자열 '<EMPTYֹ_STRING>'를 사용합니다.

    중첩된 데이터의 열은 나머지 데이터와 함께 표시되며 데이터 열 헤더에는 Nested Objects 표기법이 표시됩니다. 객체당 중첩된 데이터 항목 수는 중첩된 데이터의 더 깊은 수준으로 드릴할 수 있는 링크와 함께 나타납니다. 중첩된 데이터의 데이터 구조를 별도의 패널에 표시하려면 데이터 구조 표시 옵션을 활성화합니다.

    데이터 구조 패널에는 중첩된 데이터를 표시하는 두 가지 옵션이 있습니다.

    • 트리: 개체별로 그룹화된 중첩 데이터로, 각 개체 노드는 원본 데이터의 레코드 항목에 해당합니다. 객체 노드를 확장하여 기록에 대해 중첩된 모든 데이터를 표시합니다.
    • 컬렉션: 최상위 객체(기본적으로)로 그룹화된 다음 소프트웨어와 같은 중첩된 데이터 항목으로 그룹화된 중첩된 데이터입니다. 소프트웨어와 같은 노드를 확장하여 각 컴퓨터에 설치된 소프트웨어를 표시합니다.
    [데이터 구조] 패널, 이동 경로 경로 또는 소스 데이터 자체에 표시되는 번호 링크를 통해 중첩된 데이터 수준을 탐색할 수 있습니다. 선택 항목과 표시되는 데이터는 탐색에 관계없이 중첩된 데이터의 모든 뷰 간에 동기화된 상태로 유지됩니다.

    중첩 페이로드 데이터 작업에 대한 데모를 보려면 ServiceNow YouTube 채널에서 통합 허브 - ETL 중첩 페이로드 기능 데모 비디오를 시청하십시오.

    프로시저

    1. 다음으로 이동 모두 > 구성 > 통합 허브 ETL을 클릭하고 통합 이름을 클릭합니다.
      통합 허브 ETL의 방문 페이지에는 에서 ServiceNow Store다운로드한 통합을 포함하여 시스템에 존재하는 모든 통합이 나열됩니다.
    2. ETL 변환 맵 도우미 페이지의 안내 설정의 매핑할 소스 데이터 준비 섹션에서 데이터 미리 보기 및 준비를 선택합니다.
    3. 옵션: 데이터 구조 표시를 선택하여 중첩된 데이터의 구조를 보여주는 데이터 구조 패널을 엽니다. 데이터 구조 패널에서 중첩된 데이터의 수준을 드릴다운할 수 있습니다.
    4. 옵션: 열에 대한 작업 메뉴를 선택한 다음 정렬 작업을 선택합니다.
    5. 열에 대한 작업 메뉴를 선택한 다음 그룹화 기준을 선택하여 해당 열을 기준으로 데이터를 그룹화합니다. 그룹화 작업을 취소하려면 그룹 해제를 선택합니다.
    6. 옵션: 새 변환을 클릭한 다음 소스 열 사용을 선택합니다. 또는 열에 대한 작업 메뉴를 선택한 다음 새 변환을 선택하여 선택한 열을 변환합니다.

      이 데이터 최상위 보기에서는 중첩된 객체에 대한 새 변환을 만들 수 없습니다. 중첩된 객체 열에는 기록에 대한 중첩된 항목 수를 나타내는 숫자 링크가 포함됩니다. 중첩된 객체에 대한 새 변환을 만들려면 해당 번호 링크를 클릭하여 실제 중첩된 데이터로 드릴다운합니다. 또는 데이터 구조 패널에서 변환을 만들 중첩 개체로 이동합니다.

      중첩된 데이터의 변환은 변환되는 중첩된 데이터의 상위 객체를 참조할 수 있습니다. 중첩된 데이터에 대한 샘플 페이로드 를 예로 사용하면 인터페이스 개체에 대한 변환은 부모 컴퓨터 개체를 참조할 수 있지만 소프트웨어 개체는 참조할 수 없습니다.

      1. 오른쪽의 새 변환 사이드바에서 변환 유형을 선택하고 필요한 경우 변환 설명을 수정합니다.
        변환 유형에 대한 자세한 내용은 다음 문서를 참조하십시오 통합 허브 ETL의 변환 유형.
      2. 옵션: 이 변환에 사용된 모든 열을 현재 뷰에서 숨기려면 이 변환에 사용되는 초기 열 숨기기를 선택하십시오.
        이 설정은 현재 세션에서 일시적이며 페이지를 새로 고치면 숨겨진 열이 다시 나타납니다. 숨겨진 열을 표시하려면 배너 프레임에서 기어 아이콘을 클릭할 수도 있습니다. 그런 다음 숨겨진 열을 사용 가능에서 선택됨 목록으로 이동하고 확인을 클릭합니다.
      3. 값이 변환되는 입력 열을 선택하거나 확인합니다.
      4. 옵션: 변환된 값과 함께 추가될 열의 출력 열 이름을 수정합니다.
      5. 적용을 클릭합니다.
        변환된 값이 있는 새 열이 출력 열 이름에 따라 사전순으로 배치되어 나타납니다. 제안된 출력 열 이름을 사용한 경우 새 열이 입력 열의 오른쪽에 나타납니다.
      6. 변환된 데이터를 검토하고 필요한 경우 변환을 조정합니다.
    7. 옵션: "고정 값 열 설정" 변환을 적용하려면 다음을 수행합니다.
      1. 새 변환을 클릭한 다음 고정 값 열 설정을 선택합니다.
      2. 고정 값 설정 열 사이드바에서 새 열의 열 이름과열 설명을 입력합니다. 그런 다음 열 값 할당을 새 열에 대해 고정된 값으로 설정합니다.
      3. 적용을 클릭합니다.
    8. 옵션: 열에 대한 작업 메뉴를 선택한 다음 매핑에서 무시 를 선택하여 현재 세션의 매핑 및 통합에서 열을 제외합니다.

      후속 세션에서는 매핑에서 무시 설정이 적용되지 않고 열이 매핑에 포함됩니다.

      매핑에 포함을 클릭하여 열에 대한 매핑에서 무시 설정을 실행 취소할 수 있습니다.

    9. 옵션: 열에 대한 작업 메뉴를 선택한 다음 이 열 및 다운스트림 열 삭제를 선택합니다. 이 삭제 작업은 이 열을 입력 열로 사용하여 추가된 모든 열과 함께 열을 삭제합니다.
    10. 옵션: 새 변환을 클릭한 다음 테이블 조회를 선택하면 조회하고 추가 값을 추출할 테이블을 지정할 수 있습니다. 오른쪽에 있는 테이블 조회 사이드바의 필드를 입력합니다.
      지정된 조회 테이블의 값이 매핑된 데이터와 일치합니다. 일치하는 기록의 경우 조회 테이블의 지정된 값이 매핑을 준비 중인 데이터에 열로 추가됩니다.
      표 1. 테이블 조회
      필드 설명
      조회 테이블 매핑 중인 데이터와 일치시키는 데 사용할 테이블입니다. 조회 테이블의 기록과 매핑된 데이터가 조회 조건을 만족하면 조회 테이블의 지정된 값이 해당 기록에서 추출되어 매핑된 데이터에 추가됩니다.
      조회 조건

      열 조건 쌍의 집합입니다. 각 쌍은 조회 테이블의 열과 매핑된 데이터의 열을 지정하며, 이러한 열은 일치를 시도합니다.

      • 대상 테이블 열의 값인 경우: 매핑된 데이터의 열과 일치하는 대상 테이블의 열입니다.
      • 소스 데이터 테이블의 일치 값: 조회 테이블의 열과 일치할 매핑된 데이터의 열입니다.

      일치시킬 열 쌍을 여러 개 추가할 수 있습니다.

      조회 조건

      매핑된 데이터와 일치하는 항목이 있을 때 조회 테이블에서 추출할 값입니다.

      그런 다음 다음 열에서 값을 출력합니다. 값을 추출할 조회 테이블 열은 조회 테이블과 매핑된 데이터의 값이 조회 조건을 충족하는 경우입니다.

      값을 추출할 조회 테이블 열을 여러 개 지정할 수 있습니다. 지정하는 모든 열에 대해 해당 출력 열 이름 필드가 자동으로 나타납니다. 추출한 값과 함께 추가할 열의 레이블을 지정합니다.

      출력 열 이름

      매핑된 데이터에 추가될 열의 레이블로, 조회 테이블에서 추출된 값입니다.

      출력 열 이름 필드는 다음 열에서 지정한 모든 열에 대해 자동으로 추가됩니다.

    11. 데이터를 검토하고 통합할 데이터 세트가 변환되고, 형식이 올바르게 지정되고, 임포트할 준비가 되었는지 확인합니다.
    12. 완료로 표시를 클릭합니다.

    결과

    통합하려는 소스 데이터 열 및 변환된 열 집합이 대상 CMDB 클래스 및 속성의 형식 지정 및 기타 값 요구 사항을 충족하면 데이터가 준비됩니다. 그러면 이러한 열을 CMDB 클래스 및 속성에 매핑하고 통합할 준비가 됩니다.

    CMDB 클래스 및 속성에 데이터 열 매핑 정보

    소스 데이터를 대상 CMDB 클래스 및 속성에 매핑하기 위한 몇 가지 요구 사항과 지침이 있습니다. 또한 쉽게 다시 활성화할 수 있도록 설정을 유지하면서 클래스 매핑을 비활성화하는 옵션도 있습니다. 이러한 개념을 검토하여 IRE(식별 및 조정 엔진)에서 적절히 처리되도록 합니다.

    필수 매핑

    필요에 따라 구성되지 않은 속성에 매핑하는 것 외에도 대상 클래스의 모든 필수 속성에 데이터를 매핑해야 합니다. 또한 기본적으로 다음 두 필드가 표시되며 삭제할 수 없습니다.
    소스 네이티브 키
    IRE는 기록을 고유하게 식별하고 관계 및 참조를 구축하는 데 사용합니다. 또한 삽입 및 업데이트 작업의 성능을 향상시킵니다. 페이로드를 처리할 때 이 필드가 비어 있으면 IRE에서 오류를 생성합니다.
    소스 최근 타임스탬프

    IRE는 현재 기록보다 오래되어 무시할 수 있는 기록을 식별하여 상충하는 속성 값을 해결하는 데 사용합니다. 제공된 값은 현재 CMDB에 저장된 값보다 이후일 때만 사용됩니다. 값이 제공되지 않은 경우 IRE는 현재 타임스탬프로 속성을 업데이트합니다.

    다음 시스템 속성을 사용하면 IRE가 source_recency_timestamp 페이로드의 값을 사용하여 소스 [sys_object_source] 테이블의 속성을 업데이트하는 last_scan 방법을 수정할 수 있습니다.
    IRE의 사용 source_native_key 방법 및 source_recency_timestamp CI 식별에 대한 자세한 내용은 IRE(식별 및 조정 엔진) 단원을 참조하십시오.

    조건부 클래스

    조건부 클래스를 사용하면 특정 열 값 또는 특정 플러그인의 상태에 따라 서로 다른 데이터 기록 세트를 다른 대상 클래스에 매핑할 수 있습니다.

    예를 들어 표시 이름에 'Windows'가 포함되어 있으면 'Windows Server'가 대상 클래스로 선택됩니다. 그러나 표시 이름에 'Linux'가 포함되어 있으면 'Linux Server'가 대상 클래스로 선택됩니다. 이러한 조건을 충족하지 않는 기록(표시 이름에 'Windows' 또는 'Linux'가 포함되지 않음)의 경우 '서버'가 대상 클래스로 선택됩니다.

    연결된 클래스

    연결된 클래스를 사용하면 대상 비 CMDB 테이블과 연결할 CMDB 클래스를 선택할 수 있습니다. 비-CMDB 테이블이 IRE 처리하도록 구성되지 않은 경우 IRE 처리에 연관된 클래스를 설정해야 합니다. IRE 처리를 위해 지원되고 구성된 비-CMDB 테이블의 경우, 연관된 클래스 설정은 선택 사항입니다. 자세한 내용은 을 참조하십시오 비 CMDB 테이블에 대한 IRE 지원 .

    소프트웨어 인스턴스가 비-CMDB 클래스이지만 연결된 IRE 규칙이 없습니다. 따라서 유타 이전에 우리가 그것에 대해 말한 것은 여전히 유효합니다. 그러나 IRE 규칙이 있는 비 CMDB 클래스의 경우 연결이 필수는 아닙니다. 예를 들어, "매핑할 대상 클래스가 CMDB 클래스에 대한 참조가 있는 비 CMDB 클래스인 경우 비 CMDB 대상 클래스와 연결할 CMDB 클래스를 선택해야 합니다." 비 CMDB 클래스와 IRE 규칙 "반드시" 대신 그래야 합니다. "넌 할 수 있어". 예와 동일하며 IRE 규칙이 있는 비 CMDB에는 유효하지 않습니다.

    매핑할 대상 클래스가 CMDB 클래스에 대한 참조가 있는 비-CMDB 클래스인 경우, 비-CMDB 대상 클래스를 연결할 CMDB 클래스를 선택해야 합니다. 비 CMDB 클래스는 구성 항목 [cmdb_ci] 클래스를 확장하지 않는 일련 번호[cmdb_serial_number]와 같은 클래스를 나타냅니다. 관련 항목 [cmdb_related_entry] 클래스에는 동일한 비-CMDB 클래스에 대한 여러 CMDB 클래스 연결이 포함될 수 있습니다. 따라서 IRE 프로세스가 대상 비 CMDB 클래스를 업데이트할 수 있도록 적절한 연결을 선택하십시오.

    예를 들어, 관련 항목 [cmdb_related_entry] 클래스에는 비 CMDB 소프트웨어 인스턴스[cmdb_software_instance] 클래스를 CMDB 소프트웨어 패키지[cmdb_ci_spkg] 클래스와 연결하는 기록이 있습니다. 소프트웨어 인스턴스를 대상 클래스로 선택하는 경우 소프트웨어 인스턴스 클래스를 소프트웨어 패키지 [cmdb_ci_spkg] 클래스와 연결해야 합니다.

    클래스 매핑 비활성화

    예를 들어 서비스 그래프 커넥터에서 제공하는 ETL 변환 맵을 편집할 때 클래스 매핑을 삭제하여 통합이 실행될 때 클래스가 채워지지 않도록 할 수 있습니다. 그러나 나중에 해당 클래스를 채우려면 해당 클래스를 다시 추가하고 모든 클래스 매핑을 다시 구성해야 합니다. 대신 클래스 매핑을 비활성화하여 모든 매핑 구성을 유지하면서 통합 실행 중에 클래스를 일시적으로 무시할 수 있습니다. 비활성화하도록 선택한 클래스는 사용자 인터페이스에서 회색으로 표시되지만 클래스 매핑을 계속하고 편집할 수 있습니다. 나중에 클래스 매핑을 다시 활성화하여 클래스 매핑을 다시 구성할 필요 없이 클래스를 채울 수 있습니다.

    비활성화하도록 선택한 일부 클래스는 직접 비활성화하도록 선택하지 않은 추가 클래스의 자동 비활성화를 트리거합니다. 자동으로 비활성화되는 클래스는 비활성화하도록 선택한 클래스에 따라 다릅니다. 예를 들어, 클래스에 종속 관계가 있거나 연결된 클래스가 있는지 여부입니다. 자동으로 비활성화된 클래스:
    • 사용자 인터페이스에 연한 회색으로 표시되며 다시 활성화할 수 없습니다.
    • 다시 활성화하면 자동으로 다시 활성화됩니다.
      • 처음에 비활성화하여 자동 비활성화를 트리거한 클래스
      • 비활성화된 클래스가 종속된 모든 클래스

    매핑을 직접 비활성화하는 모든 클래스와 자동으로 비활성화되는 결과 클래스 매핑은 통합이 실행될 때 채워지지 않습니다. 또한 이러한 클래스와 연결된 관계 및 조회 테이블은 통합이 실행될 때 채워지지 않습니다.

    클래스 매핑 및 기타 비활성화 시나리오:
    • 종속된 클래스와 연결된 클래스가 없는 클래스를 비활성화합니다.

      비활성화된 클래스와 연결된 조회 규칙 및 관계의 자동 비활성화를 트리거합니다.

    • 클래스 매핑 내에서 일련 번호와 같은 조회 규칙을 비활성화합니다.

      자동 비활성화를 트리거하지 않습니다.

    • 비 CMDB 클래스와 연결된 CMDB 클래스를 비활성화합니다.
      • 연결된 비 CMDB 클래스의 자동 비활성화를 트리거합니다.
      • 비 CMDB 클래스를 비활성화해도 연결된 CMDB 클래스에는 영향을 주지 않습니다.
    • 종속 관계가 있는 클래스를 비활성화합니다(통합 허브 ETL에 종속 관계가 있는 경우에만 적용됨):
      • 비활성화된 클래스와 단일 종속 관계가 있는 모든 클래스의 자동 비활성화를 트리거합니다.
      • 클래스에 여러 종속 관계가 있는 경우에는 종속 클래스를 모두 비활성화하는 경우에만 자동으로 비활성화됩니다.

        예를 들어 파일 시스템 클래스가 컴퓨터 및 서버 클래스와 종속 관계를 갖는 시나리오입니다. Computer 클래스를 비활성화하면 File System 클래스가 자동으로 비활성화되지 않습니다. Server 클래스도 비활성화하는 경우에만 File System 클래스가 자동으로 비활성화됩니다.

    • 조건부 클래스 또는 조건부 클래스 내의 클래스 매핑을 비활성화합니다.
      • 조건부 클래스를 비활성화하거나 활성화하면 조건부 클래스 내의 모든 조건부 클래스 매핑이 자동으로 비활성화되거나 활성화됩니다.
      • 조건부 클래스 내에서 클래스 매핑 비활성화: 통합 실행 중에 비활성화된 클래스가 채워지지 않도록 합니다. 그러나 연결된 'If', 'Else if' 또는 'Else' 조건 자체는 조건부 클래스의 조건 내에서 계속 적용됩니다. 예를 들어, 다음 클래스 매핑을 비활성화하는 경우:

        [만약에] [operating_system] [포함] [리눅스] 그렇다면 [Class] [is] [Linux Server]입니다.

        그러면 Linux Server 클래스는 채워지지 않지만 [If] [operating_system] [contains] [Linux] 조건이 적용됩니다.

    데이터 열을 CMDB 클래스 및 속성에 매핑

    CMDB에서 소스 데이터 열을 매핑할 대상 클래스와 속성을 선택합니다. 데이터 열을 특정 대상 클래스에 매핑하거나 대상 클래스의 선택이 특정 데이터 값에 따라 달라지도록 조건을 추가할 수 있습니다.

    시작하기 전에

    필요한 역할: cmdb_inst_admin

    이 태스크 정보

    매핑하는 데이터 열은 변환되지 않은 원본 데이터 열 또는 변환된 데이터 열일 수 있습니다. 예를 들어 데이터 열을 컴퓨터 및 소프트웨어 패키지 클래스에 통합하려면 해당 클래스를 대상 클래스로 선택한 다음 데이터 열을 해당 클래스의 특정 특성에 매핑합니다.

    클래스, 관계 또는 조회 규칙에 대한 매핑을 구성할 때 이러한 항목은 항상 처음에 활성화됨으로 설정됩니다. 매핑 비활성화의 결과에 대한 자세한 내용은 클래스 매핑 비활성화의 내용을 참조하십시오.

    주:
    클래스를 변경하면 클래스에 대해 이미 구성된 매핑에 영향을 주며 경우에 따라 이러한 매핑이 삭제됩니다. 영향을 받는 매핑 및 영향에 대한 상세 정보는 클래스 변경을 진행하기 전에 영향을 받는 매핑 대화 상자에 표시됩니다. 그러나 이러한 상세 정보는 CMDB 클래스에서 다른 CMDB 클래스로 또는 비 CMDB 클래스에서 다른 비 CMDB 클래스로 변경하는 경우에만 나타납니다.

    프로시저

    1. 다음으로 이동 모두 > 구성 > 통합 허브 ETL을 클릭하고 통합 이름을 클릭합니다.
      통합 허브 ETL의 방문 페이지에는 에서 ServiceNow Store다운로드한 통합을 포함하여 시스템에 존재하는 모든 통합이 나열됩니다.
    2. ETL 변환 맵 도우미 페이지의 안내 설정의 CMDB에 데이터 매핑 및 관계 추가 섹션에서 CMDB 클래스를 선택하여 소스 데이터 매핑을 선택합니다.
      플랫폼에서 필요에 따라 구성된 속성은 기록되며, 이러한 속성 각각에 데이터 열을 매핑해야 합니다.
    3. Add Class(클래스 추가)를 클릭하여 매핑할 대상 클래스를 추가하거나, Edit Class(클래스 편집)를 클릭하여 클래스를 편집합니다.
      1. 클래스 추가 대화 상자에서 CMDB 클래스를 선택합니다.
      2. 저장을 클릭합니다.
      3. 옵션: 클래스의 매핑 활성화/비활성화 토글 스위치를 켜짐 또는 꺼짐으로 설정합니다. 영향을 받는 클래스 매핑 대화 상자가 나타나면 영향을 받는 클래스 목록을 검토한 다음 계속을 클릭합니다.
        CMDB가 아닌 클래스를 추가하면 연결된 활성 클래스를 추가할 때까지 처음에 비활성화되고 매핑 활성화/비활성화 토글 스위치가 비활성화됩니다.
    4. 조건부 클래스 추가를 클릭한 다음 조건부 클래스 추가 대화 상자에서 데이터를 다른 대상 클래스에 매핑하기 위해 충족해야 하는 조건을 지정합니다.
      1. 컬렉션 은 최하위 수준 속성과 연결된 계층 구조의 데이터 분기로 자동 설정됩니다. 데이터를 매핑할 데이터 분기에 대한 값을 수정할 수 있으며, 데이터 분기는 계층 구조의 동일한 데이터 분기에서 더 높은 수준에 있어야 합니다.
      2. If 드롭다운 목록에서 데이터 값이 충족해야 하는 속성 조건을 선택하거나, 검색 상자에 plugins를 입력하고 플러그인 조건을 지정합니다. 그런 다음 조건과 일치하지 않는 나머지 기록이 다른 대상 클래스에 매핑되도록 지정할 수 있습니다. 데이터 기록은 충족되는 조건에 따라 다른 대상 클래스에 매핑됩니다.

        중첩된 데이터를 처리할 때 접두사는 속성 항목에 대한 중첩된 계층 구조의 첫 번째 수준을 나타냅니다.

        주:
        CMDB가 아닌 클래스를 선택하면 연결된 활성 클래스를 추가할 때까지 처음에 비활성화되고 매핑 활성화/비활성화 토글 스위치가 비활성화됩니다.
      3. 저장을 클릭합니다.
      4. 옵션: 조건부 클래스의 매핑 활성화/비활성화 토글 스위치를 켜짐 또는 꺼짐으로 설정합니다. 영향을 받는 클래스 매핑 대화 상자가 나타나면 영향을 받는 클래스 목록을 검토한 다음 계속을 클릭합니다.
      5. 옵션: 클래스 편집을 클릭하여 조건부 클래스의 설정을 편집합니다. 조건부 클래스 편집 대화 상자에서 클래스 매핑의 매핑 활성화/비활성화 토글 스위치를 켜짐 또는 꺼짐으로 설정합니다. 저장을 클릭하고 영향을 받는 클래스 매핑 대화 상자가 나타나면 영향을 받는 클래스 목록을 검토한 다음 계속을 클릭합니다.
        • 비활성화된 클래스는 통합 실행 중에 채워지지 않지만 연결된 조건에는 영향을 주지 않습니다. 'If', 'Else if' 및 'Else' 조건 자체는 조건부 클래스의 조건 내에서 유효하며 일치하는 CI는 그에 따라 필터링됩니다.
        • 조건부 클래스의 토글 스위치는 조건부 클래스 내의 모든 조건부 클래스 매핑의 상태 요약을 반영합니다. 하나 이상의 조건부 클래스 매핑이 활성화되면 조건부 클래스의 토글 스위치가 활성화된 것으로 나타납니다. 그렇지 않으면 조건부 클래스의 토글 스위치가 비활성화된 것으로 나타납니다.
    5. 비-CMDB 클래스의 경우 연결된 클래스 추가를 클릭하여 비-CMDB 클래스를 CMDB 클래스와 연결하고매핑 활성화/비활성화 토글 스위치를 활성화합니다. 또는 연결된 클래스 편집을 클릭하여 이미 연결된 클래스를 편집합니다.
      1. 연결된 클래스 추가 대화 상자에서 CMDB 클래스를 선택합니다. 목록에는 지정된 비-CMDB 테이블에 대한 관련 항목 [cmdb_related_entry] 클래스의 모든 항목이 포함됩니다(비활성화된 클래스는 포함되지 않음).
      2. 추가를 클릭합니다.
      3. 옵션: 연결된 클래스의 매핑 활성화/비활성화 토글 스위치를 켜짐 또는 꺼짐으로 설정합니다.
        주:
        연결된 클래스가 추가되지 않았거나 비활성화된 경우 매핑 활성화/비활성화 토글 스위치가 비활성화됩니다.
    6. 매핑 설정을 클릭하여 새로 추가된 클래스에 대한 매핑을 구성하거나 매핑 편집을 클릭하여 매핑을 편집합니다.
      1. 매핑하려면 오른쪽에 있는 데이터 사이드바에서 매핑 페이지 왼쪽에 있는 CMDB 대상 속성으로 데이터 열을 끕니다. 또는 통합 허브 ETL에서 열 선택 아이콘을 클릭하여 매핑에 대한 데이터 열을 검색하고 선택합니다.
        중첩된 데이터를 매핑하는 경우:
        • 데이터 사이드바의 데이터 열은 중첩된 데이터의 구조를 나타내는 트리 형식으로 표시됩니다. 각 속성은 속성에 대한 샘플 데이터와 연결됩니다.
        • 변환된 열은 청록색으로 음영 처리된 점으로 표시됩니다.
        • 특정 CMDB 클래스에 대한 모든 매핑은 중첩된 데이터의 동일한 소스 분기에서 가져와야 합니다. 매핑할 첫 번째 열을 선택한 분기만 후속 매핑에서 열을 선택하는 데 유효합니다.

          이 제한은 조회 테이블의 속성에 매핑할 때 다르게 적용됩니다. 조회 테이블의 속성에 대한 모든 매핑도 동일한 소스 분기에서 가져와야 합니다. 그러나 해당 소스 분기는 조회하지 않는 테이블에 사용한 소스 분기와 다를 수 있습니다.

          주:
          데이터 준비 단계에서 복사 변환을 사용하여 상위 수준에서 하위 수준으로 속성을 복사하면 이 제한을 해결할 수 있습니다. 매핑하려는 모든 속성이 동일한 수준에 있도록 데이터를 준비합니다.
        • 데이터 사이드바에서 매핑할 열을 끌면 매핑에 유효한 CMDB 대상 속성의 필드가 녹색 프레임으로 강조 표시됩니다. 잘못된 대상 속성에 열을 놓으려고 하면 해당 필드가 빨간색 프레임으로 강조 표시되고 오류가 나타납니다.
      2. 속성 추가를 클릭합니다. 그런 다음 특성 추가 대화 상자의 특성 목록에서 데이터를 매핑할 대상 특성으로 하나 이상의 항목을 선택합니다. 목록의 IRE 설정 섹션까지 아래로 스크롤하여 강력한 임포트 세트 변환기 속성 중 하나를 선택할 수도 있습니다 . 저장을 클릭합니다.
        개별 항목 수준과 IRE 페이로드 수준에서 정의된 강력한 임포트 세트 변환기 속성 간의 우선 순위에 대한 자세한 내용은 강력한 임포트 세트 변환기 속성을 참조하십시오 .
      3. "일련 번호 조회 1" 규칙과 같은 조회 규칙을 매핑합니다.

        조회 규칙은 매핑할 때까지 비활성화된 상태입니다. 조회 규칙을 편집하거나 추가하려면 조회 규칙의 필터 아이콘을 클릭합니다. 조회 필터 대화 상자에서 데이터를 다양한 대상 클래스에 매핑하기 위해 충족해야 하는 속성 또는 플러그인 조건을 지정합니다. 그런 다음 저장을 클릭합니다.

        조회 규칙의 필드를 매핑한 후 규칙의 활성화/비활성화 조회 규칙 토글 스위치를 켜짐 또는 꺼짐으로 설정할 수 있습니다.

      4. 옵션: 클래스 세부 정보 보기를 클릭하여 의 CI 클래스 관리자현재 클래스를 봅니다.
      5. 옵션: 데이터 변환 탭을 클릭하여 매핑하려는 데이터를 검토하고 추가로 변환할 수 있는 데이터 준비 페이지로 이동합니다.
      6. CMDB 클래스를 맵 소스 데이터 선택 페이지로 돌아갑니다.
    7. 완료로 표시를 클릭합니다.

    관계 추가

    통합을 위해 대상 CMDB 클래스 사이에 존재하는 관계를 추가합니다.

    시작하기 전에

    • 관계에 추가하려는 클래스는 활성화된 상태여야 합니다.
    • 편집하려는 기본 관계 또는 조건부 관계 내의 관계는 활성화된 상태여야 합니다.
    • 편집하려는 조건부 관계에서는 하나 이상의 관계 조건이 활성화됨 상태여야 합니다. 그렇지 않으면 관계 편집 단추가 회색으로 표시됩니다.

    필요한 역할: cmdb_inst_admin

    이 태스크 정보

    중첩된 데이터와의 관계를 만들 때 중첩된 데이터의 형제 개체 간에 관계를 만들 수 없습니다. 중첩된 데이터에 대한 샘플 페이로드 를 예로 사용하면 인터페이스와 소프트웨어 간에 관계를 만들 수 없습니다.

    ITOM 가시성은 사용 가능한 경우 향상된 검색 패턴을 사용하여 CI 관계를 식별하고 기본 시스템의 제안된 관계 테이블에 추가합니다. 해당하는 경우 제안된 관계 테이블을 사용하여 ()CSDM 표준을 준수하는 일반 서비스 데이터 모델 관계를 선택합니다.

    프로시저

    1. 다음으로 이동 모두 > 구성 > 통합 허브 ETL을 클릭하고 통합 이름을 클릭합니다.
      통합 허브 ETL의 방문 페이지에는 에서 ServiceNow Store다운로드한 통합을 포함하여 시스템에 존재하는 모든 통합이 나열됩니다.
    2. ETL 변환 맵 도우미 페이지의 안내 설정의 CMDB에 데이터 매핑 및 관계 추가 섹션에서 관계 추가를 선택합니다.
    3. 관계를 추가하려면 관계를 추가하기 전에 충족해야 하는 속성 조건을 지정하려면 관계 추가 또는 조건부 관계 추가를 선택합니다. 그런 다음 필요에 따라 다음 작업을 완료합니다.
      옵션설명
      관계 추가
      1. 상위, 하위관계 유형 값을 선택합니다.
      2. 추가를 클릭합니다.
      조건부 관계 추가
      1. 필드 선택 목록에서 데이터 값이 충족해야 하는 속성 조건을 선택합니다.
      2. 상위, 하위관계 유형 값을 선택합니다.
      3. 저장을 클릭합니다.

      중첩된 데이터를 처리할 때 접두사는 속성 항목에 대한 중첩된 계층 구조의 첫 번째 수준을 나타냅니다.

      관계 유형 목록 메뉴는 선택한 상위 및 하위 클래스에 따라 변경됩니다.
      • 종속 관계가 있는 경우 목록을 사용할 수 없으며 관계 유형이 자동으로 채워집니다.
      • 둘 이상의 종속 관계가 있는 경우, 목록에 포함 및 호스팅 관계 옵션이 모두 표시되고 포함 관계 유형이 자동으로 채워집니다.
      • 종속 관계가 없는 경우 목록에 제안된 관계가 표시되고 첫 번째로 제안된 관계가 자동으로 선택된 후 기본 시스템 관계 유형이 표시됩니다.
      • 제안된 관계가 없으면 목록에 제안된 관계 없음 과 기본 시스템 관계 유형이 표시됩니다.
    4. 저장을 클릭하여 현재 변경 내용을 저장하거나 완료로 표시를 클릭합니다.

      저장을 클릭하면 헤더에 타임 스탬프가 나타나며, 이는 ETL 변환 맵에 대한 통합 허브 ETL 세션 기간 동안 유지됩니다. 세션에 다시 들어가거나 ETL 맵 간에 전환하면 타임스탬프가 사라집니다.

    매핑 결과 미리 보기

    샘플 데이터 통합의 결과를 미리 봅니다.

    시작하기 전에

    필요한 역할: cmdb_inst_admin

    이 태스크 정보

    통합 테스트를 실행하고 샘플 데이터에 대한 결과 요약을 봅니다(기본적으로 최대 100개 기록). 요약에는 생성된 관계의 총 수, 매핑된 클래스, IRE에서 처리할 수 없는 부분 페이로드 및 미완료 페이로드가 포함됩니다. RTE(강력한 변환 엔진) 및 IRE(식별 조정 엔진)에서 자세한 메시지를 볼 수도 있습니다.
    주:
    RTE 및 IRE의 대부분의 통합 허브 ETL 로그 메시지는 정보 제공용입니다. 그러나 및 glide.importlog.log_to_table 시스템 속성이 INFO 로그 메시지를 추가하지 않도록 설정된 경우에도 com.glide.import_set.importlog_level 통합 허브 ETL은 INFO 로그 메시지를 렌더링합니다. 이러한 속성에 대한 자세한 내용은 임포트 세트 속성을 참조하십시오.

    요약 페이지에서 상세 정보를 본 후에는 어느 단계로든 돌아가서 조정한 다음 통합을 다시 실행할 수 있습니다.

    프로시저

    1. 다음으로 이동 모두 > 구성 > 통합 허브 ETL을 클릭하고 통합 이름을 클릭합니다.
      통합 허브 ETL의 방문 페이지에는 에서 ServiceNow Store다운로드한 통합을 포함하여 시스템에 존재하는 모든 통합이 나열됩니다.
    2. ETL 변환 맵 도우미 페이지의 안내 설정의 샘플 통합 결과 미리 보기 및 임포트 예약 섹션에서 테스트 및 통합 결과 롤백을 선택합니다.
    3. 통합 테스트 및 롤백 결과 페이지에서 통합 실행을 클릭합니다.
    4. 요약 페이지를 보고 다양한 탭을 클릭하여 영향을 받는 CMDB 클래스에 대한 통합 실행 결과를 봅니다. 미리 보기 아이콘을 클릭하여 CI 양식을 열고 정보를 볼 수 있습니다.
      주:
      속성 열의 순서는 플랫폼의 클래스에 대한 기본 열 목록을 따릅니다. 먼저 클래스의 기본 열이 왼쪽에서 오른쪽으로 표시되고 나머지 속성 열이 알파벳 순서로 정렬됩니다. 예를 들어 Computers 클래스의 기본 열 목록을 보려면 모두 > 구성 > 컴퓨터.
    5. 옵션: 클래스 탭을 선택하고 매핑 편집을 클릭하여 매핑 설정을 검토하고 변경할 수 있는 맵 소스 데이터에 CMDB 클래스 선택 페이지로 돌아갑니다.
      주:
      매핑 편집을 클릭하면 이 통합 실행의 결과로 CMDB에 적용된 모든 변경 사항이 롤백됩니다.
    6. 옵션: 관계 탭을 클릭하고 생성된 관계를 검토합니다.
    7. 옵션: 관계 편집을 클릭하여 관계 구성을 검토하고 변경할 수 있는 관계 추가 페이지로 돌아갑니다.
      주:
      관계 편집을 클릭하면 이 통합 실행의 결과로 CMDB에 적용된 모든 변경 내용이 롤백됩니다.
    8. 오류 로그, 활동 로그 또는 경고 로그 탭을 클릭하여 통합 중에 IRE 및 RTE에서 로깅한 각각의 세부 정보를 확인합니다.

      IRE 로그 기록은 범주별로 그룹화되고 각 클래스별로 추가로 구성됩니다. IRE 로그 메시지의 경우 메시지 열에는 원시 로그 메시지에서 추출된 메시지 자체만 포함됩니다. 로그 메시지 열에는 메시지 자체 외에도 클래스 및 범주를 포함하는 전체 로그 메시지가 포함됩니다. RTE 로그는 기타 범주 아래에 표시됩니다.

      자세한 정보 표시 토글 스위치를 사용하여 메시지 및 로그 메시지 열의 보기 모드를 변경합니다.
      • 자세한 정보 표시 켜기: 로그 메시지의 완전히 확장된 텍스트를 표시합니다.
      • 자세한 정보 표시 끄기: 로그 메시지의 요약 버전을 표시합니다. 메시지를 가리키면 로그 메시지의 완전히 확장된 텍스트가 나타납니다.
    9. 통합 실행을 위한 IRE 페이로드에 대한 자세한 내용을 보려면 미완료 페이로드부분 페이로드 탭을 클릭하십시오.
    10. 완료로 표시를 선택합니다.
      롤백 옵션 대화 상자가 나타나고 다음 옵션 중 하나를 선택할 수 있습니다.
      • 데이터 보존: 이 통합으로 인해 CMDB에 대한 모든 변경 내용이 유지됩니다.
      • 롤백 수행: 통합을 실행하기 전에 이 통합으로 인해 CMDB에 대한 모든 변경 내용이 롤백되고 CMDB가 해당 상태로 복원됩니다.

    통합 일정 제공

    이 ETL 변환 맵을 사용하여 CMDB에 데이터를 임포트하기 위한 일정을 구성합니다.

    시작하기 전에

    필요한 역할: cmdb_inst_admin

    프로시저

    1. 다음으로 이동 모두 > 구성 > 통합 허브 ETL을 클릭하고 통합 이름을 클릭합니다.
      통합 허브 ETL의 방문 페이지에는 에서 ServiceNow Store다운로드한 통합을 포함하여 시스템에 존재하는 모든 통합이 나열됩니다.
    2. ETL 변환 맵 도우미 페이지의 안내 설정의 샘플 통합 결과 미리보기 및 임포트 예약 섹션에서 임포트 일정 설정을 선택합니다.
    3. 일정 제공 페이지에서 일정 설정을 클릭합니다.
    4. 새 탭에서 열리는 예약된 데이터 임포트 목록 뷰에서 새로 만들기를 클릭합니다.
    5. 예약된 데이터 임포트 양식을 작성한 다음 제출을 클릭합니다.
      양식 필드에 대한 자세한 내용은 데이터 임포트 예약을 참조하십시오.
    6. 완료로 표시를 클릭합니다.

    통합 허브 ETL의 변환 유형

    통합 허브 ETL에서 다양한 변환을 사용하여 CMDB에 매핑할 소스 데이터를 변환하고 준비합니다.

    CMDB용 통합 커먼즈 스토어 앱의 변환은 통합 허브 ETL에서도 사용할 수 있습니다.

    연결

    입력 필드의 값을 단일 문자열로 결합하여 선택적 joining_string 필드에 조인합니다.

    세부사항
    테이블 sys_rte_eb_concat_operation
    입력 필드 source_sys_rte_eb_fields
    출력 필드 target_sys_rte_eb_field
    추가 필드 joining_string (선택 사항)
    예제
    입력 "input_1", "input_2", "input_3"
    추가 필드 joining_string = ”, ”
    결과 "input_1, input_2, input_3"

    부울로 변환

    수신 값을 부울로 변환합니다. 'true' 및 '1' 값은 'true'(대/소문자 구분 안 함)로 변환되고 다른 값은 'false'로 변환됩니다.

    세부사항
    테이블 sys_rte_eb_to_boolean_operation
    입력 필드 source_sys_rte_eb_field
    출력 필드 target_sys_rte_eb_field
    예제:
    • 다음 입력은 모두 'true'를 반환합니다.
      • 1
    • 다음 입력은 모두 'false'를 반환합니다.
      • "input_1"
      • “”
      • 0
      • 11

    날짜로 변환

    date_format 수신 값에 적용하여 수신 값을 GlideDateTime 값으로 변환하려고 시도합니다. 가 date_format 잘못된 경우 using GlideDateTime 을 직접 변환하려고 시도합니다.

    세부사항
    테이블 sys_rte_eb_to_date_operation
    입력 필드 source_sys_rte_eb_field
    출력 필드 target_sys_rte_eb_field

    구문 분석할 수 없는 경우 빈 값을 반환합니다.

    추가 필드 date_format (Java 단순 날짜 형식)
    예제
    입력 "2018/09/20 오전 11:21:00 EST"
    추가 필드 date_format = "yyyy/MM/dd hh:mm:ss a z"
    결과 “2018-09-20 16:21:00”
    예제
    입력 "2018/09/20 01:21:00 PM EST"
    추가 필드 date_format = "yyyy/MM/dd hh:mm:ss a z"
    결과 “2018-09-20 18:21:00”
    예제
    입력 "09/20/18”
    추가 필드 date_format = "yyyy/MM/dd hh:mm:ss a z"
    결과 “0018-09-20 00:00:00”

    숫자로 변환

    수신 값을 숫자로 변환합니다.

    세부사항
    테이블 sys_rte_eb_to_numeric_operation
    입력 필드 source_sys_rte_eb_field
    출력 필드 target_sys_rte_eb_field

    수신 값이 숫자가 아닌 경우 출력이 비어 있습니다.

    예제
    입력 1.23
    결과 1.23
    예제
    입력 1.00
    결과 1
    예제
    입력 input_1
    결과 null
    예제
    입력 2
    결과 null

    복사

    소스 필드의 값을 모든 대상 필드에 복사합니다.

    세부사항
    테이블 sys_rte_eb_copy_operation
    입력 필드 source_sys_rte_eb_field
    출력 필드 target_sys_rte_eb_fields
    추가 필드 overwrite_existing_value (선택 사항, 부울): true이면 대상 필드의 값이 바뀝니다. 그렇지 않으면 비어 있지 않은 값을 덮어쓰지 않습니다.

    선행 숫자 추출

    대상 필드를 소스 필드에 있는 첫 번째 숫자 값으로 설정합니다.

    세부사항
    테이블 sys_rte_eb_extract_numeric_operation
    입력 필드 source_sys_rte_eb_field
    출력 필드 target_sys_rte_eb_field
    추가 필드
    • decimal_places (선택 사항, number): 출력이 지정된 소수 자릿수를 갖도록 합니다.
    • remainder_target_field (선택 사항, 필드 참조): 첫 번째 숫자 값을 제거한 후 소스 필드의 잘린 나머지 부분으로 설정합니다.
    예제
    입력 '100메가바이트'
    결과 "100"
    예제
    입력 "100.123메가바이트"
    결과 “100.123"
    예제
    입력 "100.123메가바이트"
    추가 필드 decimal_places = 2
    결과 “100.12”
    예제
    입력 '100메가바이트'
    추가 필드 decimal_places = 2
    결과 “100.00”
    예제
    입력 '100메가바이트'
    추가 필드 remainder_target_field = <필드>
    결과 "100" 및 <field> = "mb"

    Glide 조회

    의 데이터베이스에서 target_table조회를 수행합니다.

    세부사항
    테이블 sys_rte_eb_glide_lookup_operation
    입력 필드 source_sys_rte_eb_fields
    출력 필드 target_sys_rte_eb_fields
    추가 필드
    • target_table
    • glide_matching_fields (문자열): 대상 테이블에 있는 열 이름의 쉼표로 구분된 목록입니다. 의 source_sys_rte_eb_fields각 입력 필드에 대해 의 값 수가 같아야 합니다. glide_matching_fields
    • glide_target_fields (문자열): 대상 테이블에 있는 열 이름의 쉼표로 구분된 목록입니다. 의 target_sys_rte_eb_fields각 대상 필드에 대해 에 동일한 수의 값이 glide_target_fields있어야 합니다.
    예제
    입력
    • 입력 필드 1: 100 South Charles Street, Baltimore
    • 입력 필드 2: MD
    추가 필드
    • 대상 테이블: 위치(cmn_location)
    • Glide 일치 필드: 거리, 주
    • Glide 대상 필드: sys_id
    결과 출력 필드 1: 25ab9c4d0a0a0bb300f7dabdc0ca7c1c

    최소/최대

    대상 필드를 모든 입력 필드 값의 최대값 또는 최소값으로 설정합니다.

    세부사항
    테이블 sys_rte_eb_min_max_operation
    입력 필드 source_sys_rte_eb_fields
    출력 필드 target_sys_rte_eb_field
    추가 필드
    • data_type (선택 목록 <STRING,NUMERIC,DATE>)
    • min_max (선택 목록 <MIN,MAX>)
    예제
    입력 “2”, “-1”, “0”
    추가 필드
    • data_type = 숫자
    • min_max = 최대
    결과 “2”
    예제
    입력 "a", "b"
    추가 필드
    • data_type = 문자열
    • min_max = 최대
    결과 "비"
    예제
    입력 “2”, “-1”, “0”
    추가 필드
    • data_type = 숫자
    • min_max = 최소값
    결과 “-1”
    예제
    입력 "a", "b"
    추가 필드
    • data_type = 문자열
    • min_max = 최소값
    결과 "ᅡ"

    다중 입력 스크립트

    여러 입력이 있는 스크립트를 실행하여 해당 스크립트의 == 출력을 설정합니다 target_field .

    각 소스 필드는 'batch' 변수 내에서 JavScript 필드로 사용할 수 있습니다. JavaScript 필드의 이름은 엔터티 필드의 필드 속성입니다( sys_rte_eb_field.field, not sys_rte_eb_field.name).

    세부사항
    테이블 sys_rte_eb_multi_in_script_operation
    입력 필드 source_sys_rte_eb_fields
    출력 필드 target_sys_rte_eb_field
    추가 필드
    • script (스크립트)
    • use_unique_input_sets (부울): true인 경우 IRE 처리를 위해 고유한 입력 값만 데이터 배치에 포함됩니다. 그렇지 않으면 모든 입력 객체의 필드 값이 포함됩니다.
    를 입력으로 사용하고 record_typeoperating_system 반환하는 record_with_os스크립트 함수와 함께 를 사용하는 use_unique_input_sets예 :
    표 2. 입력 데이터
    기록 record_type operating_system record_with_os
    1 컴퓨터 Windows XP
    2 컴퓨터 Linux
    3 컴퓨터 Windows XP
    use_unique_inputs_setstrue로 설정되면 스크립트는 두 개의 값(컴퓨터 + Windows XP 및 컴퓨터 + Linux)만 처리합니다. use_unique_inputs_setsfalse로 설정하면 세 가지 값이 각각 개별적으로 처리됩니다(컴퓨터 + Windows XP, 컴퓨터 + Linux 및 컴퓨터 + Windows XP).
    샘플 스크립트:
                (function(batch, output) { 
                    for (var i = 0; i < batch.length; i++) { 
                            // batch[i] is the unique set of inputs/individual record 
                            // batch[i].<field> gives access to the field value 
                            var in0 = gs.nil(batch[i].record_type) ? '' : batch[i].record_type;
                            var in1 = gs.nil(batch[i].operating_system) ? '' : batch[i].operating_system;
                            // output[i] is the output for the specific combination of inputs/individual record 
                            output[i] = in0 + "_" + in1; 
                        } 
                    } 
                })(batch, output);
    샘플 스크립트:
                /* Example Script
                 // In this example the script input fields are 'input_field_1', 'input_field_2' - replace these with the fields used as script inputs // There is a static field 'input' that has all the input field values concatenated with a '|' (function(batch, output) {
                     for (var i = 0; i < batch.length; i++) {
               
                         //step1: access the input variables
                         var a = batch[i].input_field_1; //Value of the first source field.
                         var b = batch[i].input_field_2; //Value of the second source field.
                 
                         //step2: Your script/code goes here.
                         var c = a + b;
               
                         //step3: set the output for each elements
                         output[i] = b;
                     }
               
                 })(batch, output);
                */

    Rexeg 바꾸기

    지정된 match_regex과 일치하는 수신 문자열의 각 하위 문자열을 지정된 replacement_regex 문자열 값으로 바꿉니다.

    세부사항
    테이블 sys_rte_eb_regex_replace_operation
    입력 필드 source_sys_rte_eb_field
    출력 필드 target_sys_rte_eb_field
    추가 필드
    • match_regex (문자열, 정규 표현식)
    • replacement_regex (문자열)
    예제
    입력 "String&With(특수)$Characters"
    추가 필드
    • match_regex = "[^0-9a-zA-Z]+"
    • replacement_regex = “ ”
    결과 "특수 문자가 있는 문자열"

    교체

    지정된 match_string날짜 replacement_string 와 일치하는 수신 문자열의 각 하위 문자열을 문자열 값으로 바꿉니다.

    세부사항
    테이블 sys_rte_eb_replace_operation
    입력 필드 source_sys_rte_eb_field
    출력 필드 target_sys_rte_eb_field
    추가 필드
    • match_string (문자열)
    • replacement_string (문자열)
    예제
    입력 "원래 문자열"
    추가 필드
    • match_string = "원본"
    • replacement_string = "교체"
    결과 "교체 문자열"

    반올림 숫자

    숫자 값을 가장 가까운 정수로 반올림합니다. 숫자가 아닌 숫자는 잘립니다.

    세부사항
    테이블 sys_rte_eb_round_numeric_operation
    입력 필드 source_sys_rte_eb_field
    출력 필드 target_sys_rte_eb_field
    예제
    입력 “1.5”
    결과 "2"
    예제
    입력 “1.4”
    결과 "1"
    예제
    입력 "나는 끈이다"
    결과 ""

    스크립트

    입력으로 스크립트를 실행하고 해당 스크립트의 target_field == 출력을 설정합니다.

    이 변환은 다중 입력 스크립트 변환으로 대체되었으며 기존 구성과의 이전 버전 호환성을 위해 포함되었습니다.

    세부사항
    테이블 sys_rte_eb_script_operation
    입력 필드 source_sys_rte_eb_field
    출력 필드 target_sys_rte_eb_field
    추가 필드
    • script (스크립트)
    • use_unique_input_sets (부울): true인 경우 IRE 처리를 위해 고유한 입력 값만 데이터 배치에 포함됩니다. 그렇지 않으면 모든 입력 객체의 필드 값이 포함됩니다. 예시 및 자세한 내용은 다중 입력 스크립트 변환을 참조하십시오.
    소스 필드는 "배치" 변수에 JavaScript 필드 "입력"으로 포함됩니다.
              (function(batch, output) { 
                    for (var i = 0; i < batch.length; i++) { 
                            // batch[i] is the unique set of inputs/individual record 
                            // batch[i].input gives access to the field value 
                            var in0 = gs.nil(batch[i].input) ? '' : batch[i].input; 
                            // output[i] is the output for the specific combination of inputs/individual record 
                            output[i] = in0 + " modified by script”; 
                        } 
                    } 
                })(batch, output); 
    예제:
    /* Example Script
     (function(batch, output) {
         for (var i = 0; i < batch.length; i++) {
             //step1: access the input variables
             var a = batch[i].input; //Value of the source field.
     
             //step2: Your script/code goes here.
             var b = a + 1;
             //step3: set the output for each elements
             output[i] = b;
         }
     })(batch, output);
    */ 

    설정

    대상 필드의 값을 에 지정된 set_value문자열로 설정합니다.

    세부사항
    테이블 sys_rte_eb_set_operation
    입력 필드 source_sys_rte_eb_field
    출력 필드 target_sys_rte_eb_field
    추가 필드
    • set_value (문자열)
    • overwrite_existing_value (선택 사항, 부울): true이면 대상 필드의 현재 값을 덮어씁니다. 그렇지 않으면 비어 있지 않은 값이 대체되지 않습니다.

    분할

    에서 splitting_string 소스 필드의 값을 분할하고 분할 target_sys_rte_eb_fields의 각 결과 항목을 에 순서대로 할당합니다.

    세부사항
    테이블 sys_rte_eb_split_operation
    입력 필드 source_sys_rte_eb_field
    출력 필드 target_sys_rte_eb_fields
    추가 필드 splitting_string (문자열)
    예제
    입력 "value1||값2||value3", target_sys_rte_eb_fields {target1,target2,target3}
    추가 필드 splitting_string = ”||”
    결과 대상1 : 값1, 대상2 : 값2, 대상3 : 값3
    예제
    입력 "value1||값2||value3", {target1} 포함 target_sys_rte_eb_fields
    추가 필드 splitting_string = ”||”
    결과 대상1 : 값1
    예제
    입력 {target1,target2,target3}이 있는 target_sys_rte_eb_fields "value1"
    추가 필드 splitting_string = ”||”
    결과 target1 : value1, target2 : <null>, target3 : <null>

    트리밍

    값에서 선행 및 후행 공백을 source_sys_rte_eb_field 제거하고 결과를 에 target_sys_rte_eb_field 할당합니다. 이 변환은 Java String.trim()과 동일합니다.

    세부사항
    테이블 sys_rte_eb_trim_operation
    입력 필드 source_sys_rte_eb_field
    출력 필드 target_sys_rte_eb_field
    예제
    입력 " 값 1 "
    결과 " 값 1 "

    대문자

    값을 대문자로 source_sys_rte_eb_field 표시하고 결과를 에 할당합니다.target_sys_rte_eb_field

    세부사항
    테이블 sys_rte_eb_upper_case_operation
    입력 필드 source_sys_rte_eb_field
    출력 필드 target_sys_rte_eb_field
    예제
    입력 " 값 1 "
    결과 "값1"

    대문자 트리밍

    대문자 및 트리밍 변환을 모두 결합합니다.

    세부사항
    테이블 sys_rte_eb_upper_case_trim_operation
    입력 필드 source_sys_rte_eb_field
    출력 필드 target_sys_rte_eb_field
    예제
    입력 " 값 1 "
    결과 "값1"