Use the ActionSet component

The ActionSet component lets an automation interact with Windows applications (such as web browsers) and with Citrix applications. Using this single component in RPA Desktop Design Studio, you can click, drag, read and set text, interact with tables, and more, combining several user actions into a single task.

始める前に

Role required: none

このタスクについて

Using the ActionSet component, you can simulate a user interaction in an automation by specifying multiple user actions.

You can configure the properties for the ActionSet component settings. For more information about these properties, see Properties of Actions (UI) components.

Using the controls in the window, you capture an area of an application window, set one or more anchors, and define the user interactions that you want to simulate in that window. An anchor helps specify the target area for the interaction by defining a static area from which actions can be defined at a relative distance. For more information about anchors, see Anchor.

図 : 1. The ActionSet Settings Window

注:

The ActionSet component is compatible with the Internet Explorer browser, Windows, and Citrix applications.

手順

1. In the Toolbox pane, navigate to Actions (UI) > ActionSet.
2. Drag the ActionSet component to the Design surface.
3. Click the component settings icon (), or, double-click the header of the component.
   The ACTIONSET SETTINGS window appears.
4. Do the following actions:
   Capture the area of the external application’s window that you want the automation to interact with. For example, capture the area surrounding a button or a text field in a web browser.
   1. Click Capture Image.
      The Press "CTRL+SHIFT" for selection message appears.
   2. Switch to the external application.
   3. Press the Ctrl + Shift keys at the same time, then release them.
      The mouse device turns into a crossover icon ().
   4. Drag the mouse device over the element on which you want the ActionSet component to perform an action and its surrounding area and release.
      For example, if you want the component to click a button, drag the mouse device to capture the button and its surrounding areas.
      The selected area is captured as an image in the ACTIONSET SETTINGS window.

      All ActionSet actions take place in the selected window. To run actions in more than one window, use more than one ActionSet component in your workflow.

5. To add one or more anchors, follow these steps:
   1. Return to RPA Desktop Design Studio and in the ACTIONSET SETTINGS window, click ADD ANCHOR.
      The anchor appears as a yellow rectangle with red borders.
   2. If necessary, move the anchor to a part of the captured image that will not change.
      For example, move the anchor to a title or field label.

      If the area under the anchor does not exactly match the corresponding area of the captured image, the anchor will not be recognized, and the ActionSet component will not work as intended. Choose a static area of the image to set your anchor.

      You can define more than one anchor. Multiple anchors let you define the geographical relationship between anchor and target with greater accuracy when targeting different locations in the image.

6. Right-click the anchor and select an action to perform in the contextual menu.
7. To do the actions that the ActionSet component can perform, see the following steps in the appropriate topic to configure the action:

   表 : 1. ActionSet component actions

   Action	Reference
   Simulate a mouse click	Use the ActionSet Click action.
   Enter text in a field	Use the ActionSet SetText action.
   Capture text from a window or web page	Use the ActionSet GetText action.
   Capture a table	Use the ActionSet Get Table action.
   Select, copy, or delete text	Use the ActionSet Text Selection action.
   Read text in an image	Use the ActionSet OCR Read Text action.
   Read a table in an image	Use the ActionSet OCR Read Table action.
   Read text in an image and click it when found	Use the ActionSet OCR Read Text action.
   Simulate a key press or a key function	Use the ActionSet SendKeys action.
   Simulate an alternative mouse action (for example, right-click, drag, scroll, or paste)	Use the ActionSet Mouse action.

8. オプション: To add more actions, repeat step 6 and 7.
9. オプション: To delete the anchor, right-click the anchor and click Delete.
10. オプション: Connect the data and control ports of the ActionSet component to the corresponding ports of the other components as described in the following table.

    The ActionSet component has one optional parameter, which you can use to specify the handle of the window where the action takes place. A window handle may identify a specific window more quickly than is possible using image matching. You can also specify match rules to help the automation find the target window by testing available windows against the rules you specify.

    To specify the window handle, connect the Window Handle Data Out port of another component (such as the Start App component) to the Window Handle Data In port of the ActionSet component. For more information about the Window Handle parameter, see the following table.

    Port type	Port name	Data type	Purpose of connection	Notes
    Data In	Window Handle	Integer	The numeric handle of the window where the action will be performed. This must be the window from which the image in the ACTIONSET SETTINGS window was captured.	You must provide the handle of the window from which you have captured the image of the screen.

• Use the ActionSet Click action
  Simulate a simple left-click on the target area as part of a series of actions in the ActionSet component.
• Use the ActionSet SetText action
  Set text to fields on the Windows applications or the Internet Explorer browser by using the Set Text action in RPA Desktop Design Studio.
• Use the ActionSet GetText action
  Capture text from the Windows applications, and web pages on the Internet Explorer browser by using the Get Text action in RPA Desktop Design Studio.
• Use the ActionSet Text Selection action
  Select, copy, or delete text from the Desktop and Windows applications, and the Internet Explorer browser by using the Text Selection action in RPA Desktop Design Studio.
• Use the ActionSet Get Table action
  Capture a table from the Windows applications, and web pages on the Internet Explorer browser by using the Get Table component in RPA Desktop Design Studio.
• Use the ActionSet GetImage action
  Capture images from the desktop, Windows applications, and web pages on the Internet Explorer browser by using the GetImage component in RPA Desktop Design Studio.
• Use the ActionSet OCR Read Text action
  Extract text from images in the desktop, Windows applications, and the Internet Explorer browser by using the OCR Read Text action in RPA Desktop Design Studio.
• Use the ActionSet OCR Read Table action
  Extract a table from images in the desktop, Windows applications, and web pages on the Internet Explorer browser by using the OCR Read Table action in RPA Desktop Design Studio.
• Use the ActionSet OCR ClickText action
  Perform a mouse device action on a text in an image in the Internet Explorer browser or Windows applications by specifying the text using the OCR ClickText action.
• Use the ActionSet SendKeys action
  Set text or perform keyboard shortcuts on fields and elements on the desktop, Windows applications, and web pages on the Internet Explorer browser using the ActionSet Send Keys action in RPA Desktop Design Studio.
• Use the ActionSet Mouse action
  Do various mouse device actions on the desktop, Windows applications, and web pages on the Internet Explorer browser using the ActionSet Mouse action in RPA Desktop Design Studio.