ETL 변환 맵 생성

  • 릴리스 버전: Xanadu
  • 업데이트 날짜 2024년 08월 01일
  • 소요 시간: 42분
  • 통합 허브 ETL은 특정 통합에 대한 ETL 변환 맵을 만드는 데 필요한 모든 작업을 완료하도록 안내하는 안내 설정을 제공합니다.

    안내 설정

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

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

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

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

    시작하기 전에

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

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

    필요한 역할: cmdb_inst_admin

    프로시저

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

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

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

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

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

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

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

      임포트 세트를 선택하지 않거나 지정된 데이터 소스 가 임포트 세트와 연결되어 있지 않은 경우 최대 100개 기록으로 구성된 임포트 세트가 자동으로 생성되고 선택됩니다.

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

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

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

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

    데이터 미리 보기 및 준비

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

    시작하기 전에

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

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

    필요한 역할: cmdb_inst_admin

    이 태스크 정보

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

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

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

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

    중첩 페이로드 데이터 작업에 대한 데모는 ServiceNow YouTube 채널에서 Integration Hub - ETL 중첩 페이로드 기능 데모 비디오를 시청하십시오.

    프로시저

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

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

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

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

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

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

    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 클래스를 선택해야 합니다." IRE 규칙이 있는 비 CMDB 클래스는 "반드시" 대신 선택해야 합니다. "넌 할 수 있어". 예제와 동일하며 IRE 규칙이 있는 비 CMDB에는 유효하지 않습니다.

    매핑의 대상 클래스가 CMDB 클래스에 대한 참조가 있는 비 CMDB 클래스인 경우 비 CMDB 대상 클래스와 연결할 CMDB 클래스를 선택해야 합니다. CMDB가 아닌 클래스는 일련 번호 [cmdb_serial_number]과 같이 구성 항목 [cmdb_ci] 클래스를 확장하지 않는 클래스를 참조합니다. 관련 항목 [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 클래스를 비활성화하면 파일 시스템 클래스가 자동으로 비활성화되지 않습니다. Server 클래스도 비활성화하는 경우에만 파일 시스템 클래스가 자동으로 비활성화됩니다.

    • 조건부 클래스 또는 조건부 클래스 내의 클래스 매핑을 비활성화합니다.
      • 조건부 클래스를 비활성화하거나 활성화하면 조건부 클래스 내에서 모든 조건부 클래스 매핑의 자동 비활성화 또는 활성화가 트리거됩니다.
      • 조건부 클래스 내에서 클래스 매핑 비활성화: 통합 실행 중에 비활성화된 클래스가 채워지지 않도록 합니다. 그러나 연결된 '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 드롭다운 목록에서 데이터 값이 충족해야 하는 속성 조건을 선택하거나 검색 상자에 플러그인을 입력하고 플러그인 조건을 지정합니다. 그런 다음 조건과 일치하지 않는 나머지 기록이 다른 대상 클래스에 매핑되도록 지정할 수 있습니다. 데이터 기록은 충족되는 조건에 따라 다른 대상 클래스에 매핑됩니다.

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

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

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

          주:
          데이터 준비 단계에서 복사 변환을 사용하여 상위 수준에서 하위 수준으로 속성을 복사하면 이 제한을 해결할 수 있습니다. 매핑하려는 모든 속성이 동일한 수준에 있도록 데이터를 준비합니다.
        • 데이터 사이드바에서 매핑할 열을 드래그하면 매핑에 유효한 CMDB 대상 속성의 필드가 녹색 프레임으로 강조 표시됩니다. 잘못된 대상 속성에서 열을 놓으려고 하면 해당 필드가 빨간색 프레임으로 강조 표시되고 오류가 나타납니다.
      2. Add Attribute(속성 추가)를 클릭합니다. 그런 다음 특성 추가 대화 상자의 특성 목록에서 데이터를 매핑할 대상 특성으로 하나 이상의 항목을 선택합니다. 목록의 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(식별 조정 엔진)에서 자세한 메시지를 볼 수도 있습니다.
    주:
    대부분의 통합 허브 ETL 로그 메시지(RTE 및 IRE에서)는 정보 제공용입니다. 그러나 및 glide.importlog.log_to_table 시스템 속성이 INFO 로그 메시지를 추가하지 않도록 설정되어 있 com.glide.import_set.importlog_level 더라도 통합 허브 ETL은 INFO 로그 메시지를 렌더링합니다. 이러한 속성에 대한 자세한 내용은 임포트 세트 속성을 참조하십시오.

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

    프로시저

    1. 다음으로 이동 모두 > 구성 > 통합 허브 ETL을 클릭하고 통합 이름을 클릭합니다.
      통합 허브 ETL의 방문 페이지에는 에서 다운로드한 통합을 포함하여 시스템에 존재하는 모든 통합이 나열됩니다 ServiceNow Store.
    2. ETL 변환 맵 도우미 페이지에 있는 안내 설정의 샘플 통합 결과 미리보기 및 일정 임포트 섹션에서 통합 결과 테스트 및 롤백을 선택합니다.
    3. Test and Rollback Integration Results(테스트 및 롤백 통합 결과) 페이지에서 Run Integration(통합 실행)을 클릭합니다.
    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. Provide Schedule(일정 제공) 페이지에서 Set Schedules(일정 설정)를 클릭합니다.
    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

    날짜로 변환

    를 수신 값에 GlideDateTime 적용 date_format 하여 수신 값을 값으로 변환하려고 시도합니다. 가 올바르지 않은 경우 사용하여 GlideDateTime 직접 변환을 시도합니다 date_format .

    세부사항
    테이블 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 (선택 사항, 필드에 대한 참조): 첫 번째 숫자 값을 제거한 후 소스 필드의 잘라낸 나머지로 설정합니다.
    예제
    입력 "100MB"
    결과 "100"
    예제
    입력 "100.123 메가바이트"
    결과 “100.123"
    예제
    입력 "100.123 메가바이트"
    추가 필드 decimal_places = 2
    결과 “100.12”
    예제
    입력 "100MB"
    추가 필드 decimal_places = 2
    결과 “100.00”
    예제
    입력 "100MB"
    추가 필드 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 일치 필드: street,state
    • 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 (선택 목록 <최소, 최대>)
    예제
    입력 “2”, “-1”, “0”
    추가 필드
    • data_type = 숫자
    • min_max = 최대값
    결과 “2”
    예제
    입력 "ᅡ", "ᄂ"
    추가 필드
    • data_type = 문자열
    • min_max = 최대값
    결과 "ᄂ"
    예제
    입력 “2”, “-1”, “0”
    추가 필드
    • data_type = 숫자
    • min_max = 최소
    결과 “-1”
    예제
    입력 "ᅡ", "ᄂ"
    추가 필드
    • data_type = 문자열
    • min_max = 최소
    결과 "ᅡ"

    다중 입력 스크립트

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

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

    세부사항
    테이블 sys_rte_eb_multi_in_script_operation
    입력 필드 source_sys_rte_eb_fields
    출력 필드 target_sys_rte_eb_field
    추가 필드
    • script (스크립트)
    • use_unique_input_sets (부울): true인 경우 IRE 처리를 위해 데이터 배치에 고유한 입력 값만 포함됩니다. 그렇지 않으면 모든 입력 객체의 필드 값이 포함됩니다.
    use_unique_input_setsoperating_system 를 입력으로 사용하고 record_type 반환record_with_os하는 스크립트 함수와 함께 사용하는 예:
    표 2. 입력 데이터
    기록 record_type operating_system record_with_os
    1 computer Windows XP
    2 computer Linux
    3 computer 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 필드 'input'으로 'batch' 변수에 포함됩니다.
              (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 (문자열)
    예제
    입력 "값1||값2||value3", {target1,target2,target3} 포함 target_sys_rte_eb_fields
    추가 필드 splitting_string = ”||”
    결과 target1 : 값1, target2 : 값2, target3 : 값3
    예제
    입력 "값1||값2||value3", target_sys_rte_eb_fields {target1}
    추가 필드 splitting_string = ”||”
    결과 대상1 : 값1
    예제
    입력 "value1", {target1,target2,target3}과 함께 target_sys_rte_eb_fields
    추가 필드 splitting_string = ”||”
    결과 target1 : 값1, 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"