큐 커넥터 메서드

  • 릴리스 버전: Yokohama
  • 업데이트 날짜 2025년 01월 30일
  • 읽기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. 확인을 클릭합니다.

    작업 항목 가져오기

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

    입력
    제한
    출력
    총 카운트

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

    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 데이터가 선택됩니다. 예를 들어 키-값 쌍 "City: Mumbai"(City는 키이고 Mumbai는 값)가 RequestContent 필드에 있고 "City: Delhi"(City는 키이고 Delhi는 값)가 SensitiveRequestContent 필드에 작성되는 경우입니다. 동일한 작업 항목을 선택하려고 하면 두 필드 모두 키가 동일하므로 SensitiveRequestContent 필드에 우선순위가 부여되고 이 필드에서 해당 출력이 검색됩니다.
    3. 확인을 클릭합니다.

    릴리스작업 항목

    봇이 수락하고 실행한 작업 항목을 해제합니다. 이 메서드를 실행하기 전에 PickWorkItem 메서드를 실행해야 합니다.
    입력
    작업 항목 ID
    출력
    결과(Return)

    UpdateWorkItem

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

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

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

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

      예를 들어 회계 시스템 큐의 경우 저축과 당기는 계정 유형입니다.

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

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

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

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