| Both sides previous revision Previous revision | |
| public:99_annexes:annex-b-terms-and-definitions:e:executable_instruction [2026/09/12 17:42] – ↷ Page moved from private:99_annexes:annex-b-terms-and-definitions:e:executable_instruction to public:99_annexes:annex-b-terms-and-definitions:e:executable_instruction nick_dido | public:99_annexes:annex-b-terms-and-definitions:e:executable_instruction [2026/09/12 17:43] (current) – ↷ Links adapted because of a move operation nick_dido |
|---|
| ====== Executable Instruction ====== | ====== Executable Instruction ====== |
| |
| [[private:99_annexes:annex-b-terms-and-definitions:start|Go up to Terms and Definitions]] | [[public:99_annexes:annex-b-terms-and-definitions:start|Go up to Terms and Definitions]] |
| |
| ===== Discussion ===== | ===== Discussion ===== |
| |
| An Executable Instruction specifies an operation in a form that an [[private:99_annexes:annex-b-terms-and-definitions:e:execution_facility|Execution Facility]] can interpret or perform. | An Executable Instruction specifies an operation in a form that an [[public:99_annexes:annex-b-terms-and-definitions:e:execution_facility|Execution Facility]] can interpret or perform. |
| |
| An Executable Instruction can implement: | An Executable Instruction can implement: |
| * An action | * An action |
| * A calculation | * A calculation |
| * A [[private:99_annexes:annex-b-terms-and-definitions:v:validation|Validation]] | * A [[public:99_annexes:annex-b-terms-and-definitions:v:validation|Validation]] |
| * A communication | * A communication |
| * A state transition | * A state transition |
| * Its name | * Its name |
| * Its description | * Its description |
| * Its [[private:99_annexes:annex-b-terms-and-definitions:v:version|Version]] | * Its [[public:99_annexes:annex-b-terms-and-definitions:v:version|Version]] |
| * Its instruction type | * Its instruction type |
| * Its language or format | * Its language or format |
| * Its operation | * Its operation |
| * Its applicable [[private:99_annexes:annex-b-terms-and-definitions:t:test_argument|Test Arguments]] | * Its applicable [[public:99_annexes:annex-b-terms-and-definitions:t:test_argument|Test Arguments]] |
| * Its applicable [[private:99_annexes:annex-b-terms-and-definitions:t:test_argument_value|Test Argument Values]] | * Its applicable [[public:99_annexes:annex-b-terms-and-definitions:t:test_argument_value|Test Argument Values]] |
| * Its required inputs | * Its required inputs |
| * Its produced outputs | * Its produced outputs |
| * Its required dependencies | * Its required dependencies |
| * Its required [[private:99_annexes:annex-b-terms-and-definitions:e:execution_facility|Execution Facilities]] | * Its required [[public:99_annexes:annex-b-terms-and-definitions:e:execution_facility|Execution Facilities]] |
| * Its applicable [[private:99_annexes:annex-b-terms-and-definitions:t:test_item|Test Items]] | * Its applicable [[public:99_annexes:annex-b-terms-and-definitions:t:test_item|Test Items]] |
| * Its applicable [[private:99_annexes:annex-b-terms-and-definitions:t:test_environment|Test Environments]] | * Its applicable [[public:99_annexes:annex-b-terms-and-definitions:t:test_environment|Test Environments]] |
| * Its preconditions | * Its preconditions |
| * Its completion condition | * Its completion condition |
| * Its failure condition | * Its failure condition |
| * Its timeout | * Its timeout |
| * Its applicable [[private:99_annexes:annex-b-terms-and-definitions:g:governance_policy|Governance Policies]] | * Its applicable [[public:99_annexes:annex-b-terms-and-definitions:g:governance_policy|Governance Policies]] |
| * Its [[private:99_annexes:annex-b-terms-and-definitions:p:provenance|Provenance]] | * Its [[public:99_annexes:annex-b-terms-and-definitions:p:provenance|Provenance]] |
| * Its [[private:99_annexes:annex-b-terms-and-definitions:t:traceability|Traceability]] | * Its [[public:99_annexes:annex-b-terms-and-definitions:t:traceability|Traceability]] |
| |
| A [[private:99_annexes:annex-b-terms-and-definitions:t:test_executable|Test Executable]] contains or references one or more Executable Instructions that implement a test action or [[private:99_annexes:annex-b-terms-and-definitions:v:validation|Validation]]. | A [[public:99_annexes:annex-b-terms-and-definitions:t:test_executable|Test Executable]] contains or references one or more Executable Instructions that implement a test action or [[public:99_annexes:annex-b-terms-and-definitions:v:validation|Validation]]. |
| |
| A Test Executable can contain the Executable Instructions directly or reference an independently maintained [[private:99_annexes:annex-b-terms-and-definitions:e:executable_artifact|Executable Artifact]] that contains them. | A Test Executable can contain the Executable Instructions directly or reference an independently maintained [[public:99_annexes:annex-b-terms-and-definitions:e:executable_artifact|Executable Artifact]] that contains them. |
| |
| An [[private:99_annexes:annex-b-terms-and-definitions:e:execution_facility|Execution Facility]] interprets or performs the Executable Instructions during [[private:99_annexes:annex-b-terms-and-definitions:t:test_execution|Test Execution]]. | An [[public:99_annexes:annex-b-terms-and-definitions:e:execution_facility|Execution Facility]] interprets or performs the Executable Instructions during [[public:99_annexes:annex-b-terms-and-definitions:t:test_execution|Test Execution]]. |
| |
| ===== Definition ===== | ===== Definition ===== |
| |
| //instruction expressed in a form that an [[private:99_annexes:annex-b-terms-and-definitions:e:execution_facility|Execution Facility]] can interpret or perform// | //instruction expressed in a form that an [[public:99_annexes:annex-b-terms-and-definitions:e:execution_facility|Execution Facility]] can interpret or perform// |
| |
| ===== Source ===== | ===== Source ===== |
| |
| * [[https://www.omg.org/spec/TestIF/1.0/Beta3/PDF|OMG Test Information Interchange Format (TestIF), Version 1.0 Beta 3, Section 7.3.7, TestExecutable]] | * [[https://www.omg.org/spec/TestIF/1.0/Beta3/PDF|OMG Test Information Interchange Format (TestIF), Version 1.0 Beta 3, Section 7.3.7, TestExecutable]] |
| * [[private:99_annexes:annex-b-terms-and-definitions:t:test_executable|Test Executable]] | * [[public:99_annexes:annex-b-terms-and-definitions:t:test_executable|Test Executable]] |
| * [[private:99_annexes:annex-b-terms-and-definitions:t:test_step|Test Step]] | * [[public:99_annexes:annex-b-terms-and-definitions:t:test_step|Test Step]] |
| * [[private:99_annexes:annex-b-terms-and-definitions:t:test_execution|Test Execution]] | * [[public:99_annexes:annex-b-terms-and-definitions:t:test_execution|Test Execution]] |
| * DIDO Reference Implementation Conceptual Model | * DIDO Reference Implementation Conceptual Model |
| * DIDO-TE draft Requirements Register | * DIDO-TE draft Requirements Register |
| OMG TestIF does not define Executable Instruction as a separate TestIF model element. This definition introduces Executable Instruction to distinguish an instruction from: | OMG TestIF does not define Executable Instruction as a separate TestIF model element. This definition introduces Executable Instruction to distinguish an instruction from: |
| |
| * The [[private:99_annexes:annex-b-terms-and-definitions:t:test_step|Test Step]] that specifies the required test action or Validation | * The [[public:99_annexes:annex-b-terms-and-definitions:t:test_step|Test Step]] that specifies the required test action or Validation |
| * The [[private:99_annexes:annex-b-terms-and-definitions:t:test_executable|Test Executable]] that contains or references the instruction | * The [[public:99_annexes:annex-b-terms-and-definitions:t:test_executable|Test Executable]] that contains or references the instruction |
| * The [[private:99_annexes:annex-b-terms-and-definitions:e:executable_artifact|Executable Artifact]] that stores or packages the instruction | * The [[public:99_annexes:annex-b-terms-and-definitions:e:executable_artifact|Executable Artifact]] that stores or packages the instruction |
| * The [[private:99_annexes:annex-b-terms-and-definitions:e:execution_facility|Execution Facility]] that interprets or performs the instruction | * The [[public:99_annexes:annex-b-terms-and-definitions:e:execution_facility|Execution Facility]] that interprets or performs the instruction |
| |
| ===== Note ===== | ===== Note ===== |
| Every Executable Instruction expresses an operation in a form that an identified Execution Facility can interpret or perform. | Every Executable Instruction expresses an operation in a form that an identified Execution Facility can interpret or perform. |
| |
| An Executable Instruction differs from a [[private:99_annexes:annex-b-terms-and-definitions:t:test_step|Test Step]]: | An Executable Instruction differs from a [[public:99_annexes:annex-b-terms-and-definitions:t:test_step|Test Step]]: |
| |
| * A Test Step specifies a test action or Validation independently of a particular execution mechanism | * A Test Step specifies a test action or Validation independently of a particular execution mechanism |
| * An Executable Instruction provides part or all of the executable realization of that action or Validation | * An Executable Instruction provides part or all of the executable realization of that action or Validation |
| |
| An Executable Instruction differs from a [[private:99_annexes:annex-b-terms-and-definitions:t:test_executable|Test Executable]]: | An Executable Instruction differs from a [[public:99_annexes:annex-b-terms-and-definitions:t:test_executable|Test Executable]]: |
| |
| * An Executable Instruction specifies an operation | * An Executable Instruction specifies an operation |
| * A Test Executable contains, organizes, or references one or more Executable Instructions | * A Test Executable contains, organizes, or references one or more Executable Instructions |
| |
| An Executable Instruction differs from an [[private:99_annexes:annex-b-terms-and-definitions:e:executable_artifact|Executable Artifact]]: | An Executable Instruction differs from an [[public:99_annexes:annex-b-terms-and-definitions:e:executable_artifact|Executable Artifact]]: |
| |
| * An Executable Instruction specifies an operation | * An Executable Instruction specifies an operation |
| * An Executable Artifact stores, packages, or provides one or more Executable Instructions | * An Executable Artifact stores, packages, or provides one or more Executable Instructions |
| |
| An Executable Instruction differs from an [[private:99_annexes:annex-b-terms-and-definitions:e:execution_facility|Execution Facility]]: | An Executable Instruction differs from an [[public:99_annexes:annex-b-terms-and-definitions:e:execution_facility|Execution Facility]]: |
| |
| * An Executable Instruction specifies the operation | * An Executable Instruction specifies the operation |
| * Associated with a particular programming language | * Associated with a particular programming language |
| |
| A change to an Executable Instruction’s operation, inputs, outputs, parameters, control flow, dependencies, expected behavior, or execution requirements can create a new [[private:99_annexes:annex-b-terms-and-definitions:v:version|Version]] under the applicable versioning policy. | A change to an Executable Instruction’s operation, inputs, outputs, parameters, control flow, dependencies, expected behavior, or execution requirements can create a new [[public:99_annexes:annex-b-terms-and-definitions:v:version|Version]] under the applicable versioning policy. |
| |
| A reproducible [[private:99_annexes:annex-b-terms-and-definitions:t:test_run|Test Run]] should identify the exact Versions of the Executable Instructions and referenced Executable Artifacts used during [[private:99_annexes:annex-b-terms-and-definitions:t:test_execution|Test Execution]]. | A reproducible [[public:99_annexes:annex-b-terms-and-definitions:t:test_run|Test Run]] should identify the exact Versions of the Executable Instructions and referenced Executable Artifacts used during [[public:99_annexes:annex-b-terms-and-definitions:t:test_execution|Test Execution]]. |
| |
| ===== Example ===== | ===== Example ===== |
| |
| A [[private:99_annexes:annex-b-terms-and-definitions:t:test_step|Test Step]] requires a [[private:99_annexes:annex-b-terms-and-definitions:n:node|Node]] to submit a proposed transaction through a specified [[private:99_annexes:annex-b-terms-and-definitions:e:endpoint|Endpoint]]. | A [[public:99_annexes:annex-b-terms-and-definitions:t:test_step|Test Step]] requires a [[public:99_annexes:annex-b-terms-and-definitions:n:node|Node]] to submit a proposed transaction through a specified [[public:99_annexes:annex-b-terms-and-definitions:e:endpoint|Endpoint]]. |
| |
| A [[private:99_annexes:annex-b-terms-and-definitions:t:test_executable|Test Executable]] references a versioned script containing Executable Instructions that: | A [[public:99_annexes:annex-b-terms-and-definitions:t:test_executable|Test Executable]] references a versioned script containing Executable Instructions that: |
| |
| * Read the applicable [[private:99_annexes:annex-b-terms-and-definitions:t:test_argument_value|Test Argument Values]] | * Read the applicable [[public:99_annexes:annex-b-terms-and-definitions:t:test_argument_value|Test Argument Values]] |
| * Establish a connection to the Endpoint | * Establish a connection to the Endpoint |
| * Submit the proposed transaction | * Submit the proposed transaction |
| * Record the transaction identifier | * Record the transaction identifier |
| * Return the submission status | * Return the submission status |
| * Preserve the resulting [[private:99_annexes:annex-b-terms-and-definitions:e:evidence|Evidence]] | * Preserve the resulting [[public:99_annexes:annex-b-terms-and-definitions:e:evidence|Evidence]] |
| |
| During Test Execution, the applicable [[private:99_annexes:annex-b-terms-and-definitions:e:execution_facility|Execution Facility]] interprets or performs the Executable Instructions. | During Test Execution, the applicable [[public:99_annexes:annex-b-terms-and-definitions:e:execution_facility|Execution Facility]] interprets or performs the Executable Instructions. |
| |
| The [[private:99_annexes:annex-b-terms-and-definitions:t:test_run|Test Run]] records: | The [[public:99_annexes:annex-b-terms-and-definitions:t:test_run|Test Run]] records: |
| |
| * The Test Executable identity | * The Test Executable identity |
| * The Executable Artifact digest | * The Executable Artifact digest |
| * The applicable Test Argument Values | * The applicable Test Argument Values |
| * The applicable [[private:99_annexes:annex-b-terms-and-definitions:t:test_environment|Test Environment]] | * The applicable [[public:99_annexes:annex-b-terms-and-definitions:t:test_environment|Test Environment]] |
| * The resulting [[private:99_annexes:annex-b-terms-and-definitions:t:test_result|Test Result]] | * The resulting [[public:99_annexes:annex-b-terms-and-definitions:t:test_result|Test Result]] |
| * The supporting Evidence | * The supporting Evidence |
| |