org.odpi.openmetadata.commonservices.generichandlers

Class OpenMetadataAPIGenericHandler<B>

java.lang.Object

org.odpi.openmetadata.commonservices.generichandlers.OpenMetadataAPIGenericHandler<B>

Direct Known Subclasses:

DataFieldHandler, DiscoveryAnalysisReportHandler, GovernanceZoneHandler, InformalTagHandler, LikeHandler, RatingHandler, ReferenceableHandler, RelatedAssetHandler, SearchKeywordHandler

public class OpenMetadataAPIGenericHandler<B>
extends Object

OpenMetadataAPIGenericHandler manages the exchange of Open Metadata API Bean content with the repository services (via the repository handler).

Field Summary

Fields

Modifier and Type	Field and Description
protected AuditLog	auditLog
protected Class<B>	beanClass
protected OpenMetadataAPIGenericConverter<B>	converter
protected List<String>	defaultZones
protected RepositoryErrorHandler	errorHandler
protected InvalidParameterHandler	invalidParameterHandler
protected String	localServerUserId
protected List<String>	publishZones
protected RepositoryHandler	repositoryHandler
protected OMRSRepositoryHelper	repositoryHelper
protected OpenMetadataServerSecurityVerifier	securityVerifier
protected String	serverName
protected String	serviceName
protected List<String>	supportedZones

Constructor Summary

Constructors

Constructor and Description

OpenMetadataAPIGenericHandler(OpenMetadataAPIGenericConverter<B> converter, Class<B> beanClass, String serviceName, String serverName, InvalidParameterHandler invalidParameterHandler, RepositoryHandler repositoryHandler, OMRSRepositoryHelper repositoryHelper, String localServerUserId, OpenMetadataServerSecurityVerifier securityVerifier, List<String> supportedZones, List<String> defaultZones, List<String> publishZones, AuditLog auditLog) Construct the handler information needed to interact with the repository services

Method Summary

Modifier and Type	Method and Description
int	countAttachments(String userId, String elementGUID, String elementTypeName, String attachmentTypeGUID, String attachmentTypeName, String methodName) Count up the number of elements of a certain type that are attached to a specific entity.
String	createBeanFromTemplate(String userId, String externalSourceGUID, String externalSourceName, String templateGUID, String templateGUIDParameterName, String entityTypeGUID, String entityTypeName, String uniqueParameterValue, String uniqueParameterName, OpenMetadataAPIGenericBuilder propertyBuilder, String methodName) Create a new entity in the repository based on the contents of an existing entity (the template).
String	createBeanInRepository(String userId, String externalSourceGUID, String externalSourceName, String entityTypeGUID, String entityTypeName, String uniqueParameterValue, String uniqueParameterName, OpenMetadataAPIGenericBuilder propertyBuilder, String methodName) Create a new entity in the repository assuming all parameters are ok.
void	deleteBeanInRepository(String userId, String externalSourceGUID, String externalSourceName, String entityGUID, String entityGUIDParameterName, String entityTypeGUID, String entityTypeName, String validatingPropertyName, String validatingPropertyValue, List<String> serviceSupportedZones, String methodName) Delete an entity from the repository.
void	deleteBeanInRepository(String userId, String externalSourceGUID, String externalSourceName, String entityGUID, String entityGUIDParameterName, String entityTypeGUID, String entityTypeName, String validatingPropertyName, String validatingPropertyValue, String methodName) Delete an entity from the repository.
List<String>	findBeanGUIDs(String userId, String searchString, String searchStringParameterName, String resultTypeGUID, String resultTypeName, int startFrom, int pageSize, String methodName) Return the list of beans of the requested type that match the supplied value.
List<B>	findBeans(String userId, String searchString, String searchStringParameterName, String resultTypeGUID, String resultTypeName, int startFrom, int pageSize, String methodName) Return the list of beans matching the supplied searchString.
List<B>	findBeans(String userId, String searchString, String searchStringParameterName, String resultTypeGUID, String resultTypeName, List<String> serviceSupportedZones, int startFrom, int pageSize, String methodName) Return the list of beans matching the supplied searchString.
List<B>	findBeans(String userId, String searchString, String searchStringParameterName, String resultTypeGUID, String resultTypeName, String requiredClassificationName, String omittedClassificationName, int startFrom, int pageSize, String methodName) Return the list of beans matching the supplied searchString.
List<EntityDetail>	findEntities(String userId, String searchString, String searchStringParameterName, String resultTypeGUID, String resultTypeName, String requiredClassificationName, String omittedClassificationName, int startFrom, int pageSize, String methodName) Return the list of entities matching the supplied searchString.
List<Relationship>	getAllAttachmentLinks(String userId, String startingGUID, String startingGUIDParameterName, String startingTypeName, String methodName) Return all relationships attached to a specific entity.
List<B>	getAnchorsForAttachedElements(String userId, String startingGUID, String startingGUIDParameterName, String startingTypeName, String attachmentRelationshipTypeGUID, String attachmentRelationshipTypeName, String attachmentEntityTypeName, String requiredClassificationName, String omittedClassificationName, int selectionEnd, List<String> serviceSupportedZones, int startingFrom, int pageSize, String methodName) Return the elements of the requested type attached to an entity identified by the starting GUID.
B	getAttachedElement(String userId, String startingElementGUID, String startingElementGUIDParameterName, String startingElementTypeName, String relationshipTypeGUID, String relationshipTypeName, String resultingElementTypeName, List<String> serviceSupportedZones, String methodName) Return the Bean for the required relationship attached to a specific element.
B	getAttachedElement(String userId, String startingElementGUID, String startingElementGUIDParameterName, String startingElementTypeName, String relationshipTypeGUID, String relationshipTypeName, String resultingElementTypeName, String methodName) Return the Bean for the required relationship attached to a specific element.
String	getAttachedElementGUID(String userId, String startingGUID, String startingGUIDParameterName, String startingTypeName, String attachmentRelationshipTypeGUID, String attachmentRelationshipTypeName, String attachmentEntityTypeName, int selectionEnd, List<String> serviceSupportedZones, String methodName) Return the elements of the requested type attached to an entity identified by the starting GUID.
String	getAttachedElementGUID(String userId, String startingGUID, String startingGUIDParameterName, String startingTypeName, String attachmentRelationshipTypeGUID, String attachmentRelationshipTypeName, String attachmentEntityTypeName, int selectionEnd, String methodName) Return the elements of the requested type attached to an entity identified by the starting GUID.
List<String>	getAttachedElementGUIDs(String userId, String startingGUID, String startingGUIDParameterName, String startingTypeName, String attachmentRelationshipTypeGUID, String attachmentRelationshipTypeName, String attachmentEntityTypeName, int startingFrom, int pageSize, String methodName) Return the elements of the requested type attached to an entity identified by the starting GUID.
List<String>	getAttachedElementGUIDs(String userId, String startingGUID, String startingGUIDParameterName, String startingTypeName, String attachmentRelationshipTypeGUID, String attachmentRelationshipTypeName, String attachmentEntityTypeName, List<String> serviceSupportedZones, int startingFrom, int pageSize, String methodName) Return the elements of the requested type attached to an entity identified by the starting GUID.
List<B>	getAttachedElements(String userId, String startingGUID, String startingGUIDParameterName, String startingTypeName, String attachmentRelationshipTypeGUID, String attachmentRelationshipTypeName, String attachmentEntityTypeName, int startingFrom, int pageSize, String methodName) Return the elements of the requested type attached to an entity identified by the starting GUID.
List<B>	getAttachedElements(String userId, String startingGUID, String startingGUIDParameterName, String startingTypeName, String attachmentRelationshipTypeGUID, String attachmentRelationshipTypeName, String attachmentEntityTypeName, List<String> serviceSupportedZones, int startingFrom, int pageSize, String methodName) Return the elements of the requested type attached to an entity identified by the starting GUID.
List<B>	getAttachedElements(String userId, String startingGUID, String startingGUIDParameterName, String startingTypeName, String attachmentRelationshipTypeGUID, String attachmentRelationshipTypeName, String attachmentEntityTypeName, String requiredClassificationName, String omittedClassificationName, int selectionEnd, int startingFrom, int pageSize, String methodName) Return the elements of the requested type attached to an entity identified by the starting GUID.
List<B>	getAttachedElements(String userId, String anchorGUID, String anchorGUIDParameterName, String startingGUID, String startingGUIDParameterName, String startingTypeName, String attachmentRelationshipTypeGUID, String attachmentRelationshipTypeName, String attachmentEntityTypeName, String requiredClassificationName, String omittedClassificationName, int selectionEnd, List<String> serviceSupportedZones, int startingFrom, int pageSize, String methodName) Return the elements of the requested type attached to an entity identified by the starting GUID.
List<EntityDetail>	getAttachedEntities(String userId, String startingElementGUID, String startingElementGUIDParameterName, String startingElementTypeName, String relationshipTypeGUID, String relationshipTypeName, String resultingElementTypeName, int startingFrom, int pageSize, String methodName) Return the entities for the required relationships attached to a specific entity.
List<EntityDetail>	getAttachedEntities(String userId, String startingElementGUID, String startingElementGUIDParameterName, String startingElementTypeName, String relationshipTypeGUID, String relationshipTypeName, String resultingElementTypeName, String requiredClassificationName, String omittedClassificationName, List<String> serviceSupportedZones, int startingFrom, int pageSize, String methodName) Return the entities for the required relationships attached to a specific entity.
EntityDetail	getAttachedEntity(String userId, String startingElementGUID, String startingElementGUIDParameterName, String startingElementTypeName, String relationshipTypeGUID, String relationshipTypeName, String resultingElementTypeName, List<String> serviceSupportedZones, String methodName) Return the entity for the required relationship attached to a specific entity.
EntityDetail	getAttachedEntity(String userId, String startingElementGUID, String startingElementGUIDParameterName, String startingElementTypeName, String relationshipTypeGUID, String relationshipTypeName, String resultingElementTypeName, String methodName) Return the entity for the required relationship attached to a specific entity.
List<Relationship>	getAttachmentLinks(String userId, String startingGUID, String startingGUIDParameterName, String startingTypeName, String attachmentRelationshipTypeGUID, String attachmentRelationshipTypeName, String attachmentEntityTypeName, int startingFrom, int pageSize, String methodName) Return the relationships to required elements attached to a specific entity.
List<Relationship>	getAttachmentLinks(String userId, String startingGUID, String startingGUIDParameterName, String startingTypeName, String attachmentRelationshipTypeGUID, String attachmentRelationshipTypeName, String attachmentEntityGUID, String attachmentEntityTypeName, int startingFrom, int pageSize, String methodName) Return the relationships to required elements attached to a specific entity.
B	getBeanByUniqueName(String userId, String name, String nameParameterName, String namePropertyName, String resultTypeGUID, String resultTypeName, List<String> serviceSupportedZones, String methodName) Return the list of beans of the requested type that match the supplied value.
B	getBeanByUniqueName(String userId, String name, String nameParameterName, String namePropertyName, String resultTypeGUID, String resultTypeName, String methodName) Return the list of beans of the requested type that match the supplied value.
B	getBeanByValue(String userId, String value, String valueParameterName, String resultTypeGUID, String resultTypeName, List<String> specificMatchPropertyNames, String methodName) Return the bean that matches the requested value.
B	getBeanFromRepository(String userId, String guid, String guidParameterName, String entityTypeName, List<String> serviceSupportedZones, String methodName) Return the bean for the supplied unique identifier (guid).
B	getBeanFromRepository(String userId, String guid, String guidParameterName, String resultTypeName, String methodName) Use the supplied unique identifier (guid) of an entity in the repository to retrieve its contents as a bean.
String	getBeanGUIDByUniqueName(String userId, String name, String nameParameterName, String namePropertyName, String resultTypeGUID, String resultTypeName, List<String> serviceSupportedZones, String methodName) Return the list of beans of the requested type that match the supplied value.
List<String>	getBeanGUIDsByClassification(String userId, String resultTypeGUID, String resultClassificationName, int startFrom, int pageSize, String methodName) Return the list of beans of the requested type that match the supplied name.
List<String>	getBeanGUIDsByType(String userId, String resultTypeGUID, String resultTypeName, int startFrom, int pageSize, String methodName) Return the list of beans of the requested type.
List<String>	getBeanGUIDsByType(String userId, String resultTypeGUID, String resultTypeName, List<String> serviceSupportedZones, int startFrom, int pageSize, String methodName) Return the list of beans of the requested type.
List<String>	getBeanGUIDsByValue(String userId, String value, String valueParameterName, String resultTypeGUID, String resultTypeName, List<String> specificMatchPropertyNames, boolean exactValueMatch, List<String> serviceSupportedZones, int startFrom, int pageSize, String methodName) Return the list of beans of the requested type that match the supplied value.
List<B>	getBeansByClassification(String userId, String resultTypeGUID, String resultClassificationName, int startFrom, int pageSize, String methodName) Return the list of beans of the requested type that match the supplied name.
List<B>	getBeansByCreator(String userId, String searchString, String searchStringParameterName, String resultTypeGUID, String resultTypeName, List<String> specificMatchPropertyNames, boolean exactValueMatch, List<String> serviceSupportedZones, int startFrom, int pageSize, String methodName) Return the list of beans of the requested type that were created by the requesting user.
List<B>	getBeansByType(String userId, String resultTypeGUID, String resultTypeName, int startFrom, int pageSize, String methodName) Return the list of beans of the requested type.
List<B>	getBeansByType(String userId, String resultTypeGUID, String resultTypeName, List<String> serviceSupportedZones, int startFrom, int pageSize, String methodName) Return the list of beans of the requested type that match the supplied name.
List<B>	getBeansByValue(String userId, String value, String valueParameterName, String resultTypeGUID, String resultTypeName, List<String> specificMatchPropertyNames, boolean exactValueMatch, int startFrom, int pageSize, String methodName) Return the list of beans of the requested type that match the supplied value.
List<B>	getBeansByValue(String userId, String value, String valueParameterName, String resultTypeGUID, String resultTypeName, List<String> specificMatchPropertyNames, boolean exactValueMatch, List<String> serviceSupportedZones, int startFrom, int pageSize, String methodName) Return the list of beans of the requested type that match the supplied value.
List<B>	getBeansByValue(String userId, String value, String valueParameterName, String resultTypeGUID, String resultTypeName, List<String> specificMatchPropertyNames, boolean exactValueMatch, String requiredClassificationName, String omittedClassificationName, int startFrom, int pageSize, String methodName) Return the list of beans of the requested type that match the supplied value.
List<B>	getBeansByValue(String userId, String value, String valueParameterName, String resultTypeGUID, String resultTypeName, List<String> specificMatchPropertyNames, boolean exactValueMatch, String requiredClassificationName, String omittedClassificationName, List<String> serviceSupportedZones, int startFrom, int pageSize, String methodName) Return the list of beans of the requested type that match the supplied value.
List<EntityDetail>	getEntitiesByType(String userId, String resultTypeGUID, String resultTypeName, List<String> serviceSupportedZones, int startFrom, int pageSize, String methodName) Return the list of entities of the requested type.
List<EntityDetail>	getEntitiesByValue(String userId, String value, String valueParameterName, String resultTypeGUID, String resultTypeName, List<String> specificMatchPropertyNames, boolean exactValueMatch, String requiredClassificationName, String omittedClassificationName, int startFrom, int pageSize, String methodName) Return the list of entities of the requested type that match the supplied value.
List<EntityDetail>	getEntitiesByValue(String userId, String value, String valueParameterName, String resultTypeGUID, String resultTypeName, List<String> specificMatchPropertyNames, boolean exactValueMatch, String requiredClassificationName, String omittedClassificationName, List<String> serviceSupportedZones, int startFrom, int pageSize, String methodName) Return the list of entities of the requested type that match the supplied value.
EntityDetail	getEntityByValue(String userId, String value, String valueParameterName, String resultTypeGUID, String resultTypeName, List<String> specificMatchPropertyNames, String methodName) Return the entity that matches the requested value.
EntityDetail	getEntityFromRepository(String userId, String requestedEntityGUID, String requestedEntityGUIDParameterName, String requestedEntityTypeName, String methodName) Return the keyword for the supplied unique identifier (guid).
EntityDetail	getEntityFromRepository(String userId, String requestedEntityGUID, String requestedEntityGUIDParameterName, String requestedEntityTypeName, String requiredClassificationName, String omittedClassificationName, List<String> serviceSupportedZones, String methodName) Return the entity for the supplied unique identifier (guid).
EntityDetail	getEntityFromRepository(String userId, String requestedEntityGUID, String requestedEntityGUIDParameterName, String requestedEntityTypeName, String requiredClassificationName, String omittedClassificationName, String methodName) Return the keyword for the supplied unique identifier (guid).
String	getEntityGUIDByValue(String userId, String value, String valueParameterName, String resultTypeGUID, String resultTypeName, List<String> specificMatchPropertyNames, String methodName) Return the unique identifier of the entity matching the value.
OMRSRepositoryHelper	getRepositoryHelper() Return the repository helper for this server.
String	getServiceName() Return the name of this service.
Relationship	getUniqueAttachmentLink(String userId, String startingGUID, String startingGUIDParameterName, String startingTypeName, String attachmentRelationshipTypeGUID, String attachmentRelationshipTypeName, String attachmentEntityGUID, String attachmentEntityTypeName, String methodName) Return the relationship between the requested elements - there should be only one.
void	linkElementToElement(String userId, String externalSourceGUID, String externalSourceName, String startingGUID, String startingGUIDParameterName, String startingElementTypeName, String attachingGUID, String attachingGUIDParameterName, String attachingElementTypeName, List<String> suppliedSupportedZones, String attachmentTypeGUID, String attachmentTypeName, InstanceProperties relationshipProperties, String methodName) Creates a relationship between two elements and updates the LatestChange in each one's anchor entity (if they have one).
void	linkElementToElement(String userId, String externalSourceGUID, String externalSourceName, String startingGUID, String startingGUIDParameterName, String startingElementTypeName, String attachingGUID, String attachingGUIDParameterName, String attachingElementTypeName, String relationshipTypeGUID, String relationshipTypeName, InstanceProperties relationshipProperties, String methodName) Creates a relationship between two elements and updates the LatestChange in each one's anchor entity (if they have one).
void	relinkElementToNewElement(String userId, String externalSourceGUID, String externalSourceName, String startingGUID, String startingGUIDParameterName, String startingElementTypeName, boolean startAtEnd1, String newAttachingGUID, String newAttachingGUIDParameterName, String newAttachingElementTypeName, List<String> suppliedSupportedZones, String attachmentTypeGUID, String attachmentTypeName, InstanceProperties relationshipProperties, String methodName) Deleted the existing relationship between the starting element and another element then create a new relationship between the starting element element and the new attaching element.
void	relinkElementToNewElement(String userId, String externalSourceGUID, String externalSourceName, String startingGUID, String startingGUIDParameterName, String startingElementTypeName, boolean startAtEnd1, String newAttachingGUID, String newAttachingGUIDParameterName, String newAttachingElementTypeName, String attachmentTypeGUID, String attachmentTypeName, InstanceProperties relationshipProperties, String methodName) Delete the existing relationship between the starting element and another element then create a new relationship between the starting element element and the new attaching element.
void	setSecurityVerifier(OpenMetadataServerSecurityVerifier securityVerifier) Set up a new security verifier (the handler runs with a default verifier until this method is called).
void	unlinkAllElements(String userId, boolean onlyCreatorPermitted, String externalSourceGUID, String externalSourceName, String startingGUID, String startingGUIDParameterName, String startingElementTypeName, List<String> suppliedSupportedZones, String attachmentTypeGUID, String attachmentTypeName, String methodName) Calls unlinkElementFromElement for all relationships of a certain type emanating from the requested element.
String	unlinkConnectedElement(String userId, boolean onlyCreatorPermitted, String externalSourceGUID, String externalSourceName, String startingGUID, String startingGUIDParameterName, String startingElementTypeName, List<String> suppliedSupportedZones, String attachmentTypeGUID, String attachmentTypeName, String detachedElementTypeName, String methodName) Removes the relationship of a specific type attached to an entity.
void	unlinkElementFromElement(String userId, boolean onlyCreatorPermitted, String externalSourceGUID, String externalSourceName, String startingGUID, String startingGUIDParameterName, String startingElementTypeName, String attachedGUID, String attachedGUIDParameterName, String attachedElementTypeGUID, String attachedElementTypeName, List<String> suppliedSupportedZones, String attachmentTypeGUID, String attachmentTypeName, String methodName) Removes a relationship between two specified elements.
void	unlinkElementFromElement(String userId, boolean onlyCreatorPermitted, String externalSourceGUID, String externalSourceName, String startingGUID, String startingGUIDParameterName, String startingElementTypeName, String attachingGUID, String attachingGUIDParameterName, String attachingElementTypeGUID, String attachingElementTypeName, String attachmentTypeGUID, String attachmentTypeName, String methodName) Removes a relationship between two elements.
void	updateBeanInRepository(String userId, String externalSourceGUID, String externalSourceName, String entityGUID, String entityGUIDParameterName, String entityTypeGUID, String entityTypeName, InstanceProperties properties, boolean isMergeUpdate, String methodName) Update one or more properties in the requested entity.
void	updateBeanInRepository(String userId, String externalSourceGUID, String externalSourceName, String entityGUID, String entityGUIDParameterName, String entityTypeGUID, String entityTypeName, List<String> serviceSupportedZones, InstanceProperties updateProperties, boolean isMergeUpdate, String methodName) Update one or more updateProperties in the requested entity.
void	updateBeanPropertyInRepository(String userId, String externalSourceGUID, String externalSourceName, String entityGUID, String entityGUIDParameterName, String entityTypeGUID, String entityTypeName, String propertyName, String propertyValue, String methodName) Update one or more properties in the requested entity.
void	updateBeanStatusInRepository(String userId, String externalSourceGUID, String externalSourceName, String entityGUID, String entityGUIDParameterName, String entityTypeGUID, String entityTypeName, List<String> serviceSupportedZones, InstanceStatus newStatus, String newStatusParameterName, String methodName) Update the instance status in the requested entity.
EntityDetail	validateAnchorEntity(String userId, String connectToGUID, String connectToType, EntityDetail connectToEntity, String connectToGUIDParameterName, boolean isUpdate, List<String> suppliedSupportedZones, String methodName) Validates whether an operation is valid based on the type of entity it is connecting to, who the user is and whether it is a read or an update.
EntityDetail	validateAnchorEntity(String userId, String connectToGUID, String connectToGUIDParameterName, String connectToType, boolean isUpdate, List<String> suppliedSupportedZones, String methodName) Validates whether an operation is valid based on the type of entity it is connecting to, who the user is and whether it is a read or an update.
void	verifyExternalSourceIdentity(String userId, String externalSourceGUID, String externalSourceName, String methodName) Verify that the integrator identities are either null or refer to a valid software server capability.

Methods inherited from class java.lang.Object

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

Field Detail

converter

protected OpenMetadataAPIGenericConverter<B> converter

beanClass

protected Class<B> beanClass

serviceName

protected String serviceName

serverName

protected String serverName

repositoryHelper

protected OMRSRepositoryHelper repositoryHelper

repositoryHandler

protected RepositoryHandler repositoryHandler

invalidParameterHandler

protected InvalidParameterHandler invalidParameterHandler

localServerUserId

protected String localServerUserId

securityVerifier

protected OpenMetadataServerSecurityVerifier securityVerifier

supportedZones

protected List<String> supportedZones

publishZones

protected List<String> publishZones

defaultZones

protected List<String> defaultZones

errorHandler

protected RepositoryErrorHandler errorHandler

auditLog

protected AuditLog auditLog

Constructor Detail

OpenMetadataAPIGenericHandler

public OpenMetadataAPIGenericHandler(OpenMetadataAPIGenericConverter<B> converter,
                                     Class<B> beanClass,
                                     String serviceName,
                                     String serverName,
                                     InvalidParameterHandler invalidParameterHandler,
                                     RepositoryHandler repositoryHandler,
                                     OMRSRepositoryHelper repositoryHelper,
                                     String localServerUserId,
                                     OpenMetadataServerSecurityVerifier securityVerifier,
                                     List<String> supportedZones,
                                     List<String> defaultZones,
                                     List<String> publishZones,
                                     AuditLog auditLog)

Construct the handler information needed to interact with the repository services

Parameters:

converter - specific converter for this bean class

beanClass - name of bean class that is represented by the generic class B

serviceName - name of this service

serverName - name of the local server

invalidParameterHandler - handler for managing parameter errors

repositoryHandler - manages calls to the repository services

repositoryHelper - provides utilities for manipulating the repository services objects

localServerUserId - userId for this server

securityVerifier - open metadata security services verifier

supportedZones - list of zones that the access service is allowed to serve Asset instances from.

defaultZones - list of zones that the access service should set in all new Asset instances.

publishZones - list of zones that the access service sets up in published Asset instances.

auditLog - destination for audit log events.

Method Detail

setSecurityVerifier

public void setSecurityVerifier(OpenMetadataServerSecurityVerifier securityVerifier)

Set up a new security verifier (the handler runs with a default verifier until this method is called). The security verifier provides authorization checks for access and maintenance changes to open metadata. Authorization checks are enabled through the OpenMetadataServerSecurityConnector.

Parameters:

securityVerifier - new security verifier

getRepositoryHelper

public OMRSRepositoryHelper getRepositoryHelper()

Return the repository helper for this server.

Returns:

repository helper object

getServiceName

public String getServiceName()

Return the name of this service.

Returns:

string name

validateAnchorEntity

public EntityDetail validateAnchorEntity(String userId,
                                         String connectToGUID,
                                         String connectToGUIDParameterName,
                                         String connectToType,
                                         boolean isUpdate,
                                         List<String> suppliedSupportedZones,
                                         String methodName)
                                  throws InvalidParameterException,
                                         PropertyServerException,
                                         UserNotAuthorizedException

Validates whether an operation is valid based on the type of entity it is connecting to, who the user is and whether it is a read or an update.

Parameters:

userId - userId of user making request.

connectToGUID - unique id for the object to connect the attachment to.

connectToGUIDParameterName - name of the parameter that passed the connect to guid

connectToType - type of the connect to element.

isUpdate - is this an update request?

suppliedSupportedZones - supported zone list from calling service

methodName - calling method

Returns:

anchor entity or null. The anchor entity is used by the caller to set the LatestChange classification

Throws:

InvalidParameterException - one of the parameters is null or invalid.

PropertyServerException - there is a problem adding the asset properties to the repositories.

UserNotAuthorizedException - the requesting user is not authorized to issue this request.

validateAnchorEntity

public EntityDetail validateAnchorEntity(String userId,
                                         String connectToGUID,
                                         String connectToType,
                                         EntityDetail connectToEntity,
                                         String connectToGUIDParameterName,
                                         boolean isUpdate,
                                         List<String> suppliedSupportedZones,
                                         String methodName)
                                  throws InvalidParameterException,
                                         PropertyServerException,
                                         UserNotAuthorizedException

Validates whether an operation is valid based on the type of entity it is connecting to, who the user is and whether it is a read or an update. The first part of this method is looking to see if the connectToEntity is an anchor entity. In which case it calls any specific validation for that entity and returns the connectToEntity, assuming all is ok - exceptions are thrown if the entity is not valid or the user does not have access to it. If the connectToEntity is of a type that has a lifecycle that is linked to the lifecycle of another entity - typically a referenceable - then that other entity is its anchor (examples are schema elements, comments, connections). The anchor entity needs to be retrieved and validated. Some anchor entities have specific validation to perform.

Parameters:

userId - userId of user making request.

connectToGUID - unique id for the object to connect the attachment to

connectToType - name of type of connectToEntity

connectToEntity - entity retrieved from the repository

connectToGUIDParameterName - name of the parameter that passed the connect to guid

isUpdate - is this an update request?

suppliedSupportedZones - list of supported zones from the caller.

methodName - calling method

Returns:

anchor entity or null. The anchor entity is used by the caller to set the LatestChange classification

Throws:

InvalidParameterException - one of the parameters is null or invalid.

PropertyServerException - there is a problem accessing the properties in the repositories.

UserNotAuthorizedException - the requesting user is not authorized to issue this request.

countAttachments

public int countAttachments(String userId,
                            String elementGUID,
                            String elementTypeName,
                            String attachmentTypeGUID,
                            String attachmentTypeName,
                            String methodName)
                     throws InvalidParameterException,
                            PropertyServerException,
                            UserNotAuthorizedException

Count up the number of elements of a certain type that are attached to a specific entity.

Parameters:

userId - calling user

elementGUID - unique identifier for the entity that the object is attached to (anchor entity)

elementTypeName - type of the anchor entity

attachmentTypeGUID - unique identifier of the attachment relationship's type

attachmentTypeName - unique name of the attachment's type

methodName - calling method

Returns:

count of attached objects

Throws:

InvalidParameterException - the parameters are invalid

UserNotAuthorizedException - user not authorized to issue this request

PropertyServerException - problem accessing the repositories

getAttachedEntity

public EntityDetail getAttachedEntity(String userId,
                                      String startingElementGUID,
                                      String startingElementGUIDParameterName,
                                      String startingElementTypeName,
                                      String relationshipTypeGUID,
                                      String relationshipTypeName,
                                      String resultingElementTypeName,
                                      String methodName)
                               throws InvalidParameterException,
                                      PropertyServerException,
                                      UserNotAuthorizedException

Return the entity for the required relationship attached to a specific entity. This method assumes the starting entity has a validated anchor

Parameters:

userId - calling user

startingElementGUID - identifier for the entity that the identifier is attached to

startingElementGUIDParameterName - name of the parameter used to pass the guid

startingElementTypeName - type name for anchor

relationshipTypeGUID - unique identifier of the attachment's relationship type

relationshipTypeName - unique name of the attachment's relationship type

resultingElementTypeName - unique name of the attached entity's type

methodName - calling method

Returns:

list of retrieved objects or null if none found

Throws:

InvalidParameterException - the input properties are invalid

UserNotAuthorizedException - user not authorized to issue this request

PropertyServerException - problem accessing the repositories

getAttachedEntity

public EntityDetail getAttachedEntity(String userId,
                                      String startingElementGUID,
                                      String startingElementGUIDParameterName,
                                      String startingElementTypeName,
                                      String relationshipTypeGUID,
                                      String relationshipTypeName,
                                      String resultingElementTypeName,
                                      List<String> serviceSupportedZones,
                                      String methodName)
                               throws InvalidParameterException,
                                      PropertyServerException,
                                      UserNotAuthorizedException

Return the entity for the required relationship attached to a specific entity. This method assumes the starting entity has a validated anchor

Parameters:

userId - calling user

startingElementGUID - identifier for the entity that the identifier is attached to

startingElementGUIDParameterName - name of the parameter used to pass the guid

startingElementTypeName - type name for anchor

relationshipTypeGUID - unique identifier of the attachment's relationship type

relationshipTypeName - unique name of the attachment's relationship type

resultingElementTypeName - unique name of the attached entity's type

serviceSupportedZones - supported zones for calling service

methodName - calling method

Returns:

list of retrieved objects or null if none found

Throws:

InvalidParameterException - the input properties are invalid

UserNotAuthorizedException - user not authorized to issue this request

PropertyServerException - problem accessing the repositories

getAttachedEntities

public List<EntityDetail> getAttachedEntities(String userId,
                                              String startingElementGUID,
                                              String startingElementGUIDParameterName,
                                              String startingElementTypeName,
                                              String relationshipTypeGUID,
                                              String relationshipTypeName,
                                              String resultingElementTypeName,
                                              int startingFrom,
                                              int pageSize,
                                              String methodName)
                                       throws InvalidParameterException,
                                              PropertyServerException,
                                              UserNotAuthorizedException

Return the entities for the required relationships attached to a specific entity.

Parameters:

userId - calling user

startingElementGUID - identifier for the entity that the identifier is attached to

startingElementGUIDParameterName - name of the parameter used to pass the guid

startingElementTypeName - type name for anchor

relationshipTypeGUID - unique identifier of the attachment's relationship type

relationshipTypeName - unique name of the attachment's relationship type

resultingElementTypeName - unique name of the attached entity's type

startingFrom - start position for results

pageSize - maximum number of results

methodName - calling method

Returns:

list of retrieved objects or null if none found

Throws:

InvalidParameterException - the input properties are invalid

UserNotAuthorizedException - user not authorized to issue this request

PropertyServerException - problem accessing the repositories

getAttachedEntities

public List<EntityDetail> getAttachedEntities(String userId,
                                              String startingElementGUID,
                                              String startingElementGUIDParameterName,
                                              String startingElementTypeName,
                                              String relationshipTypeGUID,
                                              String relationshipTypeName,
                                              String resultingElementTypeName,
                                              String requiredClassificationName,
                                              String omittedClassificationName,
                                              List<String> serviceSupportedZones,
                                              int startingFrom,
                                              int pageSize,
                                              String methodName)
                                       throws InvalidParameterException,
                                              PropertyServerException,
                                              UserNotAuthorizedException

Return the entities for the required relationships attached to a specific entity.

Parameters:

userId - calling user

startingElementGUID - identifier for the entity that the identifier is attached to

startingElementGUIDParameterName - name of the parameter used to pass the guid

startingElementTypeName - type name for anchor

relationshipTypeGUID - unique identifier of the attachment's relationship type

relationshipTypeName - unique name of the attachment's relationship type

resultingElementTypeName - unique name of the attached entity's type

requiredClassificationName - name of a classification that must be on the entity for a match

omittedClassificationName - name of a classification that must NOT be on the entity for a match

serviceSupportedZones - supported zones for calling service

startingFrom - start position for results

pageSize - maximum number of results

methodName - calling method

Returns:

list of retrieved objects or null if none found

Throws:

InvalidParameterException - the input properties are invalid

UserNotAuthorizedException - user not authorized to issue this request

PropertyServerException - problem accessing the repositories

getUniqueAttachmentLink

public Relationship getUniqueAttachmentLink(String userId,
                                            String startingGUID,
                                            String startingGUIDParameterName,
                                            String startingTypeName,
                                            String attachmentRelationshipTypeGUID,
                                            String attachmentRelationshipTypeName,
                                            String attachmentEntityGUID,
                                            String attachmentEntityTypeName,
                                            String methodName)
                                     throws InvalidParameterException,
                                            PropertyServerException,
                                            UserNotAuthorizedException

Return the relationship between the requested elements - there should be only one. Note that the entities are not checked.

Parameters:

userId - calling user

startingGUID - identifier for the entity that the identifier is attached to

startingGUIDParameterName - name of the parameter used to pass the guid

startingTypeName - type name for anchor

attachmentRelationshipTypeGUID - unique identifier of the relationship type connect to the attachment

attachmentRelationshipTypeName - unique name of the relationship type connect to the attachment

attachmentEntityGUID - unique identifier of the entity on the other end or null if unknown

attachmentEntityTypeName - unique name of the attached entity's type

methodName - calling method

Returns:

list of retrieved relationships or null if none found

Throws:

InvalidParameterException - the input properties are invalid

UserNotAuthorizedException - user not authorized to issue this request

PropertyServerException - problem accessing the repositories

getAllAttachmentLinks

public List<Relationship> getAllAttachmentLinks(String userId,
                                                String startingGUID,
                                                String startingGUIDParameterName,
                                                String startingTypeName,
                                                String methodName)
                                         throws InvalidParameterException,
                                                PropertyServerException,
                                                UserNotAuthorizedException

Return all relationships attached to a specific entity.

Parameters:

userId - calling user

startingGUID - identifier for the entity that the identifier is attached to

startingGUIDParameterName - name of the parameter used to pass the guid

startingTypeName - type name for anchor

methodName - calling method

Returns:

list of retrieved relationships or null if none found

Throws:

InvalidParameterException - the input properties are invalid

UserNotAuthorizedException - user not authorized to issue this request

PropertyServerException - problem accessing the repositories

getAttachmentLinks

public List<Relationship> getAttachmentLinks(String userId,
                                             String startingGUID,
                                             String startingGUIDParameterName,
                                             String startingTypeName,
                                             String attachmentRelationshipTypeGUID,
                                             String attachmentRelationshipTypeName,
                                             String attachmentEntityTypeName,
                                             int startingFrom,
                                             int pageSize,
                                             String methodName)
                                      throws InvalidParameterException,
                                             PropertyServerException,
                                             UserNotAuthorizedException

Return the relationships to required elements attached to a specific entity. Note that the entities are not checked.

Parameters:

userId - calling user

startingGUID - identifier for the entity that the identifier is attached to

startingGUIDParameterName - name of the parameter used to pass the guid

startingTypeName - type name for anchor

attachmentRelationshipTypeGUID - unique identifier of the relationship type connect to the attachment

attachmentRelationshipTypeName - unique name of the relationship type connect to the attachment

attachmentEntityTypeName - unique name of the attached entity's type

startingFrom - start position for results

pageSize - maximum number of results

methodName - calling method

Returns:

list of retrieved relationships or null if none found

Throws:

InvalidParameterException - the input properties are invalid

UserNotAuthorizedException - user not authorized to issue this request

PropertyServerException - problem accessing the repositories

getAttachmentLinks

public List<Relationship> getAttachmentLinks(String userId,
                                             String startingGUID,
                                             String startingGUIDParameterName,
                                             String startingTypeName,
                                             String attachmentRelationshipTypeGUID,
                                             String attachmentRelationshipTypeName,
                                             String attachmentEntityGUID,
                                             String attachmentEntityTypeName,
                                             int startingFrom,
                                             int pageSize,
                                             String methodName)
                                      throws InvalidParameterException,
                                             PropertyServerException,
                                             UserNotAuthorizedException

Return the relationships to required elements attached to a specific entity. Note that the entities are not checked.

Parameters:

userId - calling user

startingGUID - identifier for the entity that the identifier is attached to

startingGUIDParameterName - name of the parameter used to pass the guid

startingTypeName - type name for anchor

attachmentRelationshipTypeGUID - unique identifier of the relationship type connect to the attachment

attachmentRelationshipTypeName - unique name of the relationship type connect to the attachment

attachmentEntityGUID - unique identifier of the entity on the other end or null if unknown

attachmentEntityTypeName - unique name of the attached entity's type

startingFrom - start position for results

pageSize - maximum number of results

methodName - calling method

Returns:

list of retrieved relationships or null if none found

Throws:

InvalidParameterException - the input properties are invalid

UserNotAuthorizedException - user not authorized to issue this request

PropertyServerException - problem accessing the repositories

createBeanInRepository

public String createBeanInRepository(String userId,
                                     String externalSourceGUID,
                                     String externalSourceName,
                                     String entityTypeGUID,
                                     String entityTypeName,
                                     String uniqueParameterValue,
                                     String uniqueParameterName,
                                     OpenMetadataAPIGenericBuilder propertyBuilder,
                                     String methodName)
                              throws InvalidParameterException,
                                     PropertyServerException,
                                     UserNotAuthorizedException

Create a new entity in the repository assuming all parameters are ok.

Parameters:

userId - userId of user making request.

externalSourceGUID - guid of the software server capability entity that represented the external source - null for local

externalSourceName - name of the software server capability entity that represented the external source

entityTypeGUID - unique identifier of the type of entity to create

entityTypeName - unique name of the type of entity to create

uniqueParameterValue - value of unique parameter (or null if no unique properties)

uniqueParameterName - name of unique parameter (or null if no unique properties)

propertyBuilder - builder pre-populated with the properties and classifications of the new entity

methodName - calling method

Returns:

unique identifier of new entity

Throws:

InvalidParameterException - one of the parameters is null or invalid.

PropertyServerException - there is a problem adding the properties to the repositories.

UserNotAuthorizedException - the requesting user is not authorized to issue this request.

createBeanFromTemplate

public String createBeanFromTemplate(String userId,
                                     String externalSourceGUID,
                                     String externalSourceName,
                                     String templateGUID,
                                     String templateGUIDParameterName,
                                     String entityTypeGUID,
                                     String entityTypeName,
                                     String uniqueParameterValue,
                                     String uniqueParameterName,
                                     OpenMetadataAPIGenericBuilder propertyBuilder,
                                     String methodName)
                              throws InvalidParameterException,
                                     PropertyServerException,
                                     UserNotAuthorizedException

Create a new entity in the repository based on the contents of an existing entity (the template). The supplied builder is pre-loaded with properties that should override the properties from the the template.

Parameters:

userId - calling user

externalSourceGUID - guid of the software server capability entity that represented the external source - null for local

externalSourceName - name of the software server capability entity that represented the external source

templateGUID - unique identifier of existing entity to use

templateGUIDParameterName - name of parameter passing the templateGUID

entityTypeGUID - unique identifier of the type for the entity

entityTypeName - unique name of the type for the entity

uniqueParameterValue - the value of a unique property (eg qualifiedName) in the new entity - this is used to create unique names in the attachments.

uniqueParameterName - name of the property where the unique value is stored.

propertyBuilder - this property builder has the new properties supplied by the caller. They will be augmented by the template properties and classification.

methodName - calling method

Returns:

unique identifier of the the new bean

Throws:

InvalidParameterException - one of the parameters is invalid

PropertyServerException - there is a problem in the repository services

UserNotAuthorizedException - the user is not authorized to access one of the elements.

updateBeanPropertyInRepository

public void updateBeanPropertyInRepository(String userId,
                                           String externalSourceGUID,
                                           String externalSourceName,
                                           String entityGUID,
                                           String entityGUIDParameterName,
                                           String entityTypeGUID,
                                           String entityTypeName,
                                           String propertyName,
                                           String propertyValue,
                                           String methodName)
                                    throws InvalidParameterException,
                                           PropertyServerException,
                                           UserNotAuthorizedException

Update one or more properties in the requested entity.

Parameters:

userId - calling user

externalSourceGUID - guid of the software server capability entity that represented the external source - null for local

externalSourceName - name of the software server capability entity that represented the external source

entityGUID - unique identifier of object to update

entityGUIDParameterName - name of parameter supplying the GUID

entityTypeGUID - unique identifier of the entity's type

entityTypeName - unique name of the entity's type

propertyName - name of bean property to update

propertyValue - new value for bean property

methodName - calling method

Throws:

InvalidParameterException - one of the parameters is null or invalid.

PropertyServerException - there is a problem updating the properties tin the repositories.

UserNotAuthorizedException - the requesting user is not authorized to issue this request.

updateBeanInRepository

public void updateBeanInRepository(String userId,
                                   String externalSourceGUID,
                                   String externalSourceName,
                                   String entityGUID,
                                   String entityGUIDParameterName,
                                   String entityTypeGUID,
                                   String entityTypeName,
                                   InstanceProperties properties,
                                   boolean isMergeUpdate,
                                   String methodName)
                            throws InvalidParameterException,
                                   PropertyServerException,
                                   UserNotAuthorizedException

Update one or more properties in the requested entity.

Parameters:

userId - calling user

externalSourceGUID - guid of the software server capability entity that represented the external source - null for local

externalSourceName - name of the software server capability entity that represented the external source

entityGUID - unique identifier of object to update

entityGUIDParameterName - name of parameter supplying the GUID

entityTypeGUID - unique identifier of the entity's type

entityTypeName - unique name of the entity's type

properties - object containing the properties for the repository instances based on the properties of the bean

isMergeUpdate - should the supplied properties be merged with existing properties (true) only replacing the properties with matching names, or should the entire properties of the instance be replaced?

methodName - calling method

Throws:

InvalidParameterException - one of the parameters is null or invalid.

PropertyServerException - there is a problem updating the properties in the repositories.

UserNotAuthorizedException - the requesting user is not authorized to issue this request.

updateBeanInRepository

public void updateBeanInRepository(String userId,
                                   String externalSourceGUID,
                                   String externalSourceName,
                                   String entityGUID,
                                   String entityGUIDParameterName,
                                   String entityTypeGUID,
                                   String entityTypeName,
                                   List<String> serviceSupportedZones,
                                   InstanceProperties updateProperties,
                                   boolean isMergeUpdate,
                                   String methodName)
                            throws InvalidParameterException,
                                   PropertyServerException,
                                   UserNotAuthorizedException

Update one or more updateProperties in the requested entity.

Parameters:

userId - calling user

externalSourceGUID - guid of the software server capability entity that represented the external source - null for local

externalSourceName - name of the software server capability entity that represented the external source

entityGUID - unique identifier of object to update

entityGUIDParameterName - name of parameter supplying the GUID

entityTypeGUID - unique identifier of the entity's type

entityTypeName - unique name of the entity's type

serviceSupportedZones - supported zones for calling service

updateProperties - object containing the properties

isMergeUpdate - should the supplied updateProperties be merged with existing updateProperties (true) only replacing the updateProperties with matching names, or should the entire updateProperties of the instance be replaced?

methodName - calling method

Throws:

InvalidParameterException - one of the parameters is null or invalid.

PropertyServerException - there is a problem adding the new properties to the repositories.

UserNotAuthorizedException - the requesting user is not authorized to issue this request.

updateBeanStatusInRepository

public void updateBeanStatusInRepository(String userId,
                                         String externalSourceGUID,
                                         String externalSourceName,
                                         String entityGUID,
                                         String entityGUIDParameterName,
                                         String entityTypeGUID,
                                         String entityTypeName,
                                         List<String> serviceSupportedZones,
                                         InstanceStatus newStatus,
                                         String newStatusParameterName,
                                         String methodName)
                                  throws InvalidParameterException,
                                         PropertyServerException,
                                         UserNotAuthorizedException

Update the instance status in the requested entity.

Parameters:

userId - calling user

externalSourceGUID - guid of the software server capability entity that represented the external source - null for local

externalSourceName - name of the software server capability entity that represented the external source

entityGUID - unique identifier of object to update

entityGUIDParameterName - name of parameter supplying the GUID

entityTypeGUID - unique identifier of the entity's type

entityTypeName - unique name of the entity's type

serviceSupportedZones - supported zones for calling service

newStatus - new status value

newStatusParameterName - parameter providing the new status value

methodName - calling method

Throws:

InvalidParameterException - one of the parameters is null or invalid.

PropertyServerException - there is a problem adding the new properties to the repositories.

UserNotAuthorizedException - the requesting user is not authorized to issue this request.

deleteBeanInRepository

public void deleteBeanInRepository(String userId,
                                   String externalSourceGUID,
                                   String externalSourceName,
                                   String entityGUID,
                                   String entityGUIDParameterName,
                                   String entityTypeGUID,
                                   String entityTypeName,
                                   String validatingPropertyName,
                                   String validatingPropertyValue,
                                   String methodName)
                            throws InvalidParameterException,
                                   PropertyServerException,
                                   UserNotAuthorizedException

Delete an entity from the repository.

Parameters:

userId - calling user

externalSourceGUID - guid of the software server capability entity that represented the external source - null for local

externalSourceName - name of the software server capability entity that represented the external source

entityGUID - unique identifier of object to update

entityGUIDParameterName - name of parameter supplying the GUID

entityTypeGUID - unique identifier of the entity's type

entityTypeName - unique name of the entity's type

validatingPropertyName - name of property to verify - of null if no verification is required

validatingPropertyValue - value of property to verify

methodName - calling method

Throws:

InvalidParameterException - one of the parameters is null or invalid.

PropertyServerException - there is a problem removing the properties from the repositories.

UserNotAuthorizedException - the requesting user is not authorized to issue this request.

deleteBeanInRepository

public void deleteBeanInRepository(String userId,
                                   String externalSourceGUID,
                                   String externalSourceName,
                                   String entityGUID,
                                   String entityGUIDParameterName,
                                   String entityTypeGUID,
                                   String entityTypeName,
                                   String validatingPropertyName,
                                   String validatingPropertyValue,
                                   List<String> serviceSupportedZones,
                                   String methodName)
                            throws InvalidParameterException,
                                   PropertyServerException,
                                   UserNotAuthorizedException

Delete an entity from the repository.

Parameters:

userId - calling user

externalSourceGUID - guid of the software server capability entity that represented the external source - null for local

externalSourceName - name of the software server capability entity that represented the external source

entityGUID - unique identifier of object to update

entityGUIDParameterName - name of parameter supplying the GUID

entityTypeGUID - unique identifier of the entity's type

entityTypeName - unique name of the entity's type

validatingPropertyName - name of property to verify - of null if no verification is required

validatingPropertyValue - value of property to verify

serviceSupportedZones - supported zones for calling service

methodName - calling method

Throws:

InvalidParameterException - one of the parameters is null or invalid.

PropertyServerException - there is a problem removing the properties from the repositories.

UserNotAuthorizedException - the requesting user is not authorized to issue this request.

getAttachedElementGUIDs

public List<String> getAttachedElementGUIDs(String userId,
                                            String startingGUID,
                                            String startingGUIDParameterName,
                                            String startingTypeName,
                                            String attachmentRelationshipTypeGUID,
                                            String attachmentRelationshipTypeName,
                                            String attachmentEntityTypeName,
                                            int startingFrom,
                                            int pageSize,
                                            String methodName)
                                     throws InvalidParameterException,
                                            PropertyServerException,
                                            UserNotAuthorizedException

Return the elements of the requested type attached to an entity identified by the starting GUID.

Parameters:

userId - calling user

startingGUID - identifier for the entity that the identifier is attached to

startingGUIDParameterName - name of parameter supplying the GUID

startingTypeName - name of the type of object being attached to

attachmentRelationshipTypeGUID - unique identifier of the relationship type connect to the attachment

attachmentRelationshipTypeName - unique name of the relationship type connect to the attachment

attachmentEntityTypeName - unique name of the attached entity's type

startingFrom - start position for results

pageSize - maximum number of results

methodName - calling method

Returns:

list of unique identifiers for retrieved objects or null if none found

Throws:

InvalidParameterException - the input properties are invalid

UserNotAuthorizedException - user not authorized to issue this request

PropertyServerException - problem accessing the repositories

getAttachedElementGUIDs

public List<String> getAttachedElementGUIDs(String userId,
                                            String startingGUID,
                                            String startingGUIDParameterName,
                                            String startingTypeName,
                                            String attachmentRelationshipTypeGUID,
                                            String attachmentRelationshipTypeName,
                                            String attachmentEntityTypeName,
                                            List<String> serviceSupportedZones,
                                            int startingFrom,
                                            int pageSize,
                                            String methodName)
                                     throws InvalidParameterException,
                                            PropertyServerException,
                                            UserNotAuthorizedException

Return the elements of the requested type attached to an entity identified by the starting GUID.

Parameters:

userId - calling user

startingGUID - identifier for the entity that the identifier is attached to

startingGUIDParameterName - name of parameter supplying the GUID

startingTypeName - name of the type of object being attached to

attachmentRelationshipTypeGUID - unique identifier of the relationship type connect to the attachment

attachmentRelationshipTypeName - unique name of the relationship type connect to the attachment

attachmentEntityTypeName - unique name of the attached entity's type

serviceSupportedZones - supported zones for calling service

startingFrom - start position for results

pageSize - maximum number of results

methodName - calling method

Returns:

list of unique identifiers for retrieved objects or null if none found

Throws:

InvalidParameterException - the input properties are invalid

UserNotAuthorizedException - user not authorized to issue this request

PropertyServerException - problem accessing the repositories

getAttachedElementGUID

public String getAttachedElementGUID(String userId,
                                     String startingGUID,
                                     String startingGUIDParameterName,
                                     String startingTypeName,
                                     String attachmentRelationshipTypeGUID,
                                     String attachmentRelationshipTypeName,
                                     String attachmentEntityTypeName,
                                     int selectionEnd,
                                     String methodName)
                              throws InvalidParameterException,
                                     PropertyServerException,
                                     UserNotAuthorizedException

Return the elements of the requested type attached to an entity identified by the starting GUID.

Parameters:

userId - calling user

startingGUID - identifier for the entity that the identifier is attached to

startingGUIDParameterName - name of parameter supplying the GUID

startingTypeName - name of the type of object being attached to

attachmentRelationshipTypeGUID - unique identifier of the relationship type connect to the attachment

attachmentRelationshipTypeName - unique name of the relationship type connect to the attachment

attachmentEntityTypeName - unique name of the attached entity's type

selectionEnd - 0 means either end, 1 means only take from end 1, 2 means only take from end 2

methodName - calling method

Returns:

list of unique identifiers for retrieved objects or null if none found

Throws:

InvalidParameterException - the input properties are invalid

UserNotAuthorizedException - user not authorized to issue this request

PropertyServerException - problem accessing the repositories

getAttachedElementGUID

public String getAttachedElementGUID(String userId,
                                     String startingGUID,
                                     String startingGUIDParameterName,
                                     String startingTypeName,
                                     String attachmentRelationshipTypeGUID,
                                     String attachmentRelationshipTypeName,
                                     String attachmentEntityTypeName,
                                     int selectionEnd,
                                     List<String> serviceSupportedZones,
                                     String methodName)
                              throws InvalidParameterException,
                                     PropertyServerException,
                                     UserNotAuthorizedException

Return the elements of the requested type attached to an entity identified by the starting GUID.

Parameters:

userId - calling user

startingGUID - identifier for the entity that the identifier is attached to

startingGUIDParameterName - name of parameter supplying the GUID

startingTypeName - name of the type of object being attached to

attachmentRelationshipTypeGUID - unique identifier of the relationship type connect to the attachment

attachmentRelationshipTypeName - unique name of the relationship type connect to the attachment

attachmentEntityTypeName - unique name of the attached entity's type

selectionEnd - 0 means either end, 1 means only take from end 1, 2 means only take from end 2

serviceSupportedZones - supported zones for calling service

methodName - calling method

Returns:

list of unique identifiers for retrieved objects or null if none found

Throws:

InvalidParameterException - the input properties are invalid

UserNotAuthorizedException - user not authorized to issue this request

PropertyServerException - problem accessing the repositories

getAttachedElement

public B getAttachedElement(String userId,
                            String startingElementGUID,
                            String startingElementGUIDParameterName,
                            String startingElementTypeName,
                            String relationshipTypeGUID,
                            String relationshipTypeName,
                            String resultingElementTypeName,
                            String methodName)
                     throws InvalidParameterException,
                            PropertyServerException,
                            UserNotAuthorizedException

Return the Bean for the required relationship attached to a specific element. This method assumes the starting element has a validated anchor.

Parameters:

userId - calling user

startingElementGUID - identifier for the entity that the identifier is attached to

startingElementGUIDParameterName - name of the parameter used to pass the guid

startingElementTypeName - type name for anchor

relationshipTypeGUID - unique identifier of the attachment's relationship type

relationshipTypeName - unique name of the attachment's relationship type

resultingElementTypeName - unique name of the attached entity's type

methodName - calling method

Returns:

list of retrieved objects or null if none found

Throws:

InvalidParameterException - the input properties are invalid

UserNotAuthorizedException - user not authorized to issue this request

PropertyServerException - problem accessing the repositories

getAttachedElement

public B getAttachedElement(String userId,
                            String startingElementGUID,
                            String startingElementGUIDParameterName,
                            String startingElementTypeName,
                            String relationshipTypeGUID,
                            String relationshipTypeName,
                            String resultingElementTypeName,
                            List<String> serviceSupportedZones,
                            String methodName)
                     throws InvalidParameterException,
                            PropertyServerException,
                            UserNotAuthorizedException

Return the Bean for the required relationship attached to a specific element. This method assumes the starting element has a validated anchor.

Parameters:

userId - calling user

startingElementGUID - identifier for the entity that the identifier is attached to

startingElementGUIDParameterName - name of the parameter used to pass the guid

startingElementTypeName - type name for anchor

relationshipTypeGUID - unique identifier of the attachment's relationship type

relationshipTypeName - unique name of the attachment's relationship type

resultingElementTypeName - unique name of the attached entity's type

serviceSupportedZones - supported zones for calling service

methodName - calling method

Returns:

list of retrieved objects or null if none found

Throws:

InvalidParameterException - the input properties are invalid

UserNotAuthorizedException - user not authorized to issue this request

PropertyServerException - problem accessing the repositories

getAttachedElements

public List<B> getAttachedElements(String userId,
                                   String startingGUID,
                                   String startingGUIDParameterName,
                                   String startingTypeName,
                                   String attachmentRelationshipTypeGUID,
                                   String attachmentRelationshipTypeName,
                                   String attachmentEntityTypeName,
                                   int startingFrom,
                                   int pageSize,
                                   String methodName)
                            throws InvalidParameterException,
                                   PropertyServerException,
                                   UserNotAuthorizedException

Return the elements of the requested type attached to an entity identified by the starting GUID.

Parameters:

userId - calling user

startingGUID - identifier for the entity that the identifier is attached to

startingGUIDParameterName - name of parameter supplying the GUID

startingTypeName - name of the type of object being attached to

attachmentRelationshipTypeGUID - unique identifier of the relationship type connect to the attachment

attachmentRelationshipTypeName - unique name of the relationship type connect to the attachment

attachmentEntityTypeName - unique name of the attached entity's type

startingFrom - start position for results

pageSize - maximum number of results

methodName - calling method

Returns:

list of retrieved objects or null if none found

Throws:

InvalidParameterException - the input properties are invalid

UserNotAuthorizedException - user not authorized to issue this request

PropertyServerException - problem accessing the repositories

getAttachedElements

public List<B> getAttachedElements(String userId,
                                   String startingGUID,
                                   String startingGUIDParameterName,
                                   String startingTypeName,
                                   String attachmentRelationshipTypeGUID,
                                   String attachmentRelationshipTypeName,
                                   String attachmentEntityTypeName,
                                   List<String> serviceSupportedZones,
                                   int startingFrom,
                                   int pageSize,
                                   String methodName)
                            throws InvalidParameterException,
                                   PropertyServerException,
                                   UserNotAuthorizedException

Return the elements of the requested type attached to an entity identified by the starting GUID.

Parameters:

userId - calling user

startingGUID - identifier for the entity that the identifier is attached to

startingGUIDParameterName - name of parameter supplying the GUID

startingTypeName - name of the type of object being attached to

attachmentRelationshipTypeGUID - unique identifier of the relationship type connect to the attachment

attachmentRelationshipTypeName - unique name of the relationship type connect to the attachment

attachmentEntityTypeName - unique name of the attached entity's type

serviceSupportedZones - supported zones for calling service

startingFrom - start position for results

pageSize - maximum number of results

methodName - calling method

Returns:

list of retrieved objects or null if none found

Throws:

InvalidParameterException - the input properties are invalid

UserNotAuthorizedException - user not authorized to issue this request

PropertyServerException - problem accessing the repositories

getAttachedElements

public List<B> getAttachedElements(String userId,
                                   String startingGUID,
                                   String startingGUIDParameterName,
                                   String startingTypeName,
                                   String attachmentRelationshipTypeGUID,
                                   String attachmentRelationshipTypeName,
                                   String attachmentEntityTypeName,
                                   String requiredClassificationName,
                                   String omittedClassificationName,
                                   int selectionEnd,
                                   int startingFrom,
                                   int pageSize,
                                   String methodName)
                            throws InvalidParameterException,
                                   PropertyServerException,
                                   UserNotAuthorizedException

Return the elements of the requested type attached to an entity identified by the starting GUID.

Parameters:

userId - calling user

startingGUID - identifier for the entity that the identifier is attached to

startingGUIDParameterName - name of parameter supplying the GUID

startingTypeName - name of the type of object being attached to

attachmentRelationshipTypeGUID - unique identifier of the relationship type connect to the attachment

attachmentRelationshipTypeName - unique name of the relationship type connect to the attachment

attachmentEntityTypeName - unique name of the attached entity's type

requiredClassificationName - String the name of the classification that must be on the attached entity.

omittedClassificationName - String the name of a classification that must not be on the attached entity.

selectionEnd - 0 means either end, 1 means only take from end 1, 2 means only take from end 2

startingFrom - start position for results

pageSize - maximum number of results

methodName - calling method

Returns:

list of retrieved objects or null if none found

Throws:

InvalidParameterException - the input properties are invalid

UserNotAuthorizedException - user not authorized to issue this request

PropertyServerException - problem accessing the repositories

getAttachedElements

public List<B> getAttachedElements(String userId,
                                   String anchorGUID,
                                   String anchorGUIDParameterName,
                                   String startingGUID,
                                   String startingGUIDParameterName,
                                   String startingTypeName,
                                   String attachmentRelationshipTypeGUID,
                                   String attachmentRelationshipTypeName,
                                   String attachmentEntityTypeName,
                                   String requiredClassificationName,
                                   String omittedClassificationName,
                                   int selectionEnd,
                                   List<String> serviceSupportedZones,
                                   int startingFrom,
                                   int pageSize,
                                   String methodName)
                            throws InvalidParameterException,
                                   PropertyServerException,
                                   UserNotAuthorizedException

Return the elements of the requested type attached to an entity identified by the starting GUID.

Parameters:

userId - calling user

anchorGUID - expected anchorGUID for this element

anchorGUIDParameterName - parameter supplying anchorGUID

startingGUID - identifier for the entity that the identifier is attached to

startingGUIDParameterName - name of parameter supplying the GUID

startingTypeName - name of the type of object being attached to

attachmentRelationshipTypeGUID - unique identifier of the relationship type connect to the attachment

attachmentRelationshipTypeName - unique name of the relationship type connect to the attachment

attachmentEntityTypeName - unique name of the attached entity's type

requiredClassificationName - String the name of the classification that must be on the attached entity.

omittedClassificationName - String the name of a classification that must not be on the attached entity.

selectionEnd - 0 means either end, 1 means only take from end 1, 2 means only take from end 2

serviceSupportedZones - supported zones for calling service

startingFrom - start position for results

pageSize - maximum number of results

methodName - calling method

Returns:

list of retrieved objects or null if none found

Throws:

InvalidParameterException - the input properties are invalid

UserNotAuthorizedException - user not authorized to issue this request

PropertyServerException - problem accessing the repositories

getAnchorsForAttachedElements

public List<B> getAnchorsForAttachedElements(String userId,
                                             String startingGUID,
                                             String startingGUIDParameterName,
                                             String startingTypeName,
                                             String attachmentRelationshipTypeGUID,
                                             String attachmentRelationshipTypeName,
                                             String attachmentEntityTypeName,
                                             String requiredClassificationName,
                                             String omittedClassificationName,
                                             int selectionEnd,
                                             List<String> serviceSupportedZones,
                                             int startingFrom,
                                             int pageSize,
                                             String methodName)
                                      throws InvalidParameterException,
                                             PropertyServerException,
                                             UserNotAuthorizedException

Return the elements of the requested type attached to an entity identified by the starting GUID.

Parameters:

userId - calling user

startingGUID - identifier for the entity that the identifier is attached to

startingGUIDParameterName - name of parameter supplying the GUID

startingTypeName - name of the type of object being attached to

attachmentRelationshipTypeGUID - unique identifier of the relationship type connect to the attachment

attachmentRelationshipTypeName - unique name of the relationship type connect to the attachment

attachmentEntityTypeName - unique name of the attached entity's type

requiredClassificationName - String the name of the classification that must be on the attached entity.

omittedClassificationName - String the name of a classification that must not be on the attached entity.

selectionEnd - 0 means either end, 1 means only take from end 1, 2 means only take from end 2

serviceSupportedZones - supported zones for calling service

startingFrom - start position for results

pageSize - maximum number of results

methodName - calling method

Returns:

list of retrieved objects or null if none found

Throws:

InvalidParameterException - the input properties are invalid

UserNotAuthorizedException - user not authorized to issue this request

PropertyServerException - problem accessing the repositories

getEntityFromRepository

public EntityDetail getEntityFromRepository(String userId,
                                            String requestedEntityGUID,
                                            String requestedEntityGUIDParameterName,
                                            String requestedEntityTypeName,
                                            String methodName)
                                     throws InvalidParameterException,
                                            PropertyServerException,
                                            UserNotAuthorizedException

Return the keyword for the supplied unique identifier (guid). The keyword is only returned if

Parameters:

userId - userId of the user making the request

requestedEntityGUID - unique identifier of the entity to retrieve from the repository

requestedEntityGUIDParameterName - name of the parameter supplying the GUID

requestedEntityTypeName - name of type of entity to retrieve

methodName - calling method

Returns:

retrieved entity

Throws:

InvalidParameterException - the userId is null or invalid.

PropertyServerException - there is a problem retrieving information from the repositories.

UserNotAuthorizedException - the requesting user is not authorized to issue this request.

getEntityFromRepository

public EntityDetail getEntityFromRepository(String userId,
                                            String requestedEntityGUID,
                                            String requestedEntityGUIDParameterName,
                                            String requestedEntityTypeName,
                                            String requiredClassificationName,
                                            String omittedClassificationName,
                                            String methodName)
                                     throws InvalidParameterException,
                                            PropertyServerException,
                                            UserNotAuthorizedException

Return the keyword for the supplied unique identifier (guid). The keyword is only returned if

Parameters:

userId - userId of the user making the request

requestedEntityGUID - unique identifier of the entity to retrieve from the repository

requestedEntityGUIDParameterName - name of the parameter supplying the GUID

requestedEntityTypeName - name of type of entity to retrieve

requiredClassificationName - String the name of the classification that must be on the attached entity.

omittedClassificationName - String the name of a classification that must not be on the attached entity.

methodName - calling method

Returns:

retrieved entity

Throws:

InvalidParameterException - the userId is null or invalid.

PropertyServerException - there is a problem retrieving information from the repositories.

UserNotAuthorizedException - the requesting user is not authorized to issue this request.

getEntityFromRepository

public EntityDetail getEntityFromRepository(String userId,
                                            String requestedEntityGUID,
                                            String requestedEntityGUIDParameterName,
                                            String requestedEntityTypeName,
                                            String requiredClassificationName,
                                            String omittedClassificationName,
                                            List<String> serviceSupportedZones,
                                            String methodName)
                                     throws InvalidParameterException,
                                            PropertyServerException,
                                            UserNotAuthorizedException

Return the entity for the supplied unique identifier (guid). An exception is thrown if the entity does not exist.

Parameters:

userId - userId of the user making the request

requestedEntityGUID - unique identifier of the entity to retrieve from the repository

requestedEntityGUIDParameterName - name of the parameter supplying the GUID

requestedEntityTypeName - name of type of entity to retrieve

requiredClassificationName - String the name of the classification that must be on the attached entity.

omittedClassificationName - String the name of a classification that must not be on the attached entity.

serviceSupportedZones - supported zones for calling service

methodName - calling method

Returns:

retrieved entity

Throws:

InvalidParameterException - the userId is null or invalid, the entity does not exist.

PropertyServerException - there is a problem retrieving information from the repositories.

UserNotAuthorizedException - the requesting user is not authorized to issue this request.

getBeanFromRepository

public B getBeanFromRepository(String userId,
                               String guid,
                               String guidParameterName,
                               String resultTypeName,
                               String methodName)
                        throws InvalidParameterException,
                               PropertyServerException,
                               UserNotAuthorizedException

Use the supplied unique identifier (guid) of an entity in the repository to retrieve its contents as a bean. The entity is checked to ensure it is of the required return type.

Parameters:

userId - calling user

guid - unique identifier of the entity to retrieve

guidParameterName - parameter supplying the unique identifier

resultTypeName - type of the retrieve entity

methodName - calling method

Returns:

B bean

Throws:

InvalidParameterException - one of the properties (probably the GUID) is invalid

PropertyServerException - the repository services hit an unexpected problem

UserNotAuthorizedException - the user is not permitted to access this entity

getBeanFromRepository

public B getBeanFromRepository(String userId,
                               String guid,
                               String guidParameterName,
                               String entityTypeName,
                               List<String> serviceSupportedZones,
                               String methodName)
                        throws InvalidParameterException,
                               PropertyServerException,
                               UserNotAuthorizedException

Return the bean for the supplied unique identifier (guid). An exception occurs if the bean GUID is not known.

Parameters:

userId - userId of the user making the request

guid - unique identifier of the entity to retrieve from the repository

guidParameterName - name of the parameter supplying the GUID

entityTypeName - name of type of entity to retrieve

serviceSupportedZones - supported zones for calling service

methodName - calling method

Returns:

new bean

Throws:

InvalidParameterException - the userId is null or invalid.

PropertyServerException - there is a problem retrieving information from the repositories.

UserNotAuthorizedException - the requesting user is not authorized to issue this request.

getBeanGUIDByUniqueName

public String getBeanGUIDByUniqueName(String userId,
                                      String name,
                                      String nameParameterName,
                                      String namePropertyName,
                                      String resultTypeGUID,
                                      String resultTypeName,
                                      List<String> serviceSupportedZones,
                                      String methodName)
                               throws InvalidParameterException,
                                      PropertyServerException,
                                      UserNotAuthorizedException

Return the list of beans of the requested type that match the supplied value. A null is returned if the entity is not found.

Parameters:

userId - the calling user

name - value to search

nameParameterName - parameter providing value

namePropertyName - open metadata property name to match on

resultTypeGUID - unique identifier of the type that the results should match with

resultTypeName - unique value of the type that the results should match with

serviceSupportedZones - list of supported zones for this service

methodName - calling method

Returns:

list of beans

Throws:

InvalidParameterException - the userId is null or invalid.

PropertyServerException - there is a problem retrieving information from the repositories.

UserNotAuthorizedException - the requesting user is not authorized to issue this request.

getBeanByUniqueName

public B getBeanByUniqueName(String userId,
                             String name,
                             String nameParameterName,
                             String namePropertyName,
                             String resultTypeGUID,
                             String resultTypeName,
                             String methodName)
                      throws InvalidParameterException,
                             PropertyServerException,
                             UserNotAuthorizedException

Return the list of beans of the requested type that match the supplied value.

Parameters:

userId - the calling user

name - value to search

nameParameterName - parameter providing value

namePropertyName - open metadata property name to match on

resultTypeGUID - unique identifier of the type that the results should match with

resultTypeName - unique value of the type that the results should match with

methodName - calling method

Returns:

list of beans

Throws:

InvalidParameterException - the userId is null or invalid.

PropertyServerException - there is a problem retrieving information from the repositories.

UserNotAuthorizedException - the requesting user is not authorized to issue this request.

getBeanByUniqueName

public B getBeanByUniqueName(String userId,
                             String name,
                             String nameParameterName,
                             String namePropertyName,
                             String resultTypeGUID,
                             String resultTypeName,
                             List<String> serviceSupportedZones,
                             String methodName)
                      throws InvalidParameterException,
                             PropertyServerException,
                             UserNotAuthorizedException

Return the list of beans of the requested type that match the supplied value.

Parameters:

userId - the calling user

name - value to search

nameParameterName - parameter providing value

namePropertyName - open metadata property name to match on

resultTypeGUID - unique identifier of the type that the results should match with

resultTypeName - unique value of the type that the results should match with

serviceSupportedZones - list of supported zones for this service

methodName - calling method

Returns:

list of beans

Throws:

InvalidParameterException - the userId is null or invalid.

PropertyServerException - there is a problem retrieving information from the repositories.

UserNotAuthorizedException - the requesting user is not authorized to issue this request.

getBeanByValue

public B getBeanByValue(String userId,
                        String value,
                        String valueParameterName,
                        String resultTypeGUID,
                        String resultTypeName,
                        List<String> specificMatchPropertyNames,
                        String methodName)
                 throws InvalidParameterException,
                        UserNotAuthorizedException,
                        PropertyServerException

Return the bean that matches the requested value.

Parameters:

userId - identifier of calling user

value - value to search

valueParameterName - parameter providing value

resultTypeGUID - unique identifier of the type that the results should match with

resultTypeName - unique value of the type that the results should match with

specificMatchPropertyNames - list of property value to look in - if null or empty list then all string properties are checked.

methodName - calling method

Returns:

matching bean.

Throws:

InvalidParameterException - one of the parameters is null or invalid.

UserNotAuthorizedException - user not authorized to issue this request.

PropertyServerException - problem retrieving the bean definition.

getBeansByValue

public List<B> getBeansByValue(String userId,
                               String value,
                               String valueParameterName,
                               String resultTypeGUID,
                               String resultTypeName,
                               List<String> specificMatchPropertyNames,
                               boolean exactValueMatch,
                               int startFrom,
                               int pageSize,
                               String methodName)
                        throws InvalidParameterException,
                               PropertyServerException,
                               UserNotAuthorizedException

Return the list of beans of the requested type that match the supplied value.

Parameters:

userId - the calling user

value - value to search

valueParameterName - parameter providing value

resultTypeGUID - unique identifier of the type that the results should match with

resultTypeName - unique value of the type that the results should match with

specificMatchPropertyNames - list of property value to look in - if null or empty list then all string properties are checked.

exactValueMatch - indicates whether the value must match the whole property value in a matching result, or whether it is a RegEx partial match

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

pageSize - maximum number of elements to return

methodName - calling method

Returns:

list of beans

Throws:

InvalidParameterException - the userId is null or invalid.

PropertyServerException - there is a problem retrieving information from the repositories.

UserNotAuthorizedException - the requesting user is not authorized to issue this request.

findBeans

public List<B> findBeans(String userId,
                         String searchString,
                         String searchStringParameterName,
                         String resultTypeGUID,
                         String resultTypeName,
                         int startFrom,
                         int pageSize,
                         String methodName)
                  throws InvalidParameterException,
                         PropertyServerException,
                         UserNotAuthorizedException

Return the list of beans matching the supplied searchString.

Parameters:

userId - the searchString of the calling user.

searchString - searchString of endpoint. This may include wild card characters.

searchStringParameterName - name of parameter providing search string

resultTypeGUID - unique identifier of the type that the results should match with

resultTypeName - unique value of the type that the results should match with

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

pageSize - maximum number of elements to return.

methodName - calling method

Returns:

list of beans

Throws:

InvalidParameterException - the userId is null or invalid.

PropertyServerException - there is a problem retrieving information from the repositories.

UserNotAuthorizedException - the requesting user is not authorized to issue this request.

findBeans

public List<B> findBeans(String userId,
                         String searchString,
                         String searchStringParameterName,
                         String resultTypeGUID,
                         String resultTypeName,
                         String requiredClassificationName,
                         String omittedClassificationName,
                         int startFrom,
                         int pageSize,
                         String methodName)
                  throws InvalidParameterException,
                         PropertyServerException,
                         UserNotAuthorizedException

Return the list of beans matching the supplied searchString.

Parameters:

userId - the searchString of the calling user.

searchString - searchString of endpoint. This may include wild card characters.

searchStringParameterName - name of parameter providing search string

resultTypeGUID - unique identifier of the type that the results should match with

resultTypeName - unique value of the type that the results should match with

requiredClassificationName - String the name of the classification that must be on the entity.

omittedClassificationName - String the name of a classification that must not be on the entity.

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

pageSize - maximum number of elements to return.

methodName - calling method

Returns:

list of beans

Throws:

InvalidParameterException - the userId is null or invalid.

PropertyServerException - there is a problem retrieving information from the repositories.

UserNotAuthorizedException - the requesting user is not authorized to issue this request.

findBeans

public List<B> findBeans(String userId,
                         String searchString,
                         String searchStringParameterName,
                         String resultTypeGUID,
                         String resultTypeName,
                         List<String> serviceSupportedZones,
                         int startFrom,
                         int pageSize,
                         String methodName)
                  throws InvalidParameterException,
                         PropertyServerException,
                         UserNotAuthorizedException

Return the list of beans matching the supplied searchString.

Parameters:

userId - the searchString of the calling user.

searchString - searchString of endpoint. This may include wild card characters.

searchStringParameterName - name of parameter providing search string

serviceSupportedZones - list of supported zones for this service.

resultTypeGUID - unique identifier of the type that the results should match with

resultTypeName - unique value of the type that the results should match with

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

pageSize - maximum number of elements to return.

methodName - calling method

Returns:

list of beans

Throws:

InvalidParameterException - the userId is null or invalid.

PropertyServerException - there is a problem retrieving information from the repositories.

UserNotAuthorizedException - the requesting user is not authorized to issue this request.

getBeansByValue

public List<B> getBeansByValue(String userId,
                               String value,
                               String valueParameterName,
                               String resultTypeGUID,
                               String resultTypeName,
                               List<String> specificMatchPropertyNames,
                               boolean exactValueMatch,
                               List<String> serviceSupportedZones,
                               int startFrom,
                               int pageSize,
                               String methodName)
                        throws InvalidParameterException,
                               PropertyServerException,
                               UserNotAuthorizedException

Return the list of beans of the requested type that match the supplied value.

Parameters:

userId - the calling user

value - value to search

valueParameterName - parameter providing value

resultTypeGUID - unique identifier of the type that the results should match with

resultTypeName - unique value of the type that the results should match with

specificMatchPropertyNames - list of property value to look in - if null or empty list then all string properties are checked.

exactValueMatch - indicates whether the value must match the whole property value in a matching result, or whether it is a RegEx partial match

serviceSupportedZones - list of supported zones for this service

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

pageSize - maximum number of elements to return

methodName - calling method

Returns:

list of beans

Throws:

InvalidParameterException - the userId is null or invalid.

PropertyServerException - there is a problem retrieving information from the repositories.

UserNotAuthorizedException - the requesting user is not authorized to issue this request.

getBeansByValue

public List<B> getBeansByValue(String userId,
                               String value,
                               String valueParameterName,
                               String resultTypeGUID,
                               String resultTypeName,
                               List<String> specificMatchPropertyNames,
                               boolean exactValueMatch,
                               String requiredClassificationName,
                               String omittedClassificationName,
                               int startFrom,
                               int pageSize,
                               String methodName)
                        throws InvalidParameterException,
                               PropertyServerException,
                               UserNotAuthorizedException

Return the list of beans of the requested type that match the supplied value.

Parameters:

userId - the calling user

value - value to search

valueParameterName - parameter providing value

resultTypeGUID - unique identifier of the type that the results should match with

resultTypeName - unique value of the type that the results should match with

specificMatchPropertyNames - list of property value to look in - if null or empty list then all string properties are checked.

exactValueMatch - indicates whether the value must match the whole property value in a matching result, or whether it is a RegEx partial match

requiredClassificationName - String the name of the classification that must be on the entity.

omittedClassificationName - String the name of a classification that must not be on the entity.

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

pageSize - maximum number of elements to return

methodName - calling method

Returns:

list of beans

Throws:

InvalidParameterException - the userId is null or invalid.

PropertyServerException - there is a problem retrieving information from the repositories.

UserNotAuthorizedException - the requesting user is not authorized to issue this request.

getBeansByValue

public List<B> getBeansByValue(String userId,
                               String value,
                               String valueParameterName,
                               String resultTypeGUID,
                               String resultTypeName,
                               List<String> specificMatchPropertyNames,
                               boolean exactValueMatch,
                               String requiredClassificationName,
                               String omittedClassificationName,
                               List<String> serviceSupportedZones,
                               int startFrom,
                               int pageSize,
                               String methodName)
                        throws InvalidParameterException,
                               PropertyServerException,
                               UserNotAuthorizedException

Return the list of beans of the requested type that match the supplied value.

Parameters:

userId - the calling user

value - value to search

valueParameterName - parameter providing value

resultTypeGUID - unique identifier of the type that the results should match with

resultTypeName - unique value of the type that the results should match with

specificMatchPropertyNames - list of property value to look in - if null or empty list then all string properties are checked.

exactValueMatch - indicates whether the value must match the whole property value in a matching result, or whether it is a RegEx partial match

requiredClassificationName - String the name of the classification that must be on the entity.

omittedClassificationName - String the name of a classification that must not be on the entity.

serviceSupportedZones - list of supported zones for this service

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

pageSize - maximum number of elements to return

methodName - calling method

Returns:

list of beans

Throws:

InvalidParameterException - the userId is null or invalid.

PropertyServerException - there is a problem retrieving information from the repositories.

UserNotAuthorizedException - the requesting user is not authorized to issue this request.

getEntitiesByType

public List<EntityDetail> getEntitiesByType(String userId,
                                            String resultTypeGUID,
                                            String resultTypeName,
                                            List<String> serviceSupportedZones,
                                            int startFrom,
                                            int pageSize,
                                            String methodName)
                                     throws InvalidParameterException,
                                            PropertyServerException,
                                            UserNotAuthorizedException

Return the list of entities of the requested type.

Parameters:

userId - the name of the calling user

resultTypeGUID - unique identifier of the type that the results should match with

resultTypeName - unique name of the type that the results should match with

serviceSupportedZones - list of supported zones for this service

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

pageSize - maximum number of elements to return

methodName - calling method

Returns:

list of entities

Throws:

InvalidParameterException - the userId is null or invalid.

PropertyServerException - there is a problem retrieving information from the repositories.

UserNotAuthorizedException - the requesting user is not authorized to issue this request.

findEntities

public List<EntityDetail> findEntities(String userId,
                                       String searchString,
                                       String searchStringParameterName,
                                       String resultTypeGUID,
                                       String resultTypeName,
                                       String requiredClassificationName,
                                       String omittedClassificationName,
                                       int startFrom,
                                       int pageSize,
                                       String methodName)
                                throws InvalidParameterException,
                                       PropertyServerException,
                                       UserNotAuthorizedException

Return the list of entities matching the supplied searchString.

Parameters:

userId - the searchString of the calling user.

searchString - searchString of endpoint. This may include wild card characters.

searchStringParameterName - name of parameter providing search string

resultTypeGUID - unique identifier of the type that the results should match with

resultTypeName - unique value of the type that the results should match with

requiredClassificationName - String the name of the classification that must be on the entity.

omittedClassificationName - String the name of a classification that must not be on the entity.

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

pageSize - maximum number of elements to return.

methodName - calling method

Returns:

list of entities

Throws:

InvalidParameterException - the userId is null or invalid.

PropertyServerException - there is a problem retrieving information from the repositories.

UserNotAuthorizedException - the requesting user is not authorized to issue this request.

getEntitiesByValue

public List<EntityDetail> getEntitiesByValue(String userId,
                                             String value,
                                             String valueParameterName,
                                             String resultTypeGUID,
                                             String resultTypeName,
                                             List<String> specificMatchPropertyNames,
                                             boolean exactValueMatch,
                                             String requiredClassificationName,
                                             String omittedClassificationName,
                                             int startFrom,
                                             int pageSize,
                                             String methodName)
                                      throws InvalidParameterException,
                                             PropertyServerException,
                                             UserNotAuthorizedException

Return the list of entities of the requested type that match the supplied value.

Parameters:

userId - the calling user

value - value to search

valueParameterName - parameter providing value

resultTypeGUID - unique identifier of the type that the results should match with

resultTypeName - unique value of the type that the results should match with

specificMatchPropertyNames - list of property value to look in - if null or empty list then all string properties are checked.

exactValueMatch - indicates whether the value must match the whole property value in a matching result, or whether it is a RegEx partial match

requiredClassificationName - String the name of the classification that must be on the attached entity.

omittedClassificationName - String the name of a classification that must not be on the attached entity.

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

pageSize - maximum number of elements to return

methodName - calling method

Returns:

list of beans

Throws:

InvalidParameterException - the userId is null or invalid.

PropertyServerException - there is a problem retrieving information from the repositories.

UserNotAuthorizedException - the requesting user is not authorized to issue this request.

getEntitiesByValue

public List<EntityDetail> getEntitiesByValue(String userId,
                                             String value,
                                             String valueParameterName,
                                             String resultTypeGUID,
                                             String resultTypeName,
                                             List<String> specificMatchPropertyNames,
                                             boolean exactValueMatch,
                                             String requiredClassificationName,
                                             String omittedClassificationName,
                                             List<String> serviceSupportedZones,
                                             int startFrom,
                                             int pageSize,
                                             String methodName)
                                      throws InvalidParameterException,
                                             PropertyServerException,
                                             UserNotAuthorizedException

Return the list of entities of the requested type that match the supplied value.

Parameters:

userId - the calling user

value - value to search

valueParameterName - parameter providing value

resultTypeGUID - unique identifier of the type that the results should match with

resultTypeName - unique value of the type that the results should match with

specificMatchPropertyNames - list of property value to look in - if null or empty list then all string properties are checked.

exactValueMatch - indicates whether the value must match the whole property value in a matching result, or whether it is a RegEx partial match

requiredClassificationName - String the name of the classification that must be on the attached entity.

omittedClassificationName - String the name of a classification that must not be on the attached entity.

serviceSupportedZones - list of supported zones for this service

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

pageSize - maximum number of elements to return

methodName - calling method

Returns:

list of beans

Throws:

InvalidParameterException - the userId is null or invalid.

PropertyServerException - there is a problem retrieving information from the repositories.

UserNotAuthorizedException - the requesting user is not authorized to issue this request.

getEntityByValue

public EntityDetail getEntityByValue(String userId,
                                     String value,
                                     String valueParameterName,
                                     String resultTypeGUID,
                                     String resultTypeName,
                                     List<String> specificMatchPropertyNames,
                                     String methodName)
                              throws InvalidParameterException,
                                     UserNotAuthorizedException,
                                     PropertyServerException

Return the entity that matches the requested value.

Parameters:

userId - identifier of calling user

value - value to search

valueParameterName - parameter providing value

resultTypeGUID - unique identifier of the type that the results should match with

resultTypeName - unique value of the type that the results should match with

specificMatchPropertyNames - list of property value to look in - if null or empty list then all string properties are checked.

methodName - calling method

Returns:

requested entity

Throws:

InvalidParameterException - one of the parameters is null or invalid.

UserNotAuthorizedException - user not authorized to issue this request.

PropertyServerException - problem retrieving the entity.

getEntityGUIDByValue

public String getEntityGUIDByValue(String userId,
                                   String value,
                                   String valueParameterName,
                                   String resultTypeGUID,
                                   String resultTypeName,
                                   List<String> specificMatchPropertyNames,
                                   String methodName)
                            throws InvalidParameterException,
                                   UserNotAuthorizedException,
                                   PropertyServerException

Return the unique identifier of the entity matching the value.

Parameters:

userId - identifier of calling user

value - value to search

valueParameterName - parameter providing value

resultTypeGUID - unique identifier of the type that the results should match with

resultTypeName - unique value of the type that the results should match with

specificMatchPropertyNames - list of property value to look in - if null or empty list then all string properties are checked.

methodName - calling method

Returns:

unique identifier of the requested entity.

Throws:

InvalidParameterException - one of the parameters is null or invalid.

UserNotAuthorizedException - user not authorized to issue this request.

PropertyServerException - problem retrieving the entity.

findBeanGUIDs

public List<String> findBeanGUIDs(String userId,
                                  String searchString,
                                  String searchStringParameterName,
                                  String resultTypeGUID,
                                  String resultTypeName,
                                  int startFrom,
                                  int pageSize,
                                  String methodName)
                           throws InvalidParameterException,
                                  PropertyServerException,
                                  UserNotAuthorizedException

Return the list of beans of the requested type that match the supplied value.

Parameters:

userId - the searchString of the calling user.

searchString - searchString of endpoint. This may include wild card characters.

searchStringParameterName - name of parameter providing search string

resultTypeGUID - unique identifier of the type that the results should match with

resultTypeName - unique value of the type that the results should match with

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

pageSize - maximum number of elements to return.

methodName - calling method

Returns:

list of beans

Throws:

InvalidParameterException - the userId is null or invalid.

PropertyServerException - there is a problem retrieving information from the repositories.

UserNotAuthorizedException - the requesting user is not authorized to issue this request.

getBeanGUIDsByValue

public List<String> getBeanGUIDsByValue(String userId,
                                        String value,
                                        String valueParameterName,
                                        String resultTypeGUID,
                                        String resultTypeName,
                                        List<String> specificMatchPropertyNames,
                                        boolean exactValueMatch,
                                        List<String> serviceSupportedZones,
                                        int startFrom,
                                        int pageSize,
                                        String methodName)
                                 throws InvalidParameterException,
                                        PropertyServerException,
                                        UserNotAuthorizedException

Return the list of beans of the requested type that match the supplied value.

Parameters:

userId - the calling user

value - value to search

valueParameterName - parameter providing value

resultTypeGUID - unique identifier of the type that the results should match with

resultTypeName - unique value of the type that the results should match with

specificMatchPropertyNames - list of property value to look in - if null or empty list then all string properties are checked.

exactValueMatch - indicates whether the value must match the whole property value in a matching result, or whether it is a RegEx partial match

serviceSupportedZones - list of supported zones for this service

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

pageSize - maximum number of elements to return

methodName - calling method

Returns:

list of beans

Throws:

InvalidParameterException - the userId is null or invalid.

PropertyServerException - there is a problem retrieving information from the repositories.

UserNotAuthorizedException - the requesting user is not authorized to issue this request.

getBeansByCreator

public List<B> getBeansByCreator(String userId,
                                 String searchString,
                                 String searchStringParameterName,
                                 String resultTypeGUID,
                                 String resultTypeName,
                                 List<String> specificMatchPropertyNames,
                                 boolean exactValueMatch,
                                 List<String> serviceSupportedZones,
                                 int startFrom,
                                 int pageSize,
                                 String methodName)
                          throws InvalidParameterException,
                                 PropertyServerException,
                                 UserNotAuthorizedException

Return the list of beans of the requested type that were created by the requesting user.

Parameters:

userId - the name of the calling user

searchString - value that describes what to search for

searchStringParameterName - parameter providing search string

resultTypeGUID - unique identifier of the type that the results should match with

resultTypeName - unique name of the type that the results should match with

specificMatchPropertyNames - name of properties to visit

exactValueMatch - does the value need to match exactly?

serviceSupportedZones - list of supported zones for this service

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

pageSize - maximum number of elements to return

methodName - calling method

Returns:

list of beans

Throws:

InvalidParameterException - the userId is null or invalid.

PropertyServerException - there is a problem retrieving information from the repositories.

UserNotAuthorizedException - the requesting user is not authorized to issue this request.

getBeansByType

public List<B> getBeansByType(String userId,
                              String resultTypeGUID,
                              String resultTypeName,
                              int startFrom,
                              int pageSize,
                              String methodName)
                       throws InvalidParameterException,
                              PropertyServerException,
                              UserNotAuthorizedException

Return the list of beans of the requested type.

Parameters:

userId - the name of the calling user

resultTypeGUID - unique identifier of the type that the results should match with

resultTypeName - unique name of the type that the results should match with

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

pageSize - maximum number of elements to return

methodName - calling method

Returns:

list of beans

Throws:

InvalidParameterException - the userId is null or invalid.

PropertyServerException - there is a problem retrieving information from the repositories.

UserNotAuthorizedException - the requesting user is not authorized to issue this request.

getBeansByType

public List<B> getBeansByType(String userId,
                              String resultTypeGUID,
                              String resultTypeName,
                              List<String> serviceSupportedZones,
                              int startFrom,
                              int pageSize,
                              String methodName)
                       throws InvalidParameterException,
                              PropertyServerException,
                              UserNotAuthorizedException

Return the list of beans of the requested type that match the supplied name.

Parameters:

userId - the name of the calling user

resultTypeGUID - unique identifier of the type that the results should match with

resultTypeName - unique name of the type that the results should match with

serviceSupportedZones - list of supported zones for this service

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

pageSize - maximum number of elements to return

methodName - calling method

Returns:

list of beans

Throws:

InvalidParameterException - the userId is null or invalid.

PropertyServerException - there is a problem retrieving information from the repositories.

UserNotAuthorizedException - the requesting user is not authorized to issue this request.

getBeanGUIDsByType

public List<String> getBeanGUIDsByType(String userId,
                                       String resultTypeGUID,
                                       String resultTypeName,
                                       int startFrom,
                                       int pageSize,
                                       String methodName)
                                throws InvalidParameterException,
                                       PropertyServerException,
                                       UserNotAuthorizedException

Return the list of beans of the requested type.

Parameters:

userId - the name of the calling user

resultTypeGUID - unique identifier of the type that the results should match with

resultTypeName - unique name of the type that the results should match with

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

pageSize - maximum number of elements to return

methodName - calling method

Returns:

list of unique identifiers for matching beans

Throws:

InvalidParameterException - the userId is null or invalid.

PropertyServerException - there is a problem retrieving information from the repositories.

UserNotAuthorizedException - the requesting user is not authorized to issue this request.

getBeanGUIDsByType

public List<String> getBeanGUIDsByType(String userId,
                                       String resultTypeGUID,
                                       String resultTypeName,
                                       List<String> serviceSupportedZones,
                                       int startFrom,
                                       int pageSize,
                                       String methodName)
                                throws InvalidParameterException,
                                       PropertyServerException,
                                       UserNotAuthorizedException

Return the list of beans of the requested type.

Parameters:

userId - the name of the calling user

resultTypeGUID - unique identifier of the type that the results should match with

resultTypeName - unique name of the type that the results should match with

serviceSupportedZones - list of supported zones for this service

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

pageSize - maximum number of elements to return

methodName - calling method

Returns:

list of unique identifiers for matching beans

Throws:

InvalidParameterException - the userId is null or invalid.

PropertyServerException - there is a problem retrieving information from the repositories.

UserNotAuthorizedException - the requesting user is not authorized to issue this request.

getBeansByClassification

public List<B> getBeansByClassification(String userId,
                                        String resultTypeGUID,
                                        String resultClassificationName,
                                        int startFrom,
                                        int pageSize,
                                        String methodName)
                                 throws InvalidParameterException,
                                        PropertyServerException,
                                        UserNotAuthorizedException

Return the list of beans of the requested type that match the supplied name.

Parameters:

userId - the name of the calling user

resultTypeGUID - unique identifier of the type that the results should match with

resultClassificationName - unique name of the classification that the results should match with

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

pageSize - maximum number of elements to return

methodName - calling method

Returns:

list of beans

Throws:

InvalidParameterException - the userId is null or invalid.

PropertyServerException - there is a problem retrieving information from the repositories.

UserNotAuthorizedException - the requesting user is not authorized to issue this request.

getBeanGUIDsByClassification

public List<String> getBeanGUIDsByClassification(String userId,
                                                 String resultTypeGUID,
                                                 String resultClassificationName,
                                                 int startFrom,
                                                 int pageSize,
                                                 String methodName)
                                          throws InvalidParameterException,
                                                 PropertyServerException,
                                                 UserNotAuthorizedException

Return the list of beans of the requested type that match the supplied name.

Parameters:

userId - the name of the calling user

resultTypeGUID - unique identifier of the type that the results should match with

resultClassificationName - unique name of the classification that the results should match with

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

pageSize - maximum number of elements to return

methodName - calling method

Returns:

list of guids representing beans

Throws:

InvalidParameterException - the userId is null or invalid.

PropertyServerException - there is a problem retrieving information from the repositories.

UserNotAuthorizedException - the requesting user is not authorized to issue this request.

linkElementToElement

public void linkElementToElement(String userId,
                                 String externalSourceGUID,
                                 String externalSourceName,
                                 String startingGUID,
                                 String startingGUIDParameterName,
                                 String startingElementTypeName,
                                 String attachingGUID,
                                 String attachingGUIDParameterName,
                                 String attachingElementTypeName,
                                 String relationshipTypeGUID,
                                 String relationshipTypeName,
                                 InstanceProperties relationshipProperties,
                                 String methodName)
                          throws InvalidParameterException,
                                 PropertyServerException,
                                 UserNotAuthorizedException

Creates a relationship between two elements and updates the LatestChange in each one's anchor entity (if they have one). Both elements must be visible to the user to allow the link.

Parameters:

userId - userId of user making request

externalSourceGUID - guid of the software server capability entity that represented the external source - null for local

externalSourceName - name of the software server capability entity that represented the external source

startingGUID - unique id for the starting element's entity

startingGUIDParameterName - name of the parameter supplying the startingGUID

startingElementTypeName - type name of the starting element's entity

attachingGUID - unique id of the entity for the element that is being attached

attachingGUIDParameterName - name of the parameter supplying the attachingGUID

attachingElementTypeName - type name of the attaching element's entity

relationshipTypeGUID - unique identifier of type of the relationship to create

relationshipTypeName - unique name of type of the relationship to create

relationshipProperties - properties to add to the relationship or null if no properties to add

methodName - calling method

Throws:

InvalidParameterException - one of the parameters is null or invalid.

PropertyServerException - there is a problem updating the repositories.

UserNotAuthorizedException - the requesting user is not authorized to issue this request.

linkElementToElement

public void linkElementToElement(String userId,
                                 String externalSourceGUID,
                                 String externalSourceName,
                                 String startingGUID,
                                 String startingGUIDParameterName,
                                 String startingElementTypeName,
                                 String attachingGUID,
                                 String attachingGUIDParameterName,
                                 String attachingElementTypeName,
                                 List<String> suppliedSupportedZones,
                                 String attachmentTypeGUID,
                                 String attachmentTypeName,
                                 InstanceProperties relationshipProperties,
                                 String methodName)
                          throws InvalidParameterException,
                                 PropertyServerException,
                                 UserNotAuthorizedException

Creates a relationship between two elements and updates the LatestChange in each one's anchor entity (if they have one). Both elements must be visible to the user to allow the link.

Parameters:

userId - userId of user making request

externalSourceGUID - guid of the software server capability entity that represented the external source - null for local

externalSourceName - name of the software server capability entity that represented the external source

startingGUID - unique id for the starting element's entity

startingGUIDParameterName - name of the parameter supplying the startingGUID

startingElementTypeName - type name of the starting element's entity

attachingGUID - unique id of the entity for the element that is being attached

attachingGUIDParameterName - name of the parameter supplying the attachingGUID

attachingElementTypeName - type name of the attaching element's entity

suppliedSupportedZones - list of zones that any asset must be a member of at least one to be visible

attachmentTypeGUID - unique identifier of type of the relationship to create

attachmentTypeName - unique name of type of the relationship to create

relationshipProperties - properties to add to the relationship or null if no properties to add

methodName - calling method

Throws:

InvalidParameterException - one of the parameters is null or invalid.

PropertyServerException - there is a problem adding the relationship to the repositories.

UserNotAuthorizedException - the requesting user is not authorized to issue this request.

relinkElementToNewElement

public void relinkElementToNewElement(String userId,
                                      String externalSourceGUID,
                                      String externalSourceName,
                                      String startingGUID,
                                      String startingGUIDParameterName,
                                      String startingElementTypeName,
                                      boolean startAtEnd1,
                                      String newAttachingGUID,
                                      String newAttachingGUIDParameterName,
                                      String newAttachingElementTypeName,
                                      String attachmentTypeGUID,
                                      String attachmentTypeName,
                                      InstanceProperties relationshipProperties,
                                      String methodName)
                               throws InvalidParameterException,
                                      PropertyServerException,
                                      UserNotAuthorizedException

Delete the existing relationship between the starting element and another element then create a new relationship between the starting element element and the new attaching element. If successful this updates the LatestChange in each one's anchor entity (if they have one). Both elements must be visible to the user to allow the relinking.

Parameters:

userId - userId of user making request

externalSourceGUID - guid of the software server capability entity that represented the external source - null for local

externalSourceName - name of the software server capability entity that represented the external source

startingGUID - unique id for the starting element's entity

startingGUIDParameterName - name of the parameter supplying the startingGUID

startingElementTypeName - type name of the starting element's entity

startAtEnd1 - is the starting element at end 1 of the relationship

newAttachingGUID - unique id of the entity for the element that is being attached

newAttachingGUIDParameterName - name of the parameter supplying the newAttachingGUID

newAttachingElementTypeName - type name of the attaching element's entity

attachmentTypeGUID - unique identifier of type of the relationship to create

attachmentTypeName - unique name of type of the relationship to create

relationshipProperties - properties to add to the relationship or null if no properties to add

methodName - calling method

Throws:

InvalidParameterException - one of the parameters is null or invalid; or the relationship to change is not obvious

PropertyServerException - there is a problem adding the relationship to the repositories

UserNotAuthorizedException - the requesting user is not authorized to issue this request.

relinkElementToNewElement

public void relinkElementToNewElement(String userId,
                                      String externalSourceGUID,
                                      String externalSourceName,
                                      String startingGUID,
                                      String startingGUIDParameterName,
                                      String startingElementTypeName,
                                      boolean startAtEnd1,
                                      String newAttachingGUID,
                                      String newAttachingGUIDParameterName,
                                      String newAttachingElementTypeName,
                                      List<String> suppliedSupportedZones,
                                      String attachmentTypeGUID,
                                      String attachmentTypeName,
                                      InstanceProperties relationshipProperties,
                                      String methodName)
                               throws InvalidParameterException,
                                      PropertyServerException,
                                      UserNotAuthorizedException

Deleted the existing relationship between the starting element and another element then create a new relationship between the starting element element and the new attaching element. If successful this updates the LatestChange in each one's anchor entity (if they have one). Both elements must be visible to the user to allow the relinking.

Parameters:

userId - userId of user making request

externalSourceGUID - guid of the software server capability entity that represented the external source - null for local

externalSourceName - name of the software server capability entity that represented the external source

startingGUID - unique id for the starting element's entity

startingGUIDParameterName - name of the parameter supplying the startingGUID

startingElementTypeName - type name of the starting element's entity

startAtEnd1 - is the starting element at end 1 of the relationship

newAttachingGUID - unique id of the entity for the element that is being attached

newAttachingGUIDParameterName - name of the parameter supplying the newAttachingGUID

newAttachingElementTypeName - type name of the attaching element's entity

suppliedSupportedZones - list of zones that any asset must be a member of at least one to be visible

attachmentTypeGUID - unique identifier of type of the relationship to create

attachmentTypeName - unique name of type of the relationship to create

relationshipProperties - properties to add to the relationship or null if no properties to add

methodName - calling method

Throws:

InvalidParameterException - one of the parameters is null or invalid; or the relationship to change is not obvious

PropertyServerException - there is a problem adding the relationship to the repositories

UserNotAuthorizedException - the requesting user is not authorized to issue this request.

unlinkElementFromElement

public void unlinkElementFromElement(String userId,
                                     boolean onlyCreatorPermitted,
                                     String externalSourceGUID,
                                     String externalSourceName,
                                     String startingGUID,
                                     String startingGUIDParameterName,
                                     String startingElementTypeName,
                                     String attachingGUID,
                                     String attachingGUIDParameterName,
                                     String attachingElementTypeGUID,
                                     String attachingElementTypeName,
                                     String attachmentTypeGUID,
                                     String attachmentTypeName,
                                     String methodName)
                              throws InvalidParameterException,
                                     PropertyServerException,
                                     UserNotAuthorizedException

Removes a relationship between two elements.

Parameters:

userId - userId of user making request

onlyCreatorPermitted - operation only permitted if the userId was the same one that created the relationship

externalSourceGUID - guid of the software server capability entity that represented the external source - null for local

externalSourceName - name of the software server capability entity that represented the external source

startingGUID - unique id for the starting element's entity

startingGUIDParameterName - name of the parameter supplying the startingGUID

startingElementTypeName - type name of the starting element's entity

attachingGUID - unique id of the entity for the element that is being attached

attachingGUIDParameterName - name of the parameter supplying the attachingGUID

attachingElementTypeGUID - type identifier of the attaching element's entity

attachingElementTypeName - type name of the attaching element's entity

attachmentTypeGUID - unique identifier of type of the relationship to create

attachmentTypeName - unique name of type of the relationship to create

methodName - calling method

Throws:

InvalidParameterException - one of the parameters is null or invalid.

PropertyServerException - there is a problem updating relationship in the repositories.

UserNotAuthorizedException - the requesting user is not authorized to issue this request.

unlinkElementFromElement

public void unlinkElementFromElement(String userId,
                                     boolean onlyCreatorPermitted,
                                     String externalSourceGUID,
                                     String externalSourceName,
                                     String startingGUID,
                                     String startingGUIDParameterName,
                                     String startingElementTypeName,
                                     String attachedGUID,
                                     String attachedGUIDParameterName,
                                     String attachedElementTypeGUID,
                                     String attachedElementTypeName,
                                     List<String> suppliedSupportedZones,
                                     String attachmentTypeGUID,
                                     String attachmentTypeName,
                                     String methodName)
                              throws InvalidParameterException,
                                     PropertyServerException,
                                     UserNotAuthorizedException

Removes a relationship between two specified elements. If the attaching element is anchored to the same anchor as the starting element, it is unlinked from all other elements and deleted. This can cause a cascading effect if the anchored elements are organized in a hierarchy such as a schema or a comment conversation.

Parameters:

userId - userId of user making request

onlyCreatorPermitted - operation only permitted if the userId was the same one that created the relationship

externalSourceGUID - guid of the software server capability entity that represented the external source - null for local

externalSourceName - name of the software server capability entity that represented the external source

startingGUID - unique id for the starting element's entity

startingGUIDParameterName - name of the parameter supplying the startingGUID

startingElementTypeName - type name of the starting element's entity

attachedGUID - unique id of the entity for the element that is being attached

attachedGUIDParameterName - name of the parameter supplying the attachedGUID

attachedElementTypeGUID - type GUID of the attaching element's entity

attachedElementTypeName - type name of the attaching element's entity

suppliedSupportedZones - list of zones that any asset must be a member of at least one to be visible

attachmentTypeGUID - unique identifier of type of the relationship to create

attachmentTypeName - unique name of type of the relationship to create

methodName - calling method

Throws:

InvalidParameterException - one of the parameters is null or invalid.

PropertyServerException - there is a problem updating relationship in the repositories.

UserNotAuthorizedException - the requesting user is not authorized to issue this request.

unlinkAllElements

public void unlinkAllElements(String userId,
                              boolean onlyCreatorPermitted,
                              String externalSourceGUID,
                              String externalSourceName,
                              String startingGUID,
                              String startingGUIDParameterName,
                              String startingElementTypeName,
                              List<String> suppliedSupportedZones,
                              String attachmentTypeGUID,
                              String attachmentTypeName,
                              String methodName)
                       throws InvalidParameterException,
                              PropertyServerException,
                              UserNotAuthorizedException

Calls unlinkElementFromElement for all relationships of a certain type emanating from the requested element.

Parameters:

userId - userId of user making request

onlyCreatorPermitted - operation only permitted if the userId was the same one that created the relationship

externalSourceGUID - guid of the software server capability entity that represented the external source - null for local

externalSourceName - name of the software server capability entity that represented the external source

startingGUID - unique id for the starting element's entity

startingGUIDParameterName - name of the parameter supplying the startingGUID

startingElementTypeName - type name of the starting element's entity

suppliedSupportedZones - list of zones that any asset must be a member of at least one to be visible

attachmentTypeGUID - unique identifier of type of the relationship to create

attachmentTypeName - unique name of type of the relationship to create

methodName - calling method

Throws:

InvalidParameterException - one of the parameters is null or invalid.

PropertyServerException - there is a problem updating the relationships in the repositories.

UserNotAuthorizedException - the requesting user is not authorized to issue this request.

unlinkConnectedElement

public String unlinkConnectedElement(String userId,
                                     boolean onlyCreatorPermitted,
                                     String externalSourceGUID,
                                     String externalSourceName,
                                     String startingGUID,
                                     String startingGUIDParameterName,
                                     String startingElementTypeName,
                                     List<String> suppliedSupportedZones,
                                     String attachmentTypeGUID,
                                     String attachmentTypeName,
                                     String detachedElementTypeName,
                                     String methodName)
                              throws InvalidParameterException,
                                     PropertyServerException,
                                     UserNotAuthorizedException

Removes the relationship of a specific type attached to an entity. If the connected entity is anchored to the starting entity it is deleted (and linked dependent elements). There should be only one relationship. If there are more, an error is thrown.

Parameters:

userId - userId of user making request

onlyCreatorPermitted - operation only permitted if the userId was the same one that created the relationship

externalSourceGUID - guid of the software server capability entity that represented the external source - null for local

externalSourceName - name of the software server capability entity that represented the external source

startingGUID - unique id for the starting element's entity

startingGUIDParameterName - name of the parameter supplying the startingGUID

startingElementTypeName - type name of the starting element's entity

suppliedSupportedZones - list of zones that any asset must be a member of at least one to be visible

attachmentTypeGUID - unique identifier of type of the relationship to create

attachmentTypeName - unique name of type of the relationship to create

detachedElementTypeName - name of type of element that will be detached

methodName - calling method

Returns:

unique identifier of the entity that has been detached

Throws:

InvalidParameterException - one of the parameters is null or invalid.

PropertyServerException - there is a problem updating the relationship in the repositories.

UserNotAuthorizedException - the requesting user is not authorized to issue this request.

verifyExternalSourceIdentity

public void verifyExternalSourceIdentity(String userId,
                                         String externalSourceGUID,
                                         String externalSourceName,
                                         String methodName)
                                  throws InvalidParameterException,
                                         UserNotAuthorizedException,
                                         PropertyServerException

Verify that the integrator identities are either null or refer to a valid software server capability. These values will be used to set up the

Parameters:

userId - calling user

externalSourceGUID - guid of the software server capability entity that represented the external source - null for local

externalSourceName - name of the software server capability entity that represented the external source

methodName - calling method

Throws:

InvalidParameterException - the integrator GUID or name does not match what is in the metadata repository

PropertyServerException - problem accessing repositories

UserNotAuthorizedException - security access problem