For a deeper look into our World Check One API, look into:

Overview |  Quickstart |  Documentation |  Downloads

question

Upvotes
Accepted
42 4 4 16

OGS Update management

Hello,

When using the SEQ-case-monitor-ogs how do we identify and manage the differences between the newly updated profile and the previous one ?

Best Regards

world-checkworld-check-one
icon clock
10 |1500

Up to 2 attachments (including images) can be used with a maximum of 5.0 MiB each and 10.0 MiB total.

Upvotes
Accepted
4.5k 4 7 8

@nabil.hassoumi,

In order to get the information on the updates of the profile, you need to use the API call - 'SEQ-case-investigate-world-check-profile: Get a World-Check profile'. From the response, you will have to check the dates in 'updatedDates' section to get the details of all the updates within a profile. It would look like below -

"updatedDates":

{
"ageUpdated": null,
"aliasesUpdated": "2017-11-07T00:00:00Z",
"alternativeSpellingUpdated": null,
"asOfDateUpdated": null,
"categoryUpdated": null,
"citizenshipsUpdated": null,
"companiesUpdated": "2018-11-29T00:00:00Z",
"deceasedUpdated": null,
"dobsUpdated": "2011-11-12T00:00:00Z",
"eiUpdated": null,
"enteredUpdated": null,
"externalSourcesUpdated": "2017-11-07T00:00:00Z",
"firstNameUpdated": null,
"foreignAliasUpdated": "2017-11-07T00:00:00Z",
"furtherInformationUpdated": "2018-11-29T00:00:00Z",
"idNumbersUpdated": "2017-11-07T00:00:00Z",
"keywordsUpdated": null,
"lastNameUpdated": "2008-04-11T00:00:00Z",
"linkedToUpdated": "2018-11-29T00:00:00Z",
"locationsUpdated": "2017-11-07T00:00:00Z",
"lowQualityAliasesUpdated": null,
"passportsUpdated": null,
"placeOfBirthUpdated": null,
"positionUpdated": null,
"ssnUpdated": null,
"subCategoryUpdated": "2010-09-02T00:00:00Z",
"titleUpdated": null,
"updatecategoryUpdated": "2018-10-23T00:00:00Z"
},

From the above example, the catagory which has been updated would have the corresponding date against it. As for the example from the above. Here, the value which has been updated is-

"companiesUpdated": "2018-11-29T00:00:00Z",

Hope this clarifies your concern.

icon clock
10 |1500

Up to 2 attachments (including images) can be used with a maximum of 5.0 MiB each and 10.0 MiB total.

Upvotes
4.5k 4 7 8

Hi @nabil.hassoumi,

Thank you for your query.

When you use the API call - 'SEQ-case-monitor-ogs: Monitor ongoing screening updates on cases', you get the response in the below format.
{
"providerType": null,
"caseSystemId": "0a3687d0-63f9-1f9b-9906-e424000c252a",
"numberOfNewResults": 1,
"numberOfUpdatedResults": 1,
"updateDate": "2018-11-29T19:37:40.992Z"
},


In the above snippet, response as you can see that we have a new match (

"numberOfNewResults") and an update on an existing match ("numberOfUpdatedResults"). To check for more details on the updates provided via Monitor OGS API call, you would have to use the API call - 'SEQ-case-investigate-results: Get screening results'.

In order to identify the match which has updates, please use the "updateDate" value, which is '2018-11-29T19:37:40' (for this example) and check in the result. The match which has updates would have - "reviewRequired" as true and the "modificationDate" would have the same value as the 'updateDate'. Below is the sample response from the API call - 'Get screening results' for the above 'caseSystemId'-

{
"resultId": "0a3687d0-63f9-1560-9906-e425000c7604",
"referenceId": "e_tr_wci_4XXXX3",
"matchStrength": "EXACT",
"matchedTerm": "XXXX",
"submittedTerm": "XXXX",
"matchedNameType": "PRIMARY",
"secondaryFieldResults": [],
"sources": [ "b_trwc_SOE" ],
"categories": ["PEP"],
"creationDate": "2018-06-20T05:00:17.480Z",
"modificationDate": "2018-11-29T19:37:40.786Z",
"resolution": null,
"resultReview": {
"reviewRequired": true,
"reviewRequiredDate": "2018-11-29T00:00:00.000Z",
"reviewRemark": null,
"reviewDate": null
}
}
In order to identify a new match, you would have to use the - "updateDate" value, which is '2018-11-29T19:37:40' (for this example) and check in the results. In the results, the "modificationDate" and "creationDate" would be the same as the "updateDate". If the "resolution" status for the match is null and the 'reviewRequired' is 'false', then the match is a new match. See Example below
{
"resultId": "0a3687cf-673a-1449-99d8-3e84007a6d71",
"referenceId": "e_tr_wci_4XXXXX3",
"matchStrength": "MEDIUM",
"matchedTerm": "XXXXYYY",
"submittedTerm": "XXXXX",
"matchedNameType": "PRIMARY",
"secondaryFieldResults": [],
"sources": ["b_trwc_SOE"],
"categories": ["PEP"],
"creationDate": "2018-11-29T19:37:40.854Z",
"modificationDate": "2018-11-29T19:37:40.854Z",
"resolution": null,
"resultReview": {
"reviewRequired": false,
"reviewRequiredDate": "2018-11-29T00:00:00.000Z",
"reviewRemark": null,
"reviewDate": null
}
}

Hope this clarifies your concern.

icon clock
10 |1500

Up to 2 attachments (including images) can be used with a maximum of 5.0 MiB each and 10.0 MiB total.

Upvotes
42 4 4 16

HI Prabhjyot,

Thank you for your answer. Actually what I was asking for is :How do I identify the fields that were updated ? For example: If the profile was only belonging to PEP category and with the update he becomes sanctioned on a list, how do I capture that the sanction list is new.

Best Regards

Nabil

icon clock
10 |1500

Up to 2 attachments (including images) can be used with a maximum of 5.0 MiB each and 10.0 MiB total.

Click below to post an Idea Post Idea