Async reconciliation Sample

---------------------------

Copyright (c) 2012 ForgeRock AS

This work is licensed under a Creative Commons Attribution-

NonCommercial-NoDerivs 3.0 Unported License. See

This sample demonstrates how to perform an asynchronous action from a

reconciliation.

For documentation pertaining to this example see:

http://openidm.forgerock.org/doc/install-guide/index.html#more-sample9

To try the sample, follow these steps.

1. Start OpenIDM with the configuration for sample 9.

$ cd /path/to/openidm

$ ./startup.sh -p samples/sample9

2. Run reconciliation.

$ curl -k -u openidm-admin:openidm-admin -X POST "https://localhost:8443/openidm/recon?_action=recon&mapping=systemXmlfileAccounts_managedUser"

4. The reconciliation starts an approval workflow for each ABSENT user.

These workflows (managedUserApproval) wait for approval.

5. Query the started workflow task instances.

$ curl -k -u openidm-admin:openidm-admin "https://localhost:8443/openidm/workflow/taskinstance?_queryId=query-all-ids"

sample response:

{"result":[

{"createTime":"2014-02-19T12:45:21.256+01:00","suspensionState":1,"executionId":"4",

"assignee":"openidm-admin","cachedElContext":null,"delegationStateString":null,

"activityInstanceVariables":{},"deleted":false,"suspended":false,"_rev":1,"revisionNext":2,

"processInstanceId":"4","_id":"16","priority":50,"description":null,"taskDefinitionKey":"evaluateRequest",

"name":"Evaluate request","owner":null,"eventName":null,"processDefinitionId":"managedUserApproval:1:3",

"parentTaskId":null,"dueDate":null,"delegationState":null}

],"resultCount":1,"pagedResultsCookie":null,"remainingPagedResults":-1}

6. Approve the request.

$ curl -k -u openidm-admin:openidm-admin -X POST "https://localhost:8443/openidm/workflow/taskinstance/16?_action=complete" --data '{"requestApproved": "true"}' -H "Content-Type: application/json"

7. Query the managed users created by the asynchronous reconciliation after

the approval step.

$ curl -k -u openidm-admin:openidm-admin "https://localhost:8443/openidm/managed/user?_queryId=query-all-ids"

sample response:

{"result":[{"_id":"1","_rev":"0"}],"resultCount":1,"pagedResultsCookie":null,"remainingPagedResults":-1}

To test the sample you might want to copy the following into an executable text file and run it:

curl -k -u openidm-admin:openidm-admin -X POST "https://localhost:8443/openidm/recon?_action=recon&mapping=systemXmlfileAccounts_managedUser"

sleep 3

echo ""

curl -k -u openidm-admin:openidm-admin "https://localhost:8443/openidm/workflow/taskinstance?_queryId=query-all-ids"

echo ""

echo "now run the following after replacing XX with the taskinstanceNumber (the _id property) from above!"

echo 'curl -k -u openidm-admin:openidm-admin -X POST "https://localhost:8443/openidm/workflow/taskinstance/XX?_action=complete" -H "Content-Type: application/json" --data '\''{"requestApproved": "true"}'\'