0 votes
1.1k views
in Integrations by (30.6k points)

1 Answer

0 votes
by (30.6k points)

An external implementation is a BPD activity whose work is done by an external application instead of a human service or a system service. BPM creates the task, marks it as "external" and waits; the external application discovers the task through the REST API, does the work in its own UI / logic and completes it with the output data. It is the mechanism behind custom portals and "headless" task UIs (Angular / React apps, mobile apps, SharePoint).

  1. In Process Designer, add an External Activity artifact (library > User Interface > External Activity) with input / output variables and the location of the external UI (a URL, informational).
  2. Set the BPD activity's implementation to External Implementation and select that artifact; map the variables.
  3. The external application polls or is notified (task assignment e-mail, Process Portal, or a UCA-driven push), reads the task and completes it:
# task details incl. the external activity data
GET /rest/bpm/wle/v1/task/{taskId}?parts=data,externalActivity
# ... the external app renders its own form with data.data.variables ...
# complete the task with output values
PUT /rest/bpm/wle/v1/task/{taskId}?action=finish&params={"decision":"APPROVED","comment":"ok"}
# or claim first: PUT /rest/bpm/wle/v1/task/{taskId}?action=assign&toMe=true

When to use it: your organisation already has a task UI framework, tasks must be completed by another system (a CRM screen), or you want the BPD to stay clean of UI technology. When not: normal user tasks - a client-side human service is far less work and gets the portal features (claim, due dates, comments, collaboration) for free.

Related: external services (REST / SOAP / Java integrations) are the opposite direction - BPM calls out; an external implementation is BPM waiting for someone else to call in.

References

Related questions

0 votes
1 answer 2.5k views
0 votes
1 answer 2.3k views
0 votes
1 answer 2.8k views
asked Jan 4, 2019 in Portal by anonymous
0 votes
1 answer 948 views
0 votes
1 answer 1.5k views
0 votes
1 answer 882 views
0 votes
1 answer 1.4k views

723 questions

807 answers

98 comments

4.9k users

Join BPM Community Discord Channel

Welcome to BPM Tips Q&A, Community wiki/forum where you can ask questions and receive answers from other IBM BPM experts and members of the community. Users with 2000 points will automatically be promoted to expert level.
Created by Dosvak LLC
Our Youtube Channel
...