큐 커넥터 메서드

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

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

    필수 구성요소

    1. 작업 항목에 액세스하려면 설계 탭 RPA 데스크톱 디자인 스튜디오 의 봇 프로세스 할당 옵션을 사용하여 자동화 프로젝트에 봇 프로세스를 할당합니다. 자세한 내용은 자동화 프로젝트에 봇 프로세스 할당 문서를 참조하십시오.
    2. 다음 단계를 수행하여 QueueName 속성을 설정합니다.
      1. 에서 RPA 데스크톱 디자인 스튜디오다음으로 이동합니다. 도구 상자 > RPA 허브 > 큐.
      2. 프로젝트 탐색기의 전역 객체 아래에 있는 큐 커넥터를 끕니다.
      3. 큐 커넥터를 두 번 클릭합니다.
      4. 속성 창의 QueueName 속성에 큐의 이름을 입력합니다.
        주:
        큐의 이름은 에 정의된 RPA 허브이름과 같아야 합니다.

    CreateJSONWorkItem

    형식으로 큐에 대한 작업 항목을 생성합니다.JSON
    입력
    이름
    우선순위
    출력
    작업 항목 ID
    IsNameExists
    JSON 객체에서 키-값 쌍을 생성하려면 다음 작업을 수행합니다.
    1. CreateJSONWorkItem 메서드 표시줄에서 메서드 설정 아이콘( 메서드 설정 아이콘.
    2. 테이블에 지정된 기준을 입력합니다.
      표 1. 항목 구성 작성
      필드 설명
      구성
      입력 필드
      유형 작업 항목의 유형입니다.

      예를 들어 회계 시스템 큐의 경우 저축 및 통화는 계정 유형입니다.

      입력 필드를 구성하려면 다음 문서를 참조하십시오 포트 속성 구성.
      스테이지 작업 항목의 스테이지를 업데이트합니다.

      트랜잭션의 여러 스테이지를 유지하는 사용자 지정 필드입니다.
      SLA 작업 항목 완료에 대한 서비스 수준 계약(SLA)입니다.
      JSON 속성
      JSON 경로 표기법
      이름 요청 컨텐츠에 대한 키-값 쌍(JSON 컨텐츠)입니다.
      키를 추가하려면 다음을 수행합니다.
      1. 키 추가 아이콘( 키 추가 아이콘.)을 클릭합니다.
      2. 필드에 키 이름을 입력합니다.
      3. 키를 더 추가하려면 이전 단계를 반복합니다.
      4. 이러한 필드에 값을 전달하려면 다음 문서를 참조하십시오 포트 속성 구성.
      대소문자 구분 작업 항목이 생성될 때 전달되는 중요한 컨텐츠입니다.

      이 옵션을 민감으로 선택하면 데이터가 암호화되어 의 새 작업 항목RPA 허브에 있는 중요한 요청 콘텐츠 필드에 저장됩니다. 작업 항목 양식에 대한 자세한 내용은 다음 문서를 참조하십시오 RPA 허브의 작업 항목 양식.

      이 기능을 사용하면 큐를 통해 중요한 정보를 전달할 수 있습니다.

      예를 들어 큐에서 고객 데이터를 암호화하려면 민감 필드를 사용하여 신용 카드 번호, 주소 등과 같은 고객 세부 정보를 저장해야 합니다.
    3. 확인을 클릭합니다.

    CreateStringWorkItem

    문자열을 수락하여 큐에 작업 RPA 허브 항목을 작성합니다.
    입력
    RequestContent
    이름
    출력
    작업 항목 ID
    IsNameExists

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

    1. CreateStringWorkItem 메서드 표시줄에서 메서드 설정 아이콘( 메서드 설정 아이콘.
    2. 테이블에 지정된 기준을 입력합니다.
      표 2. 항목 구성 작성
      필드 설명
      입력 필드
      SensitiveRequestContent 중요한 콘텐츠를 암호화된 형식으로 새 작업 항목에 저장합니다.

      입력 필드를 구성하려면 다음 문서를 참조하십시오 포트 속성 구성.

      이 기능을 사용하면 큐를 통해 중요한 정보를 전달할 수 있습니다.

      예를 들어 큐에서 고객 데이터를 암호화하려면 SensitiveRequestContent 필드를 사용하여 신용 카드 번호, 주소 등과 같은 고객 세부 정보를 저장해야 합니다.
      스테이지 작업 항목의 스테이지를 업데이트합니다.

      트랜잭션의 여러 스테이지를 유지하는 사용자 지정 필드입니다.
      유형 작업 항목의 유형입니다.

      예를 들어 회계 시스템 큐의 경우 저축 및 통화는 계정 유형입니다.

      입력 필드를 구성하려면 다음 문서를 참조하십시오 포트 속성 구성.
      SLA 작업 항목 완료에 대한 서비스 수준 계약(SLA)입니다.
    3. 확인을 클릭합니다.

    GetWorkItems

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

    입력
    제한
    출력
    총 수

    작업 항목을 식별하고 가져오기 위한 추가 기준을 지정하려면 다음 단계를 수행합니다.

    1. 메서드 설정 아이콘( 메서드 설정 아이콘)을 클릭합니다.
    2. 필요에 따라 필터를 구성합니다. 필터는 필수입니다.
      표 3. 작업 항목 구성
      필드 설명
      입력 필터
      이름 작업 항목의 이름입니다. 다음 필터 중 하나를 지정할 수 있습니다.
      • 같음: 작업 항목의 이름이 지정한 기준과 정확히 같습니다.
      • 포함: 지정한 문자를 포함하는 작업 항목의 이름입니다.
      • StartsWith: 작업 항목의 이름은 지정한 문자로 시작합니다.
      • EndsWith: 작업 항목의 이름은 지정한 문자로 시작합니다.
      유형 문자열 형식의 작업 항목 유형입니다. 다음 필터 중 하나를 지정할 수 있습니다.
      • 같음: 작업 항목의 유형이 지정한 기준과 정확히 같습니다.
      • 포함: 지정한 문자를 포함하는 작업 항목의 유형입니다.
      • StartsWith: 작업 항목의 형식은 지정한 문자로 시작합니다.
      • EndsWith: 작업 항목의 형식은 지정한 문자로 시작합니다.
      상태 작업 항목의 상태입니다.
      스테이지 작업 항목의 스테이지를 업데이트합니다.

      트랜잭션의 여러 스테이지를 유지하는 사용자 지정 필드입니다.
      우선순위 실행 우선순위:
      • 중요
      • 높음
      • 보통
      • 낮음
      할당된 로봇은 작업 큐에서 정의된 우선순위에 따라 봇 프로세스를 실행합니다. 기본 우선순위는 항상 높음입니다.
      날짜 유형 작업 항목의 날짜 유형입니다. 이 필드에 입력을 제공하는 경우 FromData 및 ToDate 필드에도 입력을 제공해야 합니다.
      시작 날짜 메서드가 날짜 범위 내에서 작업 항목을 선택하는 경우 시작 날짜는 범위에 있습니다.
      종료 날짜 메서드가 날짜 범위 내에서 작업 항목을 선택하는 경우 종료 날짜는 해당 범위에 있습니다.
      오프셋 설정된 제한 이후에 검색될 작업 항목 수입니다. 예를 들어 제한이 20이면 다음으로 선택한 작업 항목은 21부터 시작됩니다.
      외부 필드
      기록 없음 객체 양식으로 작업 항목의 상세 정보를 반환합니다.
    3. 확인을 클릭합니다.
      주:
      사용자가 구성한 각 필드와 함께 데이터 입력 포트가 생성됩니다.

    작업 항목 선택

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

    로봇 풀에서 봇 프로세스가 활성화된 경우 PickWorkItem 구성요소에 포함된 queryCondition은 할당된 작업을 완료하는 데 필요한 로봇 수를 계산하는 데 고려됩니다. 로봇 수 계산에 대한 자세한 내용은 을 참조하십시오 RPA 허브에서 로봇 수 계산. 로봇 풀 개념에 대한 자세한 내용은 다음 문서를 참조하십시오 RPA 허브의 로봇 풀.

    입력
    우선순위
    출력
    작업 항목 ID
    RequestContent

    작업 항목을 선택하기 위한 추가 기준을 지정하려면 다음 단계를 수행합니다.

    1. 메서드 설정 아이콘( 메서드 설정 아이콘)을 클릭합니다.
    2. 테이블에 지정된 기준을 입력합니다.
      표 4. 항목 구성 선택
      필드 설명
      구성
      입력 필터
      이름 다음 필터에 따른 작업 항목의 이름입니다.
      • 같음: 작업 항목의 이름이 지정한 기준과 정확히 같습니다.
      • 포함: 지정한 문자를 포함하는 작업 항목의 이름입니다.
      • StartsWith: 작업 항목의 이름은 지정한 문자로 시작합니다.
      • EndsWith: 작업 항목의 이름은 지정한 문자로 시작합니다.

      선택은 데이터 입력 포트를 노출합니다.
      유형 다음 필터에 따른 작업 항목의 유형입니다.
      • 같음: 작업 항목의 유형이 지정한 기준과 정확히 같습니다.
      • 포함: 지정한 문자를 포함하는 작업 항목의 유형입니다.
      • StartsWith: 작업 항목의 형식은 지정한 문자로 시작합니다.
      • EndsWith: 작업 항목의 형식은 지정한 문자로 시작합니다.

      선택은 데이터 입력 포트를 노출합니다.
      스테이지 다음 필터에 기반한 작업 항목 작업 항목의 스테이지입니다.
      • 같음: 작업 항목의 스테이지가 지정한 기준과 정확히 같습니다.
      • 포함: 작업 항목의 스테이지에는 지정한 문자가 포함되어 있습니다.
      • StartsWith: 작업 항목의 스테이지가 지정한 문자로 시작됩니다.
      • EndsWith: 작업 항목의 스테이지가 지정한 문자로 시작됩니다.

      선택은 데이터 입력 포트를 노출합니다.
      상태 로봇이 선택할 작업 항목의 상태입니다.
      외부 필드
      이름 작업 항목의 이름을 반환하는 데이터 출력 포트입니다.
      유형 작업 항목의 유형을 반환하는 데이터 출력 포트입니다.
      발언 작업 항목에 대한 설명을 반환하는 데이터 출력 포트입니다.
      스테이지 작업 항목의 스테이지를 반환하는 데이터 출력 포트입니다.
      RequestContent 작업 항목에 대한 문자열 내용입니다. 작업 항목을 만들 때 저장된 콘텐츠를 선택합니다.
      SensitiveRequestContent 이 필드의 중요한 콘텐츠가 선택되고 암호가 해독된 후 로봇으로 전달됩니다.RPA 데스크톱 디자인 스튜디오
      JSON 속성
      JSON 경로 표기법 작업 항목의 JSON 경로 표기법을 반환하는 데이터 출력 포트입니다.

      키 추가 아이콘( 키 추가 아이콘)을 클릭하여 키 이름을 추가합니다.

      JSON은 RequestContent 및 SensitiveRequestContent 필드에 전달할 수 있습니다.

      작업 항목을 선택하는 동안 작업 항목에서 JSON 데이터를 선택합니다. 예를 들어 키-값 쌍 "도시: 뭄바이"(도시는 키이고 뭄바이는 값)가 RequestContent 필드에 있고 "도시: 델리"(도시는 키이고 델리는 값)가 SensitiveRequestContent 필드에 생성되는 경우 동일한 작업 항목을 선택하려고 하면 키가 두 필드에 대해 동일하므로 SensitiveRequestContent 필드에 우선순위가 부여되고 이 필드에서 해당 출력이 검색됩니다.
    3. 확인을 클릭합니다.

    작업 항목 릴리스

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

    작업 항목 업데이트

    로봇이 지정된 기준에 따라 PickWorkItem 메서드로 작업 항목을 선택한 후 작업 항목을 업데이트할 수 있습니다. 업데이트할 작업 항목에 대한 추가 기준을 구성할 수 있습니다. 이 메서드를 실행하기 전에 PickWorkItem 메서드를 실행해야 합니다.
    입력
    작업 항목 ID
    RequestContent
    릴리스 모드
    우선순위
    상태
    예외 유형

    작업 항목을 업데이트하기 위한 추가 조건을 지정하려면 다음 단계를 수행합니다.

    1. 메서드 설정 아이콘( 메서드 설정 아이콘)을 클릭합니다.
    2. 테이블에 지정된 기준을 입력합니다.
      표 5. 항목 구성 업데이트
      필드 설명
      구성
      입력 필드
      스테이지 작업 항목의 스테이지를 업데이트합니다.

      트랜잭션의 여러 스테이지를 유지하는 사용자 지정 필드입니다.
      연기됨 동일한 작업 항목이 선택되지 않는 기간을 지정하는 옵션입니다. 예를 들면 5분입니다.
      이름 작업 항목의 이름입니다.
      유형 작업 항목의 유형입니다.

      예를 들어 회계 시스템 큐의 경우 저축 및 통화는 계정 유형입니다.

      입력 필드를 구성하려면 다음 문서를 참조하십시오 포트 속성 구성.
      발언 작업 항목에 대한 지원 비고입니다.
      SLA 작업 항목 완료에 대한 서비스 수준 계약(SLA)입니다.
      응답컨텐츠 작업 항목에 대한 문자열 내용입니다. 작업 항목의 저장된 컨텐츠를 업데이트합니다.
      SensitiveRequestContent 작업 항목의 중요한 컨텐츠를 업데이트합니다.
      JSON 속성
      JSON 경로 표기법
      이름 요청 컨텐츠에 대한 키-값 쌍(JSON 컨텐츠)입니다.
      키를 추가하려면 다음을 수행합니다.
      1. 키 추가 아이콘( 키 추가 아이콘.)을 클릭합니다.
      2. 필드에 키 이름을 입력합니다.
      3. 키를 더 추가하려면 이전 단계를 반복합니다.
      4. 이러한 필드에 값을 전달하려면 다음 문서를 참조하십시오 포트 속성 구성.
      대소문자 구분 중요한 컨텐츠는 작업 항목에 대해 업데이트됩니다.

      이 기능을 사용하면 큐를 통해 중요한 정보를 전달할 수 있습니다.

      예를 들어 큐에서 고객 데이터를 암호화하려면 민감 필드를 사용하여 신용 카드 번호, 주소 등과 같은 고객 세부 정보를 저장해야 합니다.

      SensitiveRequestContent 필드에 키-값 쌍 "City: Mumbai"를 추가하고 JSON 경로 표기법으로 다른 키-값 쌍 "Country: India"를 추가하면 UpdateWorkItem이 실행됩니다. 그런 다음 SensitiveRequestContent 필드에서 출력이 "도시: 뭄바이" 및 "국가: 인도"로 결합됩니다.