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

Overview |  Quickstart |  Documentation |  Downloads

question

Upvotes
Accepted
42 11 17 18

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 512.0 KiB each and 1.0 MiB total.

@nabil.hassoumi, thank you for your participation in the forum. Are any of the replies below satisfactory in resolving your query? If yes please click the 'Accept' text beneath the most appropriate reply. This will guide all community members who have a similar question. Otherwise please post again offering further insight into your question. Thanks, AHS

@nabil.hassoumi

Thank you for your participation in the forum. Is the reply below satisfactory in resolving your query? If so please can you click the 'Accept' text next to the appropriate reply. This will guide all community members who have a similar question.

Thanks,

AHS

@nabil.hassoumi, please be informed that a reply has been verified as correct in answering the question, and has been marked as such. Thanks, AHS

Upvotes
Accepted
4.5k 4 8 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 512.0 KiB each and 1.0 MiB total.

Upvotes
4.5k 4 8 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 512.0 KiB each and 1.0 MiB total.

Upvotes
42 11 17 18

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 512.0 KiB each and 1.0 MiB total.

Hi Nabil,


It is impossible by API, you need to store initial data, current data and then compute differences by yourself.

Write an Answer

Hint: Notify or tag a user in this post by typing @username.

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