apps
2023.4
false
UiPath logo, featuring letters U and I in white

Apps User Guide

Last updated Apr 19, 2024

Using Apps With Queues

Background Information

For more information on queues, check the following pages:

Note: If you want to send a date-time object, datatables, objects, or arrays to a queue, make sure that you bind it to a string type field. You can also bind a complex object to a queue input using the string type field.

Overview

Before starting this example, make sure that you have the proper permissions from Orchestrator.

Add Simple Items to Queue

In this example we will add two items to a queue.

Procedure

  1. Open your already existing application or start a new one.
  2. Click the Add any icon from the top of the canvas and select Queue.



  3. Add the following input controls to your app:

    • Two textbox controls
    • One button
  4. Configure the controls as follows:

    4.1. For the first textbox, add a string item from the referenced queue in the Value binding field.
    docs image
    4.2. For the second textbox, add an integer item from the referenced queue in the Value binding field.
    docs image
    4.3. For the button, add an Add to Queue rule and add the queue you want to use in the What queue to use property.
    docs image

5. Save the app and preview it.

6. Add the word Test in the first textbox, and 321 in the second textbox. Click the button.

Note:

If the data passed in the queue does not follow the schema, Orchestrator will reject the queue item addition. In this situation an error message is displayed in Apps.

For example, this error can occur when a string value is sent in an integer type field.

Procedure Result

Attention: If there is no error message, the procedure worked. You can check the queue in Orchestrator. Go under transactions for the used queue and check the latest transaction.


Add an Expression and a Date to Queue

In this example we will add several items to a queue:

  • Text using a textbox
  • A date using the date picker control
  • Text using an expression in the Input Override property of the Add to Queue rule.

Procedure

  1. Open your already existing application or start a new one.
  2. Click the Add any icon from the top of the canvas and select Queue.



  3. Add the following input controls to your app:

    • One textbox control
    • One date picker control
    • One button
  4. Configure the controls as follows:

    4.1. For the textbox, add a string item from the referenced queue in the Value binding field.
    docs image
    4.2. For the date picker, add an integer item from the referenced queue in the Value binding field.
    Note: If you want to send a date, object, or array to the queue, make sure that you bind it to a string type field.
    docs image
    4.3. For the button, add an Add to Queue rule and add the queue you want to use in the What queue to use property.
    docs image
    4.4. In the Input Override property of the Add to Queue rule, add a string item in the first field and an expression in the second field. For example, you can add =List(1, 2, 3).
    docs image

5. Save the app and preview it.

6. Add the word Test in the textbox and select a date from the date picker. Click the button.

Note:

If the data passed in the queue does not follow the schema, Orchestrator will reject the queue item addition. In this situation an error message is displayed in Apps.

For example, this error can occur when a string value is sent in an integer type field.

Procedure Result

Attention: If there is no error message, the procedure worked.

You can check the queue in Orchestrator. Go under transactions for the used queue and check the latest transaction.



Was this page helpful?

Get The Help You Need
Learning RPA - Automation Courses
UiPath Community Forum
Uipath Logo White
© 2005-2024 UiPath. All rights reserved.