Workflow Steps
3 min
Workflows define the steps a connector follows to import, compare, and process data. Each workflow is stored as XML in a parameter on the connector resource.
The root element must be <workflow>.
Common Workflow Steps
Step | Description |
|---|---|
clearImport | Deletes all rows from the import table before a full load. |
import | Loads data into the import table from the source system. |
processImport | Compares import and data tables to detect changes. |
process | Processes detected changes through a change handler. |
execute | Runs a script. |
run | Executes another workflow. |
notify | Sends a notification email or message. |
publish / unpublish | Changes the publication state of provisioning objects. |
Example Workflow
<workflow>
<clearImport />
<import>
<provider>Innovation.Activate.Library\Innovation.Activate.Connectors.ImportText</provider>
<fileName>C:\Imports\departments.csv</fileName>
<header>true</header>
</import>
<processImport>
<maxChanges>1000</maxChanges>
</processImport>
<process>
<provider>Innovation.Activate.Library\Innovation.Activate.Connectors.RoleChangeHandler</provider>
</process>
</workflow>
Best Practices
- Always include clearImport before full imports to avoid stale data.
- Use processImport limits (maxChanges, maxDelete, maxCreate) to protect against bulk errors.
- Separate logical processes into multiple workflows where appropriate.
- Include notify steps for monitoring failures or large change counts.