Using Apps With Queues

Background Information

For more information on queues, check the following pages:

• Rule: Add to Queue
• Referencing a Queue in your App

• Replacing a Queue

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. Add a queue to your app by clicking on the next to the app's name and selecting 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.

4.2. For the second textbox, add an integer item from the referenced queue in the Value binding field.

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.

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. Add a queue to your app by clicking on the next to the app's name and selecting 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.

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.

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.

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).

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.