Dynamic Field Injection

Overview

The injection configuration feature in 3270Connect allows users to dynamically inject data into workflows. This is particularly useful for scenarios where workflows need to be parameterized or customized based on external inputs.

Configuration Format

The injection configuration is defined in a JSON file. Below is an example structure:

[
    {
      "{{firstname}}": "user1-firstname",
      "{{lastname}}": "user1-lastname"
    },
    {
      "{{firstname}}": "user2-firstname",
      "{{lastname}}": "user2-lastname"
    }
]

The workflow configuration is then define to use the key names of the injection configuration file. Below is an example structure:

  "Steps": [
    {
      "Type": "FillString",
      "Coordinates": {"Row": 5, "Column": 21},
      "Text": "{{firstname}}"
    },
    {
      "Type": "FillString",
      "Coordinates": {"Row": 6, "Column": 21},
      "Text": "{{lastname}}"
    }
  ]

Usage

To use an injection configuration file, pass it as a parameter when running 3270Connect:

3270Connect -config workflow.json -injectionConfig injection.json

Example

Here is an example of running a workflow with an injection configuration:

3270Connect -config workflow.json -injectionConfig injection.json

This will replace the specified fields in the workflow with the values provided in the injection configuration.

Conclusion

The injection configuration feature enhances the flexibility of 3270Connect by allowing workflows to be dynamically customized. This is especially useful for testing and automation scenarios where inputs vary across runs.