유틸리티 변환 기능

  • 릴리스 버전: Xanadu
  • 업데이트 날짜 2024년 08월 01일
  • 읽기4분
  • 유틸리티 변환 함수를 사용하여 배열에서 복합 객체를 반환하거나 특정 키와 연결된 값을 반환합니다.

    유틸리티 변환 함수에는 배열, 이름-값 쌍, 문자열, 정수 또는 선택 입력 데이터 알약이 필요합니다. 유틸리티 변환 함수를 적용할 때 올바른 입력 데이터 알약 유형을 사용해야 합니다. 유틸리티 변환 함수가 부적절한 데이터 유형에 적용되면 런타임에 데이터가 변환되지 않고 대신 입력 값이 반환됩니다. 플로우 런타임 값 확인에 대한 자세한 내용은 플로우 테스트 단원을 참조하십시오.

    배열에서 첫 항목 얻기

    입력 배열에서 첫 번째 항목을 복합 객체로 반환합니다.

    입력 데이터 정제 출력 데이터 정제
    배열 Complex Object - 입력 배열에서 찾은 첫 번째 항목

    배열에서 항목 얻기

    입력 배열에서 복합 객체를 반환합니다. 반환하려는 Nth Item 입력 배열에 값을 입력합니다. Nth Item 0부터 시작하는 배열 인덱스를 나타냅니다.

    입력 데이터 정제 매개변수 출력 데이터 정제
    배열 Nth Item - 입력 배열에 대상 객체의 인덱스를 입력합니다. 배열 인덱스는 0에서 시작합니다. 복합 객체

    이름/값에서 항목 가져오기

    이름-값 쌍의 맵에서 일치하는 키와 연결된 값을 반환합니다.

    입력 데이터 정제 매개변수 출력 데이터 정제
    이름-값 쌍
    • Key - 해당 값을 조회하는 데 사용되는 키의 이름
    • Default - 일치하는 키가 없을 때 반환되는 값
    일치하는 키와 연결된 문자열
    주:
    이름/값에서 항목 가져오기 변환 함수를 적용할 때 런타임 값이 표시 값이 아니라 시스템 값일 수 있다는 점을 고려하십시오. 예를 들어 인시던트 테이블의 우선순위 필드를 원격 테이블의 유사한 필드에 매핑하는 경우 반환되는 런타임 값은 2 - High가 아니라 2일 수 있습니다.
    그림 1. 예제
    • 입력: "username":"abel.tuter"
    • 키: username
    • 기본값: example.username
    • 출력: abel.tuter

    이 예에서 작업은 타사 시스템에 대한 REST 호출을 수행하고 티켓 데이터를 이름-값 쌍의 맵으로 만듭니다. 티켓 ID는 이 작업에 대한 출력으로 제공됩니다. 이름/값에서 항목 가져오기 변환 함수는 ticket_id 키와 연결된 값 또는 찾을 수 없는 티켓 ID를 반환합니다.

    ticket_id 키 또는 "티켓 ID를 찾을 수 없음"에 대한 관련 값이 작업 출력으로 반환됩니다.

    배열에서 마지막 항목 얻기

    입력 배열의 마지막 항목을 복합 객체로 반환합니다.

    입력 데이터 정제 출력 데이터 정제
    배열 Complex Object - 입력 배열에서 찾은 마지막 항목

    공백 여부

    입력이 비어 있으면 예를 반환합니다. 문자열 입력은 빈 문자열일 때 비어 있습니다. 정수 입력은 0일 때 비어 있습니다. 부울 입력은 false일 때 비어 있습니다.

    입력 데이터 정제 출력
    모든 또는 아니오를 반환합니다.
    그림 2. 예제
    • 입력: 0이 있는 정수 데이터 알약
    • 출력: true

    아니오 여부

    입력이 false이면 true 를 반환합니다. 문자열은 빈 문자열일 때 false입니다. 정수는 0일 때 false입니다. 부울 입력은 false일 때 false입니다.

    입력 데이터 정제 출력 데이터 정제
    모든 또는 아니오를 반환합니다.
    그림 3. 예제
    • 입력: 13이 있는 정수 데이터 알약
    • 출력: false

    공백이 아님

    입력이 비어 있지 않으면 예를 반환합니다. 문자열은 빈 문자열이 아닐 때 공백이 아닙니다. 정수는 0이 아닌 경우 비어 있지 않습니다. 부울 입력은 예일 때 비어 있지 않습니다.

    입력 데이터 정제 출력 데이터 정제
    모든 또는 아니오를 반환합니다.
    그림 4. 예제
    • 입력: 13이 있는 정수 데이터 알약
    • 출력: true

    Null임

    입력 값이 null이면 true 를 반환합니다. 입력은 초기화되지 않았거나 null 개체 또는 참조인 경우 null입니다.

    입력 데이터 정제 출력
    모든 또는 아니오를 반환합니다.
    그림 5. 예제
    • 입력: 725의 정수 데이터 알약
    • 출력: false

    예임

    입력이 true이면 true 를 반환합니다. 문자열은 빈 문자열이 아닌 경우 true입니다. 정수는 0이 아닌 경우 true입니다. 부울 입력은 true일 때 true입니다.

    입력 데이터 정제 출력 데이터 정제
    모든 또는 아니오를 반환합니다.
    그림 6. 예제
    • 입력: 13이 있는 정수 데이터 알약
    • 출력: true

    키 값 맵

    일치하는 키와 연결된 값을 반환하거나 일치하는 키가 없는 경우 기본값을 반환합니다.

    입력 데이터 정제 매개변수 출력 데이터 정제
    문자열 또는 정수
    • Name - 해당 값을 찾는 데 사용되는 키
    • Value - 특정 키와 일치하는 값
    • Default - 일치하는 이름이 없을 때 반환되는 값
    일치하는 키와 연결된 문자열
    그림 7. 예제

    이 예에서 로그 작업은 기록의 우선순위를 메시지로 저장합니다. 이름-값 섹션에서 각 우선 순위는 해당 문자열 값에 매핑됩니다. 플로우가 실행되면 기록의 우선순위 번호가 문자열로 변환되고 문자열이 메시지에 로깅됩니다.

    키-값 맵은 값을 숫자에서 문자열로 변환합니다.

    정렬

    지정된 배열을 오름차순 또는 내림차순으로 정렬합니다.

    입력 데이터 정제 매개변수 출력 데이터 정제
    Array.String, Array.Integer, Array.Boolean 또는 Array.Datetime. - 정렬되지 않은 배열 Sort Order - 오름차순 또는 내림차순 배열 - 정렬된 배열
    주:
    정렬 함수는 array.strings의 경우 대소문자를 구분합니다.
    그림 8. 예제
    • 입력: [7, 2, 3, 1, 7, 9]
    • 매개변수: 오름차순
    • 출력: [1, 2, 3, 7, 7, 9]

    고유

    지정된 배열에서 중복 요소를 제거합니다.
    입력 데이터 정제 출력 데이터 정제
    Array.String, Array.Integer, Array.Boolean 또는 Array.Datetime. 배열 - 중복된 요소가 제거된 후
    그림 9. 예제
    • 입력: [7, 2, 3, 2, 7, 9]
    • 출력: [7, 2, 3, 9]

    입장

    지정된 배열의 개별 요소를 지정된 구분 기호와 연결하고 연결된 문자열을 반환합니다.

    입력 데이터 정제 매개변수 출력 데이터 정제
    Array.String, Array.Integer, Array.Boolean 또는 Array.Datetime. 구분 기호 - 연결 후 개별 요소를 구분하는 문자입니다. 문자열 - 구분 기호를 추가한 후의 문자열입니다.
    그림 10. 예제
    • 입력: [1, 2, 3]
    • 매개변수: <
    • 출력: 1<2<3