You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
ORPA-pyOpenRPA/Wiki/ENG_Guide/markdown/Agent/02_Defs.md

3.7 KiB

2. Defs

pyOpenRPA.Agent.Agent

Functions:

| OSCMD(inCMDStr[, inRunAsyncBool, …])

| Execute CMD on the Agent daemonic process

| | OSFileBinaryDataBase64StrCreate(…[, …])

| Create binary file by the base64 string (safe for JSON transmition)

| | OSFileBinaryDataBase64StrReceive(inFilePathStr)

| Read binary file and encode in base64 to transmit (safe for JSON transmition)

| | OSFileTextDataStrCreate(inFilePathStr, …)

   | Create text file in the agent GUI session

                                 |

| OSFileTextDataStrReceive(inFilePathStr[, …])

| Read text file in the agent GUI session

                                   |

| ProcessWOExeUpperUserListGet()

              | Return the process list only for the current user (where Agent is running) without .EXE in upper case.

|

pyOpenRPA.Agent.Agent.OSCMD(inCMDStr, inRunAsyncBool=True, inGSettings=None, inSendOutputToOrchestratorLogsBool=True, inCMDEncodingStr='cp1251')

Execute CMD on the Agent daemonic process

  • Parameters

    • inCMDStr command to execute on the Agent session

    • inRunAsyncBool True - Agent processor dont wait execution; False - Agent processor wait cmd execution

    • inGSettings Agent global settings dict

    • inSendOutputToOrchestratorLogsBool True - catch cmd execution output and send it to the Orchestrator logs; Flase - else case; Default True

!ATTENTION! If you need to start absolutely encapsulated app - set this flag as False. If you set True - the app output will come to Agent :param inCMDEncodingStr: Set the encoding of the DOS window on the Agent server session. Windows is beautiful :) . Default is “cp1251” early was “cp866” - need test :return:

pyOpenRPA.Agent.Agent.OSFileBinaryDataBase64StrCreate(inFilePathStr, inFileDataBase64Str, inGSettings=None)

Create binary file by the base64 string (safe for JSON transmition)

pyOpenRPA.Agent.Agent.OSFileBinaryDataBase64StrReceive(inFilePathStr, inGSettings=None)

Read binary file and encode in base64 to transmit (safe for JSON transmition)

  • Parameters

    • inFilePathStr File path to read

    • inGSettings global settings of the Agent (singleton)

  • Returns

    File content in string base64 format (use base64.b64decode to decode data). Return None if file is not exist

pyOpenRPA.Agent.Agent.OSFileTextDataStrCreate(inFilePathStr, inFileDataStr, inEncodingStr='utf-8', inGSettings=None)

Create text file in the agent GUI session

  • Parameters

    • inFilePathStr File abs path

    • inFileDataStr File data text content

    • inEncodingStr Write file encoding

    • inGSettings global settings of the Agent (singleton)

  • Returns

pyOpenRPA.Agent.Agent.OSFileTextDataStrReceive(inFilePathStr, inEncodingStr='utf-8', inGSettings=None)

Read text file in the agent GUI session

  • Parameters

    • inFilePathStr File abs path

    • inEncodingStr Read file encoding. Default utf-8

    • inGSettings global settings of the Agent (singleton)

  • Returns

    File text content in string format (use base64.b64decode to decode data). Return None if file is not exist

pyOpenRPA.Agent.Agent.ProcessWOExeUpperUserListGet()

Return the process list only for the current user (where Agent is running) without .EXE in upper case. Can use in ActivityItem from Orchestrator to Agent

  • Parameters

    inProcessNameWOExeList

  • Returns

    list of the agent user process in upper case without .EXE. Example [“NOTEPAD”,”…”],

References

reStructuredText