---
sourceDocument: Xanadu 빌드 워크플로우
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/xanadu/build-workflows

 Release :

    - xanadu

ft:locale :

    - ko-KR

ft:publication_title :

    - Xanadu 빌드 워크플로우

ft:clusterId :

    - crworkflow

bundleId :

    - crworkflow

workflow :

    - Creator


---

# 유틸리티 변환 기능

# 유틸리티 변환 기능 {#ariaid-title1}

* 릴리스 버전: Xanadu
* 
* 업데이트 날짜 2024년 08월 01일
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 4분

유틸리티 변환 함수를 사용하여 배열에서 복합 객체를 반환하거나 특정 키와 연결된 값을 반환합니다.
유틸리티 변환 함수에는 배열, 이름-값 쌍, 문자열, 정수 또는 선택 입력 데이터 알약이 필요합니다. 유틸리티 변환 함수를 적용할 때 올바른 입력 [데이터 알약 유형을](https://servicenow-prod.fluidtopics.net/iZzeOQfZQXdEMCfIFQImBQ "작업과 하위 플로우는 변수를 사용하여 입력 및 출력 데이터를 저장합니다. 변수 데이터 유형에 따라 저장하는 데이터의 종류와 고급 구성 옵션이 결정됩니다.") 사용해야 합니다. 유틸리티 변환 함수가 부적절한 데이터 유형에 적용되면 런타임에 데이터가 변환되지 않고 대신 입력 값이 반환됩니다. 플로우 런타임 값 확인에 대한 자세한 내용은 [플로우 테스트 단원을](https://servicenow-prod.fluidtopics.net/kFVIqIUbOAqHJ~azc0wl1Q "다른 사용자가 액세스할 수 있도록 플로우를 활성화하기 전에 테스트하여 예상대로 작동하는지 확인합니다.") 참조하십시오.

## 배열에서 첫 항목 얻기 {#utilities-transform-functions__section_o45_hr4_mpb}

입력 배열에서 첫 번째 항목을 복합 객체로 반환합니다.  
{#utilities-transform-functions__table_ldp_nr4_mpb__entry__2}

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

{#utilities-transform-functions__table_ldp_nr4_mpb}

## 배열에서 항목 얻기 {#utilities-transform-functions__section_gzk_jvz_jjb}

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

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

{#utilities-transform-functions__table_psj_ddn_mkb}

## 이름/값에서 항목 가져오기 {#utilities-transform-functions__section_ljc_xdn_mkb}

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

| 입력 데이터 정제 | 매개변수 | 출력 데이터 정제 |
|-|-|-|
| 이름-값 쌍 | * Key - 해당 값을 조회하는 데 사용되는 키의 이름 * Default - 일치하는 키가 없을 때 반환되는 값 {#utilities-transform-functions__ul_njc_xdn_mkb} | 일치하는 키와 연결된 문자열 |
[ ]

{#utilities-transform-functions__table_mjc_xdn_mkb}  
주:  
이름/값에서 항목 가져오기 변환 함수를 적용할 때 런타임 값이 표시 값이 아니라 시스템 값일 수 있다는 점을 고려하십시오. 예를 들어 인시던트 테이블의 우선순위 필드를 원격 테이블의 유사한 필드에 매핑하는 경우 반환되는 런타임 값은 2 - High가 아니라 2일 수 있습니다.  
그림 1. 예제

* 입력: `"username":"abel.tuter"`
* 키: `username`
* 기본값: `example.username`
* 출력: `abel.tuter`

{#utilities-transform-functions__ul_ojc_xdn_mkb}

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

## 배열에서 마지막 항목 얻기 {#utilities-transform-functions__section_gjx_3r4_mpb}

입력 배열의 마지막 항목을 복합 객체로 반환합니다.  
{#utilities-transform-functions__table_ln2_xr4_mpb__entry__2}

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

{#utilities-transform-functions__table_ln2_xr4_mpb}

## 공백 여부 {#utilities-transform-functions__section_ttk_fqd_qnb}

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

| 입력 데이터 정제 | 출력 |
|-|-|
| 모든 | 예 또는 아니오를 반환합니다. |
[ ]

{#utilities-transform-functions__table_zg3_lqd_qnb}  
그림 2. 예제

* 입력: `0`이 있는 정수 데이터 알약
* 출력: `true`
{#utilities-transform-functions__ul_rp1_4qd_qnb}

## 아니오 여부 {#utilities-transform-functions__section_gx5_jr4_mpb}

입력이 false이면 true 를 반환합니다. 문자열은 빈 문자열일 때 false입니다. 정수는 0일 때 false입니다. 부울 입력은 false일 때 false입니다.  
{#utilities-transform-functions__table_qjg_c54_mpb__entry__2}

| 입력 데이터 정제 | 출력 데이터 정제 |
|-|-|
| 모든 | 예 또는 아니오를 반환합니다. |
[ ]

{#utilities-transform-functions__table_qjg_c54_mpb}  
그림 3. 예제

* 입력: `13`이 있는 정수 데이터 알약
* 출력: `false `
{#utilities-transform-functions__ul_sjg_c54_mpb}

## 공백이 아님 {#utilities-transform-functions__section_kxk_kr4_mpb}

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

| 입력 데이터 정제 | 출력 데이터 정제 |
|-|-|
| 모든 | 예 또는 아니오를 반환합니다. |
[ ]

{#utilities-transform-functions__table_n4k_js4_mpb}  
그림 4. 예제

* 입력: `13`이 있는 정수 데이터 알약
* 출력: `true`
{#utilities-transform-functions__ul_u35_ms4_mpb}

## Null임 {#utilities-transform-functions__section_k3b_gqd_qnb}

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

| 입력 데이터 정제 | 출력 |
|-|-|
| 모든 | 예 또는 아니오를 반환합니다. |
[ ]

{#utilities-transform-functions__table_wrn_rqd_qnb}  
그림 5. 예제

* 입력: `725`의 정수 데이터 알약
* 출력: `false`
{#utilities-transform-functions__ul_t1k_tqd_qnb}

## 예임 {#utilities-transform-functions__section_krb_lr4_mpb}

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

| 입력 데이터 정제 | 출력 데이터 정제 |
|-|-|
| 모든 | 예 또는 아니오를 반환합니다. |
[ ]

{#utilities-transform-functions__table_amb_wt4_mpb}  
그림 6. 예제

* 입력: `13`이 있는 정수 데이터 알약
* 출력: `true`
{#utilities-transform-functions__ul_m55_yt4_mpb}

## 키 값 맵 {#utilities-transform-functions__section_irr_r4g_ykb}

일치하는 키와 연결된 값을 반환하거나 일치하는 키가 없는 경우 기본값을 반환합니다.  
{#utilities-transform-functions__table_qqy_yqg_ykb__entry__3}

| 입력 데이터 정제 | 매개변수 | 출력 데이터 정제 |
|-|-|-|
| 문자열 또는 정수 | * Name - 해당 값을 찾는 데 사용되는 키 * Value - 특정 키와 일치하는 값 * Default - 일치하는 이름이 없을 때 반환되는 값 {#utilities-transform-functions__ul_pw3_psg_ykb} | 일치하는 키와 연결된 문자열 |
[ ]

{#utilities-transform-functions__table_qqy_yqg_ykb}  
그림 7. 예제

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

## 정렬 {#utilities-transform-functions__section_sgj_wvj_hrb}

지정된 배열을 오름차순 또는 내림차순으로 정렬합니다.
{#utilities-transform-functions__table_y4r_fwj_hrb__entry__3}

| 입력 데이터 정제 | 매개변수 | 출력 데이터 정제 |
|-|-|-|
| Array.String, Array.Integer, Array.Boolean 또는 Array.Datetime. - 정렬되지 않은 배열 | Sort Order - 오름차순 또는 내림차순 | 배열 - 정렬된 배열 |
[ ]

{#utilities-transform-functions__table_y4r_fwj_hrb}  
주:  
정렬 함수는 array.strings의 경우 대소문자를 구분합니다.
그림 8. 예제

* 입력: `[7, 2, 3, 1, 7, 9]`
* 매개변수: 오름차순
* 출력: `[1, 2, 3, 7, 7, 9]`
{#utilities-transform-functions__ul_rx1_xwj_hrb}

## 고유 {#utilities-transform-functions__section_wkn_f1k_hrb}

지정된 배열에서 중복 요소를 제거합니다.{#utilities-transform-functions__table_lww_m1k_hrb__entry__2}

| 입력 데이터 정제 | 출력 데이터 정제 |
|-|-|
| Array.String, Array.Integer, Array.Boolean 또는 Array.Datetime. | 배열 - 중복된 요소가 제거된 후 |
[ ]

{#utilities-transform-functions__table_lww_m1k_hrb}
그림 9. 예제

* 입력: `[7, 2, 3, 2, 7, 9]`
* 출력: `[7, 2, 3, 9]`
{#utilities-transform-functions__ul_uhx_w1k_hrb}

## 입장 {#utilities-transform-functions__section_ns2_4bk_hrb}

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

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

{#utilities-transform-functions__table_zyq_rbk_hrb} 그림 10. 예제

* 입력: `[1, 2, 3]`
* 매개변수: `<`
* 출력: `1<2<3`
{#utilities-transform-functions__ul_hqh_3ck_hrb}