MDM 5.5 SP06 Patch 02 

Use

With MDM 5.5 SP06 Patch 02, the Java API has been enhanced as follows:

●      New

○       New methods Search.serialize and Search.deserialize for use in URLs.

○       New method RepositorySchemaEx.getRegion(String regionNameOrCode) for getting RegionProperties by either region name or region code.

○       New MdmValueFormatterutility class for formatting fields and attributes of MDM values.

○       New methods RecordEx.getFieldDisplayValue and RecordEx.getAttributeDisplayValue returning string array of display values.

○       New set of XXXFormatInfoclasses for defining the format for different types of MDM values (XXX - type names, like DateTime, measurement, and so on).

○       New factory RelationshipFactoryfor creating instances of Relationship and RelationshipGroup classes.

○       New command DeleteWorkflowJobCommand for deleting workflow jobs.

○       New command LaunchWorkflowJobCommand for launching workflow jobs.

○       New util class MeasurementUtils for enabling conversion of measurement values.

○       New method Search.setIncludeCheckoutRecords for including checked out records when carrying out a search.

○       New command AddGroupItemCommandfor adding group items.

○       New command DeleteGroupItemCommandfor deleting group items.

○       New interfaces HierDataGroupNode, HierLocationGroupNode, and HierValidationGroupNode, each extending the HierGroupNode.

○       New factory HierGroupNodeFactoryfor creating instances of HierDataGroupNode, HierLocationGroupNode, and HierValidationGroupNode.

○       New enumeration classes GroupTypes, DataLocationTypes.

○       New command GetRepositoryDimensionsCommand for retrieving all dimensions and UOMs relevant for the specific repository. These dimensions include both basic and user-defined dimensions.

○       New DimensionsManagerfor supplying information about dimensions/UOMs.

     Fixes

○       The order of the populated attributes in the record is now the same as in the Data Manager.

○       The method Search.getType did not return the correct enumeration. Changed from SearchItem.SEARCH_GROUP to SearchItem.SEARCH.

○       SearchGroup did not allow for KeywordSearchDimension, NamedSearchSearchDimension and MaskSearchDimension. SearchGroup has been changed to throw an exception in such cases.

○       GetDBMSRepositoryListCommand returned repository identifiers with an incorrect DBMS server name.

○       Two validations have been added to the SplitWorkflowJobCommand: (1) cannot split jobs with only one record; (2) cannot split job if one of the records to be split does not belong to the set of WF jobs.

○       The method Record.setFieldValue(fieldId, fieldValue) throws an exception "Field with ID '{0}' does not exist in the table '{1}'" if the specified field was not populated in the record. This happens when the result definition of the record that was retrieved did not include the specified field.

○       Execution of ModifyRecordCommandfor the record represented by the RecordEx object including modified links, does not make changes for qualified links in the repository.

○       When any retrieve record command is specified with region layer ALL, (for example get-all-language), a null is returned for the qualifier multi-lingual field if the value for the current language layer is null (even though there is data for the other language layers).

○       Starting a long matching strategy using the MDM Java API may cause a deadlock on a running server.

○       If a search contains two search dimensions, one with FieldSearchDimension+PickListSearchConstraint and another with AttributeSearchDimension+PickListSearchConstraint, different results are returned, depending on the order in which they are added to the search.

○       If two threads are trying simultaneously to retrieve metadata (that was not initially loaded in the cache) for the same repository, then one of the threads can get the exception stating that the required metadata element (for example, the table), does not exist in the repository.

     Changes

○       All search constraints are now inherited from AbstractSearchConstraint. This has no impact on customers.

○       New handling of N/A (not applicable) values for numeric fields and attributes.

○       New workflow job IDs were added as output parameters to the SplitWorkflowJobCommand.

○       The action Delete Workflow Job through the ExecuteWorkflowTaskActionCommand is deprecated. Instead, use a new command, DeleteWorkflowJobCommand. The deprecated command uses a new command with Checkin record action.

○       Added ability to specify MinConnections, MaxConnections and TimeOut through the ConnectionManagerclass.

○       Enumeration constants defining types of HierGroupNode are deprecated in the class RetrieveGroupTreeCommand. A new enumeration class GroupTypes should be used instead.

○       New method GetRepositoryDimensions was added to class MetadataManager. This method retrieves dimensions from the MDM Server and stores them in the internal cache.