ibm/mdm-java-sdk

Java SDK for MDM on IBM Cloud

IBM Cloud Master Data Management Java SDK Version 1.0.6

Java client library to interact with various IBM Cloud Master Data Management.

Disclaimer: this SDK is being released initially as a pre-release version. Changes might occur which impact applications that use this SDK.

Table of Contents

• Overview
• Prerequisites
• Installation
  • Maven
  • Gradle
• Using the SDK
• Questions
• Issues
• Open source @ IBM
• Contributing
• License

Overview

The IBM Cloud Master Data Management Java SDK allows developers to programmatically interact with the following IBM Cloud services:

Service Name	Artifact Coordinates
Master Data Management	com.ibm.cloud:mdm:1.0.6

Prerequisites

• An IBM Cloud account.
• An IAM API key to allow the SDK to access your account. Create one here.
• Java 8 or above.

Installation

The current version of this SDK is: 1.0.6

Each service's artifact coordinates are listed in the table above.

The project artifacts are published on the public Maven Central artifact repository. This is the default public repository used by maven when searching for dependencies. To use this repository within a gradle build, please see this link.

To use a particular service, define a dependency that contains the artifact coordinates (group id, artifact id and version) for the service. Here are examples for maven and gradle:

Maven

<dependency>
    <groupId>com.ibm.cloud</groupId>
    <artifactId>mdm</artifactId>
    <version>1.0.6</version>
</dependency>

Gradle

compile 'com.ibm.cloud:mdm:1.0.6'

Using the SDK

For general SDK usage information, please see this link

Questions

If you are having difficulties using this SDK or have a question about the IBM Cloud services, please ask a question at Stack Overflow.

Issues

If you encounter an issue with the project, you are welcome to submit a bug report. Before that, please search for similar issues. It's possible that someone has already reported the problem.

Open source @ IBM

Find more open source projects on the IBM Github Page

Contributing

See CONTRIBUTING.

License

The IBM Cloud Master Data Management Java SDK is released under the Apache 2.0 license. The license's full text can be found in LICENSE.

mdm-java-sdk's Issues

Edit Distance not working for searchMatchingIndex()

searchMatchingIndex() ( .details("low") )working fines if parameters are exact same.
But, if parameters with goes for edit distance . it's error

Goes good without error

Map<String , String> legalnames = new HashMap<String, String>();
		legalnames.put("given_name", "MARYAM");
		legalnames.put("last_name", "BREIDER");

If update the parameters as below and .details("high")

Map<String, Object> attributes_map = new HashMap<String, Object>();
		
		Map<String , String> legalnames = new HashMap<String, String>();
		legalnames.put("given_name", "MARYAM");
		legalnames.put("last_name", "BREIDE");

com.google.gson.JsonSyntaxException: java.lang.NumberFormatException: Expected a long but was 3.9 at line 1 column 443 path $.records[0].compare_methods[1].methods[0].comparisons[0].distance
at com.google.gson.internal.bind.TypeAdapters$11.read(TypeAdapters.java:306)
at com.google.gson.internal.bind.TypeAdapters$11.read(TypeAdapters.java:296)
at com.google.gson.internal.bind.ReflectiveTypeAdapterFactory$1.read(ReflectiveTypeAdapterFactory.java:131)
at com.google.gson.internal.bind.ReflectiveTypeAdapterFactory$Adapter.read(ReflectiveTypeAdapterFactory.java:222)
at com.google.gson.internal.bind.TypeAdapterRuntimeTypeWrapper.read(TypeAdapterRuntimeTypeWrapper.java:41)
at com.google.gson.internal.bind.CollectionTypeAdapterFactory$Adapter.read(CollectionTypeAdapterFactory.java:82)
at com.google.gson.internal.bind.CollectionTypeAdapterFactory$Adapter.read(CollectionTypeAdapterFactory.java:61)
at com.google.gson.internal.bind.ReflectiveTypeAdapterFactory$1.read(ReflectiveTypeAdapterFactory.java:131)
at com.google.gson.internal.bind.ReflectiveTypeAdapterFactory$Adapter.read(ReflectiveTypeAdapterFactory.java:222)
at com.google.gson.internal.bind.TypeAdapterRuntimeTypeWrapper.read(TypeAdapterRuntimeTypeWrapper.java:41)
at com.google.gson.internal.bind.CollectionTypeAdapterFactory$Adapter.read(CollectionTypeAdapterFactory.java:82)
at com.google.gson.internal.bind.CollectionTypeAdapterFactory$Adapter.read(CollectionTypeAdapterFactory.java:61)
at com.google.gson.internal.bind.ReflectiveTypeAdapterFactory$1.read(ReflectiveTypeAdapterFactory.java:131)
at com.google.gson.internal.bind.ReflectiveTypeAdapterFactory$Adapter.read(ReflectiveTypeAdapterFactory.java:222)
at com.google.gson.internal.bind.TypeAdapterRuntimeTypeWrapper.read(TypeAdapterRuntimeTypeWrapper.java:41)
at com.google.gson.internal.bind.CollectionTypeAdapterFactory$Adapter.read(CollectionTypeAdapterFactory.java:82)
at com.google.gson.internal.bind.CollectionTypeAdapterFactory$Adapter.read(CollectionTypeAdapterFactory.java:61)
at com.google.gson.internal.bind.ReflectiveTypeAdapterFactory$1.read(ReflectiveTypeAdapterFactory.java:131)
at com.google.gson.internal.bind.ReflectiveTypeAdapterFactory$Adapter.read(ReflectiveTypeAdapterFactory.java:222)
at com.google.gson.internal.bind.TypeAdapterRuntimeTypeWrapper.read(TypeAdapterRuntimeTypeWrapper.java:41)
at com.google.gson.internal.bind.CollectionTypeAdapterFactory$Adapter.read(CollectionTypeAdapterFactory.java:82)
at com.google.gson.internal.bind.CollectionTypeAdapterFactory$Adapter.read(CollectionTypeAdapterFactory.java:61)
at com.google.gson.internal.bind.ReflectiveTypeAdapterFactory$1.read(ReflectiveTypeAdapterFactory.java:131)
at com.google.gson.internal.bind.ReflectiveTypeAdapterFactory$Adapter.read(ReflectiveTypeAdapterFactory.java:222)
at com.google.gson.Gson.fromJson(Gson.java:932)
at com.ibm.cloud.sdk.core.util.ResponseUtils.getValue(ResponseUtils.java:149)
at com.ibm.cloud.sdk.core.util.ResponseConverterUtils$6.convert(ResponseConverterUtils.java:137)
at com.ibm.cloud.sdk.core.service.BaseService.processServiceCall(BaseService.java:379)
at com.ibm.cloud.sdk.core.service.BaseService$WatsonServiceCall.execute(BaseService.java:436)
at com.ibm.cloud.mdm.v0.PKMDMExamples.searchMatchingIndex(PKMDMExamples.java:75)
at com.ibm.cloud.mdm.v0.PKMDMExamples.main(PKMDMExamples.java:43)
Caused by: java.lang.NumberFormatException: Expected a long but was 3.9 at line 1 column 443 path $.records[0].compare_methods[1].methods[0].comparisons[0].distance
at com.google.gson.stream.JsonReader.nextLong(JsonReader.java:968)
at com.google.gson.internal.bind.TypeAdapters$11.read(TypeAdapters.java:304)
... 30 more

Wrong ResponseConverter for getMatchingEntityDetail()

Hi There,
Please change responseConverter to "ResponseConverter<Map<String , List<Map<String, String>>>>"

Getting error with ResponseConverter<Map<String, Map<String, List>>> .
Please check success example
https://cloud.ibm.com/apidocs/mdm?code=java#get-matching-entity-detail

ResponseConverter<Map<String , List<Map<String, String>>>> responseConverter =
         ResponseConverterUtils.getValue(new com.google.gson.reflect.TypeToken<Map<String , List<Map<String, String>>>>() { }.getType());