---
sourceDocument: Brazil Workflow Data Fabric
sourceDocumentLink: https://www.servicenow.com/docs/r/integrate-applications

 Release :

    - brazil

ft:locale :

    - en-US

ft:publication_title :

    - Brazil Workflow Data Fabric

ft:clusterId :

    - crint

bundleId :

    - crint

workflow :

    - Creator


---

# Queue connector methods

# Queue connector methods {#ariaid-title1}

Release version: Brazil  
Updated September 10, 2026  
![](https://www.servicenow.com/docs/portal-asset/ico-clock) 9 minutes to read  
The Queue connector methods enable you to create and manage work items for queues in the RPA Hub.

## Prerequisites {#connectors-queues-methods__section_xtf_43m_psb}

1. Assign the bot process to the automation project by using the Assign bot process option from the Design tab of RPA Desktop Design Studio to access the work items. For more information, see [Assign bot process to an automation project](https://www.servicenow.com/docs/uHG42P5hp49nKDhIQ_pWiw "Assign a bot process to an automation project in RPA Desktop Design Studio to start using the bot process resources.").
2. Set the QueueName property by doing the following steps:
   1. In the RPA Desktop Design Studio, navigate to ToolboxRPA HubQueue.
   2. Drag the Queue connector under Global Objects in the Project Explorer.
   3. Double-click the Queue connector.
   4. Under the Properties pane, in the QueueName property, enter the name of the Queue.  
      Note:  
      The name of the Queue must be the same as that defined in RPA Hub.
   {#connectors-queues-methods__ol_q2m_2sm_psb}
{#connectors-queues-methods__ol_srn_5rm_psb}

## CreateJSONWorkItem {#connectors-queues-methods__section_lg4_lzg_srb}

Creates a work item for the queue in the JSON format.

Input
:   [Name](https://www.servicenow.com/docs/2Xv3g2fj7ujvle4OghimAg#queue-connector-method-parameters__parameter-input-createjsonworkitem-name)
:   [Priority](https://www.servicenow.com/docs/2Xv3g2fj7ujvle4OghimAg#queue-connector-method-parameters__parameter-input-createjsonworkitem-priority)

Output
:   [WorkItemId](https://www.servicenow.com/docs/2Xv3g2fj7ujvle4OghimAg#queue-connector-method-parameters__parameter-output-createjsonworkitem-workitemid)
: [IsNameExists](https://www.servicenow.com/docs/2Xv3g2fj7ujvle4OghimAg#queue-connector-method-parameters__parameter-output-createjsonworkitem-isnameexists)  
To create the key-value pairs in a JSON object, do the following actions:

1. On the CreateJSONWorkItem method bar, click the method settings icon (![Method settings icon.]()).
2. Enter the criteria as given in the table.{#connectors-queues-methods__table_lnf_rwb_wbc__entry__2}

   | Field | Description |
   |-|-|
   | CONFIGURATION ||
   | INPUT FIELDS ||
   | Type | The type of the work item. For example, for an accounting system queue, savings and current are types of accounts. To configure the input field, see [Configure port properties](https://www.servicenow.com/docs/ED3jBpqtlHH8p~yFFmyRBQ "Configure how data is passed to the input fields of a component or method in RPA Desktop Design Studio."). |
   | Stage | Updates the stage of the work item. Custom field to maintain different stages of the transaction. |
   | SLA | Service Level Agreement (SLA) of the work item completion. |
   | JSON PROPERTIES ||
   | JSON PATH NOTATIONS ||
   | Name | Key-value pair (JSON content) for the request content. To add a key, do the following: 1. Click the add key icon (![Add key icon.]()). 2. Enter the key name in the field. 3. To add more keys, repeat the previous steps. 4. To pass the value to these fields, see [Configure port properties](https://www.servicenow.com/docs/ED3jBpqtlHH8p~yFFmyRBQ "Configure how data is passed to the input fields of a component or method in RPA Desktop Design Studio."). |
   | Sensitive | Sensitive content that is passed when the work item is created. Select this option as sensitive, then the data is encrypted and stored in the Sensitive Request Content field in the new work item in RPA Hub. For more information about the work item form, see [Work item form in RPA Hub](https://www.servicenow.com/docs/N8Ls1H9~fhDkkS6oKbk2eQ#work-queue-form "Use the Work item form to view more details of the executed work items."). With this functionality, you can pass sensitive information through queues. For example, if you want customer data to be encrypted in the queue, you must use the Sensitive field to store customer details such as credit card number, address, and so on. |
   [Table 1. CREATE ITEM CONFIGURATION]

   {#connectors-queues-methods__table_lnf_rwb_wbc}
3. Click OK.
{#connectors-queues-methods__ol_spx_tyh_srb}

## CreateStringWorkItem {#connectors-queues-methods__section_uyj_qg3_srb}

Creates a work item in a queue in the RPA Hub by accepting a string.

Input
:   [RequestContent](https://www.servicenow.com/docs/2Xv3g2fj7ujvle4OghimAg#queue-connector-method-parameters__paramater-input-CreateStringWorkItem-requestcontent)
:   [Name](https://www.servicenow.com/docs/2Xv3g2fj7ujvle4OghimAg#queue-connector-method-parameters__parameter-input-createjsonworkitem-name)

Output
:   [WorkItemId](https://www.servicenow.com/docs/2Xv3g2fj7ujvle4OghimAg#queue-connector-method-parameters__parameter-output-createjsonworkitem-workitemid)
:   [IsNameExists](https://www.servicenow.com/docs/2Xv3g2fj7ujvle4OghimAg#queue-connector-method-parameters__parameter-output-createjsonworkitem-isnameexists)

To specify additional criteria for creating string work items, do the following steps.

1. On the CreateStringWorkItem method bar, click the method settings icon (![Method settings icon.]()).
2. Enter the criteria as given in the table.{#connectors-queues-methods__table_ast_sdc_wbc__entry__2}

   | Field | Description |
   |-|-|
   | INPUT FIELDS ||
   | SensitiveRequestContent | Stores sensitive content in encrypted format in the new work item. To configure the input field, see [Configure port properties](https://www.servicenow.com/docs/ED3jBpqtlHH8p~yFFmyRBQ "Configure how data is passed to the input fields of a component or method in RPA Desktop Design Studio."). With this functionality, you can pass sensitive information through queues. For example, if you want customer data to be encrypted in the queue, you must use the SensitiveRequestContent field to store customer details such as credit card number, address, and so on. |
   | Stage | Updates the stage of the work item. Custom field to maintain different stages of the transaction. |
   | Type | The type of the work item. For example, for an accounting system queue, savings and current are types of accounts. To configure the input field, see [Configure port properties](https://www.servicenow.com/docs/ED3jBpqtlHH8p~yFFmyRBQ "Configure how data is passed to the input fields of a component or method in RPA Desktop Design Studio."). |
   | SLA | Service Level Agreement (SLA) of the work item completion. |
   [Table 2. CREATE ITEM CONFIGURATION]

   {#connectors-queues-methods__table_ast_sdc_wbc}
3. Click OK.
{#connectors-queues-methods__ol_yrt_sdc_wbc}

## GetWorkItems {#connectors-queues-methods__section_n31_rpn_srb}

Returns the count and the details of the work items created under the queue based on
the criteria you specify. The method provides a default criterion already but you
can specify additional criteria.  

Input
:   [Limit](https://www.servicenow.com/docs/2Xv3g2fj7ujvle4OghimAg#queue-connector-method-parameters__parameter-input-getworkitem-limit)

Output
:   [TotalCount](https://www.servicenow.com/docs/2Xv3g2fj7ujvle4OghimAg#queue-connector-method-parameters__parameter-output-getworkitem-totalcount)

To specify additional criteria for identifying and getting work items, do the
following steps.  
1. Click the method settings icon (![Method settings icon]()).
2. Configure the filters, as required. No filter is mandatory.{#connectors-queues-methods__table_pkh_1dn_psb__entry__2}

   | Field | Description |
   |-|-|
   | INPUT FILTERS ||
   | Name | Name of the work item. You can specify one of the following filters: * Equals: Name of the work item is exactly equal to the criteria you specify. * Contains: Name of the work item contains characters you specify. * StartsWith: The name of the work item starts with the characters you specify. * EndsWith: The name of the work item starts with the characters you specify. {#connectors-queues-methods__ul_sn5_sw4_psb} |
   | Type | Type of the work item in string format. You can specify one of the following filters: * Equals: Type of the work item is exactly equal to the criteria you specify. * Contains: Type of the work item contains characters you specify. * StartsWith: The type of the work item starts with the characters you specify. * EndsWith: The type of the work item starts with the characters you specify. {#connectors-queues-methods__ul_ukt_nbn_wsb} |
   | Status | Status of the work item. |
   | Stage | Updates the stage of the work item. Custom field to maintain different stages of the transaction. |
   | Priority | Priority of execution: * Critical * High * Medium * Low {#connectors-queues-methods__ul_b11_4yk_1rb}The assigned robot executes the bot process as per the defined priority in the work queue. The default priority is always High. |
   | DateType | Date type of the work item. If you provide inputs to this field, you must also provide inputs to the FromData and ToDate fields also. |
   | FromDate | If the method is picking work items within a date range, starting date in the range. |
   | ToDate | If the method is picking work items within a date range, ending date in the range. |
   | Offset | Number of work items that will be retrieved after the set limit. For example, if the limit is 20, the next picked work item starts from 21. |
   | OUT FIELDS ||
   | OutRecords | Returns the details of the work items in an object form. |
   [Table 3. WORKITEM CONFIGURATION]

   {#connectors-queues-methods__table_pkh_1dn_psb}
3. Click OK.  
   Note:  
   A Data In port is created with each field you configure.
{#connectors-queues-methods__ol_xjk_mcn_psb}

## PickWorkItem {#connectors-queues-methods__section_b5z_vsn_srb}

Enables a robot to pick a work item based on the given criteria. You can also configure additional criteria for the work item to be picked.

queryConditions included in the PickWorkItem component are considered for calculating the number of robots required to complete the work allocated, if the bot process is enabled with robot
pool. For more information about calculating the number of robots, see [Calculate the number of robots in RPA Hub](https://www.servicenow.com/docs/_J3Dn60VYaJB6E4aKYh3hA "Calculate the number of robots that you need to complete an unattended bot process execution that is based on the allocation type, for example, the SLA Based and Percentage Reduction."). For more information about robot pool concepts, see [Robot pool in RPA Hub](https://www.servicenow.com/docs/9HFTScMf6pPb6kCE6wD4Cg "Create a robot pool in RPA Hub to distribute and manage the workload among multiple unattended robots for unattended bot processes.").  

Input
:   [Priority](https://www.servicenow.com/docs/2Xv3g2fj7ujvle4OghimAg#queue-connector-method-parameters__parameter-input-createjsonworkitem-priority)

Output
:   [WorkItemId](https://www.servicenow.com/docs/2Xv3g2fj7ujvle4OghimAg#queue-connector-method-parameters__parameter-output-createjsonworkitem-workitemid)
:   [RequestContent](https://www.servicenow.com/docs/2Xv3g2fj7ujvle4OghimAg#queue-connector-method-parameters__paramater-input-CreateStringWorkItem-requestcontent)

To specify additional criteria for picking work items, do the following steps.  
1. Click the method settings icon (![Method settings icon]()).
2. Enter the criteria as given in the table.{#connectors-queues-methods__table_ewl_yqn_psb__entry__2}

   | Field | Description |
   |-|-|
   | CONFIGURATION ||
   | INPUT FILTERS ||
   | Name | Name of the work item based on the following filters. * Equals: Name of the work item is exactly equal to the criteria you specify. * Contains: Name of the work item contains characters you specify. * StartsWith: The name of the work item starts with the characters you specify. * EndsWith: The name of the work item starts with the characters you specify. {#connectors-queues-methods__ul_agg_ydn_wsb} Selection exposes a Data In port. |
   | Type | Type of the work item based on the following filters. * Equals: Type of the work item is exactly equal to the criteria you specify. * Contains: Type of the work item contains characters you specify. * StartsWith: The type of the work item starts with the characters you specify. * EndsWith: The type of the work item starts with the characters you specify. {#connectors-queues-methods__ul_afg_zdn_wsb} Selection exposes a Data In port. |
   | Stage | Stage of the work item work item based on the following filters. * Equals: Stage of the work item is exactly equal to the criteria you specify. * Contains: Stage of the work item contains characters you specify. * StartsWith: Stage of the work item starts with the characters you specify. * EndsWith: Stage of the work item starts with the characters you specify. {#connectors-queues-methods__ul_efs_d2n_wsb} Selection exposes a Data In port. |
   | Status | Status of the work item for the robot to select. |
   | OUT FIELDS ||
   | Name | Data out port that returns the name of the work item. |
   | Type | Data out port that returns the type of the work item. |
   | Remarks | Data out port that returns remarks on the work item. |
   | Stage | Data out port that returns the stage of the work item. |
   | RequestContent | String content for the work item. Picks the stored content when the work item is created. |
   | SensitiveRequestContent | The sensitive content from this field is picked, decrypted and passed to the RPA Desktop Design Studio or robots. |
   | JSON PROPERTIES ||
   | JSON PATH NOTATIONS | Data out port that returns the JSON path notation of a work item. Click the add key icon (![Add key icon.]()) to add a key name. JSON can be passed in both RequestContent and SensitiveRequestContent fields. While picking work item, the JSON data is picked from a work item. For example, if a key-value pair "City: Mumbai" (City is key and Mumbai is value) is in the RequestContent field and "City: Delhi" (City is key and Delhi is value) is created in SensitiveRequestContent field. When you try to pick the same work item, since the key is same for both fields, the SensitiveRequestContent field is given precedence and that output is retrieved from this field. |
   [Table 4. PICK ITEM CONFIGURATION]

   {#connectors-queues-methods__table_ewl_yqn_psb}
3. Click OK.
{#connectors-queues-methods__ol_jyx_sqn_psb}

## ReleaseWorkItem {#connectors-queues-methods__section_fyw_f14_srb}

Releases a work item that has been accepted and executed by a bot. You must execute PickWorkItem method before executing this method.

Input
:   [WorkItemId](https://www.servicenow.com/docs/2Xv3g2fj7ujvle4OghimAg#queue-connector-method-parameters__parameter-output-createjsonworkitem-workitemid)

Output
:   [Return](https://www.servicenow.com/docs/2Xv3g2fj7ujvle4OghimAg#queue-connector-method-parameters__parameter-output-releaseworkitem-return)

## UpdateWorkItem {#connectors-queues-methods__section_pyn_cxn_srb}

Enables a robot to update a work item after picking it with the PickWorkItem method based on specified criteria. You can configure additional criteria for the work item to be updated. You must execute PickWorkItem method before executing this method.

Inputs
:   [WorkItemId](https://www.servicenow.com/docs/2Xv3g2fj7ujvle4OghimAg#queue-connector-method-parameters__parameter-output-createjsonworkitem-workitemid)
:   [RequestContent](https://www.servicenow.com/docs/2Xv3g2fj7ujvle4OghimAg#queue-connector-method-parameters__paramater-input-CreateStringWorkItem-requestcontent)
:   [ReleaseMode](https://www.servicenow.com/docs/2Xv3g2fj7ujvle4OghimAg#queue-connector-method-parameters__parameter-input-updateworkitem-releasemode)
:   [Priority](https://www.servicenow.com/docs/2Xv3g2fj7ujvle4OghimAg#queue-connector-method-parameters__parameter-input-createjsonworkitem-priority)
:   [Status](https://www.servicenow.com/docs/2Xv3g2fj7ujvle4OghimAg#queue-connector-method-parameters__parameter-input-pickworkitem-status)
:   [Exception Type](https://www.servicenow.com/docs/2Xv3g2fj7ujvle4OghimAg#queue-connector-method-parameters__parameter-input-exception-type)

To specify additional criteria for updating work items, do the following steps.  
1. Click the method settings icon (![Method settings icon]()).
2. Enter the criteria as given in the table.{#connectors-queues-methods__table_kvt_vtn_psb__entry__2}

   | Field | Description |
   |-|-|
   | CONFIGURATION ||
   | INPUT FIELDS ||
   | Stage | Updates the stage of the work item. Custom field to maintain different stages of the transaction. |
   | DeferredTill | Option to specify a time duration during which the same work item will not be picked. For example, 5 minutes. |
   | Name | Name of the work item. |
   | Type | The type of the work item. For example, for an accounting system queue, savings and current are types of accounts. To configure the input field, see [Configure port properties](https://www.servicenow.com/docs/ED3jBpqtlHH8p~yFFmyRBQ "Configure how data is passed to the input fields of a component or method in RPA Desktop Design Studio."). |
   | Remarks | Supporting remarks on the work item. |
   | SLA | Service Level Agreement (SLA) of the work item completion. |
   | ResponseContent | String content for the work item. Updates the stored content of a work item. |
   | SensitiveRequestContent | Updates the sensitive content of a work item. |
   | JSON PROPERTIES ||
   | JSON PATH NOTATIONS ||
   | Name | Key-value pair (JSON content) for the request content. To add a key, do the following: 1. Click the add key icon (![Add key icon.]()). 2. Enter the key name in the field. 3. To add more keys, repeat the previous steps. 4. To pass the value to these fields, see [Configure port properties](https://www.servicenow.com/docs/ED3jBpqtlHH8p~yFFmyRBQ "Configure how data is passed to the input fields of a component or method in RPA Desktop Design Studio."). {#connectors-queues-methods__ol_ifm_xxt_xbc} |
   | Sensitive | Sensitive content is updated for a work item. With this functionality, you can pass sensitive information through queues. For example, if you want customer data to be encrypted in the queue, you must use the Sensitive field to store customer details such as credit card number, address, and so on. When you add a key-value pair "City: Mumbai" in SensitiveRequestContent field and add another key-value pair "Country: India" in JSON Path Notation and the UpdateWorkItem is executed. Then, in the SensitiveRequestContent field, the output is combined to "City: Mumbai" and "Country: India". |
   [Table 5. UPDATE ITEM CONFIGURATION]

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

*[\>]: and then