This page is for developers using EAL who need to invoke an action as part of a Remote Turnkey workflow.

Overview

RemoteTurnkeyExecuteAction is listed as a Remote Turnkey operator in the server-and-persistence section of Executable Action Language (EAL). EAL extends OCL with imperative operations that you use in actions, such as button actions and other executable contexts.

Use this operator only within a Remote Turnkey workflow. Remote Turnkey operators listed with it include operations to establish a session, exchange string or byte-array values, and close the session.

Remote Turnkey workflow

The available documentation identifies the following operator sequence. Confirm the required arguments and return values for each operator before implementing it.

1. Establish the remote session with RemoteTurnkeyConnectGetSessionKey.
2. Set any values required by the remote action with RemoteTurnkeySetStringValue or RemoteTurnkeySetByteArray.
3. Invoke RemoteTurnkeyExecuteAction.
4. Read values produced by the remote workflow with RemoteTurnkeyGetStringValue or RemoteTurnkeyGetByteArray.
5. End the remote session with RemoteTurnkeyCloseSession.

Usage status

The operator's call signature, required session-key format, action identifier format, result value, error behavior, and persistence behavior are not documented in the available sources. Do not infer these details from the operator name.

When this information is available, document:

• The complete EAL syntax and a copyable example.
• Each argument, including whether the session key is supplied and its expected type.
• The return type and how to detect a failed remote action.
• Whether values must be set before execution and where output values are retrieved.
• Whether the caller must always close the session, including failure handling.

Example workflow outline

The following is an implementation outline, not executable EAL syntax:

1. Connect and retain the returned session key.
2. Provide the remote action's input values.
3. Execute the remote action through RemoteTurnkeyExecuteAction.
4. Retrieve the action's output values.
5. Close the session when the workflow is complete.

Keep session setup, execution, output retrieval, and session closure together in the same EAL action so that the lifecycle is clear during maintenance.

See also

• Documentation:EAL
• Documentation:OCLOperators RemoteTurnkeyGetStringValue
• Documentation:OCLOperators RemoteTurnkeyGetByteArray
• Documentation:OCLOperators RemoteTurnkeyCloseSession