Test a Robot on Its Environment

After you finish building a robot, test the robot on its real-world environment by running the robot from within the project.

Prerequisites

You don't need to design the integration that calls the robot.

Specify where the robot runs and activate the robot. See Specify Where a Robot Runs and Activate a Robot.
Update your network's allowlist to allow outbound calls to Oracle Integration.

If you don't complete this task, the robot agent might not be able to contact Oracle Integration so that it can poll for work, and your robot might not run if you're on a company VPN or wired network. See Review Your Network Configuration.

Test a Robot on Its Environment

If the robot is associated with an environment pool that contains multiple environments, you can't choose the environment that the robot runs on. If you want to control this aspect of testing, associate the robot with an environment pool that has only one environment.

Open a project.
1. In the navigation pane, select Projects.
2. Select the project name.
In the left toolbar, select Robot .
Run the robot.
1. In the Robots box, point to an Active robot, select ..., and select Run.
  
  The Configure and run page appears.
2. In the Input field, enter or paste the JSON code for the trigger's input.
  
  For help, see Sample Code for Testing a Robot.
3. Select Run.
  
  Below Instance ID, the identifier of the robot instance appears.

Next steps

Next, monitor the robot to verify that it ran as expected. See Monitor a Robot.

After verifying that the robot runs successfully in its environment, test the robot with its integration. See Test a Robot and Its Integration.

Sample Code for Testing a Robot

When a robot runs in the real world, an integration passes an input to a robot. However, when you run a robot independent of its integration, you must pass this value manually. To test your robot effectively, enter JSON code that matches the values that you defined in the input.

Formatting Rules

Enclose all code in curly brackets: { }
Include a comma after each line.
Enclose the property names and the values of strings in quotation marks: " "
Enclose the values of collection variables in brackets: [ ]
If a value is a string and is part of a collection variable, include the quotation marks within the brackets. For example:

"Property_Name": ["Value"],

Sample Code: Input with Multiple Properties

The input for a robot contains a number of properties, including Department, Name, Activity_Type, and so on, as shown in the following example. You can pass values for these properties to the robot.

{
  "Department": "Finance",
  "Name": "Travel expenses",
  "Activity_Type": ["Adjustments"],
  "Active": "Yes",
  "Account_Source": ["Travel account"],
  "Tax_Rate_Code_Source": ["Activity"],
  "Activity_Account": "ABCD-123456-789000",
  "searchTask": "manage expenses"
}

Sample Code: Passing Multiple Records for an Input That Is Based on a Data Type with Four Properties

The input for a robot is named Invoices and is of the InvoiceType type. The InvoiceType data type contains the following properties:

InvoiceNumber
SupplierName
InvoiceAmount
DueAmount

The input must include the name of the input, the name of its properties, and the values for its properties. If the robot iterates over multiple records, you can pass multiple records to it in the input, as shown in the following example.

{
  "Invoices": [{
    "InvoiceNumber": "US123456",
    "SupplierName": "Big Computers",
    "InvoiceAmount": 98437,
    "DueAmount": 500.00
  }, {
    "InvoiceNumber": "US234566",
    "SupplierName": "Small, Inc.",
    "InvoiceAmount": 128,
    "DueAmount": 128
  }]
 
}