---
sourceDocument: Xanadu 애플리케이션과의 통합 생성
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/xanadu/integrate-applications

 Release :

    - xanadu

ft:locale :

    - ko-KR

ft:publication_title :

    - Xanadu 애플리케이션과의 통합 생성

ft:clusterId :

    - crint

bundleId :

    - crint

workflow :

    - Creator


---

# 큐 커넥터 방법

# 큐 커넥터 방법 {#ariaid-title1}

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

Queue 커넥터 메서드를 사용하면 에서 큐에 대한 작업 항목을 만들고 관리할 수 있습니다 RPA 허브.

## 필수 구성요소 {#connectors-queues-methods__section_xtf_43m_psb}

1. 의 설계 탭에서 RPA 데스크톱 디자인 스튜디오봇 프로세스 할당 옵션을 사용하여 자동화 프로젝트에 봇 프로세스를 할당하고 작업 항목에 액세스합니다. 자세한 내용은 [자동화 프로젝트에 봇 프로세스 할당](https://servicenow-prod.fluidtopics.net/JFl_6Bjr8CWY4aKE3wOIEg "에서 자동화 프로젝트에 RPA 데스크톱 디자인 스튜디오 봇 프로세스를 할당하여 봇 프로세스 자원 사용을 시작합니다.") 문서를 참조하십시오.
2. 다음 단계를 수행하여 QueueName 속성을 설정합니다.
   1. 에서 RPA 데스크톱 디자인 스튜디오다음으로 이동합니다. 도구 상자RPA 허브큐.
   2. 큐 커넥터를 프로젝트 탐색기의 전역 개체 아래로 끌어옵니다.
   3. 큐 커넥터를 두 번 클릭합니다.
   4. 속성 창의 QueueName 속성에 큐의 이름을 입력합니다.  
      주:  
      큐의 이름은 에 RPA 허브정의된 이름과 같아야 합니다.
   {#connectors-queues-methods__ol_q2m_2sm_psb}
{#connectors-queues-methods__ol_srn_5rm_psb}

## CreateJSONWorkItem {#connectors-queues-methods__section_lg4_lzg_srb}

형식의 큐에 대한 작업 항목을 작성합니다 JSON .

입력
:   [이름](https://servicenow-prod.fluidtopics.net/GqXHcwMaSYyAbk2H4MvOdg#queue-connector-method-parameters__parameter-input-createjsonworkitem-name)
:   [우선순위](https://servicenow-prod.fluidtopics.net/GqXHcwMaSYyAbk2H4MvOdg#queue-connector-method-parameters__parameter-input-createjsonworkitem-priority)

출력
:   [작업 항목 ID](https://servicenow-prod.fluidtopics.net/GqXHcwMaSYyAbk2H4MvOdg#queue-connector-method-parameters__parameter-output-createjsonworkitem-workitemid)
: [IsNameExists](https://servicenow-prod.fluidtopics.net/GqXHcwMaSYyAbk2H4MvOdg#queue-connector-method-parameters__parameter-output-createjsonworkitem-isnameexists)  
JSON 객체에서 키-값 쌍을 생성하려면 다음 작업을 수행합니다.

1. CreateJSONWorkItem 메서드 표시줄에서 메서드 설정 아이콘( ![메서드 설정 아이콘]())을 클릭합니다.
2. 테이블에 제공된 기준을 입력합니다.{#connectors-queues-methods__table_lnf_rwb_wbc__entry__2}

   | 필드 | 설명 |
   |-|-|
   | 구성 ||
   | 입력 필드 ||
   | 유형 | 작업 항목의 형식입니다. 예를 들어, 회계 시스템 큐의 경우 저축 및 당좌는 계정 유형입니다. 입력 필드를 구성하려면 을 참조하십시오 [포트 속성 구성](https://servicenow-prod.fluidtopics.net/XyUWVVIZHNAOD1BSa3R53Q "에서 RPA 데스크톱 디자인 스튜디오구성 요소 또는 메서드의 입력 필드에 데이터를 전달하는 방법을 구성합니다."). |
   | 스테이지 | 작업 항목의 스테이지를 업데이트합니다. 트랜잭션의 여러 단계를 유지하기 위한 사용자 지정 필드입니다. |
   | SLA | 작업 항목 완료의 서비스 수준 계약(SLA)입니다. |
   | JSON 속성 ||
   | JSON 경로 표기법 ||
   | 이름 | 요청 콘텐츠에 대한 키-값 쌍(JSON 콘텐츠)입니다. 키를 추가하려면 다음을 수행합니다. 1. 키 추가 아이콘( ![Add key icon.]())을 클릭합니다. 2. 필드에 키 이름을 입력합니다. 3. 키를 더 추가하려면 이전 단계를 반복합니다. 4. 이러한 필드에 값을 전달하려면 을 참조하십시오 [포트 속성 구성](https://servicenow-prod.fluidtopics.net/XyUWVVIZHNAOD1BSa3R53Q "에서 RPA 데스크톱 디자인 스튜디오구성 요소 또는 메서드의 입력 필드에 데이터를 전달하는 방법을 구성합니다."). |
   | 대소문자 구분 | 작업 항목을 만들 때 전달되는 중요한 컨텐츠입니다. 이 옵션을 중요한 것으로 선택하면 데이터가 암호화되어 의 새 작업 항목에 RPA 허브있는 중요한 요청 컨텐츠 필드에 저장됩니다. 작업 항목 양식에 대한 자세한 내용은 을 참조하십시오 [작업 항목 양식](https://servicenow-prod.fluidtopics.net/vDWAyMSLbue2RWpabQLrlA "작업 항목 양식을 사용하여 실행된 작업 항목에 대한 자세한 내용을 봅니다."). 이 기능을 사용하면 큐를 통해 중요한 정보를 전달할 수 있습니다. 예를 들어 큐에서 고객 데이터를 암호화하려면 중요한 필드를 사용하여 신용 카드 번호, 주소 등과 같은 고객 세부 정보를 저장해야 합니다. |
   [표 1. 항목 구성 작성]

   {#connectors-queues-methods__table_lnf_rwb_wbc}
3. 확인을 클릭합니다.
{#connectors-queues-methods__ol_spx_tyh_srb}

## CreateStringWorkItem {#connectors-queues-methods__section_uyj_qg3_srb}

문자열을 수락하여 큐의 큐에 작업 항목을 작성합니다 RPA 허브 .

입력
:   [RequestContent 요청](https://servicenow-prod.fluidtopics.net/GqXHcwMaSYyAbk2H4MvOdg#queue-connector-method-parameters__paramater-input-CreateStringWorkItem-requestcontent)
:   [이름](https://servicenow-prod.fluidtopics.net/GqXHcwMaSYyAbk2H4MvOdg#queue-connector-method-parameters__parameter-input-createjsonworkitem-name)

출력
:   [작업 항목 ID](https://servicenow-prod.fluidtopics.net/GqXHcwMaSYyAbk2H4MvOdg#queue-connector-method-parameters__parameter-output-createjsonworkitem-workitemid)
:   [IsNameExists](https://servicenow-prod.fluidtopics.net/GqXHcwMaSYyAbk2H4MvOdg#queue-connector-method-parameters__parameter-output-createjsonworkitem-isnameexists)

문자열 작업 항목을 만들기 위한 추가 조건을 지정하려면 다음 단계를 수행합니다.

1. CreateStringWorkItem 메서드 모음에서 메서드 설정 아이콘( ![메서드 설정 아이콘]())을 클릭합니다.
2. 테이블에 제공된 기준을 입력합니다.{#connectors-queues-methods__table_ast_sdc_wbc__entry__2}

   | 필드 | 설명 |
   |-|-|
   | 입력 필드 ||
   | SensitiveRequestContent (민감 요청 콘텐츠) | 중요한 컨텐츠를 새 작업 항목에 암호화된 형식으로 저장합니다. 입력 필드를 구성하려면 을 참조하십시오 [포트 속성 구성](https://servicenow-prod.fluidtopics.net/XyUWVVIZHNAOD1BSa3R53Q "에서 RPA 데스크톱 디자인 스튜디오구성 요소 또는 메서드의 입력 필드에 데이터를 전달하는 방법을 구성합니다."). 이 기능을 사용하면 큐를 통해 중요한 정보를 전달할 수 있습니다. 예를 들어 큐에서 고객 데이터를 암호화하려면 SensitiveRequestContent 필드를 사용하여 신용 카드 번호, 주소 등과 같은 고객 세부 정보를 저장해야 합니다. |
   | 스테이지 | 작업 항목의 스테이지를 업데이트합니다. 트랜잭션의 여러 단계를 유지하기 위한 사용자 지정 필드입니다. |
   | 유형 | 작업 항목의 형식입니다. 예를 들어, 회계 시스템 큐의 경우 저축 및 당좌는 계정 유형입니다. 입력 필드를 구성하려면 을 참조하십시오 [포트 속성 구성](https://servicenow-prod.fluidtopics.net/XyUWVVIZHNAOD1BSa3R53Q "에서 RPA 데스크톱 디자인 스튜디오구성 요소 또는 메서드의 입력 필드에 데이터를 전달하는 방법을 구성합니다."). |
   | SLA | 작업 항목 완료의 서비스 수준 계약(SLA)입니다. |
   [표 2. 항목 구성 작성]

   {#connectors-queues-methods__table_ast_sdc_wbc}
3. 확인을 클릭합니다.
{#connectors-queues-methods__ol_yrt_sdc_wbc}

## GetWorkItems (영문) {#connectors-queues-methods__section_n31_rpn_srb}

지정한 기준에 따라 큐에서 작성된 작업 항목의 개수와 상세 정보를 반환합니다. 이 방법은 이미 기본 조건을 제공하지만 추가 조건을 지정할 수 있습니다.  

입력
:   [제한](https://servicenow-prod.fluidtopics.net/GqXHcwMaSYyAbk2H4MvOdg#queue-connector-method-parameters__parameter-input-getworkitem-limit)

출력
:   [총 개수](https://servicenow-prod.fluidtopics.net/GqXHcwMaSYyAbk2H4MvOdg#queue-connector-method-parameters__parameter-output-getworkitem-totalcount)

작업 항목을 식별하고 가져오기 위한 추가 기준을 지정하려면 다음 단계를 수행합니다.  
1. 방법 설정 아이콘( ![방법 설정 아이콘]())을 클릭합니다.
2. 필요에 따라 필터를 구성합니다. 필터는 필수가 아닙니다.{#connectors-queues-methods__table_pkh_1dn_psb__entry__2}

   | 필드 | 설명 |
   |-|-|
   | 입력 필터 ||
   | 이름 | 작업 항목의 이름입니다. 다음 필터 중 하나를 지정할 수 있습니다. * 같음: 작업 항목의 이름이 지정한 조건과 정확히 같습니다. * 포함: 지정한 문자가 포함된 작업 항목의 이름입니다. * StartsWith: 작업 항목의 이름은 지정한 문자로 시작합니다. * EndsWith: 작업 항목의 이름은 지정한 문자로 시작합니다. {#connectors-queues-methods__ul_sn5_sw4_psb} |
   | 유형 | 문자열 형식의 작업 항목 형식입니다. 다음 필터 중 하나를 지정할 수 있습니다. * 같음: 작업 항목의 형식이 지정한 조건과 정확히 같습니다. * 포함: 지정한 문자가 포함된 작업 항목의 형식입니다. * StartsWith: 작업 항목의 형식은 지정한 문자로 시작합니다. * EndsWith: 작업 항목의 형식은 지정한 문자로 시작합니다. {#connectors-queues-methods__ul_ukt_nbn_wsb} |
   | 상태 | 작업 항목의 상태입니다. |
   | 스테이지 | 작업 항목의 스테이지를 업데이트합니다. 트랜잭션의 여러 단계를 유지하기 위한 사용자 지정 필드입니다. |
   | 우선순위 | 실행 우선순위: * 중요 * 높음 * 보통 * 낮음 {#connectors-queues-methods__ul_b11_4yk_1rb}할당된 로봇은 작업 큐에 정의된 우선순위에 따라 봇 프로세스를 실행합니다. 기본 우선순위는 항상 높음입니다. |
   | 날짜 유형 | 작업 항목의 날짜 형식입니다. 이 필드에 입력을 제공하는 경우 FromData 및 ToDate 필드에도 입력을 제공해야 합니다. |
   | 시작일 | 메서드가 날짜 범위 내에서 작업 항목을 선택하는 경우 범위의 시작 날짜입니다. |
   | 종료일 | 메서드가 날짜 범위 내에서 작업 항목을 선택하는 경우 범위의 종료 날짜입니다. |
   | 오프셋 | 설정된 제한 후에 검색할 작업 항목 수입니다. 예를 들어 제한이 20인 경우 다음으로 선택한 작업 항목은 21부터 시작합니다. |
   | 아웃 필드 ||
   | 아웃 레코드 | 객체 양식에서 작업 항목의 상세 정보를 반환합니다. |
   [표 3. 작업 항목 구성]

   {#connectors-queues-methods__table_pkh_1dn_psb}
3. 확인을 클릭합니다.  
   주:  
   구성한 각 필드와 함께 Data In 포트가 생성됩니다.
{#connectors-queues-methods__ol_xjk_mcn_psb}

## PickWorkItem (작업 항목 선택) {#connectors-queues-methods__section_b5z_vsn_srb}

로봇이 지정된 기준에 따라 작업 항목을 선택할 수 있습니다. 선택할 작업 항목에 대한 추가 기준을 구성할 수도 있습니다.

PickWorkItem 구성요소에 포함된 queryConditions는 봇 프로세스가 로봇 풀로 활성화된 경우 무인 봇 프로세스 실행을 완료하는 데 필요한 로봇 수를 계산하는 데 고려됩니다. 로봇 수 계산에 대한 자세한 내용은 을 참조하십시오 . 로봇 풀 개념에 대한 자세한 내용은 을 참조하십시오 .  

입력
:   [우선순위](https://servicenow-prod.fluidtopics.net/GqXHcwMaSYyAbk2H4MvOdg#queue-connector-method-parameters__parameter-input-createjsonworkitem-priority)

출력
:   [작업 항목 ID](https://servicenow-prod.fluidtopics.net/GqXHcwMaSYyAbk2H4MvOdg#queue-connector-method-parameters__parameter-output-createjsonworkitem-workitemid)
:   [RequestContent 요청](https://servicenow-prod.fluidtopics.net/GqXHcwMaSYyAbk2H4MvOdg#queue-connector-method-parameters__paramater-input-CreateStringWorkItem-requestcontent)

작업 항목을 선택하기 위한 추가 조건을 지정하려면 다음 단계를 수행합니다.  
1. 방법 설정 아이콘( ![방법 설정 아이콘]())을 클릭합니다.
2. 테이블에 제공된 기준을 입력합니다.{#connectors-queues-methods__table_ewl_yqn_psb__entry__2}

   | 필드 | 설명 |
   |-|-|
   | 구성 ||
   | 입력 필터 ||
   | 이름 | 다음 필터를 기반으로 하는 작업 항목의 이름입니다. * 같음: 작업 항목의 이름이 지정한 조건과 정확히 같습니다. * 포함: 지정한 문자가 포함된 작업 항목의 이름입니다. * StartsWith: 작업 항목의 이름은 지정한 문자로 시작합니다. * EndsWith: 작업 항목의 이름은 지정한 문자로 시작합니다. {#connectors-queues-methods__ul_agg_ydn_wsb} 선택하면 Data In 포트가 노출됩니다. |
   | 유형 | 다음 필터를 기반으로 하는 작업 항목의 유형입니다. * 같음: 작업 항목의 형식이 지정한 조건과 정확히 같습니다. * 포함: 지정한 문자가 포함된 작업 항목의 형식입니다. * StartsWith: 작업 항목의 형식은 지정한 문자로 시작합니다. * EndsWith: 작업 항목의 형식은 지정한 문자로 시작합니다. {#connectors-queues-methods__ul_afg_zdn_wsb} 선택하면 Data In 포트가 노출됩니다. |
   | 스테이지 | 다음 필터를 기반으로 하는 작업 항목 작업 항목의 스테이지입니다. * 같음: 작업 항목의 스테이지가 지정한 조건과 정확히 같습니다. * 포함: 작업 항목의 스테이지에는 지정한 문자가 포함됩니다. * StartsWith: 작업 항목의 스테이지는 지정한 문자로 시작됩니다. * EndsWith: 작업 항목의 스테이지는 지정한 문자로 시작합니다. {#connectors-queues-methods__ul_efs_d2n_wsb} 선택하면 Data In 포트가 노출됩니다. |
   | 상태 | 로봇이 선택할 작업 항목의 상태입니다. |
   | 아웃 필드 ||
   | 이름 | 작업 항목의 이름을 반환하는 데이터 출력 포트입니다. |
   | 유형 | 작업 항목의 형식을 반환하는 데이터 출력 포트입니다. |
   | 발언 | 작업 항목에 대한 설명을 반환하는 데이터 출력 포트입니다. |
   | 스테이지 | 작업 항목의 스테이지를 반환하는 데이터 출력 포트입니다. |
   | RequestContent 요청 | 작업 항목에 대한 문자열 컨텐츠입니다. 작업 항목이 생성될 때 저장된 컨텐츠를 선택합니다. |
   | SensitiveRequestContent (민감 요청 콘텐츠) | 이 필드의 중요한 컨텐츠가 선택되고 해독되어 OR 로봇으로 RPA 데스크톱 디자인 스튜디오 전달됩니다. |
   | JSON 속성 ||
   | JSON 경로 표기법 | 작업 항목의 JSON 경로 표기법을 반환하는 데이터 출력 포트입니다. 키 추가 아이콘( ![Add key icon.]())을 클릭하여 키 이름을 추가합니다. JSON은 RequestContent 및 SensitiveRequestContent 필드 모두에 전달할 수 있습니다. 작업 항목을 선택하는 동안 작업 항목에서 JSON 데이터가 선택됩니다. 예를 들어 키-값 쌍 "City: Mumbai"(City는 키, Mumbai는 값)가 RequestContent 필드에 있고 "City: Delhi"(City는 키, Delhi는 값)가 SensitiveRequestContent 필드에 생성되는 경우입니다. 동일한 작업 항목을 선택하려고 하면 두 필드에 대해 키가 동일하므로 SensitiveRequestContent 필드에 우선 순위가 지정되고 해당 출력이 이 필드에서 검색됩니다. |
   [표 4. 수취 항목 구성]

   {#connectors-queues-methods__table_ewl_yqn_psb}
3. 확인을 클릭합니다.
{#connectors-queues-methods__ol_jyx_sqn_psb}

## 작업 항목 해제 {#connectors-queues-methods__section_fyw_f14_srb}

봇이 수락하고 실행한 작업 항목을 릴리스합니다. 이 메서드를 실행하기 전에 PickWorkItem 메서드를 실행해야 합니다.

입력
:   [작업 항목 ID](https://servicenow-prod.fluidtopics.net/GqXHcwMaSYyAbk2H4MvOdg#queue-connector-method-parameters__parameter-output-createjsonworkitem-workitemid)

출력
:   [결과(Return)](https://servicenow-prod.fluidtopics.net/GqXHcwMaSYyAbk2H4MvOdg#queue-connector-method-parameters__parameter-output-releaseworkitem-return)

## 작업 항목 업데이트(UpdateWorkItem) {#connectors-queues-methods__section_pyn_cxn_srb}

로봇이 지정된 조건에 따라 PickWorkItem 메서드로 작업 항목을 선택한 후 업데이트할 수 있도록 합니다. 업데이트할 작업 항목에 대한 추가 기준을 구성할 수 있습니다. 이 메서드를 실행하기 전에 PickWorkItem 메서드를 실행해야 합니다.

입력
:   [작업 항목 ID](https://servicenow-prod.fluidtopics.net/GqXHcwMaSYyAbk2H4MvOdg#queue-connector-method-parameters__parameter-output-createjsonworkitem-workitemid)
:   [RequestContent 요청](https://servicenow-prod.fluidtopics.net/GqXHcwMaSYyAbk2H4MvOdg#queue-connector-method-parameters__paramater-input-CreateStringWorkItem-requestcontent)
:   [릴리스 모드](https://servicenow-prod.fluidtopics.net/GqXHcwMaSYyAbk2H4MvOdg#queue-connector-method-parameters__parameter-input-updateworkitem-releasemode)
:   [우선순위](https://servicenow-prod.fluidtopics.net/GqXHcwMaSYyAbk2H4MvOdg#queue-connector-method-parameters__parameter-input-createjsonworkitem-priority)
:   [상태](https://servicenow-prod.fluidtopics.net/GqXHcwMaSYyAbk2H4MvOdg#queue-connector-method-parameters__parameter-input-pickworkitem-status)
:   [예외 유형](https://servicenow-prod.fluidtopics.net/GqXHcwMaSYyAbk2H4MvOdg#queue-connector-method-parameters__parameter-input-exception-type)

작업 항목을 업데이트하기 위한 추가 조건을 지정하려면 다음 단계를 수행합니다.  
1. 방법 설정 아이콘( ![방법 설정 아이콘]())을 클릭합니다.
2. 테이블에 제공된 기준을 입력합니다.{#connectors-queues-methods__table_kvt_vtn_psb__entry__2}

   | 필드 | 설명 |
   |-|-|
   | 구성 ||
   | 입력 필드 ||
   | 스테이지 | 작업 항목의 스테이지를 업데이트합니다. 트랜잭션의 여러 단계를 유지하기 위한 사용자 지정 필드입니다. |
   | 다음까지 연기됨 | 동일한 작업 항목이 선택되지 않는 기간을 지정하는 옵션입니다. 예를 들면 5분입니다. |
   | 이름 | 작업 항목의 이름입니다. |
   | 유형 | 작업 항목의 형식입니다. 예를 들어, 회계 시스템 큐의 경우 저축 및 당좌는 계정 유형입니다. 입력 필드를 구성하려면 을 참조하십시오 [포트 속성 구성](https://servicenow-prod.fluidtopics.net/XyUWVVIZHNAOD1BSa3R53Q "에서 RPA 데스크톱 디자인 스튜디오구성 요소 또는 메서드의 입력 필드에 데이터를 전달하는 방법을 구성합니다."). |
   | 발언 | 작업 항목에 대한 지원 비고입니다. |
   | SLA | 작업 항목 완료의 서비스 수준 계약(SLA)입니다. |
   | ResponseContent | 작업 항목에 대한 문자열 컨텐츠입니다. 작업 항목의 저장된 컨텐츠를 업데이트합니다. |
   | SensitiveRequestContent (민감 요청 콘텐츠) | 작업 항목의 중요한 컨텐츠를 업데이트합니다. |
   | JSON 속성 ||
   | JSON 경로 표기법 ||
   | 이름 | 요청 콘텐츠에 대한 키-값 쌍(JSON 콘텐츠)입니다. 키를 추가하려면 다음을 수행합니다. 1. 키 추가 아이콘( ![Add key icon.]())을 클릭합니다. 2. 필드에 키 이름을 입력합니다. 3. 키를 더 추가하려면 이전 단계를 반복합니다. 4. 이러한 필드에 값을 전달하려면 을 참조하십시오 [포트 속성 구성](https://servicenow-prod.fluidtopics.net/XyUWVVIZHNAOD1BSa3R53Q "에서 RPA 데스크톱 디자인 스튜디오구성 요소 또는 메서드의 입력 필드에 데이터를 전달하는 방법을 구성합니다."). {#connectors-queues-methods__ol_ifm_xxt_xbc} |
   | 대소문자 구분 | 작업 항목에 대해 중요한 컨텐츠가 업데이트됩니다. 이 기능을 사용하면 큐를 통해 중요한 정보를 전달할 수 있습니다. 예를 들어 큐에서 고객 데이터를 암호화하려면 중요한 필드를 사용하여 신용 카드 번호, 주소 등과 같은 고객 세부 정보를 저장해야 합니다. SensitiveRequestContent 필드에 키-값 쌍 'City: Mumbai'를 추가하고 JSON 경로 표기법에 다른 키-값 쌍 'Country: India'를 추가하면 UpdateWorkItem이 실행됩니다. 그런 다음 SensitiveRequestContent 필드에서 출력이 "City: Mumbai" 및 "Country: India"로 결합됩니다. |
   [표 5. 항목 구성 업데이트]

   {#connectors-queues-methods__table_kvt_vtn_psb}
{#connectors-queues-methods__ol_arb_qtn_psb}