Table of Contents

Search

  1. Preface
  2. Introduction to Informatica MDM - Relate 360
  3. Linking Batch Data
  4. Tokenizing Batch Data
  5. Processing Streaming Data
  6. Creating Relationship Graph
  7. Loading Linked and Consolidated Data into Hive
  8. Searching Data
  9. Monitoring the Batch Jobs
  10. Troubleshooting
  11. Glossary

User Guide

User Guide

Get Cluster Web Service

Get Cluster Web Service

The Get Cluster web service gets a list of records in a cluster based on the cluster identifier or the primary key column value of a record that is part of the cluster.
Before you run the Get Cluster web service, run the Get Cluster Layout web service to get the cluster layout in the JSON format for the configuration file. Based on the cluster layout, you can configure the input parameters for the Get Cluster web service.

Request URL

Use the POST method to run the Get Cluster web service.
To run the Get Cluster web service, use the following URL format:
http://<Host>:<Port>/<WAR File Name>/<Version Number>/<Configuration File Identifier>/GetCluster
For example:
http://localhost:8080/MDMBDRMSYS/
v5.0
/SYS/GetCluster

Request Header

Use the request header to specify the following headers:
Token
Required if you secure the RESTful web services. Authentication token that the Authenticate web service returns. If the token is not valid or you do not specify the
Token
header, the web service request uses the
Authorization
header.
Authorization
Required if you have secured the RESTful web services, but optional if you specify the
Token
header.
Type of authentication and the user credentials in the Base64 format. The RESTful web services use the HTTP basic authentication. Use the following format to specify the value for the
Authorization
header:
Basic <Encoded User Credentials>
Basic
indicates the HTTP basic authentication, and
Encoded User Credentials
indicates the Base64 format of the user name and password separated by a colon. For example,
Authorization: Basic dGVzdDpUZXN0
Accept
Format of the response. The supported response format is JSON. Specify
application/json
as the header value.
Content-Type
Format of the request body. The supported format is JSON. Specify
application/json
as the header value.

Request Body

Use the following layout for the Get Cluster web service:
{ "clusterinput":{ "<Name of the column that stores cluster identifiers>":"<Cluster ID>" }, "completeDetails":true, "searchToken":-1, "pageLimit":10, "pageOffset":0, "sortField":"" }
The layout includes the following parameters:
clusterinput
Lists the details of the cluster for which you want to retrieve all the records that belong to the cluster.
Use the following format to specify the cluster details:
"<Name of the column that stores cluster identifiers >":"<Cluster ID>"
In the configuration file, under the MetaData section, the
CLUSTER_COLUMN_NAME
parameter displays the name of the column that stores the cluster identifier.
completeDetails
Indicates whether to retrieve the complete details of each record or only the source and the primary key value of each record. Set to true to retrieve the complete details of each record. Default is false.
searchToken
Optional. Indicates whether to enable pagination for the search results when you perform a search for the first time. If you enable pagination, the search request returns a token with the search results. You can use the token in the subsequent requests to get the search results from cache to avoid performing the search again.
When you run a search request for the first time, set
searchToken=0
to enable pagination. In the subsequent requests, you can use the token that the search request returns. For example,
searchToken=1994262671816343815
. Set
searchToken=-1
to disable pagination. By default, pagination is disabled.
pageLimit
Optional. Maximum number of search results to return. The
pageLimit
parameter is applicable if you enable pagination. For example,
pageLimit=20
returns 20 search results. Default is 10.
pageOffset
Optional. Number of search results to skip. The
pageOffset
parameter is applicable if you enable pagination. For example,
pageOffset=40
indicates to skip the first 40 search results and return search results starting from 41. Default is 0.
sortField
Optional. Column name based on which you want to sort the search results lexicographically. You can use one of the columns that you define in the PZMAP section of the configuration file to sort the search results. You can also use the parameter value as
score
to sort the results in the descending order of the search result scores. For example,
"sortField":"score"
.
The following sample cluster layout retrieves all the records that are part of the cluster, ffcdf6d7-4122-4813-86ea-7999dda4f481:
{ "clusterinput": { "CLUSTERNUMBER": "ffcdf6d7-4122-4813-86ea-7999dda4f481" }, "completeDetails" : true, "searchToken" : 0, "pageLimit": 4, "resultlimit" : 10, "pageOffset": 0, "sortField" : "ID" }

Sample Response

The following sample response lists the records that are part of the cluster, ffcdf6d7-4122-4813-86ea-7999dda4f481:
{ "sortField":"ID", "searchType":"", "resultlimit":0, "scoreThreshold":0, "ignoreMatch":false, "searchinput":{ }, "searchlayout":{ }, "searchResults":[ { "SALARY":"10001", "CITY":"Bangalore", "CLUSTERNUMBER":"ffcdf6d7-4122-4813-86ea-7999dda4f481 ", "ADDRESS":"Bagmane TechPark", "PHONE":"08040201000", "SOURCE":"SAP", "ID":" 1", "PINCODE":"560103", "DOJ":"2012", "NAME":"John Smith", "COMPANY":"INFA" }, { "SALARY":"10000", "CITY":"Bangalore", "CLUSTERNUMBER":"ffcdf6d7-4122-4813-86ea-7999dda4f481 ", "ADDRESS":"Bagmane TechPark", "PHONE":"08040201001", "SOURCE":"Salesforce", "ID":" 2", "PINCODE":"560103", "DOJ":"2012", "NAME":"John Smith", "COMPANY":"INFA", "AGE":"30" }, { "SALARY":"10000", "CITY":"Bangalore", "CLUSTERNUMBER":"ffcdf6d7-4122-4813-86ea-7999dda4f481 ", "ADDRESS":"Bagmane TechPark", "PHONE":"08040201000", "SOURCE":"Baan", "ID":" 3", "PINCODE":"560103", "DOJ":"2013", "NAME":"John Smith", "COMPANY":"INFA", "AGE":"30" }, { "SALARY":"10001", "CITY":"Bangalore", "CLUSTERNUMBER":"ffcdf6d7-4122-4813-86ea-7999dda4f481 ", "ADDRESS":"Bagmane TechPark", "PHONE":"08040201001", "SOURCE":"SAP", "ID":" 4", "PINCODE":"560103", "DOJ":"2012", "NAME":"John Smith", "COMPANY":"INFA", "AGE":"31" } ], "searchToken":1837122831, "pageLimit":4, "pageOffset":0, "totalCount":30, "prSearchType":"", "completeDetails":true, "debug":false, "resultCount":4, "messages":{ "Message.1":"Fresh Token generated" } }

0 COMMENTS

We’d like to hear from you!