Package org.odpi.openmetadata.accessservices.assetmanager.client.management

Class StewardshipManagementClient

java.lang.Object

org.odpi.openmetadata.accessservices.assetmanager.client.management.StewardshipManagementClient

All Implemented Interfaces:

StewardshipManagementInterface

public class StewardshipManagementClient
extends Object
implements StewardshipManagementInterface

StewardshipExchangeClient is the client for assigning relationships and classifications that help govern both metadata and its associated resources.

Constructor Summary

Constructors

Constructor	Description
StewardshipManagementClient(String serverName, String serverPlatformURLRoot, int maxPageSize)	Create a new client with no authentication embedded in the HTTP request.
StewardshipManagementClient(String serverName, String serverPlatformURLRoot, String userId, String password, int maxPageSize)	Create a new client that passes userId and password in each HTTP request.
StewardshipManagementClient(String serverName, String serverPlatformURLRoot, String userId, String password, AuditLog auditLog, int maxPageSize)	Create a new client that passes userId and password in each HTTP request.
StewardshipManagementClient(String serverName, String serverPlatformURLRoot, AssetManagerRESTClient restClient, int maxPageSize, AuditLog auditLog)	Create a new client that is going to be used in an OMAG Server.
StewardshipManagementClient(String serverName, String serverPlatformURLRoot, AuditLog auditLog, int maxPageSize)	Create a new client with no authentication embedded in the HTTP request.

Method Summary

Modifier and Type	Method	Description
void	addAssetOrigin(String userId, String assetGUID, AssetOriginProperties properties, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)	Add or replace the origin classification for an asset.
void	addElementToSubjectArea(String userId, String elementGUID, SubjectAreaClassificationProperties properties, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)	Classify the element to assert that the definitions it represents are part of a subject area definition.
void	addGovernanceDefinitionToElement(String userId, String definitionGUID, String elementGUID, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)	Link a governance definition to an element using the GovernedBy relationship.
void	addOwnership(String userId, String elementGUID, OwnerProperties properties, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)	Add or replace the ownership classification for an element.
void	addSecurityTags(String userId, String elementGUID, SecurityTagsProperties properties, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)	Add or replace the security tags for an element.
void	clearAssetOrigin(String userId, String assetGUID, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)	Remove the origin classification from an asset.
void	clearConfidenceClassification(String userId, String elementGUID, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)	Remove the confidence classification from the element.
void	clearConfidentialityClassification(String userId, String elementGUID, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)	Remove the confidence classification from the element.
void	clearCriticalityClassification(String userId, String elementGUID, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)	Remove the criticality classification from the element.
void	clearElementAsDataField(String userId, String elementGUID, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)	Remove the data field designation from the element.
void	clearOwnership(String userId, String elementGUID, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)	Remove the ownership classification from an element.
void	clearRetentionClassification(String userId, String elementGUID, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)	Remove the retention classification from the element.
void	clearSecurityTags(String userId, String elementGUID, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)	Remove the security tags classification from an element.
void	clearSemanticAssignment(String userId, String elementGUID, String glossaryTermGUID, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)	Remove a semantic assignment relationship between an element and its glossary term.
List<MetadataElementSummary>	findElementsByClassificationWithPropertyValue(String userId, String classificationName, FindPropertyNamesProperties findProperties, int startFrom, int pageSize, boolean forLineage, boolean forDuplicateProcessing)	Retrieve elements with the requested classification name and with the requested a value found in one of the classification's properties specified.
List<MetadataElementSummary>	findElementsByPropertyValue(String userId, FindPropertyNamesProperties findProperties, int startFrom, int pageSize, boolean forLineage, boolean forDuplicateProcessing)	Retrieve elements by a value found in one of the properties specified.
List<RelatedMetadataElementSummary>	findRelatedElementsWithPropertyValue(String userId, String elementGUID, String relationshipTypeName, int startingAtEnd, FindPropertyNamesProperties findProperties, int startFrom, int pageSize, boolean forLineage, boolean forDuplicateProcessing)	Retrieve elements linked via the requested relationship type name and with the relationship's properties specified.
List<MetadataRelationshipSummary>	findRelationshipsWithPropertyValue(String userId, String relationshipTypeName, FindPropertyNamesProperties findProperties, int startFrom, int pageSize, boolean forLineage, boolean forDuplicateProcessing)	Retrieve relationships of the requested relationship type name and with the requested a value found in one of the relationship's properties specified.
List<AssetElement>	getAssetsByOrigin(String userId, FindAssetOriginProperties properties, int startFrom, int pageSize, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)	Return information about the assets from a specific origin.
List<MetadataElementSummary>	getConfidenceClassifiedElements(String userId, boolean returnSpecificLevel, int levelIdentifier, int startFrom, int pageSize, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)	Return information about the elements classified with the confidence classification.
List<MetadataElementSummary>	getConfidentialityClassifiedElements(String userId, boolean returnSpecificLevel, int levelIdentifier, int startFrom, int pageSize, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)	Return information about the elements classified with the confidentiality classification.
List<MetadataElementSummary>	getCriticalityClassifiedElements(String userId, boolean returnSpecificLevel, int levelIdentifier, int startFrom, int pageSize, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)	Return information about the elements classified with the criticality classification.
List<ElementStub>	getDataFieldClassifiedElements(String userId, DataFieldQueryProperties properties, int startFrom, int pageSize, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)	Return information about the elements classified with the DataField classification.
List<MetadataElementSummary>	getElements(String userId, FindProperties findProperties, int startFrom, int pageSize, boolean forLineage, boolean forDuplicateProcessing)	Retrieve elements of the requested type name.
List<MetadataElementSummary>	getElementsByClassification(String userId, String classificationName, FindProperties findProperties, int startFrom, int pageSize, boolean forLineage, boolean forDuplicateProcessing)	Retrieve elements with the requested classification name.
List<MetadataElementSummary>	getElementsByClassificationWithPropertyValue(String userId, String classificationName, FindPropertyNamesProperties findProperties, int startFrom, int pageSize, boolean forLineage, boolean forDuplicateProcessing)	Retrieve elements with the requested classification name and with the requested a value found in one of the classification's properties specified.
List<MetadataElementSummary>	getElementsByPropertyValue(String userId, FindPropertyNamesProperties findProperties, int startFrom, int pageSize, boolean forLineage, boolean forDuplicateProcessing)	Retrieve elements by a value found in one of the properties specified.
List<RelatedMetadataElementSummary>	getElementsSourceFrom(String userId, String elementGUID, int startFrom, int pageSize, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)	Retrieve the elements linked via a "SourceFrom" relationship to the requested element.
List<GovernanceDefinitionElement>	getGovernedByDefinitions(String userId, String elementGUID, int startFrom, int pageSize, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)	Retrieve the governance definitions linked via a "GovernedBy" relationship to the requested element.
List<RelatedMetadataElementSummary>	getGovernedElements(String userId, String governanceDefinitionGUID, int startFrom, int pageSize, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)	Retrieve the elements linked via a "GovernedBy" relationship to the requested governance definition.
List<GlossaryTermElement>	getMeanings(String userId, String elementGUID, int startFrom, int pageSize, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)	Retrieve the glossary terms linked via a "SemanticAssignment" relationship to the requested element.
List<MetadataElementSummary>	getMembersOfSubjectArea(String userId, String subjectAreaName, int startFrom, int pageSize, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)	Return information about the contents of a subject area such as the glossaries, reference data sets and quality definitions.
MetadataElementSummary	getMetadataElementByGUID(String userId, String elementGUID, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime)	Retrieve the metadata element using its unique identifier.
MetadataElementSummary	getMetadataElementByUniqueName(String userId, String uniqueName, String uniquePropertyName, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime)	Retrieve the metadata element using its unique name (typically the qualified name).
String	getMetadataElementGUIDByUniqueName(String userId, String uniqueName, String uniquePropertyName, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime)	Retrieve the unique identifier of a metadata element using its unique name (typically the qualified name).
List<MetadataElementSummary>	getOwnersElements(String userId, String owner, int startFrom, int pageSize, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)	Return information about the contents of a subject area such as the glossaries, reference data sets and quality definitions.
List<RelatedMetadataElementSummary>	getRelatedElements(String userId, String elementGUID, String relationshipTypeName, int startingAtEnd, FindProperties findProperties, int startFrom, int pageSize, boolean forLineage, boolean forDuplicateProcessing)	Retrieve related elements of the requested type name.
List<RelatedMetadataElementSummary>	getRelatedElementsWithPropertyValue(String userId, String elementGUID, String relationshipTypeName, int startingAtEnd, FindPropertyNamesProperties findProperties, int startFrom, int pageSize, boolean forLineage, boolean forDuplicateProcessing)	Retrieve elements linked via the requested relationship type name and with the requested a value found in one of the classification's properties specified.
List<MetadataRelationshipSummary>	getRelationships(String userId, String relationshipTypeName, FindProperties findProperties, int startFrom, int pageSize, boolean forLineage, boolean forDuplicateProcessing)	Retrieve relationships of the requested relationship type name.
List<MetadataRelationshipSummary>	getRelationshipsWithPropertyValue(String userId, String relationshipTypeName, FindPropertyNamesProperties findProperties, int startFrom, int pageSize, boolean forLineage, boolean forDuplicateProcessing)	Retrieve relationships of the requested relationship type name and with the requested a value found in one of the relationship's properties specified.
List<MetadataElementSummary>	getRetentionClassifiedElements(String userId, boolean returnSpecificBasisIdentifier, int basisIdentifier, int startFrom, int pageSize, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)	Return information about the elements classified with the retention classification.
List<MetadataElementSummary>	getSecurityTaggedElements(String userId, int startFrom, int pageSize, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)	Return information about the contents of a subject area such as the glossaries, reference data sets and quality definitions.
List<RelatedMetadataElementSummary>	getSemanticAssignees(String userId, String glossaryTermGUID, int startFrom, int pageSize, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)	Retrieve the elements linked via a "SemanticAssignment" relationship to the requested glossary term.
List<RelatedMetadataElementSummary>	getSourceElements(String userId, String elementGUID, int startFrom, int pageSize, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)	Retrieve the elements linked via a "SourceFrom" relationship to the requested element.
void	removeElementFromSubjectArea(String userId, String elementGUID, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)	Remove the subject area designation from the identified element.
void	removeGovernanceDefinitionFromElement(String userId, String definitionGUID, String elementGUID, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)	Remove the GovernedBy relationship between a governance definition and an element.
ElementHeader	retrieveInstanceForGUID(String userId, String guid, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime)	Retrieve the header for the instance identified by the supplied unique identifier.
void	setConfidenceClassification(String userId, String elementGUID, GovernanceClassificationProperties properties, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)	Classify/reclassify the element (typically an asset) to indicate the level of confidence that the organization has that the data is complete, accurate and up-to-date.
void	setConfidentialityClassification(String userId, String elementGUID, GovernanceClassificationProperties properties, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)	Classify/reclassify the element (typically a data field, schema attribute or glossary term) to indicate the level of confidentiality that any data associated with the element should be given.
void	setCriticalityClassification(String userId, String elementGUID, GovernanceClassificationProperties properties, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)	Classify/reclassify the element (typically an asset) to indicate how critical the element (or associated resource) is to the organization.
void	setElementAsDataField(String userId, String elementGUID, DataFieldValuesProperties properties, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)	Classify the element to indicate that it describes a data field and supply properties that describe the characteristics of the data values found within.
void	setRetentionClassification(String userId, String elementGUID, RetentionClassificationProperties properties, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)	Classify/reclassify the element (typically an asset) to indicate how long the element (or associated resource) is to be retained by the organization.
void	setupSemanticAssignment(String userId, String elementGUID, String glossaryTermGUID, SemanticAssignmentProperties properties, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)	Create a semantic assignment relationship between a glossary term and an element (normally a schema attribute, data field or asset).

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

StewardshipManagementClient

public StewardshipManagementClient(String serverName,
 String serverPlatformURLRoot,
 AuditLog auditLog,
 int maxPageSize)
                            throws InvalidParameterException

Create a new client with no authentication embedded in the HTTP request.

Parameters:

serverName - name of the server to connect to

serverPlatformURLRoot - the network address of the server running the OMAS REST services

auditLog - logging destination

maxPageSize - maximum value allowed for page size

Throws:

InvalidParameterException - there is a problem creating the client-side components to issue any REST API calls.

StewardshipManagementClient

public StewardshipManagementClient(String serverName,
 String serverPlatformURLRoot,
 int maxPageSize)
                            throws InvalidParameterException

Create a new client with no authentication embedded in the HTTP request.

Parameters:

serverName - name of the server to connect to

serverPlatformURLRoot - the network address of the server running the OMAS REST services

maxPageSize - maximum value allowed for page size

Throws:

InvalidParameterException - there is a problem creating the client-side components to issue any REST API calls.

StewardshipManagementClient

public StewardshipManagementClient(String serverName,
 String serverPlatformURLRoot,
 String userId,
 String password,
 AuditLog auditLog,
 int maxPageSize)
                            throws InvalidParameterException

Create a new client that passes userId and password in each HTTP request. This is the userId/password of the calling server. The end user's userId is sent on each request.

Parameters:

serverName - name of the server to connect to

serverPlatformURLRoot - the network address of the server running the OMAS REST services

userId - caller's userId embedded in all HTTP requests

password - caller's userId embedded in all HTTP requests

auditLog - logging destination

maxPageSize - maximum value allowed for page size

Throws:

InvalidParameterException - there is a problem creating the client-side components to issue any REST API calls.

StewardshipManagementClient

public StewardshipManagementClient(String serverName,
 String serverPlatformURLRoot,
 AssetManagerRESTClient restClient,
 int maxPageSize,
 AuditLog auditLog)
                            throws InvalidParameterException

Create a new client that is going to be used in an OMAG Server.

Parameters:

serverName - name of the server to connect to

serverPlatformURLRoot - the network address of the server running the OMAS REST services

restClient - client that issues the REST API calls

maxPageSize - maximum number of results supported by this server

auditLog - logging destination

Throws:

InvalidParameterException - there is a problem creating the client-side components to issue any REST API calls.

StewardshipManagementClient

public StewardshipManagementClient(String serverName,
 String serverPlatformURLRoot,
 String userId,
 String password,
 int maxPageSize)
                            throws InvalidParameterException

Create a new client that passes userId and password in each HTTP request. This is the userId/password of the calling server. The end user's userId is sent on each request.

Parameters:

serverName - name of the server to connect to

serverPlatformURLRoot - the network address of the server running the OMAS REST services

userId - caller's userId embedded in all HTTP requests

password - caller's userId embedded in all HTTP requests

maxPageSize - maximum value allowed for page size

Throws:

InvalidParameterException - there is a problem creating the client-side components to issue any REST API calls.

Method Details

setElementAsDataField

public void setElementAsDataField(String userId,
 String elementGUID,
 DataFieldValuesProperties properties,
 Date effectiveTime,
 boolean forLineage,
 boolean forDuplicateProcessing)
                           throws InvalidParameterException,
UserNotAuthorizedException,
PropertyServerException

Classify the element to indicate that it describes a data field and supply properties that describe the characteristics of the data values found within.

Specified by:

setElementAsDataField in interface StewardshipManagementInterface

Parameters:

userId - calling user

elementGUID - unique identifier of the metadata element to update

properties - descriptive properties for the data field

effectiveTime - the time that the retrieved elements must be effective for

forLineage - return elements marked with the Memento classification?

forDuplicateProcessing - do not merge elements marked as duplicates?

Throws:

InvalidParameterException - one of the parameters is invalid

UserNotAuthorizedException - the user is not authorized to issue this request

PropertyServerException - there is a problem reported in the open metadata server(s)

clearElementAsDataField

public void clearElementAsDataField(String userId,
 String elementGUID,
 Date effectiveTime,
 boolean forLineage,
 boolean forDuplicateProcessing)
                             throws InvalidParameterException,
UserNotAuthorizedException,
PropertyServerException

Remove the data field designation from the element.

Specified by:

clearElementAsDataField in interface StewardshipManagementInterface

Parameters:

userId - calling user

elementGUID - unique identifier of the metadata element to update

effectiveTime - the time that the retrieved elements must be effective for

forLineage - return elements marked with the Memento classification?

forDuplicateProcessing - do not merge elements marked as duplicates?

Throws:

InvalidParameterException - one of the parameters is invalid

UserNotAuthorizedException - the user is not authorized to issue this request

PropertyServerException - there is a problem reported in the open metadata server(s)

getDataFieldClassifiedElements

public List<ElementStub> getDataFieldClassifiedElements(String userId,
 DataFieldQueryProperties properties,
 int startFrom,
 int pageSize,
 Date effectiveTime,
 boolean forLineage,
 boolean forDuplicateProcessing)
                                                 throws InvalidParameterException,
UserNotAuthorizedException,
PropertyServerException

Return information about the elements classified with the DataField classification.

Specified by:

getDataFieldClassifiedElements in interface StewardshipManagementInterface

Parameters:

userId - calling user

properties - values to match on

startFrom - paging start point

pageSize - maximum results that can be returned

effectiveTime - the time that the retrieved elements must be effective for

forLineage - return elements marked with the Memento classification?

forDuplicateProcessing - do not merge elements marked as duplicates?

Returns:

list of element stubs

Throws:

InvalidParameterException - qualifiedName or userId is null

PropertyServerException - problem accessing property server

UserNotAuthorizedException - security access problem

setConfidenceClassification

public void setConfidenceClassification(String userId,
 String elementGUID,
 GovernanceClassificationProperties properties,
 Date effectiveTime,
 boolean forLineage,
 boolean forDuplicateProcessing)
                                 throws InvalidParameterException,
UserNotAuthorizedException,
PropertyServerException

Classify/reclassify the element (typically an asset) to indicate the level of confidence that the organization has that the data is complete, accurate and up-to-date. The level of confidence is expressed by the levelIdentifier property.

Specified by:

setConfidenceClassification in interface StewardshipManagementInterface

Parameters:

userId - calling user

elementGUID - unique identifier of the metadata element to classify

properties - details of the classification

effectiveTime - the time that the retrieved elements must be effective for

forLineage - return elements marked with the Memento classification?

forDuplicateProcessing - do not merge elements marked as duplicates?

Throws:

InvalidParameterException - one of the parameters is invalid

UserNotAuthorizedException - the user is not authorized to issue this request

PropertyServerException - there is a problem reported in the open metadata server(s)

clearConfidenceClassification

public void clearConfidenceClassification(String userId,
 String elementGUID,
 Date effectiveTime,
 boolean forLineage,
 boolean forDuplicateProcessing)
                                   throws InvalidParameterException,
UserNotAuthorizedException,
PropertyServerException

Remove the confidence classification from the element. This normally occurs when the organization has lost track of the level of confidence to assign to the element.

Specified by:

clearConfidenceClassification in interface StewardshipManagementInterface

Parameters:

userId - calling user

elementGUID - unique identifier of the metadata element to declassify

effectiveTime - the time that the retrieved elements must be effective for

forLineage - return elements marked with the Memento classification?

forDuplicateProcessing - do not merge elements marked as duplicates?

Throws:

InvalidParameterException - one of the parameters is invalid

UserNotAuthorizedException - the user is not authorized to issue this request

PropertyServerException - there is a problem reported in the open metadata server(s)

getConfidenceClassifiedElements

public List<MetadataElementSummary> getConfidenceClassifiedElements(String userId,
 boolean returnSpecificLevel,
 int levelIdentifier,
 int startFrom,
 int pageSize,
 Date effectiveTime,
 boolean forLineage,
 boolean forDuplicateProcessing)
                                                             throws InvalidParameterException,
UserNotAuthorizedException,
PropertyServerException

Return information about the elements classified with the confidence classification.

Specified by:

getConfidenceClassifiedElements in interface StewardshipManagementInterface

Parameters:

userId - calling user

returnSpecificLevel - should the results be filtered by levelIdentifier?

levelIdentifier - the identifier to filter by (if returnSpecificLevel=true)

startFrom - paging start point

pageSize - maximum results that can be returned

effectiveTime - the time that the retrieved elements must be effective for

forLineage - return elements marked with the Memento classification?

forDuplicateProcessing - do not merge elements marked as duplicates?

Returns:

list of element stubs

Throws:

InvalidParameterException - qualifiedName or userId is null

PropertyServerException - problem accessing property server

UserNotAuthorizedException - security access problem

setCriticalityClassification

public void setCriticalityClassification(String userId,
 String elementGUID,
 GovernanceClassificationProperties properties,
 Date effectiveTime,
 boolean forLineage,
 boolean forDuplicateProcessing)
                                  throws InvalidParameterException,
UserNotAuthorizedException,
PropertyServerException

Classify/reclassify the element (typically an asset) to indicate how critical the element (or associated resource) is to the organization. The level of criticality is expressed by the levelIdentifier property.

Specified by:

setCriticalityClassification in interface StewardshipManagementInterface

Parameters:

userId - calling user

elementGUID - unique identifier of the metadata element to classify

properties - details of the classification

effectiveTime - the time that the retrieved elements must be effective for

forLineage - return elements marked with the Memento classification?

forDuplicateProcessing - do not merge elements marked as duplicates?

Throws:

InvalidParameterException - one of the parameters is invalid

UserNotAuthorizedException - the user is not authorized to issue this request

PropertyServerException - there is a problem reported in the open metadata server(s)

clearCriticalityClassification

public void clearCriticalityClassification(String userId,
 String elementGUID,
 Date effectiveTime,
 boolean forLineage,
 boolean forDuplicateProcessing)
                                    throws InvalidParameterException,
UserNotAuthorizedException,
PropertyServerException

Remove the criticality classification from the element. This normally occurs when the organization has lost track of the level of criticality to assign to the element.

Specified by:

clearCriticalityClassification in interface StewardshipManagementInterface

Parameters:

userId - calling user

elementGUID - unique identifier of the metadata element to declassify

effectiveTime - the time that the retrieved elements must be effective for

forLineage - return elements marked with the Memento classification?

forDuplicateProcessing - do not merge elements marked as duplicates?

Throws:

InvalidParameterException - one of the parameters is invalid

UserNotAuthorizedException - the user is not authorized to issue this request

PropertyServerException - there is a problem reported in the open metadata server(s)

getCriticalityClassifiedElements

public List<MetadataElementSummary> getCriticalityClassifiedElements(String userId,
 boolean returnSpecificLevel,
 int levelIdentifier,
 int startFrom,
 int pageSize,
 Date effectiveTime,
 boolean forLineage,
 boolean forDuplicateProcessing)
                                                              throws InvalidParameterException,
UserNotAuthorizedException,
PropertyServerException

Return information about the elements classified with the criticality classification.

Specified by:

getCriticalityClassifiedElements in interface StewardshipManagementInterface

Parameters:

userId - calling user

returnSpecificLevel - should the results be filtered by levelIdentifier?

levelIdentifier - the identifier to filter by (if returnSpecificLevel=true)

startFrom - paging start point

pageSize - maximum results that can be returned

effectiveTime - the time that the retrieved elements must be effective for

forLineage - return elements marked with the Memento classification?

forDuplicateProcessing - do not merge elements marked as duplicates?

Returns:

list of element stubs

Throws:

InvalidParameterException - qualifiedName or userId is null

PropertyServerException - problem accessing property server

UserNotAuthorizedException - security access problem

setConfidentialityClassification

public void setConfidentialityClassification(String userId,
 String elementGUID,
 GovernanceClassificationProperties properties,
 Date effectiveTime,
 boolean forLineage,
 boolean forDuplicateProcessing)
                                      throws InvalidParameterException,
UserNotAuthorizedException,
PropertyServerException

Classify/reclassify the element (typically a data field, schema attribute or glossary term) to indicate the level of confidentiality that any data associated with the element should be given. If the classification is attached to a glossary term, the level of confidentiality is a suggestion for any element linked to the glossary term via the SemanticAssignment classification. The level of confidence is expressed by the levelIdentifier property.

Specified by:

setConfidentialityClassification in interface StewardshipManagementInterface

Parameters:

userId - calling user

elementGUID - unique identifier of the metadata element to classify

properties - details of the classification

effectiveTime - the time that the retrieved elements must be effective for

forLineage - return elements marked with the Memento classification?

forDuplicateProcessing - do not merge elements marked as duplicates?

Throws:

InvalidParameterException - one of the parameters is invalid

UserNotAuthorizedException - the user is not authorized to issue this request

PropertyServerException - there is a problem reported in the open metadata server(s)

clearConfidentialityClassification

public void clearConfidentialityClassification(String userId,
 String elementGUID,
 Date effectiveTime,
 boolean forLineage,
 boolean forDuplicateProcessing)
                                        throws InvalidParameterException,
UserNotAuthorizedException,
PropertyServerException

Remove the confidence classification from the element. This normally occurs when the organization has lost track of the level of confidentiality to assign to the element.

Specified by:

clearConfidentialityClassification in interface StewardshipManagementInterface

Parameters:

userId - calling user

elementGUID - unique identifier of the metadata element to declassify

effectiveTime - the time that the retrieved elements must be effective for

forLineage - return elements marked with the Memento classification?

forDuplicateProcessing - do not merge elements marked as duplicates?

Throws:

InvalidParameterException - one of the parameters is invalid

UserNotAuthorizedException - the user is not authorized to issue this request

PropertyServerException - there is a problem reported in the open metadata server(s)

getConfidentialityClassifiedElements

public List<MetadataElementSummary> getConfidentialityClassifiedElements(String userId,
 boolean returnSpecificLevel,
 int levelIdentifier,
 int startFrom,
 int pageSize,
 Date effectiveTime,
 boolean forLineage,
 boolean forDuplicateProcessing)
                                                                  throws InvalidParameterException,
UserNotAuthorizedException,
PropertyServerException

Return information about the elements classified with the confidentiality classification.

Specified by:

getConfidentialityClassifiedElements in interface StewardshipManagementInterface

Parameters:

userId - calling user

returnSpecificLevel - should the results be filtered by levelIdentifier?

levelIdentifier - the identifier to filter by (if returnSpecificLevel=true)

startFrom - paging start point

pageSize - maximum results that can be returned

effectiveTime - the time that the retrieved elements must be effective for

forLineage - return elements marked with the Memento classification?

forDuplicateProcessing - do not merge elements marked as duplicates?

Returns:

list of element stubs

Throws:

InvalidParameterException - qualifiedName or userId is null

PropertyServerException - problem accessing property server

UserNotAuthorizedException - security access problem

setRetentionClassification

public void setRetentionClassification(String userId,
 String elementGUID,
 RetentionClassificationProperties properties,
 Date effectiveTime,
 boolean forLineage,
 boolean forDuplicateProcessing)
                                throws InvalidParameterException,
UserNotAuthorizedException,
PropertyServerException

Classify/reclassify the element (typically an asset) to indicate how long the element (or associated resource) is to be retained by the organization. The policy to apply to the element/resource is captured by the retentionBasis property. The dates after which the element/resource is archived and then deleted are specified in the archiveAfter and deleteAfter properties respectively.

Specified by:

setRetentionClassification in interface StewardshipManagementInterface

Parameters:

userId - calling user

elementGUID - unique identifier of the metadata element to classify

properties - details of the classification

effectiveTime - the time that the retrieved elements must be effective for

forLineage - return elements marked with the Memento classification?

forDuplicateProcessing - do not merge elements marked as duplicates?

Throws:

InvalidParameterException - one of the parameters is invalid

UserNotAuthorizedException - the user is not authorized to issue this request

PropertyServerException - there is a problem reported in the open metadata server(s)

clearRetentionClassification

public void clearRetentionClassification(String userId,
 String elementGUID,
 Date effectiveTime,
 boolean forLineage,
 boolean forDuplicateProcessing)
                                  throws InvalidParameterException,
UserNotAuthorizedException,
PropertyServerException

Remove the retention classification from the element. This normally occurs when the organization has lost track of, or no longer needs to track the retention period to assign to the element.

Specified by:

clearRetentionClassification in interface StewardshipManagementInterface

Parameters:

userId - calling user

elementGUID - unique identifier of the metadata element to declassify

effectiveTime - the time that the retrieved elements must be effective for

forLineage - return elements marked with the Memento classification?

forDuplicateProcessing - do not merge elements marked as duplicates?

Throws:

InvalidParameterException - one of the parameters is invalid

UserNotAuthorizedException - the user is not authorized to issue this request

PropertyServerException - there is a problem reported in the open metadata server(s)

getRetentionClassifiedElements

public List<MetadataElementSummary> getRetentionClassifiedElements(String userId,
 boolean returnSpecificBasisIdentifier,
 int basisIdentifier,
 int startFrom,
 int pageSize,
 Date effectiveTime,
 boolean forLineage,
 boolean forDuplicateProcessing)
                                                            throws InvalidParameterException,
UserNotAuthorizedException,
PropertyServerException

Return information about the elements classified with the retention classification.

Specified by:

getRetentionClassifiedElements in interface StewardshipManagementInterface

Parameters:

userId - calling user

returnSpecificBasisIdentifier - should the results be filtered by basisIdentifier?

basisIdentifier - the identifier to filter by (if returnSpecificBasisIdentifier=true)

startFrom - paging start point

pageSize - maximum results that can be returned

effectiveTime - the time that the retrieved elements must be effective for

forLineage - return elements marked with the Memento classification?

forDuplicateProcessing - do not merge elements marked as duplicates?

Returns:

list of element stubs

Throws:

InvalidParameterException - qualifiedName or userId is null

PropertyServerException - problem accessing property server

UserNotAuthorizedException - security access problem

addSecurityTags

public void addSecurityTags(String userId,
 String elementGUID,
 SecurityTagsProperties properties,
 Date effectiveTime,
 boolean forLineage,
 boolean forDuplicateProcessing)
                     throws InvalidParameterException,
UserNotAuthorizedException,
PropertyServerException

Add or replace the security tags for an element.

Specified by:

addSecurityTags in interface StewardshipManagementInterface

Parameters:

userId - calling user

elementGUID - element to link it to - its type must inherit from Referenceable.

properties - details of the security tags

effectiveTime - the time that the retrieved elements must be effective for

forLineage - return elements marked with the Memento classification?

forDuplicateProcessing - do not merge elements marked as duplicates?

Throws:

InvalidParameterException - element not known, null userId or guid

PropertyServerException - problem accessing property server

UserNotAuthorizedException - security access problem

clearSecurityTags

public void clearSecurityTags(String userId,
 String elementGUID,
 Date effectiveTime,
 boolean forLineage,
 boolean forDuplicateProcessing)
                       throws InvalidParameterException,
UserNotAuthorizedException,
PropertyServerException

Remove the security tags classification from an element.

Specified by:

clearSecurityTags in interface StewardshipManagementInterface

Parameters:

userId - calling user

elementGUID - element where the security tags need to be removed.

effectiveTime - the time that the retrieved elements must be effective for

forLineage - return elements marked with the Memento classification?

forDuplicateProcessing - do not merge elements marked as duplicates?

Throws:

InvalidParameterException - asset or element not known, null userId or guid

PropertyServerException - problem accessing property server

UserNotAuthorizedException - security access problem

getSecurityTaggedElements

public List<MetadataElementSummary> getSecurityTaggedElements(String userId,
 int startFrom,
 int pageSize,
 Date effectiveTime,
 boolean forLineage,
 boolean forDuplicateProcessing)
                                                       throws InvalidParameterException,
UserNotAuthorizedException,
PropertyServerException

Return information about the contents of a subject area such as the glossaries, reference data sets and quality definitions.

Specified by:

getSecurityTaggedElements in interface StewardshipManagementInterface

Parameters:

userId - calling user

startFrom - paging start point

pageSize - maximum results that can be returned

effectiveTime - the time that the retrieved elements must be effective for

forLineage - return elements marked with the Memento classification?

forDuplicateProcessing - do not merge elements marked as duplicates?

Returns:

list of element stubs

Throws:

InvalidParameterException - qualifiedName or userId is null

PropertyServerException - problem accessing property server

UserNotAuthorizedException - security access problem

addOwnership

public void addOwnership(String userId,
 String elementGUID,
 OwnerProperties properties,
 Date effectiveTime,
 boolean forLineage,
 boolean forDuplicateProcessing)
                  throws InvalidParameterException,
UserNotAuthorizedException,
PropertyServerException

Add or replace the ownership classification for an element.

Specified by:

addOwnership in interface StewardshipManagementInterface

Parameters:

userId - calling user

elementGUID - element to link it to - its type must inherit from Referenceable.

properties - details of the ownership

effectiveTime - the time that the retrieved elements must be effective for

forLineage - return elements marked with the Memento classification?

forDuplicateProcessing - do not merge elements marked as duplicates?

Throws:

InvalidParameterException - element not known, null userId or guid

PropertyServerException - problem accessing property server

UserNotAuthorizedException - security access problem

clearOwnership

public void clearOwnership(String userId,
 String elementGUID,
 Date effectiveTime,
 boolean forLineage,
 boolean forDuplicateProcessing)
                    throws InvalidParameterException,
UserNotAuthorizedException,
PropertyServerException

Remove the ownership classification from an element.

Specified by:

clearOwnership in interface StewardshipManagementInterface

Parameters:

userId - calling user

elementGUID - element where the classification needs to be removed.

effectiveTime - the time that the retrieved elements must be effective for

forLineage - return elements marked with the Memento classification?

forDuplicateProcessing - do not merge elements marked as duplicates?

Throws:

InvalidParameterException - asset or element not known, null userId or guid

PropertyServerException - problem accessing property server

UserNotAuthorizedException - security access problem

getOwnersElements

public List<MetadataElementSummary> getOwnersElements(String userId,
 String owner,
 int startFrom,
 int pageSize,
 Date effectiveTime,
 boolean forLineage,
 boolean forDuplicateProcessing)
                                               throws InvalidParameterException,
UserNotAuthorizedException,
PropertyServerException

Return information about the contents of a subject area such as the glossaries, reference data sets and quality definitions.

Specified by:

getOwnersElements in interface StewardshipManagementInterface

Parameters:

userId - calling user

owner - unique identifier for the owner

startFrom - paging start point

pageSize - maximum results that can be returned

effectiveTime - the time that the retrieved elements must be effective for

forLineage - return elements marked with the Memento classification?

forDuplicateProcessing - do not merge elements marked as duplicates?

Returns:

list of element stubs

Throws:

InvalidParameterException - qualifiedName or userId is null

PropertyServerException - problem accessing property server

UserNotAuthorizedException - security access problem

addAssetOrigin

public void addAssetOrigin(String userId,
 String assetGUID,
 AssetOriginProperties properties,
 Date effectiveTime,
 boolean forLineage,
 boolean forDuplicateProcessing)
                    throws InvalidParameterException,
UserNotAuthorizedException,
PropertyServerException

Add or replace the origin classification for an asset.

Specified by:

addAssetOrigin in interface StewardshipManagementInterface

Parameters:

userId - calling user

assetGUID - element to link it to - its type must inherit from Asset.

properties - details of the origin

effectiveTime - the time that the retrieved elements must be effective for

forLineage - return elements marked with the Memento classification?

forDuplicateProcessing - do not merge elements marked as duplicates?

Throws:

InvalidParameterException - element not known, null userId or guid

PropertyServerException - problem accessing property server

UserNotAuthorizedException - security access problem

clearAssetOrigin

public void clearAssetOrigin(String userId,
 String assetGUID,
 Date effectiveTime,
 boolean forLineage,
 boolean forDuplicateProcessing)
                      throws InvalidParameterException,
UserNotAuthorizedException,
PropertyServerException

Remove the origin classification from an asset.

Specified by:

clearAssetOrigin in interface StewardshipManagementInterface

Parameters:

userId - calling user

assetGUID - element where the classification needs to be removed.

effectiveTime - the time that the retrieved elements must be effective for

forLineage - return elements marked with the Memento classification?

forDuplicateProcessing - do not merge elements marked as duplicates?

Throws:

InvalidParameterException - asset or element not known, null userId or guid

PropertyServerException - problem accessing property server

UserNotAuthorizedException - security access problem

getAssetsByOrigin

public List<AssetElement> getAssetsByOrigin(String userId,
 FindAssetOriginProperties properties,
 int startFrom,
 int pageSize,
 Date effectiveTime,
 boolean forLineage,
 boolean forDuplicateProcessing)
                                     throws InvalidParameterException,
UserNotAuthorizedException,
PropertyServerException

Return information about the assets from a specific origin.

Specified by:

getAssetsByOrigin in interface StewardshipManagementInterface

Parameters:

userId - calling user

properties - values to search on - null means any value

startFrom - paging start point

pageSize - maximum results that can be returned

effectiveTime - the time that the retrieved elements must be effective for

forLineage - return elements marked with the Memento classification?

forDuplicateProcessing - do not merge elements marked as duplicates?

Returns:

list of the assets

Throws:

InvalidParameterException - qualifiedName or userId is null

PropertyServerException - problem accessing property server

UserNotAuthorizedException - security access problem

addElementToSubjectArea

public void addElementToSubjectArea(String userId,
 String elementGUID,
 SubjectAreaClassificationProperties properties,
 Date effectiveTime,
 boolean forLineage,
 boolean forDuplicateProcessing)
                             throws InvalidParameterException,
UserNotAuthorizedException,
PropertyServerException

Classify the element to assert that the definitions it represents are part of a subject area definition.

Specified by:

addElementToSubjectArea in interface StewardshipManagementInterface

Parameters:

userId - calling user

elementGUID - unique identifier of the metadata element to update

properties - qualified name of subject area

effectiveTime - the time that the retrieved elements must be effective for

forLineage - return elements marked with the Memento classification?

forDuplicateProcessing - do not merge elements marked as duplicates?

Throws:

InvalidParameterException - one of the parameters is invalid

UserNotAuthorizedException - the user is not authorized to issue this request

PropertyServerException - there is a problem reported in the open metadata server(s)

removeElementFromSubjectArea

public void removeElementFromSubjectArea(String userId,
 String elementGUID,
 Date effectiveTime,
 boolean forLineage,
 boolean forDuplicateProcessing)
                                  throws InvalidParameterException,
UserNotAuthorizedException,
PropertyServerException

Remove the subject area designation from the identified element.

Specified by:

removeElementFromSubjectArea in interface StewardshipManagementInterface

Parameters:

userId - calling user

elementGUID - unique identifier of the metadata element to update

effectiveTime - the time that the retrieved elements must be effective for

forLineage - return elements marked with the Memento classification?

forDuplicateProcessing - do not merge elements marked as duplicates?

Throws:

InvalidParameterException - one of the parameters is invalid

UserNotAuthorizedException - the user is not authorized to issue this request

PropertyServerException - there is a problem reported in the open metadata server(s)

getMembersOfSubjectArea

public List<MetadataElementSummary> getMembersOfSubjectArea(String userId,
 String subjectAreaName,
 int startFrom,
 int pageSize,
 Date effectiveTime,
 boolean forLineage,
 boolean forDuplicateProcessing)
                                                     throws InvalidParameterException,
UserNotAuthorizedException,
PropertyServerException

Return information about the contents of a subject area such as the glossaries, reference data sets and quality definitions.

Specified by:

getMembersOfSubjectArea in interface StewardshipManagementInterface

Parameters:

userId - calling user

subjectAreaName - unique identifier for the subject area

startFrom - paging start point

pageSize - maximum results that can be returned

effectiveTime - the time that the retrieved elements must be effective for

forLineage - return elements marked with the Memento classification?

forDuplicateProcessing - do not merge elements marked as duplicates?

Returns:

list of element stubs

Throws:

InvalidParameterException - qualifiedName or userId is null

PropertyServerException - problem accessing property server

UserNotAuthorizedException - security access problem

setupSemanticAssignment

public void setupSemanticAssignment(String userId,
 String elementGUID,
 String glossaryTermGUID,
 SemanticAssignmentProperties properties,
 Date effectiveTime,
 boolean forLineage,
 boolean forDuplicateProcessing)
                             throws InvalidParameterException,
UserNotAuthorizedException,
PropertyServerException

Create a semantic assignment relationship between a glossary term and an element (normally a schema attribute, data field or asset). This relationship indicates that the data associated with the element meaning matches the description in the glossary term.

Specified by:

setupSemanticAssignment in interface StewardshipManagementInterface

Parameters:

userId - calling user

elementGUID - unique identifier of the element that is being assigned to the glossary term

glossaryTermGUID - unique identifier of the glossary term that provides the meaning

effectiveTime - the time that the retrieved elements must be effective for

forLineage - return elements marked with the Memento classification?

forDuplicateProcessing - do not merge elements marked as duplicates?

properties - properties for relationship

Throws:

InvalidParameterException - one of the parameters is invalid

UserNotAuthorizedException - the user is not authorized to issue this request

PropertyServerException - there is a problem reported in the open metadata server(s)

clearSemanticAssignment

public void clearSemanticAssignment(String userId,
 String elementGUID,
 String glossaryTermGUID,
 Date effectiveTime,
 boolean forLineage,
 boolean forDuplicateProcessing)
                             throws InvalidParameterException,
UserNotAuthorizedException,
PropertyServerException

Remove a semantic assignment relationship between an element and its glossary term.

Specified by:

clearSemanticAssignment in interface StewardshipManagementInterface

Parameters:

userId - calling user

elementGUID - unique identifier of the element that is being assigned to the glossary term

glossaryTermGUID - unique identifier of the glossary term that provides the meaning

effectiveTime - the time that the retrieved elements must be effective for

forLineage - return elements marked with the Memento classification?

forDuplicateProcessing - do not merge elements marked as duplicates?

Throws:

InvalidParameterException - one of the parameters is invalid

UserNotAuthorizedException - the user is not authorized to issue this request

PropertyServerException - there is a problem reported in the open metadata server(s)

getMeanings

public List<GlossaryTermElement> getMeanings(String userId,
 String elementGUID,
 int startFrom,
 int pageSize,
 Date effectiveTime,
 boolean forLineage,
 boolean forDuplicateProcessing)
                                      throws InvalidParameterException,
UserNotAuthorizedException,
PropertyServerException

Retrieve the glossary terms linked via a "SemanticAssignment" relationship to the requested element.

Specified by:

getMeanings in interface StewardshipManagementInterface

Parameters:

userId - calling user

elementGUID - unique identifier of the element

startFrom - index of the list to start from (0 for start)

pageSize - maximum number of elements to return.

effectiveTime - the time that the retrieved elements must be effective for

forLineage - return elements marked with the Memento classification?

forDuplicateProcessing - do not merge elements marked as duplicates?

Returns:

list of related elements

Throws:

InvalidParameterException - one of the parameters is invalid

UserNotAuthorizedException - the user is not authorized to issue this request

PropertyServerException - there is a problem reported in the open metadata server(s)

getSemanticAssignees

public List<RelatedMetadataElementSummary> getSemanticAssignees(String userId,
 String glossaryTermGUID,
 int startFrom,
 int pageSize,
 Date effectiveTime,
 boolean forLineage,
 boolean forDuplicateProcessing)
                                                         throws InvalidParameterException,
UserNotAuthorizedException,
PropertyServerException

Retrieve the elements linked via a "SemanticAssignment" relationship to the requested glossary term.

Specified by:

getSemanticAssignees in interface StewardshipManagementInterface

Parameters:

userId - calling user

glossaryTermGUID - unique identifier of the glossary term that the returned elements are linked to

startFrom - index of the list to start from (0 for start)

pageSize - maximum number of elements to return.

effectiveTime - the time that the retrieved elements must be effective for

forLineage - return elements marked with the Memento classification?

forDuplicateProcessing - do not merge elements marked as duplicates?

Returns:

list of related elements

Throws:

InvalidParameterException - one of the parameters is invalid

UserNotAuthorizedException - the user is not authorized to issue this request

PropertyServerException - there is a problem reported in the open metadata server(s)

addGovernanceDefinitionToElement

public void addGovernanceDefinitionToElement(String userId,
 String definitionGUID,
 String elementGUID,
 Date effectiveTime,
 boolean forLineage,
 boolean forDuplicateProcessing)
                                      throws InvalidParameterException,
UserNotAuthorizedException,
PropertyServerException

Link a governance definition to an element using the GovernedBy relationship.

Specified by:

addGovernanceDefinitionToElement in interface StewardshipManagementInterface

Parameters:

userId - calling user

definitionGUID - identifier of the governance definition to link

elementGUID - unique identifier of the metadata element to link

effectiveTime - the time that the retrieved elements must be effective for

forLineage - return elements marked with the Memento classification?

forDuplicateProcessing - do not merge elements marked as duplicates?

Throws:

InvalidParameterException - one of the parameters is invalid

UserNotAuthorizedException - the user is not authorized to issue this request

PropertyServerException - there is a problem reported in the open metadata server(s)

removeGovernanceDefinitionFromElement

public void removeGovernanceDefinitionFromElement(String userId,
 String definitionGUID,
 String elementGUID,
 Date effectiveTime,
 boolean forLineage,
 boolean forDuplicateProcessing)
                                           throws InvalidParameterException,
UserNotAuthorizedException,
PropertyServerException

Remove the GovernedBy relationship between a governance definition and an element.

Specified by:

removeGovernanceDefinitionFromElement in interface StewardshipManagementInterface

Parameters:

userId - calling user

definitionGUID - identifier of the governance definition to link

elementGUID - unique identifier of the metadata element to update

effectiveTime - the time that the retrieved elements must be effective for

forLineage - return elements marked with the Memento classification?

forDuplicateProcessing - do not merge elements marked as duplicates?

Throws:

InvalidParameterException - one of the parameters is invalid

UserNotAuthorizedException - the user is not authorized to issue this request

PropertyServerException - there is a problem reported in the open metadata server(s)

getGovernedByDefinitions

public List<GovernanceDefinitionElement> getGovernedByDefinitions(String userId,
 String elementGUID,
 int startFrom,
 int pageSize,
 Date effectiveTime,
 boolean forLineage,
 boolean forDuplicateProcessing)
                                                           throws InvalidParameterException,
UserNotAuthorizedException,
PropertyServerException

Retrieve the governance definitions linked via a "GovernedBy" relationship to the requested element.

Specified by:

getGovernedByDefinitions in interface StewardshipManagementInterface

Parameters:

userId - calling user

elementGUID - unique identifier of the element

startFrom - index of the list to start from (0 for start)

pageSize - maximum number of elements to return.

effectiveTime - the time that the retrieved elements must be effective for

forLineage - return elements marked with the Memento classification?

forDuplicateProcessing - do not merge elements marked as duplicates?

Returns:

list of related elements

Throws:

InvalidParameterException - one of the parameters is invalid

UserNotAuthorizedException - the user is not authorized to issue this request

PropertyServerException - there is a problem reported in the open metadata server(s)

getGovernedElements

public List<RelatedMetadataElementSummary> getGovernedElements(String userId,
 String governanceDefinitionGUID,
 int startFrom,
 int pageSize,
 Date effectiveTime,
 boolean forLineage,
 boolean forDuplicateProcessing)
                                                        throws InvalidParameterException,
UserNotAuthorizedException,
PropertyServerException

Retrieve the elements linked via a "GovernedBy" relationship to the requested governance definition.

Specified by:

getGovernedElements in interface StewardshipManagementInterface

Parameters:

userId - calling user

governanceDefinitionGUID - unique identifier of the governance definition that the returned elements are linked to

startFrom - index of the list to start from (0 for start)

pageSize - maximum number of elements to return.

effectiveTime - the time that the retrieved elements must be effective for

forLineage - return elements marked with the Memento classification?

forDuplicateProcessing - do not merge elements marked as duplicates?

Returns:

list of related elements

Throws:

InvalidParameterException - one of the parameters is invalid

UserNotAuthorizedException - the user is not authorized to issue this request

PropertyServerException - there is a problem reported in the open metadata server(s)

getSourceElements

public List<RelatedMetadataElementSummary> getSourceElements(String userId,
 String elementGUID,
 int startFrom,
 int pageSize,
 Date effectiveTime,
 boolean forLineage,
 boolean forDuplicateProcessing)
                                                      throws InvalidParameterException,
UserNotAuthorizedException,
PropertyServerException

Retrieve the elements linked via a "SourceFrom" relationship to the requested element. The elements returned were used to create the requested element. Typically only one element is returned.

Specified by:

getSourceElements in interface StewardshipManagementInterface

Parameters:

userId - calling user

elementGUID - unique identifier of the element

startFrom - index of the list to start from (0 for start)

pageSize - maximum number of elements to return.

effectiveTime - the time that the retrieved elements must be effective for

forLineage - return elements marked with the Memento classification?

forDuplicateProcessing - do not merge elements marked as duplicates?

Returns:

list of related elements

Throws:

InvalidParameterException - one of the parameters is invalid

UserNotAuthorizedException - the user is not authorized to issue this request

PropertyServerException - there is a problem reported in the open metadata server(s)

getElementsSourceFrom

public List<RelatedMetadataElementSummary> getElementsSourceFrom(String userId,
 String elementGUID,
 int startFrom,
 int pageSize,
 Date effectiveTime,
 boolean forLineage,
 boolean forDuplicateProcessing)
                                                          throws InvalidParameterException,
UserNotAuthorizedException,
PropertyServerException

Retrieve the elements linked via a "SourceFrom" relationship to the requested element. The elements returned were created using the requested element as a template.

Specified by:

getElementsSourceFrom in interface StewardshipManagementInterface

Parameters:

userId - calling user

elementGUID - unique identifier of the element that the returned elements are linked to

startFrom - index of the list to start from (0 for start)

pageSize - maximum number of elements to return.

effectiveTime - the time that the retrieved elements must be effective for

forLineage - return elements marked with the Memento classification?

forDuplicateProcessing - do not merge elements marked as duplicates?

Returns:

list of related elements

Throws:

InvalidParameterException - one of the parameters is invalid

UserNotAuthorizedException - the user is not authorized to issue this request

PropertyServerException - there is a problem reported in the open metadata server(s)

getMetadataElementByGUID

public MetadataElementSummary getMetadataElementByGUID(String userId,
 String elementGUID,
 boolean forLineage,
 boolean forDuplicateProcessing,
 Date effectiveTime)
                                                throws InvalidParameterException,
UserNotAuthorizedException,
PropertyServerException

Retrieve the metadata element using its unique identifier.

Specified by:

getMetadataElementByGUID in interface StewardshipManagementInterface

Parameters:

userId - calling user

elementGUID - unique identifier for the metadata element

forLineage - the retrieved element is for lineage processing so include archived elements

forDuplicateProcessing - the retrieved element is for duplicate processing so do not combine results from known duplicates.

effectiveTime - only return the element if it is effective at this time. Null means anytime. Use "new Date()" for now.

Returns:

metadata element properties

Throws:

InvalidParameterException - one of the parameters is invalid

UserNotAuthorizedException - the user is not authorized to issue this request

PropertyServerException - there is a problem reported in the open metadata server(s)

getMetadataElementByUniqueName

public MetadataElementSummary getMetadataElementByUniqueName(String userId,
 String uniqueName,
 String uniquePropertyName,
 boolean forLineage,
 boolean forDuplicateProcessing,
 Date effectiveTime)
                                                      throws InvalidParameterException,
UserNotAuthorizedException,
PropertyServerException

Retrieve the metadata element using its unique name (typically the qualified name).

Specified by:

getMetadataElementByUniqueName in interface StewardshipManagementInterface

Parameters:

userId - calling user

uniqueName - unique name for the metadata element

uniquePropertyName - name of property name to test in the open metadata element - if null "qualifiedName" is used

forLineage - the retrieved element is for lineage processing so include archived elements

forDuplicateProcessing - the retrieved element is for duplicate processing so do not combine results from known duplicates.

effectiveTime - only return the element if it is effective at this time. Null means anytime. Use "new Date()" for now.

Returns:

metadata element properties

Throws:

InvalidParameterException - one of the parameters is invalid

UserNotAuthorizedException - the user is not authorized to issue this request

PropertyServerException - there is a problem reported in the open metadata server(s)

getMetadataElementGUIDByUniqueName

public String getMetadataElementGUIDByUniqueName(String userId,
 String uniqueName,
 String uniquePropertyName,
 boolean forLineage,
 boolean forDuplicateProcessing,
 Date effectiveTime)
                                          throws InvalidParameterException,
UserNotAuthorizedException,
PropertyServerException

Retrieve the unique identifier of a metadata element using its unique name (typically the qualified name).

Specified by:

getMetadataElementGUIDByUniqueName in interface StewardshipManagementInterface

Parameters:

userId - calling user

uniqueName - unique name for the metadata element

uniquePropertyName - name of property name to test in the open metadata element - if null "qualifiedName" is used

forLineage - the retrieved element is for lineage processing so include archived elements

forDuplicateProcessing - the retrieved element is for duplicate processing so do not combine results from known duplicates.

effectiveTime - only return the element if it is effective at this time. Null means anytime. Use "new Date()" for now.

Returns:

metadata element unique identifier (guid)

Throws:

InvalidParameterException - one of the parameters is invalid

UserNotAuthorizedException - the user is not authorized to issue this request

PropertyServerException - there is a problem reported in the open metadata server(s)

getElements

public List<MetadataElementSummary> getElements(String userId,
 FindProperties findProperties,
 int startFrom,
 int pageSize,
 boolean forLineage,
 boolean forDuplicateProcessing)
                                         throws InvalidParameterException,
UserNotAuthorizedException,
PropertyServerException

Retrieve elements of the requested type name.

Specified by:

getElements in interface StewardshipManagementInterface

Parameters:

userId - calling user

findProperties - open metadata type to search on

startFrom - index of the list to start from (0 for start)

pageSize - maximum number of elements to return.

forLineage - return elements marked with the Memento classification?

forDuplicateProcessing - do not merge elements marked as duplicates?

Returns:

list of related elements

Throws:

InvalidParameterException - one of the parameters is invalid

UserNotAuthorizedException - the user is not authorized to issue this request

PropertyServerException - there is a problem reported in the open metadata server(s)

getElementsByPropertyValue

public List<MetadataElementSummary> getElementsByPropertyValue(String userId,
 FindPropertyNamesProperties findProperties,
 int startFrom,
 int pageSize,
 boolean forLineage,
 boolean forDuplicateProcessing)
                                                        throws InvalidParameterException,
UserNotAuthorizedException,
PropertyServerException

Retrieve elements by a value found in one of the properties specified. The value must match exactly. An open metadata type name may be supplied to restrict the results.

Specified by:

getElementsByPropertyValue in interface StewardshipManagementInterface

Parameters:

userId - calling user

findProperties - properties and optional open metadata type to search on

startFrom - index of the list to start from (0 for start)

pageSize - maximum number of elements to return.

forLineage - return elements marked with the Memento classification?

forDuplicateProcessing - do not merge elements marked as duplicates?

Returns:

list of related elements

Throws:

InvalidParameterException - one of the parameters is invalid

UserNotAuthorizedException - the user is not authorized to issue this request

PropertyServerException - there is a problem reported in the open metadata server(s)

findElementsByPropertyValue

public List<MetadataElementSummary> findElementsByPropertyValue(String userId,
 FindPropertyNamesProperties findProperties,
 int startFrom,
 int pageSize,
 boolean forLineage,
 boolean forDuplicateProcessing)
                                                         throws InvalidParameterException,
UserNotAuthorizedException,
PropertyServerException

Retrieve elements by a value found in one of the properties specified. The value must be contained in the properties rather than needing to be an exact match. An open metadata type name may be supplied to restrict the results.

Specified by:

findElementsByPropertyValue in interface StewardshipManagementInterface

Parameters:

userId - calling user

findProperties - properties and optional open metadata type to search on

startFrom - index of the list to start from (0 for start)

pageSize - maximum number of elements to return.

forLineage - return elements marked with the Memento classification?

forDuplicateProcessing - do not merge elements marked as duplicates?

Returns:

list of related elements

Throws:

InvalidParameterException - one of the parameters is invalid

UserNotAuthorizedException - the user is not authorized to issue this request

PropertyServerException - there is a problem reported in the open metadata server(s)

getElementsByClassification

public List<MetadataElementSummary> getElementsByClassification(String userId,
 String classificationName,
 FindProperties findProperties,
 int startFrom,
 int pageSize,
 boolean forLineage,
 boolean forDuplicateProcessing)
                                                         throws InvalidParameterException,
UserNotAuthorizedException,
PropertyServerException

Retrieve elements with the requested classification name. It is also possible to limit the results by specifying a type name for the elements that should be returned. If no type name is specified then any type of element may be returned.

Specified by:

getElementsByClassification in interface StewardshipManagementInterface

Parameters:

userId - calling user

classificationName - name of classification

findProperties - open metadata type to search on

startFrom - index of the list to start from (0 for start)

pageSize - maximum number of elements to return.

forLineage - return elements marked with the Memento classification?

forDuplicateProcessing - do not merge elements marked as duplicates?

Returns:

list of related elements

Throws:

InvalidParameterException - one of the parameters is invalid

UserNotAuthorizedException - the user is not authorized to issue this request

PropertyServerException - there is a problem reported in the open metadata server(s)

getElementsByClassificationWithPropertyValue

public List<MetadataElementSummary> getElementsByClassificationWithPropertyValue(String userId,
 String classificationName,
 FindPropertyNamesProperties findProperties,
 int startFrom,
 int pageSize,
 boolean forLineage,
 boolean forDuplicateProcessing)
                                                                          throws InvalidParameterException,
UserNotAuthorizedException,
PropertyServerException

Retrieve elements with the requested classification name and with the requested a value found in one of the classification's properties specified. The value must match exactly. An open metadata type name may be supplied to restrict the types of elements returned.

Specified by:

getElementsByClassificationWithPropertyValue in interface StewardshipManagementInterface

Parameters:

userId - calling user

classificationName - name of classification

findProperties - properties and optional open metadata type to search on

startFrom - index of the list to start from (0 for start)

pageSize - maximum number of elements to return.

forLineage - return elements marked with the Memento classification?

forDuplicateProcessing - do not merge elements marked as duplicates?

Returns:

list of related elements

Throws:

InvalidParameterException - one of the parameters is invalid

UserNotAuthorizedException - the user is not authorized to issue this request

PropertyServerException - there is a problem reported in the open metadata server(s)

findElementsByClassificationWithPropertyValue

public List<MetadataElementSummary> findElementsByClassificationWithPropertyValue(String userId,
 String classificationName,
 FindPropertyNamesProperties findProperties,
 int startFrom,
 int pageSize,
 boolean forLineage,
 boolean forDuplicateProcessing)
                                                                           throws InvalidParameterException,
UserNotAuthorizedException,
PropertyServerException

Retrieve elements with the requested classification name and with the requested a value found in one of the classification's properties specified. The value must be contained in the properties rather than needing to be an exact match. An open metadata type name may be supplied to restrict the results.

Specified by:

findElementsByClassificationWithPropertyValue in interface StewardshipManagementInterface

Parameters:

userId - calling user

classificationName - name of classification

findProperties - properties and optional open metadata type to search on

startFrom - index of the list to start from (0 for start)

pageSize - maximum number of elements to return.

forLineage - return elements marked with the Memento classification?

forDuplicateProcessing - do not merge elements marked as duplicates?

Returns:

list of related elements

Throws:

InvalidParameterException - one of the parameters is invalid

UserNotAuthorizedException - the user is not authorized to issue this request

PropertyServerException - there is a problem reported in the open metadata server(s)

getRelatedElements

public List<RelatedMetadataElementSummary> getRelatedElements(String userId,
 String elementGUID,
 String relationshipTypeName,
 int startingAtEnd,
 FindProperties findProperties,
 int startFrom,
 int pageSize,
 boolean forLineage,
 boolean forDuplicateProcessing)
                                                       throws InvalidParameterException,
UserNotAuthorizedException,
PropertyServerException

Retrieve related elements of the requested type name.

Specified by:

getRelatedElements in interface StewardshipManagementInterface

Parameters:

userId - calling user

elementGUID - unique identifier of the starting end

relationshipTypeName - name of relationship

startingAtEnd - indicates which end to retrieve from (0 is "either end"; 1 is end1; 2 is end 2)

findProperties - open metadata type to search on

startFrom - index of the list to start from (0 for start)

pageSize - maximum number of elements to return.

forLineage - return elements marked with the Memento classification?

forDuplicateProcessing - do not merge elements marked as duplicates?

Returns:

list of related elements

Throws:

InvalidParameterException - one of the parameters is invalid

UserNotAuthorizedException - the user is not authorized to issue this request

PropertyServerException - there is a problem reported in the open metadata server(s)

getRelatedElementsWithPropertyValue

public List<RelatedMetadataElementSummary> getRelatedElementsWithPropertyValue(String userId,
 String elementGUID,
 String relationshipTypeName,
 int startingAtEnd,
 FindPropertyNamesProperties findProperties,
 int startFrom,
 int pageSize,
 boolean forLineage,
 boolean forDuplicateProcessing)
                                                                        throws InvalidParameterException,
UserNotAuthorizedException,
PropertyServerException

Retrieve elements linked via the requested relationship type name and with the requested a value found in one of the classification's properties specified. The value must match exactly. An open metadata type name may be supplied to restrict the types of elements returned.

Specified by:

getRelatedElementsWithPropertyValue in interface StewardshipManagementInterface

Parameters:

userId - calling user

elementGUID - unique identifier of the starting element

relationshipTypeName - name of relationship

startingAtEnd - indicates which end to retrieve from (0 is "either end"; 1 is end1; 2 is end 2)

findProperties - properties and optional open metadata type to search on

startFrom - index of the list to start from (0 for start)

pageSize - maximum number of elements to return.

forLineage - return elements marked with the Memento classification?

forDuplicateProcessing - do not merge elements marked as duplicates?

Returns:

list of related elements

Throws:

InvalidParameterException - one of the parameters is invalid

UserNotAuthorizedException - the user is not authorized to issue this request

PropertyServerException - there is a problem reported in the open metadata server(s)

findRelatedElementsWithPropertyValue

public List<RelatedMetadataElementSummary> findRelatedElementsWithPropertyValue(String userId,
 String elementGUID,
 String relationshipTypeName,
 int startingAtEnd,
 FindPropertyNamesProperties findProperties,
 int startFrom,
 int pageSize,
 boolean forLineage,
 boolean forDuplicateProcessing)
                                                                         throws InvalidParameterException,
UserNotAuthorizedException,
PropertyServerException

Retrieve elements linked via the requested relationship type name and with the relationship's properties specified. The value must be contained in the by a value found in one of the properties specified. The value must be contained in the properties rather than needing to be an exact match. An open metadata type name may be supplied to restrict the results.

Specified by:

findRelatedElementsWithPropertyValue in interface StewardshipManagementInterface

Parameters:

userId - calling user

elementGUID - unique identifier of the starting element

relationshipTypeName - name of relationship

startingAtEnd - indicates which end to retrieve from (0 is "either end"; 1 is end1; 2 is end 2)

findProperties - properties and optional open metadata type to search on

startFrom - index of the list to start from (0 for start)

pageSize - maximum number of elements to return.

forLineage - return elements marked with the Memento classification?

forDuplicateProcessing - do not merge elements marked as duplicates?

Returns:

list of related elements

Throws:

InvalidParameterException - one of the parameters is invalid

UserNotAuthorizedException - the user is not authorized to issue this request

PropertyServerException - there is a problem reported in the open metadata server(s)

getRelationships

public List<MetadataRelationshipSummary> getRelationships(String userId,
 String relationshipTypeName,
 FindProperties findProperties,
 int startFrom,
 int pageSize,
 boolean forLineage,
 boolean forDuplicateProcessing)
                                                   throws InvalidParameterException,
UserNotAuthorizedException,
PropertyServerException

Retrieve relationships of the requested relationship type name.

Specified by:

getRelationships in interface StewardshipManagementInterface

Parameters:

userId - calling user

relationshipTypeName - name of relationship

findProperties - properties describing the search

startFrom - index of the list to start from (0 for start)

pageSize - maximum number of elements to return.

forLineage - return elements marked with the Memento classification?

forDuplicateProcessing - do not merge elements marked as duplicates?

Returns:

list of related elements

Throws:

InvalidParameterException - one of the parameters is invalid

UserNotAuthorizedException - the user is not authorized to issue this request

PropertyServerException - there is a problem reported in the open metadata server(s)

getRelationshipsWithPropertyValue

public List<MetadataRelationshipSummary> getRelationshipsWithPropertyValue(String userId,
 String relationshipTypeName,
 FindPropertyNamesProperties findProperties,
 int startFrom,
 int pageSize,
 boolean forLineage,
 boolean forDuplicateProcessing)
                                                                    throws InvalidParameterException,
UserNotAuthorizedException,
PropertyServerException

Retrieve relationships of the requested relationship type name and with the requested a value found in one of the relationship's properties specified. The value must match exactly.

Specified by:

getRelationshipsWithPropertyValue in interface StewardshipManagementInterface

Parameters:

userId - calling user

relationshipTypeName - name of relationship

findProperties - properties and optional open metadata type to search on

startFrom - index of the list to start from (0 for start)

pageSize - maximum number of elements to return.

forLineage - return elements marked with the Memento classification?

forDuplicateProcessing - do not merge elements marked as duplicates?

Returns:

list of related elements

Throws:

InvalidParameterException - one of the parameters is invalid

UserNotAuthorizedException - the user is not authorized to issue this request

PropertyServerException - there is a problem reported in the open metadata server(s)

findRelationshipsWithPropertyValue

public List<MetadataRelationshipSummary> findRelationshipsWithPropertyValue(String userId,
 String relationshipTypeName,
 FindPropertyNamesProperties findProperties,
 int startFrom,
 int pageSize,
 boolean forLineage,
 boolean forDuplicateProcessing)
                                                                     throws InvalidParameterException,
UserNotAuthorizedException,
PropertyServerException

Retrieve relationships of the requested relationship type name and with the requested a value found in one of the relationship's properties specified. The value must only be contained in the properties rather than needing to be an exact match.

Specified by:

findRelationshipsWithPropertyValue in interface StewardshipManagementInterface

Parameters:

userId - calling user

relationshipTypeName - name of relationship

findProperties - properties and optional open metadata type to search on

startFrom - index of the list to start from (0 for start)

pageSize - maximum number of elements to return.

forLineage - return elements marked with the Memento classification?

forDuplicateProcessing - do not merge elements marked as duplicates?

Returns:

list of related elements

Throws:

InvalidParameterException - one of the parameters is invalid

UserNotAuthorizedException - the user is not authorized to issue this request

PropertyServerException - there is a problem reported in the open metadata server(s)

retrieveInstanceForGUID

public ElementHeader retrieveInstanceForGUID(String userId,
 String guid,
 boolean forLineage,
 boolean forDuplicateProcessing,
 Date effectiveTime)
                                      throws InvalidParameterException,
UserNotAuthorizedException,
PropertyServerException

Retrieve the header for the instance identified by the supplied unique identifier. It may be an element (entity) or a relationship between elements.

Specified by:

retrieveInstanceForGUID in interface StewardshipManagementInterface

Parameters:

userId - name of the server instance to connect to

guid - identifier to use in the lookup

forLineage - return elements marked with the Memento classification?

forDuplicateProcessing - do not merge elements marked as duplicates?

effectiveTime - effective time

Returns:

list of matching elements or InvalidParameterException one of the parameters is invalid UserNotAuthorizedException the user is not authorized to issue this request PropertyServerException there is a problem reported in the open metadata server(s)

Throws:

InvalidParameterException

UserNotAuthorizedException

PropertyServerException