유틸리티 변환 함수

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

    • 유틸리티 변환 함수를 사용하여 배열에서 복합 객체 또는 특정 키와 관련된 값을 반환합니다.

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

    배열에서 첫 항목 얻기

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

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

    배열에서 항목 가져오기

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

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

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

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

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

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

    ticket_id 키 또는 "티켓 ID를 찾을 수 없음"에 대한 연결된 값이 작업 출력으로 반환되었습니다.

    배열에서 마지막 항목 얻기

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

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

    비어 있음

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

    아니오임

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

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

    비어 있지 않음

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

    Null 여부

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

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

    예 여부

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

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

    키 값 맵

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

    입력 데이터 정제 매개변수 출력 데이터 정제
    문자열 또는 정수
    • 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