Add an Upload File Action

The upload file action uploads a file to an application.

Prerequisites

  1. Confirm that the web application that you need to upload a file to contains the following buttons:

    • A button for navigating to the file.

    • A separate button for uploading the file.

  2. Create a variable that is of the File type.

    See Create a Variable.

  3. Determine where you'll get the file to upload. You have the following options:

    • In the same robot, first download the file from a web application, and then upload the file.

      While defining the download file action, specify the variable that you just created as the action's output. See Add a Download File Action.

    • Use an integration to get the file, and then use the integration to pass the file to the robot.

      While defining the robot's trigger, create and specify an input property that is of the File type. To define the robot's trigger, see Create a Robot.

Add an Upload File Action

Note:

You must use the low-code capabilities to add this action to a robot. Keep reading for step-by-step instructions.
  1. Open the robot to edit.
  2. Add the action to the robot.
    1. On the canvas, point to an action, and click +.

      A mouse cursor points to an action in the canvas and hovers over the plus sign button, which appears at the bottom of the rectangle that represents the action. A plus sign button also appears at the top of the rectangle, for adding an action after the current action.

      A menu of available actions appears.

    2. Select Upload File.

      An Upload File action appears on the canvas, and the Download File panel appears.

  3. In the panel, enter a Name and Description for the action.

    The Name appears on the action in the canvas and should help you and others understand the goal of the action.

  4. In another browser window or tab, open the application where the robot works.
  5. On the Input tab, specify input details for the action.
    Field Description
    browse

    1. Click within the browse field, and select Target a page element Target a page element.

      The Target a page element panel appears.

    2. In the panel, from the Select browser tab to target drop-down, select the application where the robot works, and select Go. You might need to scroll down to find the application.

      The application opens.

    3. In the application, point to the button for browsing to a file, but don't select it.

      For example, if the field is shaded purple and the magnifying lens icon appears, don't click yet. The recorder is still collecting information.

      A button is shaded purple, and a magnifying lens icon appears above it. A big red X appears, indicating that the button isn't ready to be selected

    4. After the shading turns green, the icon changes to a target, and the mouse icon changes to a hand, select the UI element.

      A button is shaded green, and a target icon appears above it. A big green checkmark appears, indicating that the button is ready to be selected

      For more tips, see Quick Start for Building Robots.

      The recorder enters a value in the browse field in the robot.

      Tip:

      Your settings determine whether Oracle Integration reuses targets for previously selected UI controls. You can override these settings, if needed. Reusing a target offers benefits. For example, you can update a target one time, and all actions that use the target get the update.
    File reference

    Specify the variable that identifies the file to upload.

    1. Click within the File reference field, and select Variables Variables.

      The Variables panel appears.

    2. Determine whether the variable that you need appears in the list. If not, create it. See Create a Variable.

    3. Select a variable that is of the File type and that isn't a collection, and drag it to the File reference field field.

    submit

    Repeat the steps you followed for the browse field, but target the button that you select to upload the file to the web application.

    Maximum upload wait time (seconds)

    Enter the maximum time in seconds to wait for the file to upload.

    If an upload attempt isn't successful, the robot retries approximately every 60 seconds, so consider entering a value that is a multiple of 60.

    The robot moves on to the next action immediately after the upload is successful.
    Screenshots

    Specify whether to capture any screenshots as part of the action. See Capture Screenshots in Robots.
  6. On the Pre Validate and Post Validate tabs, specify whether to complete any validation before and after the action.
  7. Click OK.
  8. Above the canvas, select Save.