Primo.1C.Automation.Linux 1.0.3

About

Primo.1C.Automation.Linux is a set of ready-to-use activities for Primo RPA Studio designed to automate the user interface of 1C:Enterprise 8 through the automated-testing mechanism built into the platform. It addresses the need to drive 1C managed forms reliably, without UI selectors, image recognition or screen coordinates, and without changing the 1C configuration. Key activities include: connecting to a 1C test client, setting and reading values of form elements, clicking buttons, reading table fields, and executing form commands and built-in-language scripts. The package can be added to any Primo RPA Studio project via the built-in dependency manager.

Only managed forms are supported: ordinary forms are outside the automated-testing API. The 1C user must be allowed to run external data processors, and the platform must allow a test connection.

How to Use

In Primo RPA Studio, create a project that will be executed by the Primo RPA Robot. Install this package via the ".Dependencies → Manage Dependencies" menu; the "1C" node with package elements will appear in the Elements tree.

The "1C: Connect" element is a container for all other elements. It starts the 1C test client and test manager, or attaches to already running ones, and holds the connection for the elements placed inside it. The driver is shipped inside the package, so no separate EPF file is needed.

Elements

Available elements:

• 1C: Connect — starts or attaches to the 1C test client and test manager. Container for the elements below.
• 1C: Check Connection, 1C: Disconnect — verify that the connection is alive, or close it.
• 1C: Get Current Form, 1C: Get Form Elements, 1C: Close Form — read the active form, enumerate the elements of a form as a tree or a DataTable, close a form.
• 1C: Wait for Object, 1C: Check Object Exists, 1C: Navigate — wait for a form element to appear, check for it without waiting, follow a navigation link or interface command.
• 1C: Set Element Value, 1C: Set Checkbox Value, 1C: Read Text, 1C: Compare Text, 1C: Click Element — input, reading and verification for form fields and buttons.
• 1C: Read Table, 1C: Read Table Cell, 1C: Select Table Row, 1C: Click Table Cell, 1C: Find Value in Table — work with table fields.
• 1C: Execute Script, 1C: Execute Query — run built-in-language code in the client or server context, or a 1C query that returns a DataTable.
• 1C: Send Keys, 1C: Click at Position — keyboard and coordinate fallbacks for cases the automated-testing API does not cover.

Key Features

• Automation of 1C:Enterprise 8 managed forms through the native automated-testing API
• No changes to the 1C configuration and no separate EPF file: the driver ships inside the package
• Element picker that lists open forms and shows their elements as a tree
• Table reading in whole-table or row-by-row mode, with column selection
• Execution of built-in-language scripts in the client or server context and of 1C queries
• Compatible with Primo RPA Studio 1.26.9 and earlier (Avalonia 11)
• Supports .NET 8+

Main Types

• Primo.Automation1C.Elements.WFConnect
• Primo.Automation1C.Elements.WFCheckConnection
• Primo.Automation1C.Elements.WFSetElementValue
• Primo.Automation1C.Elements.WFReadElementText
• Primo.Automation1C.Elements.WFClickElement
• Primo.Automation1C.Elements.WFReadTable
• Primo.Automation1C.Elements.WFExecuteScript
• Primo.Automation1C.Elements.WFExecuteQuery
• Primo.Automation1C.Model.OneSClient

Feedback

Bug reports and contributions are welcome at Primo RPA chat