유틸리티 변환 함수

  • 릴리스 버전: Zurich
  • 업데이트 날짜 2025년 07월 31일
  • 소요 시간: 4분
  • 유틸리티 변환 함수를 사용하여 배열에서 복합 객체 또는 특정 키와 관련된 값을 반환합니다.

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

    배열에서 첫 항목 얻기

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

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

    배열에서 항목 얻기

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

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

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

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

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

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

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

    배열에서 마지막 항목 얻기

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

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

    비어 있음

    입력이 비어 있으면 true 를 반환합니다. 문자열 입력이 빈 문자열이면 비어 있습니다. 정수 입력값은 0이면 비어 있습니다. 부울 입력이 false이면 비어 있습니다.
    주:
    이 변환 함수는 참조 입력을 지원하지 않습니다.
    입력 데이터 정제 출력
    모두 True 또는 False를 반환합니다.
    사용 예:
    • 입력: 0이 있는 정수 데이터 정제
    • 출력: true

    아니오 여부

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

    입력 데이터 정제 출력 데이터 정제
    모두 True 또는 False를 반환합니다.
    사용 예:
    • 입력: 13이 있는 정수 데이터 정제
    • 출력: false

    비어 있지 않음

    입력이 비어 있지 않으면 예를 반환합니다. 빈 문자열이 아니면 문자열이 비어 있지 않습니다. 정수는 0이 아닌 경우 공백이 아닙니다. 부울 입력이 일 경우 비어 있지 않습니다.
    주:
    이 변환 함수는 참조 입력을 지원하지 않습니다.
    입력 데이터 정제 출력 데이터 정제
    모두 True 또는 False를 반환합니다.
    사용 예:
    • 입력: 13이 있는 정수 데이터 정제
    • 출력: true

    Null입니까

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

    입력 데이터 정제 출력
    모두 True 또는 False를 반환합니다.
    사용 예:
    • 입력: 725의 정수 데이터 정제
    • 출력: false

    참 여부

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

    입력 데이터 정제 출력 데이터 정제
    모두 True 또는 False를 반환합니다.
    사용 예:
    • 입력: 13이 있는 정수 데이터 정제
    • 출력: true

    키 값 맵

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

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

    사용 예:

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

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

    정렬

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

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

    고유

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

    입장

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

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