Templates
Rebuild the templates that generate new business first. Test fields, attachment logic, routing, authority and the exact language version used by the process owner.
Calling a move “document export” hides the work that determines whether the business can keep signing. Templates encode fields, roles, approvals and language choices. Integrations encode authentication, events and system ownership. In-flight agreements have a deadline and active participants. Historical agreements carry retention and evidence responsibilities. These assets should not share one cutover date simply because they all originated in the same platform.
Rebuild the templates that generate new business first. Test fields, attachment logic, routing, authority and the exact language version used by the process owner.
Map every triggering system, callback, failure queue and record identifier. The objective is not API parity; it is reliable handoff to the system that owns the commercial, employee or supplier record.
Decide a date after which new transactions use the target workflow. For documents already in signature, define whether they finish in the legacy platform or are restarted using a controlled communication path.
Separate completed records from active production work. Define who retains them, how authorised teams retrieve them and how the business record will continue to point to the archive.
Parallel running is useful when it protects active business, but it becomes dangerous when users can choose either system without rules. Establish a cutover boundary by template, entity or document type. Tell senders which platform is authoritative for new transactions, name the owner who resolves exceptions, and monitor the two queues separately. A successful transition is not two systems operating forever; it is a shrinking, governed legacy queue with an exit condition.
The most damaging failures occur after a signature event seems complete: a callback is missed, a template creates the wrong document version, an approver cannot act, or a record reaches an archive without its business reference. For each critical workflow, define the detection signal, the owner, the recovery action, the maximum time to restore the record and the point at which the transaction must be restarted. This makes rollback a controlled decision rather than a late-night rescue.
| Ledger field | Why it matters | |
|---|---|---|
| Workflow and owner | Names the template, entity, process owner and technical owner so no task becomes anonymous. | |
| Source and target record | Connects the legacy template or agreement to the replacement workflow and business-system reference. | |
| Acceptance evidence | Records the completed sample, system handoff, evidence retrieval result and reviewer. | |
| Cutover and rollback rule | States when new work moves, what stays legacy, and the trigger for recovery or restart. | |
| Archive responsibility | Names the retention location, access owner and retrieval test for completed agreements. |
Move a workflow when the process owner can complete a representative transaction, the connected system receives the correct outcome, and the records owner can retrieve a complete sample afterwards. If any one of those three conditions fails, the issue is not “post-launch optimization”; it is a missing production acceptance criterion. Fix it before expanding to the next template or entity.
Start with one high-value active workflow that has a clear owner and measurable system outcome. It creates a reusable pattern for later templates without forcing historical archive decisions into the first release.
