How to remove validation errors from Process application when a toolkit dependency is removed and added again ?

Question

Hi All,

When a toolkit dependency from a process application is removed and added again. All the artifacts that were part of that particular toolkit becomes unreachable resulting in many validation errors.

How can we solve these errors? Kindly help with this situation.

Answer 1

When a toolkit dependency is removed, every artifact that referenced items of that toolkit keeps the old reference (a UUID with the toolkit's dependency id). Adding the same toolkit back creates a new dependency record, so the old references still point to nothing and the validation errors stay. Ways to clear them:

1. Re-point the references - open each artifact in the validation list, re-select the item (business object type, coach view, service) from the palette / picker and save. The designer rewrites the reference to the new dependency id. Tedious but safe; the validation panel double-click takes you to the exact artifact.
2. Use a different snapshot of the toolkit - if the dependency was added to another snapshot, Upgrade dependency (Process Designer > Toolkits > upgrade) re-maps references in bulk. Removing + adding does not.
3. Restore the dependency record - revert the process app to the snapshot taken before the dependency was removed (Process Center > snapshot > Revert to that snapshot / create a new snapshot from it). The old dependency id comes back and the references resolve again. This is the fastest fix when the removal is recent.
4. Export / fix / import - export the .twx, in META-INF/package.xml the <dependency> element carries the toolkit id; broken references in the object XML files contain the old dependency id - replace it with the new one with a script and import the twx as a new snapshot. Works, but only for people comfortable with the twx format.

Find the unreachable artifacts with the Process Center validation report (snapshot > Validation Errors and Warnings By Type) or the REST call GET /rest/bpm/wle/v1/snapshot/{snapshotId}?parts=validation which returns every error with the artifact id; the id maps to the library item in the designer URL ...#/library?id=....

References

• BAW documentation - managing toolkit dependencies
• Process REST API - snapshot resource