Class OMRSMetadataCollectionBase

  • All Implemented Interfaces:
    AuditLoggingComponent
    Direct Known Subclasses:
    LocalOMRSMetadataCollection, OMRSDynamicTypeMetadataCollectionBase, OMRSFixedTypeMetadataCollectionBase, OMRSRESTMetadataCollection

    public abstract class OMRSMetadataCollectionBase
    extends OMRSMetadataCollection

    OMRSMetadataInstanceStore is the common interface for working with the contents of a metadata repository. Within a metadata collection are the type definitions (TypeDefs) and metadata instances (Entities and Relationships). OMRSMetadataCollectionBase provides empty implementation of the abstract methods of OMRSMetadataInstanceStore. The methods on OMRSMetadataInstanceStore are in the following major groups:

    • Methods to retrieve information about the metadata repository - Used to retrieve or confirm the identity of the metadata repository
    • Methods for working with typedefs - Typedefs are used to define the type model for open metadata. The open metadata support had a comprehensive set of typedefs implemented, and these can be augmented by different vendors or applications. The typedefs can be queried, created, updated and deleted though the metadata collection.
    • Methods for querying Entities and Relationships - The metadata repository stores instances of the typedefs as metadata instances. Principally these are entities (nodes in the graph) and relationships (links between nodes). Both the entities and relationships can have properties. The entity may also have structured properties called structs and classifications attached. This second group of methods supports a range of queries to retrieve these instances.
    • Methods for maintaining the instances - The fourth group of methods supports the maintenance of the metadata instances. Each instance as a status (see InstanceStatus) that allows an instance to be proposed, drafted and approved before it becomes active. The instances can also be soft-deleted and restored or purged from the metadata collection.
    • Methods for repairing the metadata collections of the cohort - The fifth group of methods are for editing the control information of entities and relationships to manage changes in the cohort. These methods are advanced methods and are rarely used.
    • Methods for local maintenance of a metadata collection The final group of methods are for removing reference copies of the metadata instances. These updates are not broadcast to the rest of the Cohort as events.
    • Method Summary

      All Methods Instance Methods Concrete Methods Deprecated Methods 
      Modifier and Type Method Description
      void addAttributeTypeDef​(java.lang.String userId, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.AttributeTypeDef newAttributeTypeDef)
      Create a definition of a new AttributeTypeDef.
      org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.EntityDetail addEntity​(java.lang.String userId, java.lang.String entityTypeGUID, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceProperties initialProperties, java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.Classification> initialClassifications, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceStatus initialStatus)
      Create a new entity and put it in the requested state.
      protected org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDef addEntityParameterValidation​(java.lang.String userId, java.lang.String entityTypeGUID, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceProperties initialProperties, java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.Classification> initialClassifications, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceStatus initialStatus)
      Deprecated.
      protected org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDef addEntityParameterValidation​(java.lang.String userId, java.lang.String entityTypeGUID, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceProperties initialProperties, java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.Classification> initialClassifications, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceStatus initialStatus, java.lang.String methodName)
      Validate that the parameters passed to addEntity are valid.
      void addEntityProxy​(java.lang.String userId, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.EntityProxy entityProxy)
      Create an entity proxy in the metadata collection.
      protected void addEntityProxyParameterValidation​(java.lang.String userId, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.EntityProxy entityProxy)
      Validate the parameters for addEntityProxy.
      org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.EntityDetail addExternalEntity​(java.lang.String userId, java.lang.String entityTypeGUID, java.lang.String externalSourceGUID, java.lang.String externalSourceName, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceProperties initialProperties, java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.Classification> initialClassifications, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceStatus initialStatus)
      Save a new entity that is sourced from an external technology.
      protected org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDef addExternalEntityParameterValidation​(java.lang.String userId, java.lang.String entityTypeGUID, java.lang.String externalSourceGUID, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceProperties initialProperties, java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.Classification> initialClassifications, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceStatus initialStatus, java.lang.String methodName)
      Validate parameters needed to save a new entity that is sourced from an external technology.
      org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.Relationship addExternalRelationship​(java.lang.String userId, java.lang.String relationshipTypeGUID, java.lang.String externalSourceGUID, java.lang.String externalSourceName, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceProperties initialProperties, java.lang.String entityOneGUID, java.lang.String entityTwoGUID, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceStatus initialStatus)
      Save a new relationship that is sourced from an external technology.
      protected org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDef addExternalRelationshipParameterValidation​(java.lang.String userId, java.lang.String relationshipTypeGUID, java.lang.String externalSourceGUID, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceProperties initialProperties, java.lang.String entityOneGUID, java.lang.String entityTwoGUID, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceStatus initialStatus, java.lang.String methodName)
      Validate the parameters needed to save a new relationship that is sourced from an external technology.
      org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.Relationship addRelationship​(java.lang.String userId, java.lang.String relationshipTypeGUID, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceProperties initialProperties, java.lang.String entityOneGUID, java.lang.String entityTwoGUID, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceStatus initialStatus)
      Add a new relationship between two entities to the metadata collection.
      protected org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDef addRelationshipParameterValidation​(java.lang.String userId, java.lang.String relationshipTypeGUID, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceProperties initialProperties, java.lang.String entityOneGUID, java.lang.String entityTwoGUID, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceStatus initialStatus)
      Deprecated.
      protected org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDef addRelationshipParameterValidation​(java.lang.String userId, java.lang.String relationshipTypeGUID, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceProperties initialProperties, java.lang.String entityOneGUID, java.lang.String entityTwoGUID, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceStatus initialStatus, java.lang.String methodName)
      Validate the parameters for adding a new relationship between two entities to the metadata collection.
      void addTypeDef​(java.lang.String userId, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDef newTypeDef)
      Create a definition of a new TypeDef.
      void addTypeDefGallery​(java.lang.String userId, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDefGallery newTypes)
      Create a collection of related types.
      protected void attributeTypeDefCategoryParameterValidation​(java.lang.String userId, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.AttributeTypeDefCategory category, java.lang.String categoryParameterName, java.lang.String methodName)
      Validate the properties of a request that accesses types by category.
      protected void attributeTypeDefParameterValidation​(java.lang.String userId, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.AttributeTypeDef attributeTypeDef, java.lang.String typeDefParameterName, java.lang.String methodName)
      Validate that a supplied attributeTypeDef is valid.
      org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.EntityDetail classifyEntity​(java.lang.String userId, java.lang.String entityGUID, java.lang.String classificationName, java.lang.String externalSourceGUID, java.lang.String externalSourceName, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.ClassificationOrigin classificationOrigin, java.lang.String classificationOriginGUID, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceProperties classificationProperties)
      Add the requested classification to a specific entity.
      org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.EntityDetail classifyEntity​(java.lang.String userId, java.lang.String entityGUID, java.lang.String classificationName, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceProperties classificationProperties)
      Add the requested classification to a specific entity.
      protected org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDef classifyEntityParameterValidation​(java.lang.String userId, java.lang.String entityGUID, java.lang.String classificationName, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceProperties classificationProperties)
      Deprecated.
      protected org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDef classifyEntityParameterValidation​(java.lang.String userId, java.lang.String entityGUID, java.lang.String classificationName, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceProperties classificationProperties, java.lang.String methodName)
      Validate the parameters passed to classifyEntity.
      protected org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDef classifyEntityParameterValidation​(java.lang.String userId, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.EntityProxy entityProxy, java.lang.String classificationName, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceProperties classificationProperties, java.lang.String methodName)
      Validate the parameters passed to classifyEntity.
      org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.EntityDetail declassifyEntity​(java.lang.String userId, java.lang.String entityGUID, java.lang.String classificationName)
      Remove a specific classification from an entity.
      protected void declassifyEntityParameterValidation​(java.lang.String userId, java.lang.String entityGUID, java.lang.String classificationName)
      Deprecated.
      protected void declassifyEntityParameterValidation​(java.lang.String userId, java.lang.String entityGUID, java.lang.String classificationName, java.lang.String methodName)
      Validate the parameters passed to declassifyEntity.
      void deleteAttributeTypeDef​(java.lang.String userId, java.lang.String obsoleteTypeDefGUID, java.lang.String obsoleteTypeDefName)
      Delete an AttributeTypeDef.
      org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.EntityDetail deleteEntity​(java.lang.String userId, java.lang.String typeDefGUID, java.lang.String typeDefName, java.lang.String obsoleteEntityGUID)
      Delete an entity.
      void deleteEntityReferenceCopy​(java.lang.String userId, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.EntityDetail entity)
      Remove a reference copy of the entity from the local repository.
      org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.Relationship deleteRelationship​(java.lang.String userId, java.lang.String typeDefGUID, java.lang.String typeDefName, java.lang.String obsoleteRelationshipGUID)
      Delete a specific relationship.
      void deleteRelationshipReferenceCopy​(java.lang.String userId, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.Relationship relationship)
      Remove the reference copy of the relationship from the local repository.
      void deleteTypeDef​(java.lang.String userId, java.lang.String obsoleteTypeDefGUID, java.lang.String obsoleteTypeDefName)
      Delete the TypeDef.
      protected java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.AttributeTypeDef> filterAttributeTypeDefsByCategory​(java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.AttributeTypeDef> allTypes, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.AttributeTypeDefCategory category)
      Returns all the types for a specific category.
      org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.AttributeTypeDef filterAttributeTypeDefsByGUID​(java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.AttributeTypeDef> allTypes, java.lang.String guid)
      Return the AttributeTypeDef that matches the guid.
      org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.AttributeTypeDef filterAttributeTypeDefsByName​(java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.AttributeTypeDef> allTypes, java.lang.String name)
      Return the TypeDef that matches the name.
      protected java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDef> filterTypeDefsByCategory​(java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDef> allTypes, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDefCategory category)
      Returns all the types for a specific category.
      org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDef filterTypeDefsByGUID​(java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDef> allTypes, java.lang.String guid)
      Return the TypeDef that matches the guid.
      org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDef filterTypeDefsByName​(java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDef> allTypes, java.lang.String name)
      Return the TypeDef that matches the name.
      protected java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDef> filterTypeDefsByProperty​(java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDef> allTypes, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDefProperties matchCriteria)
      Return the TypeDefs that have the properties matching the supplied match criteria.
      java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDef> filterTypeDefsBySearchCriteria​(java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDef> allTypes, java.lang.String searchCriteria)
      Return the TypeDefs that match the search criteria.
      java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDef> filterTypesByExternalID​(java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDef> allTypes, java.lang.String standard, java.lang.String organization, java.lang.String identifier)
      Match the supplied external standard identifiers against the active types for this repository.
      org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDefGallery filterTypesByWildCardName​(java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDef> allTypeDefs, java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.AttributeTypeDef> allAttributeTypeDefs, java.lang.String typeDefName)
      Return the types identified by the name supplied by the caller.
      java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.AttributeTypeDef> findAttributeTypeDefsByCategory​(java.lang.String userId, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.AttributeTypeDefCategory category)
      Returns all the AttributeTypeDefs for a specific category.
      java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.EntityDetail> findEntities​(java.lang.String userId, java.lang.String entityTypeGUID, java.util.List<java.lang.String> entitySubtypeGUIDs, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.search.SearchProperties matchProperties, int fromEntityElement, java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceStatus> limitResultsByStatus, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.search.SearchClassifications matchClassifications, java.util.Date asOfTime, java.lang.String sequencingProperty, SequencingOrder sequencingOrder, int pageSize)
      Return a list of entities that match the supplied criteria.
      java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.EntityDetail> findEntitiesByClassification​(java.lang.String userId, java.lang.String entityTypeGUID, java.lang.String classificationName, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceProperties matchClassificationProperties, MatchCriteria matchCriteria, int fromEntityElement, java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceStatus> limitResultsByStatus, java.util.Date asOfTime, java.lang.String sequencingProperty, SequencingOrder sequencingOrder, int pageSize)
      Return a list of entities that have the requested type of classifications attached.
      protected void findEntitiesByClassificationParameterValidation​(java.lang.String userId, java.lang.String entityTypeGUID, java.lang.String classificationName, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceProperties matchClassificationProperties, MatchCriteria matchCriteria, int fromEntityElement, java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceStatus> limitResultsByStatus, java.util.Date asOfTime, java.lang.String sequencingProperty, SequencingOrder sequencingOrder, int pageSize)
      Validate the parameters for findEntitiesByClassification.
      java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.EntityDetail> findEntitiesByProperty​(java.lang.String userId, java.lang.String entityTypeGUID, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceProperties matchProperties, MatchCriteria matchCriteria, int fromEntityElement, java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceStatus> limitResultsByStatus, java.util.List<java.lang.String> limitResultsByClassification, java.util.Date asOfTime, java.lang.String sequencingProperty, SequencingOrder sequencingOrder, int pageSize)
      Return a list of entities that match the supplied properties according to the match criteria.
      protected void findEntitiesByPropertyParameterValidation​(java.lang.String userId, java.lang.String entityTypeGUID, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceProperties matchProperties, MatchCriteria matchCriteria, int fromEntityElement, java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceStatus> limitResultsByStatus, java.util.List<java.lang.String> limitResultsByClassification, java.util.Date asOfTime, java.lang.String sequencingProperty, SequencingOrder sequencingOrder, int pageSize)
      Validate the parameters for findEntitiesByProperty.
      java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.EntityDetail> findEntitiesByPropertyValue​(java.lang.String userId, java.lang.String entityTypeGUID, java.lang.String searchCriteria, int fromEntityElement, java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceStatus> limitResultsByStatus, java.util.List<java.lang.String> limitResultsByClassification, java.util.Date asOfTime, java.lang.String sequencingProperty, SequencingOrder sequencingOrder, int pageSize)
      Return a list of entities whose string based property values match the search criteria.
      protected void findEntitiesByPropertyValueParameterValidation​(java.lang.String userId, java.lang.String entityTypeGUID, java.lang.String searchCriteria, int fromEntityElement, java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceStatus> limitResultsByStatus, java.util.List<java.lang.String> limitResultsByClassification, java.util.Date asOfTime, java.lang.String sequencingProperty, SequencingOrder sequencingOrder, int pageSize)
      Validate parameters passed to findEntitiesByPropertyValue.
      protected void findEntitiesParameterValidation​(java.lang.String userId, java.lang.String entityTypeGUID, java.util.List<java.lang.String> entitySubtypeGUIDs, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.search.SearchProperties matchProperties, int fromEntityElement, java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceStatus> limitResultsByStatus, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.search.SearchClassifications matchClassifications, java.util.Date asOfTime, java.lang.String sequencingProperty, SequencingOrder sequencingOrder, int pageSize)
      Validate the parameters for findEntities.
      java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.Relationship> findRelationships​(java.lang.String userId, java.lang.String relationshipTypeGUID, java.util.List<java.lang.String> relationshipSubtypeGUIDs, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.search.SearchProperties matchProperties, int fromRelationshipElement, java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceStatus> limitResultsByStatus, java.util.Date asOfTime, java.lang.String sequencingProperty, SequencingOrder sequencingOrder, int pageSize)
      Return a list of relationships that match the requested conditions.
      java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.Relationship> findRelationshipsByProperty​(java.lang.String userId, java.lang.String relationshipTypeGUID, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceProperties matchProperties, MatchCriteria matchCriteria, int fromRelationshipElement, java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceStatus> limitResultsByStatus, java.util.Date asOfTime, java.lang.String sequencingProperty, SequencingOrder sequencingOrder, int pageSize)
      Return a list of relationships that match the requested properties by the matching criteria.
      protected void findRelationshipsByPropertyParameterValidation​(java.lang.String userId, java.lang.String relationshipTypeGUID, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceProperties matchProperties, MatchCriteria matchCriteria, int fromRelationshipElement, java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceStatus> limitResultsByStatus, java.util.Date asOfTime, java.lang.String sequencingProperty, SequencingOrder sequencingOrder, int pageSize)
      Validate the parameters passed to findRelationshipsByProperty.
      java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.Relationship> findRelationshipsByPropertyValue​(java.lang.String userId, java.lang.String relationshipTypeGUID, java.lang.String searchCriteria, int fromRelationshipElement, java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceStatus> limitResultsByStatus, java.util.Date asOfTime, java.lang.String sequencingProperty, SequencingOrder sequencingOrder, int pageSize)
      Return a list of relationships whose string based property values match the search criteria.
      protected void findRelationshipsByPropertyValueParameterValidation​(java.lang.String userId, java.lang.String relationshipTypeGUID, java.lang.String searchCriteria, int fromRelationshipElement, java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceStatus> limitResultsByStatus, java.util.Date asOfTime, java.lang.String sequencingProperty, SequencingOrder sequencingOrder, int pageSize)
      Validate the parameters passed to findRelationshipsByPropertyName.
      protected void findRelationshipsParameterValidation​(java.lang.String userId, java.lang.String relationshipTypeGUID, java.util.List<java.lang.String> relationshipSubtypeGUIDs, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.search.SearchProperties matchProperties, int fromRelationshipElement, java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceStatus> limitResultsByStatus, java.util.Date asOfTime, java.lang.String sequencingProperty, SequencingOrder sequencingOrder, int pageSize)
      Validate the parameters passed to findRelationships.
      java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDef> findTypeDefsByCategory​(java.lang.String userId, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDefCategory category)
      Returns all the TypeDefs for a specific category.
      java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDef> findTypeDefsByProperty​(java.lang.String userId, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDefProperties matchCriteria)
      Return the TypeDefs that have the properties matching the supplied match criteria.
      java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDef> findTypesByExternalID​(java.lang.String userId, java.lang.String standard, java.lang.String organization, java.lang.String identifier)
      Return the types that are linked to the elements from the specified standard.
      org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDefGallery findTypesByName​(java.lang.String userId, java.lang.String name)
      Returns a list of type definitions that have the specified name.
      org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDefGallery getAllTypes​(java.lang.String userId)
      Returns the list of different types of metadata organized into two groups.
      org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.AttributeTypeDef getAttributeTypeDefByGUID​(java.lang.String userId, java.lang.String guid)
      Return the AttributeTypeDef identified by the GUID.
      org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.AttributeTypeDef getAttributeTypeDefByName​(java.lang.String userId, java.lang.String name)
      Return the AttributeTypeDef identified by the unique name.
      org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.EntityDetail getEntityDetail​(java.lang.String userId, java.lang.String guid)
      Return the header, classifications and properties of a specific entity.
      org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.EntityDetail getEntityDetail​(java.lang.String userId, java.lang.String guid, java.util.Date asOfTime)
      Return a historical version of an entity.
      java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.EntityDetail> getEntityDetailHistory​(java.lang.String userId, java.lang.String guid, java.util.Date fromTime, java.util.Date toTime, int startFromElement, int pageSize, HistorySequencingOrder sequencingOrder)
      Return all historical versions of an entity within the bounds of the provided timestamps.
      org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceGraph getEntityNeighborhood​(java.lang.String userId, java.lang.String entityGUID, java.util.List<java.lang.String> entityTypeGUIDs, java.util.List<java.lang.String> relationshipTypeGUIDs, java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceStatus> limitResultsByStatus, java.util.List<java.lang.String> limitResultsByClassification, java.util.Date asOfTime, int level)
      Return the entities and relationships that radiate out from the supplied entity GUID.
      protected void getEntityNeighborhoodParameterValidation​(java.lang.String userId, java.lang.String entityGUID, java.util.List<java.lang.String> entityTypeGUIDs, java.util.List<java.lang.String> relationshipTypeGUIDs, java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceStatus> limitResultsByStatus, java.util.List<java.lang.String> limitResultsByClassification, java.util.Date asOfTime, int level)
      Return the entities and relationships that radiate out from the supplied entity GUID.
      protected org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.EntityProxy getEntityProxy​(java.lang.String userId, java.lang.String entityGUID, java.lang.String methodName)
      Retrieve an entity proxy
      org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.EntitySummary getEntitySummary​(java.lang.String userId, java.lang.String guid)
      Return the header and classifications for a specific entity.
      java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.Classification> getHomeClassifications​(java.lang.String userId, java.lang.String entityGUID)
      Retrieve any locally homed classifications assigned to the requested entity.
      java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.Classification> getHomeClassifications​(java.lang.String userId, java.lang.String entityGUID, java.util.Date asOfTime)
      Retrieve any locally homed classifications assigned to the requested entity.
      protected void getInstanceHistoryParameterValidation​(java.lang.String userId, java.lang.String guid, java.util.Date fromTime, java.util.Date toTime, java.lang.String methodName)
      Validate the parameters for a retrieve multiple historical versions of an instance.
      protected void getInstanceParameterValidation​(java.lang.String userId, java.lang.String guid, java.lang.String methodName)
      Validate the parameters for a retrieve of an instance.
      protected void getInstanceParameterValidation​(java.lang.String userId, java.lang.String guid, java.util.Date asOfTime, java.lang.String methodName)
      Validate the parameters for a retrieve of a historical version of an instance.
      org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceGraph getLinkingEntities​(java.lang.String userId, java.lang.String startEntityGUID, java.lang.String endEntityGUID, java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceStatus> limitResultsByStatus, java.util.Date asOfTime)
      Return all the relationships and intermediate entities that connect the startEntity with the endEntity.
      protected void getLinkingEntitiesParameterValidation​(java.lang.String userId, java.lang.String startEntityGUID, java.lang.String endEntityGUID, java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceStatus> limitResultsByStatus, java.util.Date asOfTime)
      Validate the parameters passed to getLinkingEntities.
      java.lang.String getMetadataCollectionId​(java.lang.String userId)
      Returns the identifier of the metadata repository.
      java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.EntityDetail> getRelatedEntities​(java.lang.String userId, java.lang.String startEntityGUID, java.util.List<java.lang.String> entityTypeGUIDs, int fromEntityElement, java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceStatus> limitResultsByStatus, java.util.List<java.lang.String> limitResultsByClassification, java.util.Date asOfTime, java.lang.String sequencingProperty, SequencingOrder sequencingOrder, int pageSize)
      Return the list of entities that are of the types listed in entityTypeGUIDs and are connected, either directly or indirectly to the entity identified by startEntityGUID.
      protected void getRelatedEntitiesParameterValidation​(java.lang.String userId, java.lang.String startEntityGUID, java.util.List<java.lang.String> entityTypeGUIDs, int fromEntityElement, java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceStatus> limitResultsByStatus, java.util.List<java.lang.String> limitResultsByClassification, java.util.Date asOfTime, java.lang.String sequencingProperty, SequencingOrder sequencingOrder, int pageSize)
      Validate the parameters passed to the getRelatedEntities.
      org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.Relationship getRelationship​(java.lang.String userId, java.lang.String guid)
      Return a requested relationship.
      org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.Relationship getRelationship​(java.lang.String userId, java.lang.String guid, java.util.Date asOfTime)
      Return a historical version of a relationship.
      java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.Relationship> getRelationshipHistory​(java.lang.String userId, java.lang.String guid, java.util.Date fromTime, java.util.Date toTime, int startFromElement, int pageSize, HistorySequencingOrder sequencingOrder)
      Return all historical versions of a relationship within the bounds of the provided timestamps.
      java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.Relationship> getRelationshipsForEntity​(java.lang.String userId, java.lang.String entityGUID, java.lang.String relationshipTypeGUID, int fromRelationshipElement, java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceStatus> limitResultsByStatus, java.util.Date asOfTime, java.lang.String sequencingProperty, SequencingOrder sequencingOrder, int pageSize)
      Return the relationships for a specific entity.
      protected void getRelationshipsForEntityParameterValidation​(java.lang.String userId, java.lang.String entityGUID, java.lang.String relationshipTypeGUID, int fromRelationshipElement, java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceStatus> limitResultsByStatus, java.util.Date asOfTime, java.lang.String sequencingProperty, SequencingOrder sequencingOrder, int pageSize)
      Validate the parameters for getRelationshipsForEntity.
      org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDef getTypeDefByGUID​(java.lang.String userId, java.lang.String guid)
      Return the TypeDef identified by the GUID.
      org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDef getTypeDefByName​(java.lang.String userId, java.lang.String name)
      Return the TypeDef identified by the unique name.
      protected org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDef getTypeDefForInstance​(org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceHeader header, java.lang.String methodName)
      Extract the typeDef for an instance
      org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.EntityDetail isEntityKnown​(java.lang.String userId, java.lang.String guid)
      Returns the entity if the entity is stored in the metadata collection, otherwise null.
      org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.Relationship isRelationshipKnown​(java.lang.String userId, java.lang.String guid)
      Returns a boolean indicating if the relationship is stored in the metadata collection.
      protected org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.AttributeTypeDef manageAttributeTypeDefParameterValidation​(java.lang.String userId, java.lang.String guidParameterName, java.lang.String nameParameterName, java.lang.String attributeTypeDefGUID, java.lang.String attributeTypeDefName, java.lang.String methodName)
      Validate the type information for a management change to an attributeTypeDef.
      protected void manageInstanceParameterValidation​(java.lang.String userId, java.lang.String instanceGUID, java.lang.String methodName)
      Deprecated.
      protected void manageInstanceParameterValidation​(java.lang.String userId, java.lang.String instanceGUID, java.lang.String instanceGUIDParameterName, java.lang.String methodName)
      Validate the parameters for calls that manage an existing instance.
      protected void manageInstanceParameterValidation​(java.lang.String userId, java.lang.String typeDefGUID, java.lang.String typeDefName, java.lang.String instanceGUID, java.lang.String instanceGUIDParameterName, java.lang.String methodName)
      Validate the parameters passed to a delete or purge instance method.
      protected void manageReferenceInstanceParameterValidation​(java.lang.String userId, java.lang.String typeDefGUID, java.lang.String typeDefName, java.lang.String instanceGUID, java.lang.String instanceGUIDParameterName, java.lang.String homeMetadataCollectionId, java.lang.String homeParameterName, java.lang.String methodName)
      Validate the parameters passed to a reference instance method.
      protected org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDef manageTypeDefParameterValidation​(java.lang.String userId, java.lang.String guidParameterName, java.lang.String nameParameterName, java.lang.String typeDefGUID, java.lang.String typeDefName, java.lang.String methodName)
      Validate the type information for a management change to a type.
      protected void newAttributeTypeDefParameterValidation​(java.lang.String userId, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.AttributeTypeDef attributeTypeDef, java.lang.String typeDefParameterName, java.lang.String methodName)
      Validate that a supplied attributeTypeDef is valid and unknown.
      protected void newTypeDefParameterValidation​(java.lang.String userId, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDef typeDef, java.lang.String typeDefParameterName, java.lang.String methodName)
      Validate that a supplied typeDef is valid and unknown.
      void purgeClassificationReferenceCopy​(java.lang.String userId, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.EntityDetail entity, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.Classification classification)
      Remove the reference copy of the classification from the local repository.
      void purgeEntity​(java.lang.String userId, java.lang.String typeDefGUID, java.lang.String typeDefName, java.lang.String deletedEntityGUID)
      Permanently removes a deleted entity from the metadata collection.
      void purgeEntityReferenceCopy​(java.lang.String userId, java.lang.String entityGUID, java.lang.String typeDefGUID, java.lang.String typeDefName, java.lang.String homeMetadataCollectionId)
      Remove a reference copy of the entity from the local repository.
      void purgeEntityReferenceCopy​(java.lang.String userId, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.EntityDetail entity)
      Remove a reference copy of the entity from the local repository.
      void purgeRelationship​(java.lang.String userId, java.lang.String typeDefGUID, java.lang.String typeDefName, java.lang.String deletedRelationshipGUID)
      Permanently delete the relationship from the repository.
      void purgeRelationshipReferenceCopy​(java.lang.String userId, java.lang.String relationshipGUID, java.lang.String typeDefGUID, java.lang.String typeDefName, java.lang.String homeMetadataCollectionId)
      Remove the reference copy of the relationship from the local repository.
      void purgeRelationshipReferenceCopy​(java.lang.String userId, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.Relationship relationship)
      Remove the reference copy of the relationship from the local repository.
      protected void referenceInstanceParameterValidation​(java.lang.String userId, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceHeader instanceHeader, java.lang.String instanceParameterName, java.lang.String methodName)
      Validate the header instance passed to a delete or purge instance method.
      void refreshEntityReferenceCopy​(java.lang.String userId, java.lang.String entityGUID, java.lang.String typeDefGUID, java.lang.String typeDefName, java.lang.String homeMetadataCollectionId)
      The local repository has requested that the repository that hosts the home metadata collection for the specified entity sends out the details of this entity so the local repository can create a reference copy.
      void refreshRelationshipReferenceCopy​(java.lang.String userId, java.lang.String relationshipGUID, java.lang.String typeDefGUID, java.lang.String typeDefName, java.lang.String homeMetadataCollectionId)
      The local server has requested that the repository that hosts the home metadata collection for the specified relationship sends out the details of this relationship so the local repository can create a reference copy.
      org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.EntityDetail reHomeEntity​(java.lang.String userId, java.lang.String entityGUID, java.lang.String typeDefGUID, java.lang.String typeDefName, java.lang.String homeMetadataCollectionId, java.lang.String newHomeMetadataCollectionId, java.lang.String newHomeMetadataCollectionName)
      Change the home of an existing entity.
      protected void reHomeInstanceParameterValidation​(java.lang.String userId, java.lang.String instanceGUID, java.lang.String instanceParameterName, java.lang.String typeDefGUID, java.lang.String typeDefName, java.lang.String homeMetadataCollectionId, java.lang.String newHomeMetadataCollectionId, java.lang.String methodName)
      Validate that the parameters passed to a reHome request are valid.
      org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.Relationship reHomeRelationship​(java.lang.String userId, java.lang.String relationshipGUID, java.lang.String typeDefGUID, java.lang.String typeDefName, java.lang.String homeMetadataCollectionId, java.lang.String newHomeMetadataCollectionId, java.lang.String newHomeMetadataCollectionName)
      Change the home of an existing relationship.
      org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.AttributeTypeDef reIdentifyAttributeTypeDef​(java.lang.String userId, java.lang.String originalAttributeTypeDefGUID, java.lang.String originalAttributeTypeDefName, java.lang.String newAttributeTypeDefGUID, java.lang.String newAttributeTypeDefName)
      Change the guid or name of an existing TypeDef to a new value.
      org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.EntityDetail reIdentifyEntity​(java.lang.String userId, java.lang.String typeDefGUID, java.lang.String typeDefName, java.lang.String entityGUID, java.lang.String newEntityGUID)
      Change the guid of an existing entity to a new value.
      protected void reIdentifyInstanceParameterValidation​(java.lang.String userId, java.lang.String typeDefGUID, java.lang.String typeDefName, java.lang.String instanceGUID, java.lang.String instanceParameterName, java.lang.String newInstanceGUID, java.lang.String newInstanceParameterName, java.lang.String methodName)  
      org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.Relationship reIdentifyRelationship​(java.lang.String userId, java.lang.String typeDefGUID, java.lang.String typeDefName, java.lang.String relationshipGUID, java.lang.String newRelationshipGUID)
      Change the guid of an existing relationship.
      org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDef reIdentifyTypeDef​(java.lang.String userId, java.lang.String originalTypeDefGUID, java.lang.String originalTypeDefName, java.lang.String newTypeDefGUID, java.lang.String newTypeDefName)
      Change the guid or name of an existing TypeDef to a new value.
      protected void removeInstanceParameterValidation​(java.lang.String userId, java.lang.String typeDefGUID, java.lang.String typeDefName, java.lang.String instanceGUID, java.lang.String methodName)
      Deprecated.
      protected void reportEntityNotKnown​(java.lang.String entityGUID, java.lang.String methodName)
      Throw exception to indicate that an entity unique identifier is not recognized.
      protected void reportEntityProxyOnly​(java.lang.String guid, java.lang.String guidParameterName, java.lang.String methodName)
      Throw an exception for the situation where there is only a proxy and the caller wants an entity details.
      protected void reportRelationshipNotKnown​(java.lang.String relationshipGUID, java.lang.String methodName)
      Throw exception to indicate that a relationship unique identifier is not recognized.
      protected void reportTypeDefAlreadyDefined​(java.lang.String typeGUID, java.lang.String typeName, java.lang.String methodName)
      Report that the type can not be created because it is already defined.
      protected void reportTypeDefConflict​(java.lang.String typeGUID, java.lang.String typeName, java.lang.String methodName)
      Report a type conflict error.
      protected void reportTypeDefInUse​(java.lang.String typeGUID, java.lang.String typeName, java.lang.String methodName)
      Report that a type can not be deleted.
      protected void reportTypeDefNotSupported​(java.lang.String typeName, java.lang.String methodName)
      Throw exception to indicate that a relationship unique identifier is not recognized.
      protected void reportUnknownTypeGUID​(java.lang.String guid, java.lang.String guidParameterName, java.lang.String methodName)
      Throw exception to indicate that a type unique identifier is not recognized.
      protected void reportUnknownTypeName​(java.lang.String name, java.lang.String methodName)
      Throw exception to indicate that a type unique identifier is not recognized.
      protected void reportUnsupportedAsOfTimeFunction​(java.lang.String methodName, java.util.Date asOfTime)
      Return an exception to indicate that the method is unsupported but this is ok because it is optional.
      org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.EntityDetail restoreEntity​(java.lang.String userId, java.lang.String deletedEntityGUID)
      Restore the requested entity to the state it was before it was deleted.
      org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.Relationship restoreRelationship​(java.lang.String userId, java.lang.String deletedRelationshipGUID)
      Restore a deleted relationship into the metadata collection.
      org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.EntityDetail reTypeEntity​(java.lang.String userId, java.lang.String entityGUID, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDefSummary currentTypeDefSummary, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDefSummary newTypeDefSummary)
      Change the type of an existing entity.
      protected void reTypeInstanceParameterValidation​(java.lang.String userId, java.lang.String instanceGUID, java.lang.String instanceParameterName, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDefCategory expectedTypeDefCategory, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDefSummary currentTypeDefSummary, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDefSummary newTypeDefSummary, java.lang.String methodName)
      Validate the parameters needed to reType an instance.
      org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.Relationship reTypeRelationship​(java.lang.String userId, java.lang.String relationshipGUID, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDefSummary currentTypeDefSummary, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDefSummary newTypeDefSummary)
      Change the type of an existing relationship.
      void saveClassificationReferenceCopy​(java.lang.String userId, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.EntityDetail entity, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.Classification classification)
      Save the classification as a reference copy.
      void saveClassificationReferenceCopy​(java.lang.String userId, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.EntityProxy entity, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.Classification classification)
      Save the classification as a reference copy.
      void saveEntityReferenceCopy​(java.lang.String userId, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.EntityDetail entity)
      Save the entity as a reference copy.
      void saveRelationshipReferenceCopy​(java.lang.String userId, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.Relationship relationship)
      Save the relationship as a reference copy.
      java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDef> searchForTypeDefs​(java.lang.String userId, java.lang.String searchCriteria)
      Return the TypeDefs that match the search criteria.
      protected void typeDefCategoryParameterValidation​(java.lang.String userId, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDefCategory category, java.lang.String categoryParameterName, java.lang.String methodName)
      Validate the properties of a request that accesses types by category.
      protected void typeDefExternalIDParameterValidation​(java.lang.String userId, java.lang.String standard, java.lang.String organization, java.lang.String identifier, java.lang.String methodName)
      Validate the properties used to locate types.
      protected void typeDefParameterValidation​(java.lang.String userId, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDef typeDef, java.lang.String typeDefParameterName, java.lang.String methodName)
      Validate that a supplied typeDef is valid.
      protected void typeDefPropertyParameterValidation​(java.lang.String userId, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDefProperties matchCriteria, java.lang.String matchCriteriaParameterName, java.lang.String methodName)
      Validate the properties used to locate types.
      protected void typeDefSearchParameterValidation​(java.lang.String userId, java.lang.String searchCriteria, java.lang.String searchCriteriaParameterName, java.lang.String methodName)
      Validate the properties used to locate types.
      protected void typeGUIDParameterValidation​(java.lang.String userId, java.lang.String guid, java.lang.String guidParameterName, java.lang.String methodName)
      Validate the properties of a request that accesses types by guid.
      protected void typeNameParameterValidation​(java.lang.String userId, java.lang.String name, java.lang.String nameParameterName, java.lang.String methodName)
      Validate the properties of a request that accesses types by name.
      org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.EntityDetail undoEntityUpdate​(java.lang.String userId, java.lang.String entityGUID)
      Undo the last update to an entity and return the previous content.
      org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.Relationship undoRelationshipUpdate​(java.lang.String userId, java.lang.String relationshipGUID)
      Undo the latest change to a relationship (either a change of properties or status).
      org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.EntityDetail updateEntityClassification​(java.lang.String userId, java.lang.String entityGUID, java.lang.String classificationName, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceProperties properties)
      Update one or more properties in one of an entity's classifications.
      protected org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDef updateEntityClassificationParameterValidation​(java.lang.String userId, java.lang.String entityGUID, java.lang.String classificationName, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceProperties properties)
      Deprecated.
      org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.EntityDetail updateEntityProperties​(java.lang.String userId, java.lang.String entityGUID, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceProperties properties)
      Update selected properties in an entity.
      org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.EntityDetail updateEntityStatus​(java.lang.String userId, java.lang.String entityGUID, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceStatus newStatus)
      Update the status for a specific entity.
      protected void updateInstancePropertiesPropertyValidation​(java.lang.String userId, java.lang.String instanceGUID, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceProperties properties, java.lang.String methodName)
      Validate the parameters for update the properties of an instance.
      protected void updateInstanceStatusParameterValidation​(java.lang.String userId, java.lang.String entityGUID, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceStatus newStatus, java.lang.String methodName)
      Validate parameters for updateEntityStatus.
      org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.Relationship updateRelationshipProperties​(java.lang.String userId, java.lang.String relationshipGUID, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceProperties properties)
      Update the properties of a specific relationship.
      org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.Relationship updateRelationshipStatus​(java.lang.String userId, java.lang.String relationshipGUID, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceStatus newStatus)
      Update the status of a specific relationship.
      org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDef updateTypeDef​(java.lang.String userId, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDefPatch typeDefPatch)
      Update one or more properties of the TypeDef.
      protected org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDef updateTypeDefParameterValidation​(java.lang.String userId, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDefPatch typeDefPatch, java.lang.String methodName)
      Validate that a patch to a type definition is valid.
      boolean verifyAttributeTypeDef​(java.lang.String userId, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.AttributeTypeDef attributeTypeDef)
      Verify that a definition of an AttributeTypeDef is either new or matches the definition already stored.
      boolean verifyTypeDef​(java.lang.String userId, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDef typeDef)
      Verify that a definition of a TypeDef is either new or matches the definition already stored.
      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    • Constructor Detail

      • OMRSMetadataCollectionBase

        public OMRSMetadataCollectionBase​(OMRSRepositoryConnector parentConnector,
                                          java.lang.String repositoryName,
                                          OMRSRepositoryHelper repositoryHelper,
                                          OMRSRepositoryValidator repositoryValidator,
                                          java.lang.String metadataCollectionId)
        Constructor ensures the metadata collection is linked to its connector and knows its metadata collection Id.
        Parameters:
        parentConnector - connector that this metadata collection supports. The connector has the information to call the metadata repository.
        repositoryName - name of this repository.
        repositoryHelper - helper class for building types and instances
        repositoryValidator - validator class for checking open metadata repository objects and parameters.
        metadataCollectionId - unique identifier of the metadata collection Id.
    • Method Detail

      • getMetadataCollectionId

        public java.lang.String getMetadataCollectionId​(java.lang.String userId)
                                                 throws org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException
        Returns the identifier of the metadata repository. This is the identifier used to register the metadata repository with the metadata repository cohort. It is also the identifier used to identify the home repository of a metadata instance.
        Overrides:
        getMetadataCollectionId in class OMRSMetadataCollection
        Parameters:
        userId - calling user
        Returns:
        String metadata collection id.
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository.
      • typeGUIDParameterValidation

        protected void typeGUIDParameterValidation​(java.lang.String userId,
                                                   java.lang.String guid,
                                                   java.lang.String guidParameterName,
                                                   java.lang.String methodName)
                                            throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                   org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException
        Validate the properties of a request that accesses types by guid.
        Parameters:
        userId - calling user
        guid - guid of type
        guidParameterName - parameter that the guid was passed in on
        methodName - calling method
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - one of the parameters is null or invalid
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem with the repository connector
      • typeNameParameterValidation

        protected void typeNameParameterValidation​(java.lang.String userId,
                                                   java.lang.String name,
                                                   java.lang.String nameParameterName,
                                                   java.lang.String methodName)
                                            throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                   org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException
        Validate the properties of a request that accesses types by name.
        Parameters:
        userId - calling user
        name - name of type
        nameParameterName - parameter that the name was passed in on
        methodName - calling method
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - one of the parameters is null or invalid
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem with the repository connector
      • typeDefCategoryParameterValidation

        protected void typeDefCategoryParameterValidation​(java.lang.String userId,
                                                          org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDefCategory category,
                                                          java.lang.String categoryParameterName,
                                                          java.lang.String methodName)
                                                   throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                          org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException
        Validate the properties of a request that accesses types by category.
        Parameters:
        userId - calling user
        category - category of type
        categoryParameterName - parameter that the category was passed in on
        methodName - calling method
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - one of the parameters is null or invalid
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem with the repository connector
      • attributeTypeDefCategoryParameterValidation

        protected void attributeTypeDefCategoryParameterValidation​(java.lang.String userId,
                                                                   org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.AttributeTypeDefCategory category,
                                                                   java.lang.String categoryParameterName,
                                                                   java.lang.String methodName)
                                                            throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                                   org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException
        Validate the properties of a request that accesses types by category.
        Parameters:
        userId - calling user
        category - category of type
        categoryParameterName - parameter that the category was passed in on
        methodName - calling method
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - one of the parameters is null or invalid
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem with the repository connector
      • typeDefPropertyParameterValidation

        protected void typeDefPropertyParameterValidation​(java.lang.String userId,
                                                          org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDefProperties matchCriteria,
                                                          java.lang.String matchCriteriaParameterName,
                                                          java.lang.String methodName)
                                                   throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                          org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException
        Validate the properties used to locate types.
        Parameters:
        userId - unique identifier for requesting user.
        matchCriteria - TypeDefProperties containing a list of property names.
        matchCriteriaParameterName - parameter that the match criteria was passed in on
        methodName - calling method
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - the matchCriteria is null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository.
      • typeDefSearchParameterValidation

        protected void typeDefSearchParameterValidation​(java.lang.String userId,
                                                        java.lang.String searchCriteria,
                                                        java.lang.String searchCriteriaParameterName,
                                                        java.lang.String methodName)
                                                 throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException
        Validate the properties used to locate types.
        Parameters:
        userId - unique identifier for requesting user.
        searchCriteria - string containing the search criteria.
        searchCriteriaParameterName - parameter that the search criteria was passed in on
        methodName - calling method
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - the searchCriteria is null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository.
      • typeDefExternalIDParameterValidation

        protected void typeDefExternalIDParameterValidation​(java.lang.String userId,
                                                            java.lang.String standard,
                                                            java.lang.String organization,
                                                            java.lang.String identifier,
                                                            java.lang.String methodName)
                                                     throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                            org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException
        Validate the properties used to locate types.
        Parameters:
        userId - unique identifier for requesting user.
        standard - name of the standard - null means any.
        organization - name of the organization - null means any.
        identifier - identifier of the element in the standard - null means any.
        methodName - calling method
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - the matchCriteria is null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository.
      • typeDefParameterValidation

        protected void typeDefParameterValidation​(java.lang.String userId,
                                                  org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDef typeDef,
                                                  java.lang.String typeDefParameterName,
                                                  java.lang.String methodName)
                                           throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                  org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidTypeDefException,
                                                  org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException
        Validate that a supplied typeDef is valid.
        Parameters:
        userId - unique identifier for requesting user.
        typeDef - supplied type definition
        typeDefParameterName - name of the parameter for the type definition
        methodName - calling method
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - a property is null or invalid
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidTypeDefException - the type is invalid
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository.
      • attributeTypeDefParameterValidation

        protected void attributeTypeDefParameterValidation​(java.lang.String userId,
                                                           org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.AttributeTypeDef attributeTypeDef,
                                                           java.lang.String typeDefParameterName,
                                                           java.lang.String methodName)
                                                    throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                           org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidTypeDefException,
                                                           org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException
        Validate that a supplied attributeTypeDef is valid.
        Parameters:
        userId - unique identifier for requesting user.
        attributeTypeDef - supplied type definition
        typeDefParameterName - name of the parameter for the type definition
        methodName - calling method
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - a property is null or invalid
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidTypeDefException - the type is invalid
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository.
      • newTypeDefParameterValidation

        protected void newTypeDefParameterValidation​(java.lang.String userId,
                                                     org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDef typeDef,
                                                     java.lang.String typeDefParameterName,
                                                     java.lang.String methodName)
                                              throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                     org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidTypeDefException,
                                                     org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeDefConflictException,
                                                     org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeDefKnownException,
                                                     org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException
        Validate that a supplied typeDef is valid and unknown.
        Parameters:
        userId - unique identifier for requesting user.
        typeDef - supplied type definition
        typeDefParameterName - name of the parameter for the type definition
        methodName - calling method
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - a property is null or invalid
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidTypeDefException - the type is invalid
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeDefConflictException - incompatible TypeDefs
        org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeDefKnownException - duplicate TypeDefs
      • newAttributeTypeDefParameterValidation

        protected void newAttributeTypeDefParameterValidation​(java.lang.String userId,
                                                              org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.AttributeTypeDef attributeTypeDef,
                                                              java.lang.String typeDefParameterName,
                                                              java.lang.String methodName)
                                                       throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                              org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidTypeDefException,
                                                              org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeDefConflictException,
                                                              org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeDefKnownException,
                                                              org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException
        Validate that a supplied attributeTypeDef is valid and unknown.
        Parameters:
        userId - unique identifier for requesting user.
        attributeTypeDef - supplied type definition
        typeDefParameterName - name of the parameter for the type definition
        methodName - calling method
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - a property is null or invalid
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidTypeDefException - the type is invalid
        org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeDefConflictException - incompatible TypeDefs
        org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeDefKnownException - duplicate TypeDefs
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository.
      • updateTypeDefParameterValidation

        protected org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDef updateTypeDefParameterValidation​(java.lang.String userId,
                                                                                                                                                                  org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDefPatch typeDefPatch,
                                                                                                                                                                  java.lang.String methodName)
                                                                                                                                                           throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                                                                                                                                  org.odpi.openmetadata.repositoryservices.ffdc.exception.PatchErrorException,
                                                                                                                                                                  org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeDefNotKnownException,
                                                                                                                                                                  org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException
        Validate that a patch to a type definition is valid.
        Parameters:
        userId - unique identifier for requesting user.
        typeDefPatch - update to the type definition
        methodName - calling method
        Returns:
        type definition
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - a property is null or invalid
        org.odpi.openmetadata.repositoryservices.ffdc.exception.PatchErrorException - the type update is invalid
        org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeDefNotKnownException - the type is not known
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository.
      • manageTypeDefParameterValidation

        protected org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDef manageTypeDefParameterValidation​(java.lang.String userId,
                                                                                                                                                                  java.lang.String guidParameterName,
                                                                                                                                                                  java.lang.String nameParameterName,
                                                                                                                                                                  java.lang.String typeDefGUID,
                                                                                                                                                                  java.lang.String typeDefName,
                                                                                                                                                                  java.lang.String methodName)
                                                                                                                                                           throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                                                                                                                                  org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException
        Validate the type information for a management change to a type.
        Parameters:
        userId - unique identifier for requesting user.
        guidParameterName - name of parameter for type identifier
        nameParameterName - name of parameter for type name
        typeDefGUID - unique identifier of type
        typeDefName - unique name of type
        methodName - calling method
        Returns:
        typeDef
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - a property is null or invalid
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository.
      • manageAttributeTypeDefParameterValidation

        protected org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.AttributeTypeDef manageAttributeTypeDefParameterValidation​(java.lang.String userId,
                                                                                                                                                                                    java.lang.String guidParameterName,
                                                                                                                                                                                    java.lang.String nameParameterName,
                                                                                                                                                                                    java.lang.String attributeTypeDefGUID,
                                                                                                                                                                                    java.lang.String attributeTypeDefName,
                                                                                                                                                                                    java.lang.String methodName)
                                                                                                                                                                             throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                                                                                                                                                    org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException
        Validate the type information for a management change to an attributeTypeDef.
        Parameters:
        userId - unique identifier for requesting user.
        guidParameterName - name of parameter for type identifier
        nameParameterName - name of parameter for type name
        attributeTypeDefGUID - unique identifier of type
        attributeTypeDefName - unique name of type
        methodName - calling method
        Returns:
        retrieved type definition
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - a property is null or invalid
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository.
      • getAllTypes

        public org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDefGallery getAllTypes​(java.lang.String userId)
                                                                                                                                          throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                                                                                                                 org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                                                                                                                                 org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
        Returns the list of different types of metadata organized into two groups. The first are the attribute type definitions (AttributeTypeDefs). These provide types for properties in full type definitions. Full type definitions (TypeDefs) describe types for entities, relationships and classifications.
        Specified by:
        getAllTypes in class OMRSMetadataCollection
        Parameters:
        userId - unique identifier for requesting user.
        Returns:
        TypeDefGallery List of different categories of type definitions.
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - the userId is null
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
      • filterTypesByWildCardName

        public org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDefGallery filterTypesByWildCardName​(java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDef> allTypeDefs,
                                                                                                                                                               java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.AttributeTypeDef> allAttributeTypeDefs,
                                                                                                                                                               java.lang.String typeDefName)
        Return the types identified by the name supplied by the caller. The name may have wild card characters in it which is why the results are returned in a list.
        Parameters:
        allTypeDefs - list of types to filter.
        allAttributeTypeDefs - list of types to filter.
        typeDefName - unique name for the TypeDef
        Returns:
        TypeDef object or null if TypeDef is not known.
      • findTypesByName

        public org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDefGallery findTypesByName​(java.lang.String userId,
                                                                                                                                                     java.lang.String name)
                                                                                                                                              throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                                                                                                                     org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                                                                                                                                     org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
        Returns a list of type definitions that have the specified name. Type names should be unique. This method allows wildcard character to be included in the name. These are * (asterisk) for an arbitrary string of characters and ampersand for an arbitrary character.
        Specified by:
        findTypesByName in class OMRSMetadataCollection
        Parameters:
        userId - unique identifier for requesting user.
        name - name of the TypeDefs to return (including wildcard characters).
        Returns:
        TypeDefs list.
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - the name of the TypeDef is null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
      • filterTypeDefsByCategory

        protected java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDef> filterTypeDefsByCategory​(java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDef> allTypes,
                                                                                                                                                                          org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDefCategory category)
        Returns all the types for a specific category.
        Parameters:
        allTypes - list of types to filter.
        category - enum value for the category of types to return.
        Returns:
        type list list.
      • findTypeDefsByCategory

        public java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDef> findTypeDefsByCategory​(java.lang.String userId,
                                                                                                                                                                     org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDefCategory category)
                                                                                                                                                              throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                                                                                                                                     org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                                                                                                                                                     org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
        Returns all the TypeDefs for a specific category.
        Specified by:
        findTypeDefsByCategory in class OMRSMetadataCollection
        Parameters:
        userId - unique identifier for requesting user.
        category - enum value for the category of TypeDef to return.
        Returns:
        TypeDefs list.
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - the TypeDefCategory is null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
      • filterAttributeTypeDefsByCategory

        protected java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.AttributeTypeDef> filterAttributeTypeDefsByCategory​(java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.AttributeTypeDef> allTypes,
                                                                                                                                                                                            org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.AttributeTypeDefCategory category)
        Returns all the types for a specific category.
        Parameters:
        allTypes - list of types to filter.
        category - enum value for the category of types to return.
        Returns:
        type list list.
      • findAttributeTypeDefsByCategory

        public java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.AttributeTypeDef> findAttributeTypeDefsByCategory​(java.lang.String userId,
                                                                                                                                                                                       org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.AttributeTypeDefCategory category)
                                                                                                                                                                                throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                                                                                                                                                       org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                                                                                                                                                                       org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
        Returns all the AttributeTypeDefs for a specific category.
        Specified by:
        findAttributeTypeDefsByCategory in class OMRSMetadataCollection
        Parameters:
        userId - unique identifier for requesting user.
        category - enum value for the category of an AttributeTypeDef to return.
        Returns:
        TypeDefs list.
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - the TypeDefCategory is null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
      • filterTypeDefsByProperty

        protected java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDef> filterTypeDefsByProperty​(java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDef> allTypes,
                                                                                                                                                                          org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDefProperties matchCriteria)
        Return the TypeDefs that have the properties matching the supplied match criteria.
        Parameters:
        allTypes - list of types to filter.
        matchCriteria - TypeDefProperties - a list of property names.
        Returns:
        TypeDefs list.
      • findTypeDefsByProperty

        public java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDef> findTypeDefsByProperty​(java.lang.String userId,
                                                                                                                                                                     org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDefProperties matchCriteria)
                                                                                                                                                              throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                                                                                                                                     org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                                                                                                                                                     org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
        Return the TypeDefs that have the properties matching the supplied match criteria.
        Specified by:
        findTypeDefsByProperty in class OMRSMetadataCollection
        Parameters:
        userId - unique identifier for requesting user.
        matchCriteria - TypeDefProperties containing a list of property names.
        Returns:
        TypeDefs list.
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - the matchCriteria is null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
      • filterTypesByExternalID

        public java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDef> filterTypesByExternalID​(java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDef> allTypes,
                                                                                                                                                                      java.lang.String standard,
                                                                                                                                                                      java.lang.String organization,
                                                                                                                                                                      java.lang.String identifier)
        Match the supplied external standard identifiers against the active types for this repository.
        Parameters:
        allTypes - list of types to filter
        standard - name of the standard, null means any.
        organization - name of the organization, null means any.
        identifier - identifier of the element in the standard, null means any.
        Returns:
        list of typeDefs
      • findTypesByExternalID

        public java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDef> findTypesByExternalID​(java.lang.String userId,
                                                                                                                                                                    java.lang.String standard,
                                                                                                                                                                    java.lang.String organization,
                                                                                                                                                                    java.lang.String identifier)
                                                                                                                                                             throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                                                                                                                                    org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                                                                                                                                                    org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
        Return the types that are linked to the elements from the specified standard.
        Specified by:
        findTypesByExternalID in class OMRSMetadataCollection
        Parameters:
        userId - unique identifier for requesting user.
        standard - name of the standard; null means any.
        organization - name of the organization; null means any.
        identifier - identifier of the element in the standard; null means any.
        Returns:
        TypeDefs list each entry in the list contains a typedef. This is is a structure describing the TypeDef's category and properties.
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - all attributes of the external id are null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
      • filterTypeDefsBySearchCriteria

        public java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDef> filterTypeDefsBySearchCriteria​(java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDef> allTypes,
                                                                                                                                                                             java.lang.String searchCriteria)
        Return the TypeDefs that match the search criteria.
        Parameters:
        allTypes - list of types to filter.
        searchCriteria - String - search criteria.
        Returns:
        TypeDefs list - each entry in the list contains a typedef. This is is a structure describing the TypeDef's category and properties.
      • searchForTypeDefs

        public java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDef> searchForTypeDefs​(java.lang.String userId,
                                                                                                                                                                java.lang.String searchCriteria)
                                                                                                                                                         throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                                                                                                                                org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                                                                                                                                                org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
        Return the TypeDefs that match the search criteria.
        Specified by:
        searchForTypeDefs in class OMRSMetadataCollection
        Parameters:
        userId - unique identifier for requesting user.
        searchCriteria - String search criteria.
        Returns:
        TypeDefs list where each entry in the list contains a typedef. This is is a structure describing the TypeDef's category and properties.
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - the searchCriteria is null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
      • filterTypeDefsByGUID

        public org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDef filterTypeDefsByGUID​(java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDef> allTypes,
                                                                                                                                                   java.lang.String guid)
        Return the TypeDef that matches the guid.
        Parameters:
        allTypes - list of types to filter.
        guid - unique identifier for type
        Returns:
        Matching type
      • getTypeDefByGUID

        public org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDef getTypeDefByGUID​(java.lang.String userId,
                                                                                                                                               java.lang.String guid)
                                                                                                                                        throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                                                                                                               org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                                                                                                                               org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeDefNotKnownException,
                                                                                                                                               org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
        Return the TypeDef identified by the GUID.
        Specified by:
        getTypeDefByGUID in class OMRSMetadataCollection
        Parameters:
        userId - unique identifier for requesting user.
        guid - String unique id of the TypeDef.
        Returns:
        TypeDef structure describing its category and properties.
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - the guid is null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeDefNotKnownException - The requested TypeDef is not known in the metadata collection.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
      • filterAttributeTypeDefsByGUID

        public org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.AttributeTypeDef filterAttributeTypeDefsByGUID​(java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.AttributeTypeDef> allTypes,
                                                                                                                                                                     java.lang.String guid)
        Return the AttributeTypeDef that matches the guid.
        Parameters:
        allTypes - list of types to filter.
        guid - unique identifier for type
        Returns:
        Matching type
      • getAttributeTypeDefByGUID

        public org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.AttributeTypeDef getAttributeTypeDefByGUID​(java.lang.String userId,
                                                                                                                                                                 java.lang.String guid)
                                                                                                                                                          throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                                                                                                                                 org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                                                                                                                                                 org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeDefNotKnownException,
                                                                                                                                                                 org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
        Return the AttributeTypeDef identified by the GUID.
        Specified by:
        getAttributeTypeDefByGUID in class OMRSMetadataCollection
        Parameters:
        userId - unique identifier for requesting user.
        guid - String unique id of the TypeDef
        Returns:
        TypeDef structure describing its category and properties.
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - the guid is null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeDefNotKnownException - The requested TypeDef is not known in the metadata collection.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
      • filterTypeDefsByName

        public org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDef filterTypeDefsByName​(java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDef> allTypes,
                                                                                                                                                   java.lang.String name)
        Return the TypeDef that matches the name.
        Parameters:
        allTypes - list of types to filter.
        name - unique identifier for type
        Returns:
        Matching type
      • getTypeDefByName

        public org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDef getTypeDefByName​(java.lang.String userId,
                                                                                                                                               java.lang.String name)
                                                                                                                                        throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                                                                                                               org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                                                                                                                               org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeDefNotKnownException,
                                                                                                                                               org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
        Return the TypeDef identified by the unique name.
        Specified by:
        getTypeDefByName in class OMRSMetadataCollection
        Parameters:
        userId - unique identifier for requesting user.
        name - String name of the TypeDef.
        Returns:
        TypeDef structure describing its category and properties.
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - the name is null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeDefNotKnownException - the requested TypeDef is not found in the metadata collection.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
      • filterAttributeTypeDefsByName

        public org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.AttributeTypeDef filterAttributeTypeDefsByName​(java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.AttributeTypeDef> allTypes,
                                                                                                                                                                     java.lang.String name)
        Return the TypeDef that matches the name.
        Parameters:
        allTypes - list of types to filter.
        name - unique identifier for type
        Returns:
        Matching type
      • getAttributeTypeDefByName

        public org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.AttributeTypeDef getAttributeTypeDefByName​(java.lang.String userId,
                                                                                                                                                                 java.lang.String name)
                                                                                                                                                          throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                                                                                                                                 org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                                                                                                                                                 org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeDefNotKnownException,
                                                                                                                                                                 org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
        Return the AttributeTypeDef identified by the unique name.
        Specified by:
        getAttributeTypeDefByName in class OMRSMetadataCollection
        Parameters:
        userId - unique identifier for requesting user.
        name - String name of the TypeDef.
        Returns:
        TypeDef structure describing its category and properties.
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - the name is null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeDefNotKnownException - the requested TypeDef is not found in the metadata collection.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
      • addTypeDefGallery

        public void addTypeDefGallery​(java.lang.String userId,
                                      org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDefGallery newTypes)
                               throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                      org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                      org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeDefNotSupportedException,
                                      org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeDefKnownException,
                                      org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeDefConflictException,
                                      org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidTypeDefException,
                                      org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException,
                                      org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
        Create a collection of related types.
        Specified by:
        addTypeDefGallery in class OMRSMetadataCollection
        Parameters:
        userId - unique identifier for requesting user.
        newTypes - TypeDefGalleryResponse structure describing the new AttributeTypeDefs and TypeDefs.
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - the new TypeDef is null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeDefNotSupportedException - the repository is not able to support this TypeDef.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeDefKnownException - the TypeDef is already stored in the repository.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeDefConflictException - the new TypeDef conflicts with an existing TypeDef.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidTypeDefException - the new TypeDef has invalid contents.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException - the repository does not support this call.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
      • addTypeDef

        public void addTypeDef​(java.lang.String userId,
                               org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDef newTypeDef)
                        throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                               org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                               org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeDefNotSupportedException,
                               org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeDefKnownException,
                               org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeDefConflictException,
                               org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidTypeDefException,
                               org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException,
                               org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
        Create a definition of a new TypeDef.
        Specified by:
        addTypeDef in class OMRSMetadataCollection
        Parameters:
        userId - unique identifier for requesting user.
        newTypeDef - TypeDef structure describing the new TypeDef.
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - the new TypeDef is null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeDefNotSupportedException - the repository is not able to support this TypeDef.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeDefKnownException - the TypeDef is already stored in the repository.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeDefConflictException - the new TypeDef conflicts with an existing TypeDef.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidTypeDefException - the new TypeDef has invalid contents.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException - the repository does not support this call.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
      • addAttributeTypeDef

        public void addAttributeTypeDef​(java.lang.String userId,
                                        org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.AttributeTypeDef newAttributeTypeDef)
                                 throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                        org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeDefNotSupportedException,
                                        org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeDefKnownException,
                                        org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeDefConflictException,
                                        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidTypeDefException,
                                        org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException,
                                        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
        Create a definition of a new AttributeTypeDef.
        Specified by:
        addAttributeTypeDef in class OMRSMetadataCollection
        Parameters:
        userId - unique identifier for requesting user.
        newAttributeTypeDef - TypeDef structure describing the new TypeDef.
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - the new TypeDef is null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeDefNotSupportedException - the repository is not able to support this TypeDef.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeDefKnownException - the TypeDef is already stored in the repository.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeDefConflictException - the new TypeDef conflicts with an existing TypeDef.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidTypeDefException - the new TypeDef has invalid contents.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException - the repository does not support this call.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
      • verifyTypeDef

        public boolean verifyTypeDef​(java.lang.String userId,
                                     org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDef typeDef)
                              throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                     org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                     org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeDefNotSupportedException,
                                     org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeDefConflictException,
                                     org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidTypeDefException,
                                     org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
        Verify that a definition of a TypeDef is either new or matches the definition already stored.
        Specified by:
        verifyTypeDef in class OMRSMetadataCollection
        Parameters:
        userId - unique identifier for requesting user.
        typeDef - TypeDef structure describing the TypeDef to test.
        Returns:
        boolean true means the TypeDef matches the local definition; false means the TypeDef is not known.
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - the TypeDef is null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeDefNotSupportedException - the repository is not able to support this TypeDef.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeDefConflictException - the new TypeDef conflicts with an existing TypeDef.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidTypeDefException - the new TypeDef has invalid contents.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
      • verifyAttributeTypeDef

        public boolean verifyAttributeTypeDef​(java.lang.String userId,
                                              org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.AttributeTypeDef attributeTypeDef)
                                       throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                              org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                              org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeDefNotSupportedException,
                                              org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeDefConflictException,
                                              org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidTypeDefException,
                                              org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
        Verify that a definition of an AttributeTypeDef is either new or matches the definition already stored.
        Specified by:
        verifyAttributeTypeDef in class OMRSMetadataCollection
        Parameters:
        userId - unique identifier for requesting user.
        attributeTypeDef - TypeDef structure describing the TypeDef to test.
        Returns:
        boolean where true means the TypeDef matches the local definition where false means the TypeDef is not known.
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - the TypeDef is null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeDefNotSupportedException - the repository is not able to support this TypeDef.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeDefConflictException - the new TypeDef conflicts with an existing TypeDef.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidTypeDefException - the new TypeDef has invalid contents.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
      • updateTypeDef

        public org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDef updateTypeDef​(java.lang.String userId,
                                                                                                                                            org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDefPatch typeDefPatch)
                                                                                                                                     throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                                                                                                            org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                                                                                                                            org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeDefNotKnownException,
                                                                                                                                            org.odpi.openmetadata.repositoryservices.ffdc.exception.PatchErrorException,
                                                                                                                                            org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException,
                                                                                                                                            org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
        Update one or more properties of the TypeDef. The TypeDefPatch controls what types of updates are safe to make to the TypeDef.
        Specified by:
        updateTypeDef in class OMRSMetadataCollection
        Parameters:
        userId - unique identifier for requesting user.
        typeDefPatch - TypeDef patch describing change to TypeDef.
        Returns:
        updated TypeDef
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - the TypeDefPatch is null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeDefNotKnownException - the requested TypeDef is not found in the metadata collection.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.PatchErrorException - the TypeDef can not be updated because the supplied patch is incompatible with the stored TypeDef.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException - the repository does not support this call.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
      • deleteTypeDef

        public void deleteTypeDef​(java.lang.String userId,
                                  java.lang.String obsoleteTypeDefGUID,
                                  java.lang.String obsoleteTypeDefName)
                           throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                  org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                  org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeDefNotKnownException,
                                  org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeDefInUseException,
                                  org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException,
                                  org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
        Delete the TypeDef. This is only possible if the TypeDef has never been used to create instances or any instances of this TypeDef have been purged from the metadata collection.
        Specified by:
        deleteTypeDef in class OMRSMetadataCollection
        Parameters:
        userId - unique identifier for requesting user.
        obsoleteTypeDefGUID - String unique identifier for the TypeDef.
        obsoleteTypeDefName - String unique name for the TypeDef.
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - the one of TypeDef identifiers is null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeDefNotKnownException - the requested TypeDef is not found in the metadata collection.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeDefInUseException - the TypeDef can not be deleted because there are instances of this type in the the metadata collection. These instances need to be purged before the TypeDef can be deleted.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException - the repository does not support this call.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
      • deleteAttributeTypeDef

        public void deleteAttributeTypeDef​(java.lang.String userId,
                                           java.lang.String obsoleteTypeDefGUID,
                                           java.lang.String obsoleteTypeDefName)
                                    throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                           org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                           org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeDefNotKnownException,
                                           org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeDefInUseException,
                                           org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException,
                                           org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
        Delete an AttributeTypeDef. This is only possible if the AttributeTypeDef has never been used to create instances or any instances of this AttributeTypeDef have been purged from the metadata collection.
        Specified by:
        deleteAttributeTypeDef in class OMRSMetadataCollection
        Parameters:
        userId - unique identifier for requesting user.
        obsoleteTypeDefGUID - String unique identifier for the AttributeTypeDef.
        obsoleteTypeDefName - String unique name for the AttributeTypeDef.
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - the one of AttributeTypeDef identifiers is null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeDefNotKnownException - the requested AttributeTypeDef is not found in the metadata collection.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeDefInUseException - the AttributeTypeDef can not be deleted because there are instances of this type in the the metadata collection. These instances need to be purged before the AttributeTypeDef can be deleted.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException - the repository does not support this call.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
      • reIdentifyTypeDef

        public org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDef reIdentifyTypeDef​(java.lang.String userId,
                                                                                                                                                java.lang.String originalTypeDefGUID,
                                                                                                                                                java.lang.String originalTypeDefName,
                                                                                                                                                java.lang.String newTypeDefGUID,
                                                                                                                                                java.lang.String newTypeDefName)
                                                                                                                                         throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                                                                                                                org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                                                                                                                                org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeDefNotKnownException,
                                                                                                                                                org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException,
                                                                                                                                                org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
        Change the guid or name of an existing TypeDef to a new value. This is used if two different TypeDefs are discovered to have the same guid. This is extremely unlikely but not impossible so the open metadata protocol has provision for this.
        Specified by:
        reIdentifyTypeDef in class OMRSMetadataCollection
        Parameters:
        userId - unique identifier for requesting user.
        originalTypeDefGUID - the original guid of the TypeDef.
        originalTypeDefName - the original name of the TypeDef.
        newTypeDefGUID - the new identifier for the TypeDef.
        newTypeDefName - new name for this TypeDef.
        Returns:
        typeDef new values for this TypeDef, including the new guid/name.
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - one of the parameters is invalid or null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeDefNotKnownException - the TypeDef identified by the original guid/name is not found in the metadata collection.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException - the repository does not support this call.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
      • reIdentifyAttributeTypeDef

        public org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.AttributeTypeDef reIdentifyAttributeTypeDef​(java.lang.String userId,
                                                                                                                                                                  java.lang.String originalAttributeTypeDefGUID,
                                                                                                                                                                  java.lang.String originalAttributeTypeDefName,
                                                                                                                                                                  java.lang.String newAttributeTypeDefGUID,
                                                                                                                                                                  java.lang.String newAttributeTypeDefName)
                                                                                                                                                           throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                                                                                                                                  org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                                                                                                                                                  org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeDefNotKnownException,
                                                                                                                                                                  org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException,
                                                                                                                                                                  org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
        Change the guid or name of an existing TypeDef to a new value. This is used if two different TypeDefs are discovered to have the same guid. This is extremely unlikely but not impossible so the open metadata protocol has provision for this.
        Specified by:
        reIdentifyAttributeTypeDef in class OMRSMetadataCollection
        Parameters:
        userId - unique identifier for requesting user.
        originalAttributeTypeDefGUID - the original guid of the AttributeTypeDef.
        originalAttributeTypeDefName - the original name of the AttributeTypeDef.
        newAttributeTypeDefGUID - the new identifier for the AttributeTypeDef.
        newAttributeTypeDefName - new name for this AttributeTypeDef.
        Returns:
        attributeTypeDef new values for this AttributeTypeDef, including the new guid/name.
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - one of the parameters is invalid or null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeDefNotKnownException - the AttributeTypeDef identified by the original guid/name is not found in the metadata collection.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException - the repository does not support this call.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
      • getInstanceParameterValidation

        protected void getInstanceParameterValidation​(java.lang.String userId,
                                                      java.lang.String guid,
                                                      java.lang.String methodName)
                                               throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                      org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException
        Validate the parameters for a retrieve of an instance.
        Parameters:
        userId - unique identifier for requesting user.
        guid - String unique identifier for the relationship.
        methodName - name of calling method.
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - the guid or date is null or the date is for a future time
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
      • getInstanceParameterValidation

        protected void getInstanceParameterValidation​(java.lang.String userId,
                                                      java.lang.String guid,
                                                      java.util.Date asOfTime,
                                                      java.lang.String methodName)
                                               throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                      org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException
        Validate the parameters for a retrieve of a historical version of an instance.
        Parameters:
        userId - unique identifier for requesting user.
        guid - String unique identifier for the relationship.
        asOfTime - the time used to determine which version of the entity that is desired.
        methodName - name of calling method.
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - the guid or date is null or the date is for a future time
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
      • getInstanceHistoryParameterValidation

        protected void getInstanceHistoryParameterValidation​(java.lang.String userId,
                                                             java.lang.String guid,
                                                             java.util.Date fromTime,
                                                             java.util.Date toTime,
                                                             java.lang.String methodName)
                                                      throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                             org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException
        Validate the parameters for a retrieve multiple historical versions of an instance.
        Parameters:
        userId - unique identifier for requesting user.
        guid - String unique identifier for the relationship.
        fromTime - the earliest point in time from which to retrieve historical versions of the entity (inclusive)
        toTime - the latest point in time from which to retrieve historical versions of the entity (exclusive)
        methodName - name of calling method.
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - the guid is null or the 'fromTime' is after the 'toTime'
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
      • getRelationshipsForEntityParameterValidation

        protected void getRelationshipsForEntityParameterValidation​(java.lang.String userId,
                                                                    java.lang.String entityGUID,
                                                                    java.lang.String relationshipTypeGUID,
                                                                    int fromRelationshipElement,
                                                                    java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceStatus> limitResultsByStatus,
                                                                    java.util.Date asOfTime,
                                                                    java.lang.String sequencingProperty,
                                                                    SequencingOrder sequencingOrder,
                                                                    int pageSize)
                                                             throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                                    org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeErrorException,
                                                                    org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                                                    org.odpi.openmetadata.repositoryservices.ffdc.exception.PagingErrorException,
                                                                    org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
        Validate the parameters for getRelationshipsForEntity.
        Parameters:
        userId - unique identifier for requesting user.
        entityGUID - String unique identifier for the entity.
        relationshipTypeGUID - String GUID of the type of relationship required (null for all).
        fromRelationshipElement - the starting element number of the relationships to return. This is used when retrieving elements beyond the first page of results. Zero means start from the first element.
        limitResultsByStatus - By default, relationships in all non-DELETED statuses are returned. However, it is possible to specify a list of statuses (eg ACTIVE) to restrict the results to. Null means all status values except DELETED.
        asOfTime - Requests a historical query of the relationships for the entity. Null means return the present values.
        sequencingProperty - String name of the property that is to be used to sequence the results. Null means do not sequence on a property name (see SequencingOrder).
        sequencingOrder - Enum defining how the results should be ordered.
        pageSize - -- the maximum number of result classifications that can be returned on this request. Zero means unrestricted return results size.
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - a parameter is invalid or null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeErrorException - the type guid passed on the request is not known by the metadata collection.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.PagingErrorException - the paging/sequencing parameters are set up incorrectly.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
      • findEntitiesByPropertyParameterValidation

        protected void findEntitiesByPropertyParameterValidation​(java.lang.String userId,
                                                                 java.lang.String entityTypeGUID,
                                                                 org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceProperties matchProperties,
                                                                 MatchCriteria matchCriteria,
                                                                 int fromEntityElement,
                                                                 java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceStatus> limitResultsByStatus,
                                                                 java.util.List<java.lang.String> limitResultsByClassification,
                                                                 java.util.Date asOfTime,
                                                                 java.lang.String sequencingProperty,
                                                                 SequencingOrder sequencingOrder,
                                                                 int pageSize)
                                                          throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                                 org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                                                 org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeErrorException,
                                                                 org.odpi.openmetadata.repositoryservices.ffdc.exception.PropertyErrorException,
                                                                 org.odpi.openmetadata.repositoryservices.ffdc.exception.PagingErrorException,
                                                                 org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
        Validate the parameters for findEntitiesByProperty.
        Parameters:
        userId - unique identifier for requesting user.
        entityTypeGUID - String unique identifier for the entity type of interest (null means any entity type).
        matchProperties - Optional list of entity properties to match (contains wildcards).
        matchCriteria - Enum defining how the match properties should be matched to the entities in the repository.
        fromEntityElement - the starting element number of the entities to return. This is used when retrieving elements beyond the first page of results. Zero means start from the first element.
        limitResultsByStatus - By default, entities in all non-DELETED statuses are returned. However, it is possible to specify a list of statuses (eg ACTIVE) to restrict the results to. Null means all status values except DELETED.
        limitResultsByClassification - List of classifications that must be present on all returned entities.
        asOfTime - Requests a historical query of the entity. Null means return the present values.
        sequencingProperty - String name of the entity property that is to be used to sequence the results. Null means do not sequence on a property name (see SequencingOrder).
        sequencingOrder - Enum defining how the results should be ordered.
        pageSize - the maximum number of result entities that can be returned on this request. Zero means unrestricted return results size.
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - a parameter is invalid or null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeErrorException - the type guid passed on the request is not known by the metadata collection.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.PropertyErrorException - the properties specified are not valid for any of the requested types of entity.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.PagingErrorException - the paging/sequencing parameters are set up incorrectly.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
      • findEntitiesParameterValidation

        protected void findEntitiesParameterValidation​(java.lang.String userId,
                                                       java.lang.String entityTypeGUID,
                                                       java.util.List<java.lang.String> entitySubtypeGUIDs,
                                                       org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.search.SearchProperties matchProperties,
                                                       int fromEntityElement,
                                                       java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceStatus> limitResultsByStatus,
                                                       org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.search.SearchClassifications matchClassifications,
                                                       java.util.Date asOfTime,
                                                       java.lang.String sequencingProperty,
                                                       SequencingOrder sequencingOrder,
                                                       int pageSize)
                                                throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                       org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                                       org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeErrorException,
                                                       org.odpi.openmetadata.repositoryservices.ffdc.exception.PagingErrorException
        Validate the parameters for findEntities.
        Parameters:
        userId - unique identifier for requesting user.
        entityTypeGUID - String unique identifier for the entity type of interest (null means any entity type).
        entitySubtypeGUIDs - optional list of the unique identifiers (guids) for subtypes of the entityTypeGUID to include in the search results. Null means all subtypes.
        matchProperties - Optional list of entity property conditions to match.
        fromEntityElement - the starting element number of the entities to return. This is used when retrieving elements beyond the first page of results. Zero means start from the first element.
        limitResultsByStatus - By default, entities in all non-DELETED statuses are returned. However, it is possible to specify a list of statuses (eg ACTIVE) to restrict the results to. Null means all status values except DELETED.
        matchClassifications - Optional list of entity classifications to match.
        asOfTime - Requests a historical query of the entity. Null means return the present values.
        sequencingProperty - String name of the entity property that is to be used to sequence the results. Null means do not sequence on a property name (see SequencingOrder).
        sequencingOrder - Enum defining how the results should be ordered.
        pageSize - the maximum number of result entities that can be returned on this request. Zero means unrestricted return results size.
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - a parameter is invalid or null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeErrorException - the type guid passed on the request is not known by the metadata collection.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.PagingErrorException - the paging/sequencing parameters are set up incorrectly.
        See Also:
        findEntities(String, String, List, SearchProperties, int, List, SearchClassifications, Date, String, SequencingOrder, int)
      • findEntitiesByClassificationParameterValidation

        protected void findEntitiesByClassificationParameterValidation​(java.lang.String userId,
                                                                       java.lang.String entityTypeGUID,
                                                                       java.lang.String classificationName,
                                                                       org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceProperties matchClassificationProperties,
                                                                       MatchCriteria matchCriteria,
                                                                       int fromEntityElement,
                                                                       java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceStatus> limitResultsByStatus,
                                                                       java.util.Date asOfTime,
                                                                       java.lang.String sequencingProperty,
                                                                       SequencingOrder sequencingOrder,
                                                                       int pageSize)
                                                                throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                                       org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeErrorException,
                                                                       org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                                                       org.odpi.openmetadata.repositoryservices.ffdc.exception.ClassificationErrorException,
                                                                       org.odpi.openmetadata.repositoryservices.ffdc.exception.PropertyErrorException,
                                                                       org.odpi.openmetadata.repositoryservices.ffdc.exception.PagingErrorException,
                                                                       org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
        Validate the parameters for findEntitiesByClassification.
        Parameters:
        userId - unique identifier for requesting user.
        entityTypeGUID - unique identifier for the type of entity requested. Null means any type of entity.
        classificationName - name of the classification a null is not valid.
        matchClassificationProperties - Optional list of entity properties to match (contains wildcards).
        matchCriteria - Enum defining how the match properties should be matched to the classifications in the repository.
        fromEntityElement - the starting element number of the entities to return. This is used when retrieving elements beyond the first page of results. Zero means start from the first element.
        limitResultsByStatus - By default, entities in all non-DELETED statuses are returned. However, it is possible to specify a list of statuses (eg ACTIVE) to restrict the results to. Null means all status values except DELETED.
        asOfTime - Requests a historical query of the entity. Null means return the present values.
        sequencingProperty - String name of the entity property that is to be used to sequence the results. Null means do not sequence on a property name (see SequencingOrder).
        sequencingOrder - Enum defining how the results should be ordered.
        pageSize - the maximum number of result entities that can be returned on this request. Zero means unrestricted return results size.
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - a parameter is invalid or null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeErrorException - the type guid passed on the request is not known by the metadata collection.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.ClassificationErrorException - the classification request is not known to the metadata collection.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.PropertyErrorException - the properties specified are not valid for the requested type of classification.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.PagingErrorException - the paging/sequencing parameters are set up incorrectly.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
      • findEntitiesByPropertyValueParameterValidation

        protected void findEntitiesByPropertyValueParameterValidation​(java.lang.String userId,
                                                                      java.lang.String entityTypeGUID,
                                                                      java.lang.String searchCriteria,
                                                                      int fromEntityElement,
                                                                      java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceStatus> limitResultsByStatus,
                                                                      java.util.List<java.lang.String> limitResultsByClassification,
                                                                      java.util.Date asOfTime,
                                                                      java.lang.String sequencingProperty,
                                                                      SequencingOrder sequencingOrder,
                                                                      int pageSize)
                                                               throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                                      org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeErrorException,
                                                                      org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                                                      org.odpi.openmetadata.repositoryservices.ffdc.exception.PropertyErrorException,
                                                                      org.odpi.openmetadata.repositoryservices.ffdc.exception.PagingErrorException,
                                                                      org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
        Validate parameters passed to findEntitiesByPropertyValue.
        Parameters:
        userId - unique identifier for requesting user.
        entityTypeGUID - GUID of the type of entity to search for. Null means all types will be searched (could be slow so not recommended).
        searchCriteria - String expression contained in any of the property values within the entities of the supplied type.
        fromEntityElement - the starting element number of the entities to return. This is used when retrieving elements beyond the first page of results. Zero means start from the first element.
        limitResultsByStatus - By default, entities in all non-DELETED statuses are returned. However, it is possible to specify a list of statuses (eg ACTIVE) to restrict the results to. Null means all status values except DELETED.
        limitResultsByClassification - List of classifications that must be present on all returned entities.
        asOfTime - Requests a historical query of the entity. Null means return the present values.
        sequencingProperty - String name of the property that is to be used to sequence the results. Null means do not sequence on a property name (see SequencingOrder).
        sequencingOrder - Enum defining how the results should be ordered.
        pageSize - the maximum number of result entities that can be returned on this request. Zero means unrestricted return results size.
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - a parameter is invalid or null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeErrorException - the type guid passed on the request is not known by the metadata collection.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.PropertyErrorException - the sequencing property specified is not valid for any of the requested types of entity.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.PagingErrorException - the paging/sequencing parameters are set up incorrectly.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
      • findRelationshipsParameterValidation

        protected void findRelationshipsParameterValidation​(java.lang.String userId,
                                                            java.lang.String relationshipTypeGUID,
                                                            java.util.List<java.lang.String> relationshipSubtypeGUIDs,
                                                            org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.search.SearchProperties matchProperties,
                                                            int fromRelationshipElement,
                                                            java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceStatus> limitResultsByStatus,
                                                            java.util.Date asOfTime,
                                                            java.lang.String sequencingProperty,
                                                            SequencingOrder sequencingOrder,
                                                            int pageSize)
                                                     throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                            org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeErrorException,
                                                            org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                                            org.odpi.openmetadata.repositoryservices.ffdc.exception.PagingErrorException
        Validate the parameters passed to findRelationships.
        Parameters:
        userId - unique identifier for requesting user.
        relationshipTypeGUID - unique identifier (guid) for the relationship's type. Null means all types (but may be slow so not recommended).
        relationshipSubtypeGUIDs - optional list of the unique identifiers (guids) for subtypes of the relationshipTypeGUID to include in the search results. Null means all subtypes.
        matchProperties - Optional list of relationship property conditions to match.
        fromRelationshipElement - the starting element number of the entities to return. This is used when retrieving elements beyond the first page of results. Zero means start from the first element.
        limitResultsByStatus - By default, relationships in all non-DELETED statuses are returned. However, it is possible to specify a list of statuses (eg ACTIVE) to restrict the results to. Null means all status values except DELETED.
        asOfTime - Requests a historical query of the relationships for the entity. Null means return the present values.
        sequencingProperty - String name of the property that is to be used to sequence the results. Null means do not sequence on a property name (see SequencingOrder).
        sequencingOrder - Enum defining how the results should be ordered.
        pageSize - the maximum number of result relationships that can be returned on this request. Zero means unrestricted return results size.
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - one of the parameters is invalid or null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeErrorException - the type guid passed on the request is not known by the metadata collection.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.PagingErrorException - the paging/sequencing parameters are set up incorrectly.
        See Also:
        findRelationships(String, String, List, SearchProperties, int, List, Date, String, SequencingOrder, int)
      • findRelationshipsByPropertyParameterValidation

        protected void findRelationshipsByPropertyParameterValidation​(java.lang.String userId,
                                                                      java.lang.String relationshipTypeGUID,
                                                                      org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceProperties matchProperties,
                                                                      MatchCriteria matchCriteria,
                                                                      int fromRelationshipElement,
                                                                      java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceStatus> limitResultsByStatus,
                                                                      java.util.Date asOfTime,
                                                                      java.lang.String sequencingProperty,
                                                                      SequencingOrder sequencingOrder,
                                                                      int pageSize)
                                                               throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                                      org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeErrorException,
                                                                      org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                                                      org.odpi.openmetadata.repositoryservices.ffdc.exception.PropertyErrorException,
                                                                      org.odpi.openmetadata.repositoryservices.ffdc.exception.PagingErrorException,
                                                                      org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
        Validate the parameters passed to findRelationshipsByProperty.
        Parameters:
        userId - unique identifier for requesting user.
        relationshipTypeGUID - unique identifier (guid) for the new relationship's type. Null means all types (but may be slow so not recommended).
        matchProperties - list of properties used to narrow the search. The property values may include regex style wild cards.
        matchCriteria - Enum defining how the properties should be matched to the relationships in the repository.
        fromRelationshipElement - the starting element number of the entities to return. This is used when retrieving elements beyond the first page of results. Zero means start from the first element.
        limitResultsByStatus - By default, relationships in all non-DELETED statuses are returned. However, it is possible to specify a list of statuses (eg ACTIVE) to restrict the results to. Null means all status values except DELETED.
        asOfTime - Requests a historical query of the relationships for the entity. Null means return the present values.
        sequencingProperty - String name of the property that is to be used to sequence the results. Null means do not sequence on a property name (see SequencingOrder).
        sequencingOrder - Enum defining how the results should be ordered.
        pageSize - the maximum number of result relationships that can be returned on this request. Zero means unrestricted return results size.
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - one of the parameters is invalid or null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeErrorException - the type guid passed on the request is not known by the metadata collection.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.PropertyErrorException - the properties specified are not valid for any of the requested types of relationships.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.PagingErrorException - the paging/sequencing parameters are set up incorrectly.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
      • findRelationshipsByPropertyValueParameterValidation

        protected void findRelationshipsByPropertyValueParameterValidation​(java.lang.String userId,
                                                                           java.lang.String relationshipTypeGUID,
                                                                           java.lang.String searchCriteria,
                                                                           int fromRelationshipElement,
                                                                           java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceStatus> limitResultsByStatus,
                                                                           java.util.Date asOfTime,
                                                                           java.lang.String sequencingProperty,
                                                                           SequencingOrder sequencingOrder,
                                                                           int pageSize)
                                                                    throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                                           org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeErrorException,
                                                                           org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                                                           org.odpi.openmetadata.repositoryservices.ffdc.exception.PropertyErrorException,
                                                                           org.odpi.openmetadata.repositoryservices.ffdc.exception.PagingErrorException,
                                                                           org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
        Validate the parameters passed to findRelationshipsByPropertyName.
        Parameters:
        userId - unique identifier for requesting user.
        relationshipTypeGUID - GUID of the type of entity to search for. Null means all types will be searched (could be slow so not recommended).
        searchCriteria - String expression contained in any of the property values within the entities of the supplied type.
        fromRelationshipElement - Element number of the results to skip to when building the results list to return. Zero means begin at the start of the results. This is used to retrieve the results over a number of pages.
        limitResultsByStatus - By default, relationships in all non-DELETED statuses are returned. However, it is possible to specify a list of statuses (eg ACTIVE) to restrict the results to. Null means all status values except DELETED.
        asOfTime - Requests a historical query of the relationships for the entity. Null means return the present values.
        sequencingProperty - String name of the property that is to be used to sequence the results. Null means do not sequence on a property name (see SequencingOrder).
        sequencingOrder - Enum defining how the results should be ordered.
        pageSize - the maximum number of result relationships that can be returned on this request. Zero means unrestricted return results size.
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - one of the parameters is invalid or null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeErrorException - the type guid passed on the request is not known by the metadata collection.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.PropertyErrorException - there is a problem with one of the other parameters.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.PagingErrorException - the paging/sequencing parameters are set up incorrectly.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
      • getEntityNeighborhoodParameterValidation

        protected void getEntityNeighborhoodParameterValidation​(java.lang.String userId,
                                                                java.lang.String entityGUID,
                                                                java.util.List<java.lang.String> entityTypeGUIDs,
                                                                java.util.List<java.lang.String> relationshipTypeGUIDs,
                                                                java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceStatus> limitResultsByStatus,
                                                                java.util.List<java.lang.String> limitResultsByClassification,
                                                                java.util.Date asOfTime,
                                                                int level)
                                                         throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                                org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeErrorException,
                                                                org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                                                org.odpi.openmetadata.repositoryservices.ffdc.exception.EntityNotKnownException,
                                                                org.odpi.openmetadata.repositoryservices.ffdc.exception.PropertyErrorException,
                                                                org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException,
                                                                org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
        Return the entities and relationships that radiate out from the supplied entity GUID. The results are scoped both the instance type guids and the level.
        Parameters:
        userId - unique identifier for requesting user.
        entityGUID - the starting point of the query.
        entityTypeGUIDs - list of entity types to include in the query results. Null means include all entities found, irrespective of their type.
        relationshipTypeGUIDs - list of relationship types to include in the query results. Null means include all relationships found, irrespective of their type.
        limitResultsByStatus - By default, relationships in all non-DELETED statuses are returned. However, it is possible to specify a list of statuses (eg ACTIVE) to restrict the results to. Null means all status values except DELETED.
        limitResultsByClassification - List of classifications that must be present on all returned entities.
        asOfTime - Requests a historical query of the relationships for the entity. Null means return the present values.
        level - the number of the relationships out from the starting entity that the query will traverse to gather results.
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - one of the parameters is invalid or null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeErrorException - the type guid passed on the request is not known by the metadata collection.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.EntityNotKnownException - the entity identified by the entityGUID is not found in the metadata collection.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.PropertyErrorException - there is a problem with one of the other parameters.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException - the repository does not support this call.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
      • getLinkingEntitiesParameterValidation

        protected void getLinkingEntitiesParameterValidation​(java.lang.String userId,
                                                             java.lang.String startEntityGUID,
                                                             java.lang.String endEntityGUID,
                                                             java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceStatus> limitResultsByStatus,
                                                             java.util.Date asOfTime)
                                                      throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                             org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                                             org.odpi.openmetadata.repositoryservices.ffdc.exception.PropertyErrorException,
                                                             org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
        Validate the parameters passed to getLinkingEntities.
        Parameters:
        userId - unique identifier for requesting user.
        startEntityGUID - The entity that is used to anchor the query.
        endEntityGUID - the other entity that defines the scope of the query.
        limitResultsByStatus - By default, relationships in all non-DELETED statuses are returned. However, it is possible to specify a list of statuses (eg ACTIVE) to restrict the results to. Null means all status values except DELETED.
        asOfTime - Requests a historical query of the relationships for the entity. Null means return the present values.
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - one of the parameters is invalid or null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.PropertyErrorException - there is a problem with one of the other parameters.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
      • getRelatedEntitiesParameterValidation

        protected void getRelatedEntitiesParameterValidation​(java.lang.String userId,
                                                             java.lang.String startEntityGUID,
                                                             java.util.List<java.lang.String> entityTypeGUIDs,
                                                             int fromEntityElement,
                                                             java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceStatus> limitResultsByStatus,
                                                             java.util.List<java.lang.String> limitResultsByClassification,
                                                             java.util.Date asOfTime,
                                                             java.lang.String sequencingProperty,
                                                             SequencingOrder sequencingOrder,
                                                             int pageSize)
                                                      throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                             org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeErrorException,
                                                             org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                                             org.odpi.openmetadata.repositoryservices.ffdc.exception.EntityNotKnownException,
                                                             org.odpi.openmetadata.repositoryservices.ffdc.exception.PropertyErrorException,
                                                             org.odpi.openmetadata.repositoryservices.ffdc.exception.PagingErrorException,
                                                             org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
        Validate the parameters passed to the getRelatedEntities.
        Parameters:
        userId - unique identifier for requesting user.
        startEntityGUID - unique identifier of the starting entity.
        entityTypeGUIDs - list of types to search for. Null means any type.
        fromEntityElement - starting element for results list. Used in paging. Zero means first element.
        limitResultsByStatus - By default, relationships in all non-DELETED statuses are returned. However, it is possible to specify a list of statuses (eg ACTIVE) to restrict the results to. Null means all status values except DELETED.
        limitResultsByClassification - List of classifications that must be present on all returned entities.
        asOfTime - Requests a historical query of the relationships for the entity. Null means return the present values.
        sequencingProperty - String name of the property that is to be used to sequence the results. Null means do not sequence on a property name (see SequencingOrder).
        sequencingOrder - Enum defining how the results should be ordered.
        pageSize - the maximum number of result entities that can be returned on this request. Zero means unrestricted return results size.
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - one of the parameters is invalid or null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeErrorException - one of the type guids passed on the request is not known by the metadata collection.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.EntityNotKnownException - the entity identified by the startEntityGUID is not found in the metadata collection.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.PropertyErrorException - the sequencing property specified is not valid for any of the requested types of entity.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.PagingErrorException - the paging/sequencing parameters are set up incorrectly.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
      • isEntityKnown

        public org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.EntityDetail isEntityKnown​(java.lang.String userId,
                                                                                                                                                  java.lang.String guid)
                                                                                                                                           throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                                                                                                                  org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                                                                                                                                  org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
        Returns the entity if the entity is stored in the metadata collection, otherwise null.
        Specified by:
        isEntityKnown in class OMRSMetadataCollection
        Parameters:
        userId - unique identifier for requesting user.
        guid - String unique identifier for the entity
        Returns:
        the entity details if the entity is found in the metadata collection; otherwise return null
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - the guid is null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
      • getEntitySummary

        public org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.EntitySummary getEntitySummary​(java.lang.String userId,
                                                                                                                                                      java.lang.String guid)
                                                                                                                                               throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                                                                                                                      org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                                                                                                                                      org.odpi.openmetadata.repositoryservices.ffdc.exception.EntityNotKnownException,
                                                                                                                                                      org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
        Return the header and classifications for a specific entity.
        Specified by:
        getEntitySummary in class OMRSMetadataCollection
        Parameters:
        userId - unique identifier for requesting user.
        guid - String unique identifier for the entity.
        Returns:
        EntitySummary structure
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - the guid is null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.EntityNotKnownException - the requested entity instance is not known in the metadata collection.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
      • getEntityDetail

        public org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.EntityDetail getEntityDetail​(java.lang.String userId,
                                                                                                                                                    java.lang.String guid)
                                                                                                                                             throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                                                                                                                    org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                                                                                                                                    org.odpi.openmetadata.repositoryservices.ffdc.exception.EntityNotKnownException,
                                                                                                                                                    org.odpi.openmetadata.repositoryservices.ffdc.exception.EntityProxyOnlyException,
                                                                                                                                                    org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
        Return the header, classifications and properties of a specific entity.
        Specified by:
        getEntityDetail in class OMRSMetadataCollection
        Parameters:
        userId - unique identifier for requesting user.
        guid - String unique identifier for the entity.
        Returns:
        EntityDetail structure.
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - the guid is null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.EntityNotKnownException - the requested entity instance is not known in the metadata collection.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.EntityProxyOnlyException - the requested entity instance is only a proxy in the metadata collection.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
      • getEntityDetail

        public org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.EntityDetail getEntityDetail​(java.lang.String userId,
                                                                                                                                                    java.lang.String guid,
                                                                                                                                                    java.util.Date asOfTime)
                                                                                                                                             throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                                                                                                                    org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                                                                                                                                    org.odpi.openmetadata.repositoryservices.ffdc.exception.EntityNotKnownException,
                                                                                                                                                    org.odpi.openmetadata.repositoryservices.ffdc.exception.EntityProxyOnlyException,
                                                                                                                                                    org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException,
                                                                                                                                                    org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
        Return a historical version of an entity. This includes the header, classifications and properties of the entity.
        Specified by:
        getEntityDetail in class OMRSMetadataCollection
        Parameters:
        userId - unique identifier for requesting user.
        guid - String unique identifier for the entity.
        asOfTime - the time used to determine which version of the entity that is desired.
        Returns:
        EntityDetail structure.
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - the guid or date is null or date is for a future time.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.EntityNotKnownException - the requested entity instance is not known in the metadata collection at the time requested.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.EntityProxyOnlyException - the requested entity instance is only a proxy in the metadata collection.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException - the repository does not support the asOfTime parameter.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
      • getEntityDetailHistory

        public java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.EntityDetail> getEntityDetailHistory​(java.lang.String userId,
                                                                                                                                                                           java.lang.String guid,
                                                                                                                                                                           java.util.Date fromTime,
                                                                                                                                                                           java.util.Date toTime,
                                                                                                                                                                           int startFromElement,
                                                                                                                                                                           int pageSize,
                                                                                                                                                                           HistorySequencingOrder sequencingOrder)
                                                                                                                                                                    throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                                                                                                                                           org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                                                                                                                                                           org.odpi.openmetadata.repositoryservices.ffdc.exception.EntityNotKnownException,
                                                                                                                                                                           org.odpi.openmetadata.repositoryservices.ffdc.exception.EntityProxyOnlyException,
                                                                                                                                                                           org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException,
                                                                                                                                                                           org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
        Return all historical versions of an entity within the bounds of the provided timestamps. To retrieve all historical versions of an entity, set both the 'fromTime' and 'toTime' to null.
        Specified by:
        getEntityDetailHistory in class OMRSMetadataCollection
        Parameters:
        userId - unique identifier for requesting user.
        guid - String unique identifier for the entity.
        fromTime - the earliest point in time from which to retrieve historical versions of the entity (inclusive)
        toTime - the latest point in time from which to retrieve historical versions of the entity (exclusive)
        startFromElement - the starting element number of the historical versions to return. This is used when retrieving versions beyond the first page of results. Zero means start from the first element.
        pageSize - the maximum number of result versions that can be returned on this request. Zero means unrestricted return results size.
        sequencingOrder - Enum defining how the results should be ordered.
        Returns:
        List<EntityDetail> of each historical version of the entity detail within the bounds, and in the order requested.
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - the guid or date is null or fromTime is after the toTime
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.EntityNotKnownException - the requested entity instance is not known in the metadata collection at the time requested.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.EntityProxyOnlyException - the requested entity instance is only a proxy in the metadata collection.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException - the repository does not support history.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
      • getRelationshipsForEntity

        public java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.Relationship> getRelationshipsForEntity​(java.lang.String userId,
                                                                                                                                                                              java.lang.String entityGUID,
                                                                                                                                                                              java.lang.String relationshipTypeGUID,
                                                                                                                                                                              int fromRelationshipElement,
                                                                                                                                                                              java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceStatus> limitResultsByStatus,
                                                                                                                                                                              java.util.Date asOfTime,
                                                                                                                                                                              java.lang.String sequencingProperty,
                                                                                                                                                                              SequencingOrder sequencingOrder,
                                                                                                                                                                              int pageSize)
                                                                                                                                                                       throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                                                                                                                                              org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeErrorException,
                                                                                                                                                                              org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                                                                                                                                                              org.odpi.openmetadata.repositoryservices.ffdc.exception.EntityNotKnownException,
                                                                                                                                                                              org.odpi.openmetadata.repositoryservices.ffdc.exception.PropertyErrorException,
                                                                                                                                                                              org.odpi.openmetadata.repositoryservices.ffdc.exception.PagingErrorException,
                                                                                                                                                                              org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException,
                                                                                                                                                                              org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
        Return the relationships for a specific entity.
        Specified by:
        getRelationshipsForEntity in class OMRSMetadataCollection
        Parameters:
        userId - unique identifier for requesting user.
        entityGUID - String unique identifier for the entity.
        relationshipTypeGUID - String GUID of the type of relationship required (null for all).
        fromRelationshipElement - the starting element number of the relationships to return. This is used when retrieving elements beyond the first page of results. Zero means start from the first element.
        limitResultsByStatus - By default, relationships in all non-DELETED statuses are returned. However, it is possible to specify a list of statuses (eg ACTIVE) to restrict the results to. Null means all status values except DELETED.
        asOfTime - Requests a historical query of the relationships for the entity. Null means return the present values.
        sequencingProperty - String name of the property that is to be used to sequence the results. Null means do not sequence on a property name (see SequencingOrder).
        sequencingOrder - Enum defining how the results should be ordered.
        pageSize - -- the maximum number of result classifications that can be returned on this request. Zero means unrestricted return results size.
        Returns:
        Relationships list. Null means no relationships associated with the entity.
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - a parameter is invalid or null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeErrorException - the type guid passed on the request is not known by the metadata collection.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.EntityNotKnownException - the requested entity instance is not known in the metadata collection.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.PropertyErrorException - the sequencing property is not valid for the retrieved relationships.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.PagingErrorException - the paging/sequencing parameters are set up incorrectly.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException - the repository does not support the asOfTime parameter.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
      • findEntities

        public java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.EntityDetail> findEntities​(java.lang.String userId,
                                                                                                                                                                 java.lang.String entityTypeGUID,
                                                                                                                                                                 java.util.List<java.lang.String> entitySubtypeGUIDs,
                                                                                                                                                                 org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.search.SearchProperties matchProperties,
                                                                                                                                                                 int fromEntityElement,
                                                                                                                                                                 java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceStatus> limitResultsByStatus,
                                                                                                                                                                 org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.search.SearchClassifications matchClassifications,
                                                                                                                                                                 java.util.Date asOfTime,
                                                                                                                                                                 java.lang.String sequencingProperty,
                                                                                                                                                                 SequencingOrder sequencingOrder,
                                                                                                                                                                 int pageSize)
                                                                                                                                                          throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                                                                                                                                 org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                                                                                                                                                 org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeErrorException,
                                                                                                                                                                 org.odpi.openmetadata.repositoryservices.ffdc.exception.PropertyErrorException,
                                                                                                                                                                 org.odpi.openmetadata.repositoryservices.ffdc.exception.PagingErrorException,
                                                                                                                                                                 org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException,
                                                                                                                                                                 org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
        Return a list of entities that match the supplied criteria. The results can be returned over many pages.
        Specified by:
        findEntities in class OMRSMetadataCollection
        Parameters:
        userId - unique identifier for requesting user.
        entityTypeGUID - String unique identifier for the entity type of interest (null means any entity type).
        entitySubtypeGUIDs - optional list of the unique identifiers (guids) for subtypes of the entityTypeGUID to include in the search results. Null means all subtypes.
        matchProperties - Optional list of entity property conditions to match.
        fromEntityElement - the starting element number of the entities to return. This is used when retrieving elements beyond the first page of results. Zero means start from the first element.
        limitResultsByStatus - By default, entities in all non-DELETED statuses are returned. However, it is possible to specify a list of statuses (eg ACTIVE) to restrict the results to. Null means all status values except DELETED.
        matchClassifications - Optional list of entity classifications to match.
        asOfTime - Requests a historical query of the entity. Null means return the present values.
        sequencingProperty - String name of the entity property that is to be used to sequence the results. Null means do not sequence on a property name (see SequencingOrder).
        sequencingOrder - Enum defining how the results should be ordered.
        pageSize - the maximum number of result entities that can be returned on this request. Zero means unrestricted return results size.
        Returns:
        a list of entities matching the supplied criteria; null means no matching entities in the metadata collection.
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - a parameter is invalid or null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeErrorException - the type guid passed on the request is not known by the metadata collection.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.PropertyErrorException - the properties specified are not valid for any of the requested types of entity.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.PagingErrorException - the paging/sequencing parameters are set up incorrectly.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException - the repository does not support this optional method.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
      • findEntitiesByProperty

        public java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.EntityDetail> findEntitiesByProperty​(java.lang.String userId,
                                                                                                                                                                           java.lang.String entityTypeGUID,
                                                                                                                                                                           org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceProperties matchProperties,
                                                                                                                                                                           MatchCriteria matchCriteria,
                                                                                                                                                                           int fromEntityElement,
                                                                                                                                                                           java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceStatus> limitResultsByStatus,
                                                                                                                                                                           java.util.List<java.lang.String> limitResultsByClassification,
                                                                                                                                                                           java.util.Date asOfTime,
                                                                                                                                                                           java.lang.String sequencingProperty,
                                                                                                                                                                           SequencingOrder sequencingOrder,
                                                                                                                                                                           int pageSize)
                                                                                                                                                                    throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                                                                                                                                           org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                                                                                                                                                           org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeErrorException,
                                                                                                                                                                           org.odpi.openmetadata.repositoryservices.ffdc.exception.PropertyErrorException,
                                                                                                                                                                           org.odpi.openmetadata.repositoryservices.ffdc.exception.PagingErrorException,
                                                                                                                                                                           org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException,
                                                                                                                                                                           org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
        Return a list of entities that match the supplied properties according to the match criteria. The results can be returned over many pages.
        Specified by:
        findEntitiesByProperty in class OMRSMetadataCollection
        Parameters:
        userId - unique identifier for requesting user.
        entityTypeGUID - String unique identifier for the entity type of interest (null means any entity type).
        matchProperties - Optional list of entity properties to match (where any String property's value should be defined as a Java regular expression, even if it should be an exact match).
        matchCriteria - Enum defining how the match properties should be matched to the entities in the repository.
        fromEntityElement - the starting element number of the entities to return. This is used when retrieving elements beyond the first page of results. Zero means start from the first element.
        limitResultsByStatus - By default, entities in all non-DELETED statuses are returned. However, it is possible to specify a list of statuses (eg ACTIVE) to restrict the results to. Null means all status values except DELETED.
        limitResultsByClassification - List of classifications that must be present on all returned entities.
        asOfTime - Requests a historical query of the entity. Null means return the present values.
        sequencingProperty - String name of the entity property that is to be used to sequence the results. Null means do not sequence on a property name (see SequencingOrder).
        sequencingOrder - Enum defining how the results should be ordered.
        pageSize - the maximum number of result entities that can be returned on this request. Zero means unrestricted return results size.
        Returns:
        a list of entities matching the supplied criteria; null means no matching entities in the metadata collection.
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - a parameter is invalid or null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeErrorException - the type guid passed on the request is not known by the metadata collection.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.PropertyErrorException - the properties specified are not valid for any of the requested types of entity.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.PagingErrorException - the paging/sequencing parameters are set up incorrectly.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException - the repository does not support one of the provided parameters.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
        See Also:
        OMRSRepositoryHelper.getExactMatchRegex(String)
      • findEntitiesByClassification

        public java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.EntityDetail> findEntitiesByClassification​(java.lang.String userId,
                                                                                                                                                                                 java.lang.String entityTypeGUID,
                                                                                                                                                                                 java.lang.String classificationName,
                                                                                                                                                                                 org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceProperties matchClassificationProperties,
                                                                                                                                                                                 MatchCriteria matchCriteria,
                                                                                                                                                                                 int fromEntityElement,
                                                                                                                                                                                 java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceStatus> limitResultsByStatus,
                                                                                                                                                                                 java.util.Date asOfTime,
                                                                                                                                                                                 java.lang.String sequencingProperty,
                                                                                                                                                                                 SequencingOrder sequencingOrder,
                                                                                                                                                                                 int pageSize)
                                                                                                                                                                          throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                                                                                                                                                 org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeErrorException,
                                                                                                                                                                                 org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                                                                                                                                                                 org.odpi.openmetadata.repositoryservices.ffdc.exception.ClassificationErrorException,
                                                                                                                                                                                 org.odpi.openmetadata.repositoryservices.ffdc.exception.PropertyErrorException,
                                                                                                                                                                                 org.odpi.openmetadata.repositoryservices.ffdc.exception.PagingErrorException,
                                                                                                                                                                                 org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException,
                                                                                                                                                                                 org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
        Return a list of entities that have the requested type of classifications attached.
        Specified by:
        findEntitiesByClassification in class OMRSMetadataCollection
        Parameters:
        userId - unique identifier for requesting user.
        entityTypeGUID - unique identifier for the type of entity requested. Null means any type of entity (but could be slow so not recommended.
        classificationName - name of the classification, note a null is not valid.
        matchClassificationProperties - list of classification properties used to narrow the search (where any String property's value should be defined as a Java regular expression, even if it should be an exact match).
        matchCriteria - Enum defining how the match properties should be matched to the classifications in the repository.
        fromEntityElement - the starting element number of the entities to return. This is used when retrieving elements beyond the first page of results. Zero means start from the first element.
        limitResultsByStatus - By default, entities in all non-DELETED statuses are returned. However, it is possible to specify a list of statuses (eg ACTIVE) to restrict the results to. Null means all status values except DELETED.
        asOfTime - Requests a historical query of the entity. Null means return the present values.
        sequencingProperty - String name of the entity property that is to be used to sequence the results. Null means do not sequence on a property name (see SequencingOrder).
        sequencingOrder - Enum defining how the results should be ordered.
        pageSize - the maximum number of result entities that can be returned on this request. Zero means unrestricted return results size.
        Returns:
        a list of entities matching the supplied criteria; null means no matching entities in the metadata collection.
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - a parameter is invalid or null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeErrorException - the type guid passed on the request is not known by the metadata collection.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.ClassificationErrorException - the classification request is not known to the metadata collection.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.PropertyErrorException - the properties specified are not valid for the requested type of classification.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.PagingErrorException - the paging/sequencing parameters are set up incorrectly.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException - the repository does not support one of the provided parameters.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
        See Also:
        OMRSRepositoryHelper.getExactMatchRegex(String)
      • findEntitiesByPropertyValue

        public java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.EntityDetail> findEntitiesByPropertyValue​(java.lang.String userId,
                                                                                                                                                                                java.lang.String entityTypeGUID,
                                                                                                                                                                                java.lang.String searchCriteria,
                                                                                                                                                                                int fromEntityElement,
                                                                                                                                                                                java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceStatus> limitResultsByStatus,
                                                                                                                                                                                java.util.List<java.lang.String> limitResultsByClassification,
                                                                                                                                                                                java.util.Date asOfTime,
                                                                                                                                                                                java.lang.String sequencingProperty,
                                                                                                                                                                                SequencingOrder sequencingOrder,
                                                                                                                                                                                int pageSize)
                                                                                                                                                                         throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                                                                                                                                                org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeErrorException,
                                                                                                                                                                                org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                                                                                                                                                                org.odpi.openmetadata.repositoryservices.ffdc.exception.PropertyErrorException,
                                                                                                                                                                                org.odpi.openmetadata.repositoryservices.ffdc.exception.PagingErrorException,
                                                                                                                                                                                org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException,
                                                                                                                                                                                org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
        Return a list of entities whose string based property values match the search criteria. The search criteria may include regex style wild cards.
        Specified by:
        findEntitiesByPropertyValue in class OMRSMetadataCollection
        Parameters:
        userId - unique identifier for requesting user.
        entityTypeGUID - GUID of the type of entity to search for. Null means all types will be searched (could be slow so not recommended).
        searchCriteria - String Java regular expression used to match against any of the String property values within entity instances of the specified type(s). This parameter must not be null.
        fromEntityElement - the starting element number of the entities to return. This is used when retrieving elements beyond the first page of results. Zero means start from the first element.
        limitResultsByStatus - By default, entities in all non-DELETED statuses are returned. However, it is possible to specify a list of statuses (eg ACTIVE) to restrict the results to. Null means all status values except DELETED.
        limitResultsByClassification - List of classifications that must be present on all returned entities.
        asOfTime - Requests a historical query of the entity. Null means return the present values.
        sequencingProperty - String name of the property that is to be used to sequence the results. Null means do not sequence on a property name (see SequencingOrder).
        sequencingOrder - Enum defining how the results should be ordered.
        pageSize - the maximum number of result entities that can be returned on this request. Zero means unrestricted return results size.
        Returns:
        a list of entities matching the supplied criteria; null means no matching entities in the metadata collection.
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - a parameter is invalid or null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeErrorException - the type guid passed on the request is not known by the metadata collection.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.PropertyErrorException - the sequencing property specified is not valid for any of the requested types of entity.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.PagingErrorException - the paging/sequencing parameters are set up incorrectly.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException - the repository does not support one of the provided parameters.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
        See Also:
        OMRSRepositoryHelper.getExactMatchRegex(String), OMRSRepositoryHelper.getContainsRegex(String)
      • isRelationshipKnown

        public org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.Relationship isRelationshipKnown​(java.lang.String userId,
                                                                                                                                                        java.lang.String guid)
                                                                                                                                                 throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                                                                                                                        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                                                                                                                                        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
        Returns a boolean indicating if the relationship is stored in the metadata collection.
        Specified by:
        isRelationshipKnown in class OMRSMetadataCollection
        Parameters:
        userId - unique identifier for requesting user.
        guid - String unique identifier for the relationship.
        Returns:
        relationship details if the relationship is found in the metadata collection; otherwise return null.
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - the guid is null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
      • getRelationship

        public org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.Relationship getRelationship​(java.lang.String userId,
                                                                                                                                                    java.lang.String guid)
                                                                                                                                             throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                                                                                                                    org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                                                                                                                                    org.odpi.openmetadata.repositoryservices.ffdc.exception.RelationshipNotKnownException,
                                                                                                                                                    org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
        Return a requested relationship.
        Specified by:
        getRelationship in class OMRSMetadataCollection
        Parameters:
        userId - unique identifier for requesting user.
        guid - String unique identifier for the relationship.
        Returns:
        a relationship structure.
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - the guid is null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RelationshipNotKnownException - the metadata collection does not have a relationship with the requested GUID stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
      • getRelationship

        public org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.Relationship getRelationship​(java.lang.String userId,
                                                                                                                                                    java.lang.String guid,
                                                                                                                                                    java.util.Date asOfTime)
                                                                                                                                             throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                                                                                                                    org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                                                                                                                                    org.odpi.openmetadata.repositoryservices.ffdc.exception.RelationshipNotKnownException,
                                                                                                                                                    org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException,
                                                                                                                                                    org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
        Return a historical version of a relationship.
        Specified by:
        getRelationship in class OMRSMetadataCollection
        Parameters:
        userId - unique identifier for requesting user.
        guid - String unique identifier for the relationship.
        asOfTime - the time used to determine which version of the entity that is desired.
        Returns:
        Relationship structure.
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - the guid or date is null or the date is for a future time
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RelationshipNotKnownException - the requested entity instance is not known in the metadata collection at the time requested.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException - the repository does not support the asOfTime parameter.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
      • getRelationshipHistory

        public java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.Relationship> getRelationshipHistory​(java.lang.String userId,
                                                                                                                                                                           java.lang.String guid,
                                                                                                                                                                           java.util.Date fromTime,
                                                                                                                                                                           java.util.Date toTime,
                                                                                                                                                                           int startFromElement,
                                                                                                                                                                           int pageSize,
                                                                                                                                                                           HistorySequencingOrder sequencingOrder)
                                                                                                                                                                    throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                                                                                                                                           org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                                                                                                                                                           org.odpi.openmetadata.repositoryservices.ffdc.exception.RelationshipNotKnownException,
                                                                                                                                                                           org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException,
                                                                                                                                                                           org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
        Return all historical versions of a relationship within the bounds of the provided timestamps. To retrieve all historical versions of a relationship, set both the 'fromTime' and 'toTime' to null.
        Specified by:
        getRelationshipHistory in class OMRSMetadataCollection
        Parameters:
        userId - unique identifier for requesting user.
        guid - String unique identifier for the entity.
        fromTime - the earliest point in time from which to retrieve historical versions of the entity (inclusive)
        toTime - the latest point in time from which to retrieve historical versions of the entity (exclusive)
        startFromElement - the starting element number of the historical versions to return. This is used when retrieving versions beyond the first page of results. Zero means start from the first element.
        pageSize - the maximum number of result versions that can be returned on this request. Zero means unrestricted return results size.
        sequencingOrder - Enum defining how the results should be ordered.
        Returns:
        List<Relationship> of each historical version of the relationship within the bounds, and in the order requested.
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - the guid or date is null or fromTime is after the toTime
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RelationshipNotKnownException - the requested relationship instance is not known in the metadata collection at the time requested.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException - the repository does not support history.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
      • findRelationships

        public java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.Relationship> findRelationships​(java.lang.String userId,
                                                                                                                                                                      java.lang.String relationshipTypeGUID,
                                                                                                                                                                      java.util.List<java.lang.String> relationshipSubtypeGUIDs,
                                                                                                                                                                      org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.search.SearchProperties matchProperties,
                                                                                                                                                                      int fromRelationshipElement,
                                                                                                                                                                      java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceStatus> limitResultsByStatus,
                                                                                                                                                                      java.util.Date asOfTime,
                                                                                                                                                                      java.lang.String sequencingProperty,
                                                                                                                                                                      SequencingOrder sequencingOrder,
                                                                                                                                                                      int pageSize)
                                                                                                                                                               throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                                                                                                                                      org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeErrorException,
                                                                                                                                                                      org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                                                                                                                                                      org.odpi.openmetadata.repositoryservices.ffdc.exception.PropertyErrorException,
                                                                                                                                                                      org.odpi.openmetadata.repositoryservices.ffdc.exception.PagingErrorException,
                                                                                                                                                                      org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException,
                                                                                                                                                                      org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
        Return a list of relationships that match the requested conditions. The results can be received as a series of pages.
        Specified by:
        findRelationships in class OMRSMetadataCollection
        Parameters:
        userId - unique identifier for requesting user.
        relationshipTypeGUID - unique identifier (guid) for the relationship's type. Null means all types (but may be slow so not recommended).
        relationshipSubtypeGUIDs - optional list of the unique identifiers (guids) for subtypes of the relationshipTypeGUID to include in the search results. Null means all subtypes.
        matchProperties - Optional list of relationship property conditions to match.
        fromRelationshipElement - the starting element number of the entities to return. This is used when retrieving elements beyond the first page of results. Zero means start from the first element.
        limitResultsByStatus - By default, relationships in all non-DELETED statuses are returned. However, it is possible to specify a list of statuses (eg ACTIVE) to restrict the results to. Null means all status values except DELETED.
        asOfTime - Requests a historical query of the relationships for the entity. Null means return the present values.
        sequencingProperty - String name of the property that is to be used to sequence the results. Null means do not sequence on a property name (see SequencingOrder).
        sequencingOrder - Enum defining how the results should be ordered.
        pageSize - the maximum number of result relationships that can be returned on this request. Zero means unrestricted return results size.
        Returns:
        a list of relationships. Null means no matching relationships.
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - one of the parameters is invalid or null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeErrorException - the type guid passed on the request is not known by the metadata collection.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.PropertyErrorException - the properties specified are not valid for any of the requested types of relationships.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.PagingErrorException - the paging/sequencing parameters are set up incorrectly.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException - the repository does not support one of the provided parameters.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
        See Also:
        OMRSRepositoryHelper.getExactMatchRegex(String)
      • findRelationshipsByProperty

        public java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.Relationship> findRelationshipsByProperty​(java.lang.String userId,
                                                                                                                                                                                java.lang.String relationshipTypeGUID,
                                                                                                                                                                                org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceProperties matchProperties,
                                                                                                                                                                                MatchCriteria matchCriteria,
                                                                                                                                                                                int fromRelationshipElement,
                                                                                                                                                                                java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceStatus> limitResultsByStatus,
                                                                                                                                                                                java.util.Date asOfTime,
                                                                                                                                                                                java.lang.String sequencingProperty,
                                                                                                                                                                                SequencingOrder sequencingOrder,
                                                                                                                                                                                int pageSize)
                                                                                                                                                                         throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                                                                                                                                                org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeErrorException,
                                                                                                                                                                                org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                                                                                                                                                                org.odpi.openmetadata.repositoryservices.ffdc.exception.PropertyErrorException,
                                                                                                                                                                                org.odpi.openmetadata.repositoryservices.ffdc.exception.PagingErrorException,
                                                                                                                                                                                org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException,
                                                                                                                                                                                org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
        Return a list of relationships that match the requested properties by the matching criteria. The results can be received as a series of pages.
        Specified by:
        findRelationshipsByProperty in class OMRSMetadataCollection
        Parameters:
        userId - unique identifier for requesting user.
        relationshipTypeGUID - unique identifier (guid) for the new relationship's type. Null means all types (but may be slow so not recommended).
        matchProperties - Optional list of relationship properties to match (where any String property's value should be defined as a Java regular expression, even if it should be an exact match).
        matchCriteria - Enum defining how the properties should be matched to the relationships in the repository.
        fromRelationshipElement - the starting element number of the entities to return. This is used when retrieving elements beyond the first page of results. Zero means start from the first element.
        limitResultsByStatus - By default, relationships in all non-DELETED statuses are returned. However, it is possible to specify a list of statuses (eg ACTIVE) to restrict the results to. Null means all status values except DELETED.
        asOfTime - Requests a historical query of the relationships for the entity. Null means return the present values.
        sequencingProperty - String name of the property that is to be used to sequence the results. Null means do not sequence on a property name (see SequencingOrder).
        sequencingOrder - Enum defining how the results should be ordered.
        pageSize - the maximum number of result relationships that can be returned on this request. Zero means unrestricted return results size.
        Returns:
        a list of relationships. Null means no matching relationships.
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - one of the parameters is invalid or null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeErrorException - the type guid passed on the request is not known by the metadata collection.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.PropertyErrorException - the properties specified are not valid for any of the requested types of relationships.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.PagingErrorException - the paging/sequencing parameters are set up incorrectly.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException - the repository does not support this call.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
        See Also:
        OMRSRepositoryHelper.getExactMatchRegex(String)
      • findRelationshipsByPropertyValue

        public java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.Relationship> findRelationshipsByPropertyValue​(java.lang.String userId,
                                                                                                                                                                                     java.lang.String relationshipTypeGUID,
                                                                                                                                                                                     java.lang.String searchCriteria,
                                                                                                                                                                                     int fromRelationshipElement,
                                                                                                                                                                                     java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceStatus> limitResultsByStatus,
                                                                                                                                                                                     java.util.Date asOfTime,
                                                                                                                                                                                     java.lang.String sequencingProperty,
                                                                                                                                                                                     SequencingOrder sequencingOrder,
                                                                                                                                                                                     int pageSize)
                                                                                                                                                                              throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                                                                                                                                                     org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeErrorException,
                                                                                                                                                                                     org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                                                                                                                                                                     org.odpi.openmetadata.repositoryservices.ffdc.exception.PropertyErrorException,
                                                                                                                                                                                     org.odpi.openmetadata.repositoryservices.ffdc.exception.PagingErrorException,
                                                                                                                                                                                     org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException,
                                                                                                                                                                                     org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
        Return a list of relationships whose string based property values match the search criteria. The search criteria may include regex style wild cards.
        Specified by:
        findRelationshipsByPropertyValue in class OMRSMetadataCollection
        Parameters:
        userId - unique identifier for requesting user.
        relationshipTypeGUID - GUID of the type of entity to search for. Null means all types will be searched (could be slow so not recommended).
        searchCriteria - String Java regular expression used to match against any of the String property values within the relationship instances of the specified type(s). This parameter must not be null.
        fromRelationshipElement - Element number of the results to skip to when building the results list to return. Zero means begin at the start of the results. This is used to retrieve the results over a number of pages.
        limitResultsByStatus - By default, relationships in all non-DELETED statuses are returned. However, it is possible to specify a list of statuses (eg ACTIVE) to restrict the results to. Null means all status values except DELETED.
        asOfTime - Requests a historical query of the relationships for the entity. Null means return the present values.
        sequencingProperty - String name of the property that is to be used to sequence the results. Null means do not sequence on a property name (see SequencingOrder).
        sequencingOrder - Enum defining how the results should be ordered.
        pageSize - the maximum number of result relationships that can be returned on this request. Zero means unrestricted return results size.
        Returns:
        a list of relationships. Null means no matching relationships.
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - one of the parameters is invalid or null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeErrorException - the type guid passed on the request is not known by the metadata collection.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.PropertyErrorException - there is a problem with one of the other parameters.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.PagingErrorException - the paging/sequencing parameters are set up incorrectly.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException - the repository does not support this call.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
        See Also:
        OMRSRepositoryHelper.getExactMatchRegex(String), OMRSRepositoryHelper.getContainsRegex(String)
      • getLinkingEntities

        public org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceGraph getLinkingEntities​(java.lang.String userId,
                                                                                                                                                        java.lang.String startEntityGUID,
                                                                                                                                                        java.lang.String endEntityGUID,
                                                                                                                                                        java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceStatus> limitResultsByStatus,
                                                                                                                                                        java.util.Date asOfTime)
                                                                                                                                                 throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                                                                                                                        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                                                                                                                                        org.odpi.openmetadata.repositoryservices.ffdc.exception.EntityNotKnownException,
                                                                                                                                                        org.odpi.openmetadata.repositoryservices.ffdc.exception.PropertyErrorException,
                                                                                                                                                        org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException,
                                                                                                                                                        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
        Return all the relationships and intermediate entities that connect the startEntity with the endEntity.
        Specified by:
        getLinkingEntities in class OMRSMetadataCollection
        Parameters:
        userId - unique identifier for requesting user.
        startEntityGUID - The entity that is used to anchor the query.
        endEntityGUID - the other entity that defines the scope of the query.
        limitResultsByStatus - By default, relationships in all non-DELETED statuses are returned. However, it is possible to specify a list of statuses (eg ACTIVE) to restrict the results to. Null means all status values except DELETED.
        asOfTime - Requests a historical query of the relationships for the entity. Null means return the present values.
        Returns:
        InstanceGraph the sub-graph that represents the returned linked entities and their relationships.
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - one of the parameters is invalid or null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.EntityNotKnownException - the entity identified by either the startEntityGUID or the endEntityGUID is not found in the metadata collection.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.PropertyErrorException - there is a problem with one of the other parameters.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException - the repository does not support this call.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
      • getEntityNeighborhood

        public org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceGraph getEntityNeighborhood​(java.lang.String userId,
                                                                                                                                                           java.lang.String entityGUID,
                                                                                                                                                           java.util.List<java.lang.String> entityTypeGUIDs,
                                                                                                                                                           java.util.List<java.lang.String> relationshipTypeGUIDs,
                                                                                                                                                           java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceStatus> limitResultsByStatus,
                                                                                                                                                           java.util.List<java.lang.String> limitResultsByClassification,
                                                                                                                                                           java.util.Date asOfTime,
                                                                                                                                                           int level)
                                                                                                                                                    throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                                                                                                                           org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeErrorException,
                                                                                                                                                           org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                                                                                                                                           org.odpi.openmetadata.repositoryservices.ffdc.exception.EntityNotKnownException,
                                                                                                                                                           org.odpi.openmetadata.repositoryservices.ffdc.exception.PropertyErrorException,
                                                                                                                                                           org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException,
                                                                                                                                                           org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
        Return the entities and relationships that radiate out from the supplied entity GUID. The results are scoped both the instance type guids and the level.
        Specified by:
        getEntityNeighborhood in class OMRSMetadataCollection
        Parameters:
        userId - unique identifier for requesting user.
        entityGUID - the starting point of the query.
        entityTypeGUIDs - list of entity types to include in the query results. Null means include all entities found, irrespective of their type.
        relationshipTypeGUIDs - list of relationship types to include in the query results. Null means include all relationships found, irrespective of their type.
        limitResultsByStatus - By default, relationships in all non-DELETED statuses are returned. However, it is possible to specify a list of statuses (eg ACTIVE) to restrict the results to. Null means all status values except DELETED.
        limitResultsByClassification - List of classifications that must be present on all returned entities.
        asOfTime - Requests a historical query of the relationships for the entity. Null means return the present values.
        level - the number of the relationships out from the starting entity that the query will traverse to gather results.
        Returns:
        InstanceGraph the sub-graph that represents the returned linked entities and their relationships.
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - one of the parameters is invalid or null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeErrorException - the type guid passed on the request is not known by the metadata collection.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.EntityNotKnownException - the entity identified by the entityGUID is not found in the metadata collection.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.PropertyErrorException - there is a problem with one of the other parameters.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException - the repository does not support this call.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
      • getRelatedEntities

        public java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.EntityDetail> getRelatedEntities​(java.lang.String userId,
                                                                                                                                                                       java.lang.String startEntityGUID,
                                                                                                                                                                       java.util.List<java.lang.String> entityTypeGUIDs,
                                                                                                                                                                       int fromEntityElement,
                                                                                                                                                                       java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceStatus> limitResultsByStatus,
                                                                                                                                                                       java.util.List<java.lang.String> limitResultsByClassification,
                                                                                                                                                                       java.util.Date asOfTime,
                                                                                                                                                                       java.lang.String sequencingProperty,
                                                                                                                                                                       SequencingOrder sequencingOrder,
                                                                                                                                                                       int pageSize)
                                                                                                                                                                throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                                                                                                                                       org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeErrorException,
                                                                                                                                                                       org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                                                                                                                                                       org.odpi.openmetadata.repositoryservices.ffdc.exception.EntityNotKnownException,
                                                                                                                                                                       org.odpi.openmetadata.repositoryservices.ffdc.exception.PropertyErrorException,
                                                                                                                                                                       org.odpi.openmetadata.repositoryservices.ffdc.exception.PagingErrorException,
                                                                                                                                                                       org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException,
                                                                                                                                                                       org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
        Return the list of entities that are of the types listed in entityTypeGUIDs and are connected, either directly or indirectly to the entity identified by startEntityGUID.
        Specified by:
        getRelatedEntities in class OMRSMetadataCollection
        Parameters:
        userId - unique identifier for requesting user.
        startEntityGUID - unique identifier of the starting entity.
        entityTypeGUIDs - list of types to search for. Null means any type.
        fromEntityElement - starting element for results list. Used in paging. Zero means first element.
        limitResultsByStatus - By default, relationships in all non-DELETED statuses are returned. However, it is possible to specify a list of statuses (eg ACTIVE) to restrict the results to. Null means all status values except DELETED.
        limitResultsByClassification - List of classifications that must be present on all returned entities.
        asOfTime - Requests a historical query of the relationships for the entity. Null means return the present values.
        sequencingProperty - String name of the property that is to be used to sequence the results. Null means do not sequence on a property name (see SequencingOrder).
        sequencingOrder - Enum defining how the results should be ordered.
        pageSize - the maximum number of result entities that can be returned on this request. Zero means unrestricted return results size.
        Returns:
        list of entities either directly or indirectly connected to the start entity
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - one of the parameters is invalid or null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeErrorException - one of the type guids passed on the request is not known by the metadata collection.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.EntityNotKnownException - the entity identified by the startEntityGUID is not found in the metadata collection.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.PropertyErrorException - the sequencing property specified is not valid for any of the requested types of entity.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.PagingErrorException - the paging/sequencing parameters are set up incorrectly.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException - the repository does not support this call.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
      • addEntityParameterValidation

        protected org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDef addEntityParameterValidation​(java.lang.String userId,
                                                                                                                                                              java.lang.String entityTypeGUID,
                                                                                                                                                              org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceProperties initialProperties,
                                                                                                                                                              java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.Classification> initialClassifications,
                                                                                                                                                              org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceStatus initialStatus,
                                                                                                                                                              java.lang.String methodName)
                                                                                                                                                       throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                                                                                                                              org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                                                                                                                                              org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeErrorException,
                                                                                                                                                              org.odpi.openmetadata.repositoryservices.ffdc.exception.PropertyErrorException,
                                                                                                                                                              org.odpi.openmetadata.repositoryservices.ffdc.exception.ClassificationErrorException,
                                                                                                                                                              org.odpi.openmetadata.repositoryservices.ffdc.exception.StatusNotSupportedException
        Validate that the parameters passed to addEntity are valid.
        Parameters:
        userId - unique identifier for requesting user.
        entityTypeGUID - unique identifier (guid) for the new entity's type.
        initialProperties - initial list of properties for the new entity; null means no properties.
        initialClassifications - initial list of classifications for the new entity; null means no classifications.
        initialStatus - initial status typically set to DRAFT, PREPARED or ACTIVE. not have any relationships at this stage.
        methodName - calling method
        Returns:
        typeDef of the entity's type
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - one of the parameters is invalid or null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeErrorException - the requested type is not known, or not supported in the metadata repository hosting the metadata collection.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.PropertyErrorException - one or more of the requested properties are not defined, or have different characteristics in the TypeDef for this entity's type.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.ClassificationErrorException - one or more of the requested classifications are either not known or not defined for this entity type.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.StatusNotSupportedException - the metadata repository hosting the metadata collection does not support the requested status.
      • addEntityParameterValidation

        @Deprecated
        protected org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDef addEntityParameterValidation​(java.lang.String userId,
                                                                                                                                                              java.lang.String entityTypeGUID,
                                                                                                                                                              org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceProperties initialProperties,
                                                                                                                                                              java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.Classification> initialClassifications,
                                                                                                                                                              org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceStatus initialStatus)
                                                                                                                                                       throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                                                                                                                              org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                                                                                                                                              org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeErrorException,
                                                                                                                                                              org.odpi.openmetadata.repositoryservices.ffdc.exception.PropertyErrorException,
                                                                                                                                                              org.odpi.openmetadata.repositoryservices.ffdc.exception.ClassificationErrorException,
                                                                                                                                                              org.odpi.openmetadata.repositoryservices.ffdc.exception.StatusNotSupportedException,
                                                                                                                                                              org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
        Deprecated.
        Validate that the parameters passed to addEntity are valid.
        Parameters:
        userId - unique identifier for requesting user.
        entityTypeGUID - unique identifier (guid) for the new entity's type.
        initialProperties - initial list of properties for the new entity; null means no properties.
        initialClassifications - initial list of classifications for the new entity; null means no classifications.
        initialStatus - initial status typically set to DRAFT, PREPARED or ACTIVE. not have any relationships at this stage.
        Returns:
        typeDef of the entity's type
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - one of the parameters is invalid or null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeErrorException - the requested type is not known, or not supported in the metadata repository hosting the metadata collection.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.PropertyErrorException - one or more of the requested properties are not defined, or have different characteristics in the TypeDef for this entity's type.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.ClassificationErrorException - one or more of the requested classifications are either not known or not defined for this entity type.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.StatusNotSupportedException - the metadata repository hosting the metadata collection does not support the requested status.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
      • addExternalEntityParameterValidation

        protected org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDef addExternalEntityParameterValidation​(java.lang.String userId,
                                                                                                                                                                      java.lang.String entityTypeGUID,
                                                                                                                                                                      java.lang.String externalSourceGUID,
                                                                                                                                                                      org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceProperties initialProperties,
                                                                                                                                                                      java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.Classification> initialClassifications,
                                                                                                                                                                      org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceStatus initialStatus,
                                                                                                                                                                      java.lang.String methodName)
                                                                                                                                                               throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                                                                                                                                      org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                                                                                                                                                      org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeErrorException,
                                                                                                                                                                      org.odpi.openmetadata.repositoryservices.ffdc.exception.PropertyErrorException,
                                                                                                                                                                      org.odpi.openmetadata.repositoryservices.ffdc.exception.ClassificationErrorException,
                                                                                                                                                                      org.odpi.openmetadata.repositoryservices.ffdc.exception.StatusNotSupportedException,
                                                                                                                                                                      org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
        Validate parameters needed to save a new entity that is sourced from an external technology.
        Parameters:
        userId - unique identifier for requesting user.
        entityTypeGUID - unique identifier (guid) for the new entity's type.
        externalSourceGUID - unique identifier (guid) for the external source.
        initialProperties - initial list of properties for the new entity; null means no properties.
        initialClassifications - initial list of classifications for the new entity null means no classifications.
        initialStatus - initial status typically DRAFT, PREPARED or ACTIVE.
        methodName - calling method
        Returns:
        EntityDetail showing the new header plus the requested properties and classifications. The entity will not have any relationships at this stage.
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - one of the parameters is invalid or null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeErrorException - the requested type is not known, or not supported in the metadata repository hosting the metadata collection.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.PropertyErrorException - one or more of the requested properties are not defined, or have different characteristics in the TypeDef for this entity's type.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.ClassificationErrorException - one or more of the requested classifications are either not known or not defined for this entity type.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.StatusNotSupportedException - the metadata repository hosting the metadata collection does not support the requested status.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
      • addEntityProxyParameterValidation

        protected void addEntityProxyParameterValidation​(java.lang.String userId,
                                                         org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.EntityProxy entityProxy)
                                                  throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                         org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException
        Validate the parameters for addEntityProxy.
        Parameters:
        userId - unique identifier for requesting user.
        entityProxy - details of entity to add.
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - the entity proxy is null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
      • updateInstanceStatusParameterValidation

        protected void updateInstanceStatusParameterValidation​(java.lang.String userId,
                                                               java.lang.String entityGUID,
                                                               org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceStatus newStatus,
                                                               java.lang.String methodName)
                                                        throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                               org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException
        Validate parameters for updateEntityStatus.
        Parameters:
        userId - unique identifier for requesting user.
        entityGUID - unique identifier (guid) for the requested entity.
        newStatus - new InstanceStatus for the entity.
        methodName - calling method
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - one of the parameters is invalid or null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
      • updateInstancePropertiesPropertyValidation

        protected void updateInstancePropertiesPropertyValidation​(java.lang.String userId,
                                                                  java.lang.String instanceGUID,
                                                                  org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceProperties properties,
                                                                  java.lang.String methodName)
                                                           throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                                  org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException
        Validate the parameters for update the properties of an instance.
        Parameters:
        userId - unique identifier for requesting user.
        instanceGUID - String unique identifier (guid) for the entity.
        properties - a list of properties to change.
        methodName - calling method
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - one of the parameters is invalid or null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
      • manageInstanceParameterValidation

        protected void manageInstanceParameterValidation​(java.lang.String userId,
                                                         java.lang.String instanceGUID,
                                                         java.lang.String instanceGUIDParameterName,
                                                         java.lang.String methodName)
                                                  throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                         org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException
        Validate the parameters for calls that manage an existing instance.
        Parameters:
        userId - unique identifier for requesting user.
        instanceGUID - String unique identifier (guid) for the instance.
        instanceGUIDParameterName - name of parameter for instance's GUID
        methodName - name of the calling method.
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - the guid is null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
      • manageInstanceParameterValidation

        @Deprecated
        protected void manageInstanceParameterValidation​(java.lang.String userId,
                                                         java.lang.String instanceGUID,
                                                         java.lang.String methodName)
                                                  throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                         org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                                         org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
        Deprecated.
        Validate the parameters for calls that manage an existing instance.
        Parameters:
        userId - unique identifier for requesting user.
        instanceGUID - String unique identifier (guid) for the instance.
        methodName - name of the calling method.
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - the guid is null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
      • manageInstanceParameterValidation

        protected void manageInstanceParameterValidation​(java.lang.String userId,
                                                         java.lang.String typeDefGUID,
                                                         java.lang.String typeDefName,
                                                         java.lang.String instanceGUID,
                                                         java.lang.String instanceGUIDParameterName,
                                                         java.lang.String methodName)
                                                  throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                         org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException
        Validate the parameters passed to a delete or purge instance method.
        Parameters:
        userId - unique identifier for requesting user.
        typeDefGUID - unique identifier of the type of the instance to delete.
        typeDefName - unique name of the type of the instance to delete.
        instanceGUID - String unique identifier (guid) for the instance.
        instanceGUIDParameterName - name of parameter for instance's GUID
        methodName - calling method
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - one of the parameters is invalid or null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
      • removeInstanceParameterValidation

        @Deprecated
        protected void removeInstanceParameterValidation​(java.lang.String userId,
                                                         java.lang.String typeDefGUID,
                                                         java.lang.String typeDefName,
                                                         java.lang.String instanceGUID,
                                                         java.lang.String methodName)
                                                  throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                         org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                                         org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
        Deprecated.
        Validate the parameters passed to a delete or purge instance method.
        Parameters:
        userId - unique identifier for requesting user.
        typeDefGUID - unique identifier of the type of the instance to delete.
        typeDefName - unique name of the type of the instance to delete.
        instanceGUID - String unique identifier (guid) for the instance.
        methodName - calling method
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - one of the parameters is invalid or null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
      • classifyEntityParameterValidation

        protected org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDef classifyEntityParameterValidation​(java.lang.String userId,
                                                                                                                                                                   java.lang.String entityGUID,
                                                                                                                                                                   java.lang.String classificationName,
                                                                                                                                                                   org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceProperties classificationProperties,
                                                                                                                                                                   java.lang.String methodName)
                                                                                                                                                            throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                                                                                                                                   org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                                                                                                                                                   org.odpi.openmetadata.repositoryservices.ffdc.exception.PropertyErrorException
        Validate the parameters passed to classifyEntity.
        Parameters:
        userId - unique identifier for requesting user.
        entityGUID - String unique identifier (guid) for the entity.
        classificationName - String name for the classification.
        classificationProperties - list of properties to set in the classification.
        methodName - calling method
        Returns:
        typeDef for the classification
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - one of the parameters is invalid or null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.PropertyErrorException - one or more of the requested properties are not defined, or have different characteristics in the TypeDef for this classification type
      • classifyEntityParameterValidation

        @Deprecated
        protected org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDef classifyEntityParameterValidation​(java.lang.String userId,
                                                                                                                                                                   java.lang.String entityGUID,
                                                                                                                                                                   java.lang.String classificationName,
                                                                                                                                                                   org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceProperties classificationProperties)
                                                                                                                                                            throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                                                                                                                                   org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                                                                                                                                                   org.odpi.openmetadata.repositoryservices.ffdc.exception.PropertyErrorException,
                                                                                                                                                                   org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
        Deprecated.
        Validate the parameters passed to classifyEntity.
        Parameters:
        userId - unique identifier for requesting user.
        entityGUID - String unique identifier (guid) for the entity.
        classificationName - String name for the classification.
        classificationProperties - list of properties to set in the classification.
        Returns:
        typeDef for the classification
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - one of the parameters is invalid or null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.PropertyErrorException - one or more of the requested properties are not defined, or have different characteristics in the TypeDef for this classification type
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
      • classifyEntityParameterValidation

        protected org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDef classifyEntityParameterValidation​(java.lang.String userId,
                                                                                                                                                                   org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.EntityProxy entityProxy,
                                                                                                                                                                   java.lang.String classificationName,
                                                                                                                                                                   org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceProperties classificationProperties,
                                                                                                                                                                   java.lang.String methodName)
                                                                                                                                                            throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                                                                                                                                   org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                                                                                                                                                   org.odpi.openmetadata.repositoryservices.ffdc.exception.PropertyErrorException,
                                                                                                                                                                   org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
        Validate the parameters passed to classifyEntity.
        Parameters:
        userId - unique identifier for requesting user.
        entityProxy - identifier (proxy) for the entity.
        classificationName - String name for the classification.
        classificationProperties - list of properties to set in the classification.
        methodName - calling method
        Returns:
        typeDef for the classification
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - one of the parameters is invalid or null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.PropertyErrorException - one or more of the requested properties are not defined, or have different characteristics in the TypeDef for this classification type
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
      • declassifyEntityParameterValidation

        protected void declassifyEntityParameterValidation​(java.lang.String userId,
                                                           java.lang.String entityGUID,
                                                           java.lang.String classificationName,
                                                           java.lang.String methodName)
                                                    throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                           org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException
        Validate the parameters passed to declassifyEntity.
        Parameters:
        userId - unique identifier for requesting user.
        entityGUID - String unique identifier (guid) for the entity.
        classificationName - String name for the classification.
        methodName - calling method
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - one of the parameters is invalid or null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
      • declassifyEntityParameterValidation

        @Deprecated
        protected void declassifyEntityParameterValidation​(java.lang.String userId,
                                                           java.lang.String entityGUID,
                                                           java.lang.String classificationName)
                                                    throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                           org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException
        Deprecated.
        Validate the parameters passed to declassifyEntity.
        Parameters:
        userId - unique identifier for requesting user.
        entityGUID - String unique identifier (guid) for the entity.
        classificationName - String name for the classification.
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - one of the parameters is invalid or null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
      • updateEntityClassificationParameterValidation

        @Deprecated
        protected org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDef updateEntityClassificationParameterValidation​(java.lang.String userId,
                                                                                                                                                                               java.lang.String entityGUID,
                                                                                                                                                                               java.lang.String classificationName,
                                                                                                                                                                               org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceProperties properties)
                                                                                                                                                                        throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                                                                                                                                               org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                                                                                                                                                               org.odpi.openmetadata.repositoryservices.ffdc.exception.PropertyErrorException,
                                                                                                                                                                               org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
        Deprecated.
        Validate the parameters passed to updateEntityClassification.
        Parameters:
        userId - unique identifier for requesting user.
        entityGUID - String unique identifier (guid) for the entity.
        classificationName - String name for the classification.
        properties - list of properties for the classification.
        Returns:
        typeDef for the classification
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - one of the parameters is invalid or null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.PropertyErrorException - one or more of the requested properties are not defined, or have different characteristics in the TypeDef for this classification type
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
      • addRelationshipParameterValidation

        protected org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDef addRelationshipParameterValidation​(java.lang.String userId,
                                                                                                                                                                    java.lang.String relationshipTypeGUID,
                                                                                                                                                                    org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceProperties initialProperties,
                                                                                                                                                                    java.lang.String entityOneGUID,
                                                                                                                                                                    java.lang.String entityTwoGUID,
                                                                                                                                                                    org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceStatus initialStatus,
                                                                                                                                                                    java.lang.String methodName)
                                                                                                                                                             throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                                                                                                                                    org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                                                                                                                                                    org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeErrorException,
                                                                                                                                                                    org.odpi.openmetadata.repositoryservices.ffdc.exception.PropertyErrorException,
                                                                                                                                                                    org.odpi.openmetadata.repositoryservices.ffdc.exception.StatusNotSupportedException,
                                                                                                                                                                    org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
        Validate the parameters for adding a new relationship between two entities to the metadata collection.
        Parameters:
        userId - unique identifier for requesting user.
        relationshipTypeGUID - unique identifier (guid) for the new relationship's type.
        initialProperties - initial list of properties for the new entity; null means no properties.
        entityOneGUID - the unique identifier of one of the entities that the relationship is connecting together.
        entityTwoGUID - the unique identifier of the other entity that the relationship is connecting together.
        initialStatus - initial status typically set to DRAFT, PREPARED or ACTIVE.
        methodName - calling method
        Returns:
        type definition
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - one of the parameters is invalid or null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeErrorException - the requested type is not known, or not supported in the metadata repository hosting the metadata collection.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.PropertyErrorException - one or more of the requested properties are not defined, or have different characteristics in the TypeDef for this relationship's type.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.StatusNotSupportedException - the metadata repository hosting the metadata collection does not support the requested status.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
      • addRelationshipParameterValidation

        @Deprecated
        protected org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDef addRelationshipParameterValidation​(java.lang.String userId,
                                                                                                                                                                    java.lang.String relationshipTypeGUID,
                                                                                                                                                                    org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceProperties initialProperties,
                                                                                                                                                                    java.lang.String entityOneGUID,
                                                                                                                                                                    java.lang.String entityTwoGUID,
                                                                                                                                                                    org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceStatus initialStatus)
                                                                                                                                                             throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                                                                                                                                    org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                                                                                                                                                    org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeErrorException,
                                                                                                                                                                    org.odpi.openmetadata.repositoryservices.ffdc.exception.PropertyErrorException,
                                                                                                                                                                    org.odpi.openmetadata.repositoryservices.ffdc.exception.StatusNotSupportedException,
                                                                                                                                                                    org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
        Deprecated.
        Validate the parameters for adding a new relationship between two entities to the metadata collection.
        Parameters:
        userId - unique identifier for requesting user.
        relationshipTypeGUID - unique identifier (guid) for the new relationship's type.
        initialProperties - initial list of properties for the new entity; null means no properties.
        entityOneGUID - the unique identifier of one of the entities that the relationship is connecting together.
        entityTwoGUID - the unique identifier of the other entity that the relationship is connecting together.
        initialStatus - initial status typically set to DRAFT, PREPARED or ACTIVE.
        Returns:
        type definition
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - one of the parameters is invalid or null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeErrorException - the requested type is not known, or not supported in the metadata repository hosting the metadata collection.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.PropertyErrorException - one or more of the requested properties are not defined, or have different characteristics in the TypeDef for this relationship's type.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.StatusNotSupportedException - the metadata repository hosting the metadata collection does not support the requested status.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
      • addExternalRelationshipParameterValidation

        protected org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDef addExternalRelationshipParameterValidation​(java.lang.String userId,
                                                                                                                                                                            java.lang.String relationshipTypeGUID,
                                                                                                                                                                            java.lang.String externalSourceGUID,
                                                                                                                                                                            org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceProperties initialProperties,
                                                                                                                                                                            java.lang.String entityOneGUID,
                                                                                                                                                                            java.lang.String entityTwoGUID,
                                                                                                                                                                            org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceStatus initialStatus,
                                                                                                                                                                            java.lang.String methodName)
                                                                                                                                                                     throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                                                                                                                                            org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                                                                                                                                                            org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeErrorException,
                                                                                                                                                                            org.odpi.openmetadata.repositoryservices.ffdc.exception.PropertyErrorException,
                                                                                                                                                                            org.odpi.openmetadata.repositoryservices.ffdc.exception.StatusNotSupportedException,
                                                                                                                                                                            org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
        Validate the parameters needed to save a new relationship that is sourced from an external technology.
        Parameters:
        userId - unique identifier for requesting user.
        relationshipTypeGUID - unique identifier (guid) for the new relationship's type.
        externalSourceGUID - unique identifier (guid) for the external source.
        initialProperties - initial list of properties for the new entity; null means no properties.
        entityOneGUID - the unique identifier of one of the entities that the relationship is connecting together.
        entityTwoGUID - the unique identifier of the other entity that the relationship is connecting together.
        initialStatus - initial status; typically DRAFT, PREPARED or ACTIVE.
        methodName - calling method
        Returns:
        Relationship structure with the new header, requested entities and properties.
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - one of the parameters is invalid or null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeErrorException - the requested type is not known, or not supported in the metadata repository hosting the metadata collection.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.PropertyErrorException - one or more of the requested properties are not defined, or have different characteristics in the TypeDef for this relationship's type.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.StatusNotSupportedException - the metadata repository hosting the metadata collection does not support the requested status.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
      • addEntity

        public org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.EntityDetail addEntity​(java.lang.String userId,
                                                                                                                                              java.lang.String entityTypeGUID,
                                                                                                                                              org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceProperties initialProperties,
                                                                                                                                              java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.Classification> initialClassifications,
                                                                                                                                              org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceStatus initialStatus)
                                                                                                                                       throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                                                                                                              org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                                                                                                                              org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeErrorException,
                                                                                                                                              org.odpi.openmetadata.repositoryservices.ffdc.exception.PropertyErrorException,
                                                                                                                                              org.odpi.openmetadata.repositoryservices.ffdc.exception.ClassificationErrorException,
                                                                                                                                              org.odpi.openmetadata.repositoryservices.ffdc.exception.StatusNotSupportedException,
                                                                                                                                              org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException,
                                                                                                                                              org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
        Create a new entity and put it in the requested state. The new entity is returned.
        Specified by:
        addEntity in class OMRSMetadataCollection
        Parameters:
        userId - unique identifier for requesting user.
        entityTypeGUID - unique identifier (guid) for the new entity's type.
        initialProperties - initial list of properties for the new entity; null means no properties.
        initialClassifications - initial list of classifications for the new entity; null means no classifications.
        initialStatus - initial status typically set to DRAFT, PREPARED or ACTIVE.
        Returns:
        EntityDetail showing the new header plus the requested properties and classifications. The entity will not have any relationships at this stage.
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - one of the parameters is invalid or null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeErrorException - the requested type is not known, or not supported in the metadata repository hosting the metadata collection.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.PropertyErrorException - one or more of the requested properties are not defined, or have different characteristics in the TypeDef for this entity's type.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.ClassificationErrorException - one or more of the requested classifications are either not known or not defined for this entity type.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.StatusNotSupportedException - the metadata repository hosting the metadata collection does not support the requested status.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException - the repository does not support maintenance of metadata.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
      • addExternalEntity

        public org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.EntityDetail addExternalEntity​(java.lang.String userId,
                                                                                                                                                      java.lang.String entityTypeGUID,
                                                                                                                                                      java.lang.String externalSourceGUID,
                                                                                                                                                      java.lang.String externalSourceName,
                                                                                                                                                      org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceProperties initialProperties,
                                                                                                                                                      java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.Classification> initialClassifications,
                                                                                                                                                      org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceStatus initialStatus)
                                                                                                                                               throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                                                                                                                      org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                                                                                                                                      org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeErrorException,
                                                                                                                                                      org.odpi.openmetadata.repositoryservices.ffdc.exception.PropertyErrorException,
                                                                                                                                                      org.odpi.openmetadata.repositoryservices.ffdc.exception.ClassificationErrorException,
                                                                                                                                                      org.odpi.openmetadata.repositoryservices.ffdc.exception.StatusNotSupportedException,
                                                                                                                                                      org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException,
                                                                                                                                                      org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
        Save a new entity that is sourced from an external technology. The external technology is identified by a GUID and a name. These can be recorded in a Software Server Capability (guid and qualifiedName respectively. The new entity is assigned a new GUID and put in the requested state. The new entity is returned.
        Overrides:
        addExternalEntity in class OMRSMetadataCollection
        Parameters:
        userId - unique identifier for requesting user.
        entityTypeGUID - unique identifier (guid) for the new entity's type.
        externalSourceGUID - unique identifier (guid) for the external source.
        externalSourceName - unique name for the external source.
        initialProperties - initial list of properties for the new entity; null means no properties.
        initialClassifications - initial list of classifications for the new entity null means no classifications.
        initialStatus - initial status typically DRAFT, PREPARED or ACTIVE.
        Returns:
        EntityDetail showing the new header plus the requested properties and classifications. The entity will not have any relationships at this stage.
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - one of the parameters is invalid or null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeErrorException - the requested type is not known, or not supported in the metadata repository hosting the metadata collection.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.PropertyErrorException - one or more of the requested properties are not defined, or have different characteristics in the TypeDef for this entity's type.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.ClassificationErrorException - one or more of the requested classifications are either not known or not defined for this entity type.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.StatusNotSupportedException - the metadata repository hosting the metadata collection does not support the requested status.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException - the repository does not support maintenance of metadata.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
      • addEntityProxy

        public void addEntityProxy​(java.lang.String userId,
                                   org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.EntityProxy entityProxy)
                            throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                   org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                   org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException,
                                   org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
        Create an entity proxy in the metadata collection. This is used to store relationships that span metadata repositories.
        Specified by:
        addEntityProxy in class OMRSMetadataCollection
        Parameters:
        userId - unique identifier for requesting user.
        entityProxy - details of entity to add.
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - the entity proxy is null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException - the repository does not support entity proxies as first class elements.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
      • updateEntityStatus

        public org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.EntityDetail updateEntityStatus​(java.lang.String userId,
                                                                                                                                                       java.lang.String entityGUID,
                                                                                                                                                       org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceStatus newStatus)
                                                                                                                                                throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                                                                                                                       org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                                                                                                                                       org.odpi.openmetadata.repositoryservices.ffdc.exception.EntityNotKnownException,
                                                                                                                                                       org.odpi.openmetadata.repositoryservices.ffdc.exception.StatusNotSupportedException,
                                                                                                                                                       org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException,
                                                                                                                                                       org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
        Update the status for a specific entity.
        Specified by:
        updateEntityStatus in class OMRSMetadataCollection
        Parameters:
        userId - unique identifier for requesting user.
        entityGUID - unique identifier (guid) for the requested entity.
        newStatus - new InstanceStatus for the entity.
        Returns:
        EntityDetail showing the current entity header, properties and classifications.
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - one of the parameters is invalid or null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.EntityNotKnownException - the entity identified by the guid is not found in the metadata collection.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.StatusNotSupportedException - invalid status for instance.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException - the repository does not support maintenance of metadata.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
      • updateEntityProperties

        public org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.EntityDetail updateEntityProperties​(java.lang.String userId,
                                                                                                                                                           java.lang.String entityGUID,
                                                                                                                                                           org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceProperties properties)
                                                                                                                                                    throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                                                                                                                           org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                                                                                                                                           org.odpi.openmetadata.repositoryservices.ffdc.exception.EntityNotKnownException,
                                                                                                                                                           org.odpi.openmetadata.repositoryservices.ffdc.exception.PropertyErrorException,
                                                                                                                                                           org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException,
                                                                                                                                                           org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
        Update selected properties in an entity.
        Specified by:
        updateEntityProperties in class OMRSMetadataCollection
        Parameters:
        userId - unique identifier for requesting user.
        entityGUID - String unique identifier (guid) for the entity.
        properties - a list of properties to change.
        Returns:
        EntityDetail showing the resulting entity header, properties and classifications.
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - one of the parameters is invalid or null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.EntityNotKnownException - the entity identified by the guid is not found in the metadata collection
        org.odpi.openmetadata.repositoryservices.ffdc.exception.PropertyErrorException - one or more of the requested properties are not defined, or have different characteristics in the TypeDef for this entity's type
        org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException - the repository does not support maintenance of metadata.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
      • undoEntityUpdate

        public org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.EntityDetail undoEntityUpdate​(java.lang.String userId,
                                                                                                                                                     java.lang.String entityGUID)
                                                                                                                                              throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                                                                                                                     org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                                                                                                                                     org.odpi.openmetadata.repositoryservices.ffdc.exception.EntityNotKnownException,
                                                                                                                                                     org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException,
                                                                                                                                                     org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
        Undo the last update to an entity and return the previous content.
        Specified by:
        undoEntityUpdate in class OMRSMetadataCollection
        Parameters:
        userId - unique identifier for requesting user.
        entityGUID - String unique identifier (guid) for the entity.
        Returns:
        EntityDetail showing the resulting entity header, properties and classifications.
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - the guid is null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.EntityNotKnownException - the entity identified by the guid is not found in the metadata collection.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException - the repository does not support undo.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
      • deleteEntity

        public org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.EntityDetail deleteEntity​(java.lang.String userId,
                                                                                                                                                 java.lang.String typeDefGUID,
                                                                                                                                                 java.lang.String typeDefName,
                                                                                                                                                 java.lang.String obsoleteEntityGUID)
                                                                                                                                          throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                                                                                                                 org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                                                                                                                                 org.odpi.openmetadata.repositoryservices.ffdc.exception.EntityNotKnownException,
                                                                                                                                                 org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException,
                                                                                                                                                 org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
        Delete an entity. The entity is soft deleted. This means it is still in the graph but it is no longer returned on queries. All homed relationships to the entity are also soft-deleted and will no longer be usable, while any reference copy relationships to the entity will be purged (and will no longer be accessible in this repository). To completely eliminate the entity from the graph requires a call to the purgeEntity() method after the delete call. The restoreEntity() method will switch an entity back to Active status to restore the entity to normal use; however, this will not restore any of the relationships that were soft-deleted as part of the original deleteEntity() call.
        Specified by:
        deleteEntity in class OMRSMetadataCollection
        Parameters:
        userId - unique identifier for requesting user.
        typeDefGUID - unique identifier of the type of the entity to delete.
        typeDefName - unique name of the type of the entity to delete.
        obsoleteEntityGUID - String unique identifier (guid) for the entity.
        Returns:
        deleted entity
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - one of the parameters is invalid or null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.EntityNotKnownException - the entity identified by the guid is not found in the metadata collection.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException - the metadata repository hosting the metadata collection does not support soft-deletes (use purgeEntity() to remove the entity permanently).
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
      • purgeEntity

        public void purgeEntity​(java.lang.String userId,
                                java.lang.String typeDefGUID,
                                java.lang.String typeDefName,
                                java.lang.String deletedEntityGUID)
                         throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                org.odpi.openmetadata.repositoryservices.ffdc.exception.EntityNotKnownException,
                                org.odpi.openmetadata.repositoryservices.ffdc.exception.EntityNotDeletedException,
                                org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException,
                                org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
        Permanently removes a deleted entity from the metadata collection. All relationships to the entity -- both homed and reference copies -- will also be purged to maintain referential integrity within the repository. This request can not be undone.
        Specified by:
        purgeEntity in class OMRSMetadataCollection
        Parameters:
        userId - unique identifier for requesting user.
        typeDefGUID - unique identifier of the type of the entity to purge.
        typeDefName - unique name of the type of the entity to purge.
        deletedEntityGUID - String unique identifier (guid) for the entity.
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - one of the parameters is invalid or null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.EntityNotKnownException - the entity identified by the guid is not found in the metadata collection
        org.odpi.openmetadata.repositoryservices.ffdc.exception.EntityNotDeletedException - the entity is not in DELETED status and so can not be purged
        org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException - the repository does not support maintenance of metadata.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
      • restoreEntity

        public org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.EntityDetail restoreEntity​(java.lang.String userId,
                                                                                                                                                  java.lang.String deletedEntityGUID)
                                                                                                                                           throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                                                                                                                  org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                                                                                                                                  org.odpi.openmetadata.repositoryservices.ffdc.exception.EntityNotKnownException,
                                                                                                                                                  org.odpi.openmetadata.repositoryservices.ffdc.exception.EntityNotDeletedException,
                                                                                                                                                  org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException,
                                                                                                                                                  org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
        Restore the requested entity to the state it was before it was deleted.
        Specified by:
        restoreEntity in class OMRSMetadataCollection
        Parameters:
        userId - unique identifier for requesting user.
        deletedEntityGUID - String unique identifier (guid) for the entity.
        Returns:
        EntityDetail showing the restored entity header, properties and classifications.
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - the guid is null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.EntityNotKnownException - the entity identified by the guid is not found in the metadata collection
        org.odpi.openmetadata.repositoryservices.ffdc.exception.EntityNotDeletedException - the entity is currently not in DELETED status and so it can not be restored
        org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException - the repository does not support soft-deletes.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
      • classifyEntity

        public org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.EntityDetail classifyEntity​(java.lang.String userId,
                                                                                                                                                   java.lang.String entityGUID,
                                                                                                                                                   java.lang.String classificationName,
                                                                                                                                                   org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceProperties classificationProperties)
                                                                                                                                            throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                                                                                                                   org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                                                                                                                                   org.odpi.openmetadata.repositoryservices.ffdc.exception.EntityNotKnownException,
                                                                                                                                                   org.odpi.openmetadata.repositoryservices.ffdc.exception.ClassificationErrorException,
                                                                                                                                                   org.odpi.openmetadata.repositoryservices.ffdc.exception.PropertyErrorException,
                                                                                                                                                   org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException,
                                                                                                                                                   org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
        Add the requested classification to a specific entity.
        Specified by:
        classifyEntity in class OMRSMetadataCollection
        Parameters:
        userId - unique identifier for requesting user.
        entityGUID - String unique identifier (guid) for the entity.
        classificationName - String name for the classification.
        classificationProperties - list of properties to set in the classification.
        Returns:
        EntityDetail showing the resulting entity header, properties and classifications.
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - one of the parameters is invalid or null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.EntityNotKnownException - the entity identified by the guid is not found in the metadata collection
        org.odpi.openmetadata.repositoryservices.ffdc.exception.ClassificationErrorException - the requested classification is either not known or not valid for the entity.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.PropertyErrorException - one or more of the requested properties are not defined, or have different characteristics in the TypeDef for this classification type
        org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException - the repository does not support maintenance of metadata.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
      • classifyEntity

        public org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.EntityDetail classifyEntity​(java.lang.String userId,
                                                                                                                                                   java.lang.String entityGUID,
                                                                                                                                                   java.lang.String classificationName,
                                                                                                                                                   java.lang.String externalSourceGUID,
                                                                                                                                                   java.lang.String externalSourceName,
                                                                                                                                                   org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.ClassificationOrigin classificationOrigin,
                                                                                                                                                   java.lang.String classificationOriginGUID,
                                                                                                                                                   org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceProperties classificationProperties)
                                                                                                                                            throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                                                                                                                   org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                                                                                                                                   org.odpi.openmetadata.repositoryservices.ffdc.exception.EntityNotKnownException,
                                                                                                                                                   org.odpi.openmetadata.repositoryservices.ffdc.exception.ClassificationErrorException,
                                                                                                                                                   org.odpi.openmetadata.repositoryservices.ffdc.exception.PropertyErrorException,
                                                                                                                                                   org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException,
                                                                                                                                                   org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException
        Add the requested classification to a specific entity.
        Overrides:
        classifyEntity in class OMRSMetadataCollection
        Parameters:
        userId - unique identifier for requesting user.
        entityGUID - String unique identifier (guid) for the entity.
        classificationName - String name for the classification.
        externalSourceGUID - unique identifier (guid) for the external source.
        externalSourceName - unique name for the external source.
        classificationOrigin - source of the classification
        classificationOriginGUID - if the classification is propagated, this is the unique identifier of the entity where
        classificationProperties - list of properties to set in the classification.
        Returns:
        EntityDetail showing the resulting entity header, properties and classifications.
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - one of the parameters is invalid or null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.EntityNotKnownException - the entity identified by the guid is not found in the metadata collection
        org.odpi.openmetadata.repositoryservices.ffdc.exception.ClassificationErrorException - the requested classification is either not known or not valid for the entity.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.PropertyErrorException - one or more of the requested properties are not defined, or have different characteristics in the TypeDef for this classification type
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException - the repository does not support maintenance of metadata.
      • declassifyEntity

        public org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.EntityDetail declassifyEntity​(java.lang.String userId,
                                                                                                                                                     java.lang.String entityGUID,
                                                                                                                                                     java.lang.String classificationName)
                                                                                                                                              throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                                                                                                                     org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                                                                                                                                     org.odpi.openmetadata.repositoryservices.ffdc.exception.EntityNotKnownException,
                                                                                                                                                     org.odpi.openmetadata.repositoryservices.ffdc.exception.ClassificationErrorException,
                                                                                                                                                     org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException,
                                                                                                                                                     org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
        Remove a specific classification from an entity.
        Specified by:
        declassifyEntity in class OMRSMetadataCollection
        Parameters:
        userId - unique identifier for requesting user.
        entityGUID - String unique identifier (guid) for the entity.
        classificationName - String name for the classification.
        Returns:
        EntityDetail showing the resulting entity header, properties and classifications.
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - one of the parameters is invalid or null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.EntityNotKnownException - the entity identified by the guid is not found in the metadata collection
        org.odpi.openmetadata.repositoryservices.ffdc.exception.ClassificationErrorException - the requested classification is not set on the entity.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException - the repository does not support maintenance of metadata.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
      • updateEntityClassification

        public org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.EntityDetail updateEntityClassification​(java.lang.String userId,
                                                                                                                                                               java.lang.String entityGUID,
                                                                                                                                                               java.lang.String classificationName,
                                                                                                                                                               org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceProperties properties)
                                                                                                                                                        throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                                                                                                                               org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                                                                                                                                               org.odpi.openmetadata.repositoryservices.ffdc.exception.EntityNotKnownException,
                                                                                                                                                               org.odpi.openmetadata.repositoryservices.ffdc.exception.ClassificationErrorException,
                                                                                                                                                               org.odpi.openmetadata.repositoryservices.ffdc.exception.PropertyErrorException,
                                                                                                                                                               org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException,
                                                                                                                                                               org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
        Update one or more properties in one of an entity's classifications.
        Specified by:
        updateEntityClassification in class OMRSMetadataCollection
        Parameters:
        userId - unique identifier for requesting user.
        entityGUID - String unique identifier (guid) for the entity.
        classificationName - String name for the classification.
        properties - list of properties for the classification.
        Returns:
        EntityDetail showing the resulting entity header, properties and classifications.
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - one of the parameters is invalid or null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.EntityNotKnownException - the entity identified by the guid is not found in the metadata collection
        org.odpi.openmetadata.repositoryservices.ffdc.exception.ClassificationErrorException - the requested classification is not attached to the classification.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.PropertyErrorException - one or more of the requested properties are not defined, or have different characteristics in the TypeDef for this classification type
        org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException - the repository does not support maintenance of metadata.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
      • getEntityProxy

        protected org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.EntityProxy getEntityProxy​(java.lang.String userId,
                                                                                                                                                     java.lang.String entityGUID,
                                                                                                                                                     java.lang.String methodName)
                                                                                                                                              throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                                                                                                                     org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                                                                                                                                     org.odpi.openmetadata.repositoryservices.ffdc.exception.EntityNotKnownException,
                                                                                                                                                     org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
        Retrieve an entity proxy
        Parameters:
        userId - calling user
        entityGUID - entity guid
        methodName - calling method
        Returns:
        entity proxy
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - one of the parameters is null
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the remote repository
        org.odpi.openmetadata.repositoryservices.ffdc.exception.EntityNotKnownException - the guid is not recognised
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the calling user can not access this entity.
      • addRelationship

        public org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.Relationship addRelationship​(java.lang.String userId,
                                                                                                                                                    java.lang.String relationshipTypeGUID,
                                                                                                                                                    org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceProperties initialProperties,
                                                                                                                                                    java.lang.String entityOneGUID,
                                                                                                                                                    java.lang.String entityTwoGUID,
                                                                                                                                                    org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceStatus initialStatus)
                                                                                                                                             throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                                                                                                                    org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                                                                                                                                    org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeErrorException,
                                                                                                                                                    org.odpi.openmetadata.repositoryservices.ffdc.exception.PropertyErrorException,
                                                                                                                                                    org.odpi.openmetadata.repositoryservices.ffdc.exception.EntityNotKnownException,
                                                                                                                                                    org.odpi.openmetadata.repositoryservices.ffdc.exception.StatusNotSupportedException,
                                                                                                                                                    org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException,
                                                                                                                                                    org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
        Add a new relationship between two entities to the metadata collection.
        Specified by:
        addRelationship in class OMRSMetadataCollection
        Parameters:
        userId - unique identifier for requesting user.
        relationshipTypeGUID - unique identifier (guid) for the new relationship's type.
        initialProperties - initial list of properties for the new entity; null means no properties.
        entityOneGUID - the unique identifier of one of the entities that the relationship is connecting together.
        entityTwoGUID - the unique identifier of the other entity that the relationship is connecting together.
        initialStatus - initial status typically set to DRAFT, PREPARED or ACTIVE.
        Returns:
        Relationship structure with the new header, requested entities and properties.
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - one of the parameters is invalid or null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeErrorException - the requested type is not known, or not supported in the metadata repository hosting the metadata collection.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.PropertyErrorException - one or more of the requested properties are not defined, or have different characteristics in the TypeDef for this relationship's type.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.EntityNotKnownException - one of the requested entities is not known in the metadata collection.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.StatusNotSupportedException - the metadata repository hosting the metadata collection does not support the requested status.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException - the repository does not support maintenance of metadata.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
      • addExternalRelationship

        public org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.Relationship addExternalRelationship​(java.lang.String userId,
                                                                                                                                                            java.lang.String relationshipTypeGUID,
                                                                                                                                                            java.lang.String externalSourceGUID,
                                                                                                                                                            java.lang.String externalSourceName,
                                                                                                                                                            org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceProperties initialProperties,
                                                                                                                                                            java.lang.String entityOneGUID,
                                                                                                                                                            java.lang.String entityTwoGUID,
                                                                                                                                                            org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceStatus initialStatus)
                                                                                                                                                     throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                                                                                                                            org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                                                                                                                                            org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeErrorException,
                                                                                                                                                            org.odpi.openmetadata.repositoryservices.ffdc.exception.PropertyErrorException,
                                                                                                                                                            org.odpi.openmetadata.repositoryservices.ffdc.exception.EntityNotKnownException,
                                                                                                                                                            org.odpi.openmetadata.repositoryservices.ffdc.exception.StatusNotSupportedException,
                                                                                                                                                            org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException,
                                                                                                                                                            org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException
        Save a new relationship that is sourced from an external technology. The external technology is identified by a GUID and a name. These can be recorded in a Software Server Capability (guid and qualifiedName respectively. The new relationship is assigned a new GUID and put in the requested state. The new relationship is returned.
        Overrides:
        addExternalRelationship in class OMRSMetadataCollection
        Parameters:
        userId - unique identifier for requesting user.
        relationshipTypeGUID - unique identifier (guid) for the new relationship's type.
        externalSourceGUID - unique identifier (guid) for the external source.
        externalSourceName - unique name for the external source.
        initialProperties - initial list of properties for the new entity; null means no properties.
        entityOneGUID - the unique identifier of one of the entities that the relationship is connecting together.
        entityTwoGUID - the unique identifier of the other entity that the relationship is connecting together.
        initialStatus - initial status; typically DRAFT, PREPARED or ACTIVE.
        Returns:
        Relationship structure with the new header, requested entities and properties.
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - one of the parameters is invalid or null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeErrorException - the requested type is not known, or not supported in the metadata repository hosting the metadata collection.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.PropertyErrorException - one or more of the requested properties are not defined, or have different characteristics in the TypeDef for this relationship's type.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.EntityNotKnownException - one of the requested entities is not known in the metadata collection.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.StatusNotSupportedException - the metadata repository hosting the metadata collection does not support the requested status.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException - the repository does not support maintenance of metadata.
      • updateRelationshipStatus

        public org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.Relationship updateRelationshipStatus​(java.lang.String userId,
                                                                                                                                                             java.lang.String relationshipGUID,
                                                                                                                                                             org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceStatus newStatus)
                                                                                                                                                      throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                                                                                                                             org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                                                                                                                                             org.odpi.openmetadata.repositoryservices.ffdc.exception.RelationshipNotKnownException,
                                                                                                                                                             org.odpi.openmetadata.repositoryservices.ffdc.exception.StatusNotSupportedException,
                                                                                                                                                             org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException,
                                                                                                                                                             org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
        Update the status of a specific relationship.
        Specified by:
        updateRelationshipStatus in class OMRSMetadataCollection
        Parameters:
        userId - unique identifier for requesting user.
        relationshipGUID - String unique identifier (guid) for the relationship.
        newStatus - new InstanceStatus for the relationship.
        Returns:
        Resulting relationship structure with the new status set.
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - one of the parameters is invalid or null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RelationshipNotKnownException - the requested relationship is not known in the metadata collection.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.StatusNotSupportedException - invalid status for instance.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException - the repository does not support maintenance of metadata.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
      • updateRelationshipProperties

        public org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.Relationship updateRelationshipProperties​(java.lang.String userId,
                                                                                                                                                                 java.lang.String relationshipGUID,
                                                                                                                                                                 org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceProperties properties)
                                                                                                                                                          throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                                                                                                                                 org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                                                                                                                                                 org.odpi.openmetadata.repositoryservices.ffdc.exception.RelationshipNotKnownException,
                                                                                                                                                                 org.odpi.openmetadata.repositoryservices.ffdc.exception.PropertyErrorException,
                                                                                                                                                                 org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException,
                                                                                                                                                                 org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
        Update the properties of a specific relationship.
        Specified by:
        updateRelationshipProperties in class OMRSMetadataCollection
        Parameters:
        userId - unique identifier for requesting user.
        relationshipGUID - String unique identifier (guid) for the relationship.
        properties - list of the properties to update.
        Returns:
        Resulting relationship structure with the new properties set.
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - one of the parameters is invalid or null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RelationshipNotKnownException - the requested relationship is not known in the metadata collection.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.PropertyErrorException - one or more of the requested properties are not defined, or have different characteristics in the TypeDef for this relationship's type.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException - the repository does not support maintenance of metadata.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
      • undoRelationshipUpdate

        public org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.Relationship undoRelationshipUpdate​(java.lang.String userId,
                                                                                                                                                           java.lang.String relationshipGUID)
                                                                                                                                                    throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                                                                                                                           org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                                                                                                                                           org.odpi.openmetadata.repositoryservices.ffdc.exception.RelationshipNotKnownException,
                                                                                                                                                           org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException,
                                                                                                                                                           org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
        Undo the latest change to a relationship (either a change of properties or status).
        Specified by:
        undoRelationshipUpdate in class OMRSMetadataCollection
        Parameters:
        userId - unique identifier for requesting user.
        relationshipGUID - String unique identifier (guid) for the relationship.
        Returns:
        Relationship structure with the new current header, requested entities and properties.
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - the guid is null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RelationshipNotKnownException - the requested relationship is not known in the metadata collection.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException - the repository does not support undo.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
      • deleteRelationship

        public org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.Relationship deleteRelationship​(java.lang.String userId,
                                                                                                                                                       java.lang.String typeDefGUID,
                                                                                                                                                       java.lang.String typeDefName,
                                                                                                                                                       java.lang.String obsoleteRelationshipGUID)
                                                                                                                                                throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                                                                                                                       org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                                                                                                                                       org.odpi.openmetadata.repositoryservices.ffdc.exception.RelationshipNotKnownException,
                                                                                                                                                       org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException,
                                                                                                                                                       org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
        Delete a specific relationship. This is a soft-delete which means the relationship's status is updated to DELETED and it is no longer available for queries. To remove the relationship permanently from the metadata collection, use purgeRelationship().
        Specified by:
        deleteRelationship in class OMRSMetadataCollection
        Parameters:
        userId - unique identifier for requesting user.
        typeDefGUID - unique identifier of the type of the relationship to delete.
        typeDefName - unique name of the type of the relationship to delete.
        obsoleteRelationshipGUID - String unique identifier (guid) for the relationship.
        Returns:
        deleted relationship
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - one of the parameters is null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RelationshipNotKnownException - the requested relationship is not known in the metadata collection.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException - the metadata repository hosting the metadata collection does not support soft-deletes.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
      • purgeRelationship

        public void purgeRelationship​(java.lang.String userId,
                                      java.lang.String typeDefGUID,
                                      java.lang.String typeDefName,
                                      java.lang.String deletedRelationshipGUID)
                               throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                      org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                      org.odpi.openmetadata.repositoryservices.ffdc.exception.RelationshipNotKnownException,
                                      org.odpi.openmetadata.repositoryservices.ffdc.exception.RelationshipNotDeletedException,
                                      org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException,
                                      org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
        Permanently delete the relationship from the repository. There is no means to undo this request.
        Specified by:
        purgeRelationship in class OMRSMetadataCollection
        Parameters:
        userId - unique identifier for requesting user.
        typeDefGUID - unique identifier of the type of the relationship to purge.
        typeDefName - unique name of the type of the relationship to purge.
        deletedRelationshipGUID - String unique identifier (guid) for the relationship.
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - one of the parameters is null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RelationshipNotKnownException - the requested relationship is not known in the metadata collection.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RelationshipNotDeletedException - the requested relationship is not in DELETED status.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException - the repository does not support maintenance of metadata.
      • restoreRelationship

        public org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.Relationship restoreRelationship​(java.lang.String userId,
                                                                                                                                                        java.lang.String deletedRelationshipGUID)
                                                                                                                                                 throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                                                                                                                        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                                                                                                                                        org.odpi.openmetadata.repositoryservices.ffdc.exception.RelationshipNotKnownException,
                                                                                                                                                        org.odpi.openmetadata.repositoryservices.ffdc.exception.RelationshipNotDeletedException,
                                                                                                                                                        org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException,
                                                                                                                                                        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
        Restore a deleted relationship into the metadata collection. The new status will be ACTIVE and the restored details of the relationship are returned to the caller.
        Specified by:
        restoreRelationship in class OMRSMetadataCollection
        Parameters:
        userId - unique identifier for requesting user.
        deletedRelationshipGUID - String unique identifier (guid) for the relationship.
        Returns:
        Relationship structure with the restored header, requested entities and properties.
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - the guid is null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RelationshipNotKnownException - the requested relationship is not known in the metadata collection.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RelationshipNotDeletedException - the requested relationship is not in DELETED status.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException - the repository does not support soft-deletes.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
      • reIdentifyInstanceParameterValidation

        protected void reIdentifyInstanceParameterValidation​(java.lang.String userId,
                                                             java.lang.String typeDefGUID,
                                                             java.lang.String typeDefName,
                                                             java.lang.String instanceGUID,
                                                             java.lang.String instanceParameterName,
                                                             java.lang.String newInstanceGUID,
                                                             java.lang.String newInstanceParameterName,
                                                             java.lang.String methodName)
                                                      throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                             org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                                             org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
        Parameters:
        userId - unique identifier for requesting user.
        typeDefGUID - the guid of the TypeDef for the instance - used to verify the entity identity.
        typeDefName - the name of the TypeDef for the instance - used to verify the entity identity.
        instanceGUID - unique identifier of the instance
        instanceParameterName - name of original instance GUID parameter
        newInstanceGUID - new unique identifier for the instance
        newInstanceParameterName - name of new instance GUID's parameter
        methodName - calling method
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - one of the parameters is invalid or null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
      • reTypeInstanceParameterValidation

        protected void reTypeInstanceParameterValidation​(java.lang.String userId,
                                                         java.lang.String instanceGUID,
                                                         java.lang.String instanceParameterName,
                                                         org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDefCategory expectedTypeDefCategory,
                                                         org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDefSummary currentTypeDefSummary,
                                                         org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDefSummary newTypeDefSummary,
                                                         java.lang.String methodName)
                                                  throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                         org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                                         org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeErrorException
        Validate the parameters needed to reType an instance.
        Parameters:
        userId - unique identifier for requesting user.
        instanceGUID - unique identifier of the instance
        instanceParameterName - name of instance GUID parameter
        expectedTypeDefCategory - the category of the instance
        currentTypeDefSummary - the current type
        newTypeDefSummary - the new type
        methodName - calling method
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - one of the parameters is invalid or null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeErrorException - the requested type is not known, or not supported in the metadata repository hosting the metadata collection.
      • reHomeInstanceParameterValidation

        protected void reHomeInstanceParameterValidation​(java.lang.String userId,
                                                         java.lang.String instanceGUID,
                                                         java.lang.String instanceParameterName,
                                                         java.lang.String typeDefGUID,
                                                         java.lang.String typeDefName,
                                                         java.lang.String homeMetadataCollectionId,
                                                         java.lang.String newHomeMetadataCollectionId,
                                                         java.lang.String methodName)
                                                  throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                         org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException
        Validate that the parameters passed to a reHome request are valid.
        Parameters:
        userId - unique identifier for requesting user.
        instanceGUID - unique identifier of the instance
        instanceParameterName - name of instance GUID parameter
        typeDefGUID - unique identifier of type
        typeDefName - unique name of type
        homeMetadataCollectionId - existing home
        newHomeMetadataCollectionId - new home
        methodName - calling method
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - one of the parameters is invalid or null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository.
      • reIdentifyEntity

        public org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.EntityDetail reIdentifyEntity​(java.lang.String userId,
                                                                                                                                                     java.lang.String typeDefGUID,
                                                                                                                                                     java.lang.String typeDefName,
                                                                                                                                                     java.lang.String entityGUID,
                                                                                                                                                     java.lang.String newEntityGUID)
                                                                                                                                              throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                                                                                                                     org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                                                                                                                                     org.odpi.openmetadata.repositoryservices.ffdc.exception.EntityNotKnownException,
                                                                                                                                                     org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException,
                                                                                                                                                     org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
        Change the guid of an existing entity to a new value. This is used if two different entities are discovered to have the same guid. This is extremely unlikely but not impossible so the open metadata protocol has provision for this.
        Specified by:
        reIdentifyEntity in class OMRSMetadataCollection
        Parameters:
        userId - unique identifier for requesting user.
        typeDefGUID - the guid of the TypeDef for the entity - used to verify the entity identity.
        typeDefName - the name of the TypeDef for the entity - used to verify the entity identity.
        entityGUID - the existing identifier for the entity.
        newEntityGUID - new unique identifier for the entity.
        Returns:
        entity new values for this entity, including the new guid.
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - one of the parameters is invalid or null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.EntityNotKnownException - the entity identified by the guid is not found in the metadata collection.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException - the repository does not support the re-identification of instances.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
      • reTypeEntity

        public org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.EntityDetail reTypeEntity​(java.lang.String userId,
                                                                                                                                                 java.lang.String entityGUID,
                                                                                                                                                 org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDefSummary currentTypeDefSummary,
                                                                                                                                                 org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDefSummary newTypeDefSummary)
                                                                                                                                          throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                                                                                                                 org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                                                                                                                                 org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeErrorException,
                                                                                                                                                 org.odpi.openmetadata.repositoryservices.ffdc.exception.PropertyErrorException,
                                                                                                                                                 org.odpi.openmetadata.repositoryservices.ffdc.exception.ClassificationErrorException,
                                                                                                                                                 org.odpi.openmetadata.repositoryservices.ffdc.exception.EntityNotKnownException,
                                                                                                                                                 org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException,
                                                                                                                                                 org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
        Change the type of an existing entity. Typically this action is taken to move an entity's type to either a super type (so the subtype can be deleted) or a new subtype (so additional properties can be added.) However, the type can be changed to any compatible type and the properties adjusted.
        Specified by:
        reTypeEntity in class OMRSMetadataCollection
        Parameters:
        userId - unique identifier for requesting user.
        entityGUID - the unique identifier for the entity to change.
        currentTypeDefSummary - the current details of the TypeDef for the entity used to verify the entity identity
        newTypeDefSummary - details of this entity's new TypeDef.
        Returns:
        entity new values for this entity, including the new type information.
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - one of the parameters is invalid or null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeErrorException - the requested type is not known, or not supported in the metadata repository hosting the metadata collection.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.PropertyErrorException - The properties in the instance are incompatible with the requested type.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.ClassificationErrorException - the entity's classifications are not valid for the new type.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.EntityNotKnownException - the entity identified by the guid is not found in the metadata collection.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException - the repository does not support the re-typing of instances.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
      • reHomeEntity

        public org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.EntityDetail reHomeEntity​(java.lang.String userId,
                                                                                                                                                 java.lang.String entityGUID,
                                                                                                                                                 java.lang.String typeDefGUID,
                                                                                                                                                 java.lang.String typeDefName,
                                                                                                                                                 java.lang.String homeMetadataCollectionId,
                                                                                                                                                 java.lang.String newHomeMetadataCollectionId,
                                                                                                                                                 java.lang.String newHomeMetadataCollectionName)
                                                                                                                                          throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                                                                                                                 org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                                                                                                                                 org.odpi.openmetadata.repositoryservices.ffdc.exception.EntityNotKnownException,
                                                                                                                                                 org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException,
                                                                                                                                                 org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
        Change the home of an existing entity. This action is taken for example, if the original home repository becomes permanently unavailable, or if the user community updating this entity move to working from a different repository in the open metadata repository cohort.
        Overrides:
        reHomeEntity in class OMRSMetadataCollection
        Parameters:
        userId - unique identifier for requesting user.
        entityGUID - the unique identifier for the entity to change.
        typeDefGUID - the guid of the TypeDef for the entity used to verify the entity identity.
        typeDefName - the name of the TypeDef for the entity used to verify the entity identity.
        homeMetadataCollectionId - the existing identifier for this entity's home.
        newHomeMetadataCollectionId - unique identifier for the new home metadata collection/repository.
        newHomeMetadataCollectionName - display name for the new home metadata collection/repository.
        Returns:
        entity new values for this entity, including the new home information.
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - one of the parameters is invalid or null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.EntityNotKnownException - the entity identified by the guid is not found in the metadata collection.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException - the repository does not support the re-homing of instances.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
      • reIdentifyRelationship

        public org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.Relationship reIdentifyRelationship​(java.lang.String userId,
                                                                                                                                                           java.lang.String typeDefGUID,
                                                                                                                                                           java.lang.String typeDefName,
                                                                                                                                                           java.lang.String relationshipGUID,
                                                                                                                                                           java.lang.String newRelationshipGUID)
                                                                                                                                                    throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                                                                                                                           org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                                                                                                                                           org.odpi.openmetadata.repositoryservices.ffdc.exception.RelationshipNotKnownException,
                                                                                                                                                           org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException,
                                                                                                                                                           org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
        Change the guid of an existing relationship. This is used if two different relationships are discovered to have the same guid. This is extremely unlikely but not impossible so the open metadata protocol has provision for this.
        Specified by:
        reIdentifyRelationship in class OMRSMetadataCollection
        Parameters:
        userId - unique identifier for requesting user.
        typeDefGUID - the guid of the TypeDef for the relationship used to verify the relationship identity.
        typeDefName - the name of the TypeDef for the relationship used to verify the relationship identity.
        relationshipGUID - the existing identifier for the relationship.
        newRelationshipGUID - the new unique identifier for the relationship.
        Returns:
        relationship new values for this relationship, including the new guid.
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - one of the parameters is invalid or null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RelationshipNotKnownException - the relationship identified by the guid is not found in the metadata collection.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException - the repository does not support the re-identification of instances.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
      • reTypeRelationship

        public org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.Relationship reTypeRelationship​(java.lang.String userId,
                                                                                                                                                       java.lang.String relationshipGUID,
                                                                                                                                                       org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDefSummary currentTypeDefSummary,
                                                                                                                                                       org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDefSummary newTypeDefSummary)
                                                                                                                                                throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                                                                                                                       org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                                                                                                                                       org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeErrorException,
                                                                                                                                                       org.odpi.openmetadata.repositoryservices.ffdc.exception.PropertyErrorException,
                                                                                                                                                       org.odpi.openmetadata.repositoryservices.ffdc.exception.RelationshipNotKnownException,
                                                                                                                                                       org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException,
                                                                                                                                                       org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
        Change the type of an existing relationship. Typically this action is taken to move a relationship's type to either a super type (so the subtype can be deleted) or a new subtype (so additional properties can be added.) However, the type can be changed to any compatible type.
        Specified by:
        reTypeRelationship in class OMRSMetadataCollection
        Parameters:
        userId - unique identifier for requesting user.
        relationshipGUID - the unique identifier for the relationship.
        currentTypeDefSummary - the details of the TypeDef for the relationship used to verify the relationship identity.
        newTypeDefSummary - details of this relationship's new TypeDef.
        Returns:
        relationship new values for this relationship, including the new type information.
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - one of the parameters is invalid or null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeErrorException - the requested type is not known, or not supported in the metadata repository hosting the metadata collection.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.PropertyErrorException - The properties in the instance are incompatible with the requested type.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RelationshipNotKnownException - the relationship identified by the guid is not found in the metadata collection.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException - the repository does not support the re-typing of instances.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
      • reHomeRelationship

        public org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.Relationship reHomeRelationship​(java.lang.String userId,
                                                                                                                                                       java.lang.String relationshipGUID,
                                                                                                                                                       java.lang.String typeDefGUID,
                                                                                                                                                       java.lang.String typeDefName,
                                                                                                                                                       java.lang.String homeMetadataCollectionId,
                                                                                                                                                       java.lang.String newHomeMetadataCollectionId,
                                                                                                                                                       java.lang.String newHomeMetadataCollectionName)
                                                                                                                                                throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                                                                                                                       org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                                                                                                                                       org.odpi.openmetadata.repositoryservices.ffdc.exception.RelationshipNotKnownException,
                                                                                                                                                       org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException,
                                                                                                                                                       org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
        Change the home of an existing relationship. This action is taken for example, if the original home repository becomes permanently unavailable, or if the user community updating this relationship move to working from a different repository in the open metadata repository cohort.
        Overrides:
        reHomeRelationship in class OMRSMetadataCollection
        Parameters:
        userId - unique identifier for requesting user.
        relationshipGUID - the unique identifier for the relationship.
        typeDefGUID - the guid of the TypeDef for the relationship used to verify the relationship identity.
        typeDefName - the name of the TypeDef for the relationship used to verify the relationship identity.
        homeMetadataCollectionId - the existing identifier for this relationship's home.
        newHomeMetadataCollectionId - unique identifier for the new home metadata collection/repository.
        newHomeMetadataCollectionName - display name for the new home metadata collection/repository.
        Returns:
        relationship new values for this relationship, including the new home information.
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - one of the parameters is invalid or null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RelationshipNotKnownException - the relationship identified by the guid is not found in the metadata collection.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException - the repository does not support the re-homing of instances.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
      • manageReferenceInstanceParameterValidation

        protected void manageReferenceInstanceParameterValidation​(java.lang.String userId,
                                                                  java.lang.String typeDefGUID,
                                                                  java.lang.String typeDefName,
                                                                  java.lang.String instanceGUID,
                                                                  java.lang.String instanceGUIDParameterName,
                                                                  java.lang.String homeMetadataCollectionId,
                                                                  java.lang.String homeParameterName,
                                                                  java.lang.String methodName)
                                                           throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                                  org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                                                  org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
        Validate the parameters passed to a reference instance method.
        Parameters:
        userId - unique identifier for requesting user.
        typeDefGUID - unique identifier of the type of the instance to delete.
        typeDefName - unique name of the type of the instance to delete.
        instanceGUID - String unique identifier (guid) for the instance.
        instanceGUIDParameterName - name of parameter for instance's GUID
        homeMetadataCollectionId - identifier of the metadata collection that is the home to this instance.
        homeParameterName - name of homeMetadataCollectionId parameter
        methodName - calling method
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - one of the parameters is invalid or null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
      • referenceInstanceParameterValidation

        protected void referenceInstanceParameterValidation​(java.lang.String userId,
                                                            org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceHeader instanceHeader,
                                                            java.lang.String instanceParameterName,
                                                            java.lang.String methodName)
                                                     throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                            org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                                            org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
        Validate the header instance passed to a delete or purge instance method.
        Parameters:
        userId - unique identifier for requesting user.
        instanceHeader - header for the instance.
        instanceParameterName - name of parameter for instance's GUID
        methodName - calling method
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - one of the parameters is invalid or null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
      • saveEntityReferenceCopy

        public void saveEntityReferenceCopy​(java.lang.String userId,
                                            org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.EntityDetail entity)
                                     throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                            org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                            org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeErrorException,
                                            org.odpi.openmetadata.repositoryservices.ffdc.exception.PropertyErrorException,
                                            org.odpi.openmetadata.repositoryservices.ffdc.exception.HomeEntityException,
                                            org.odpi.openmetadata.repositoryservices.ffdc.exception.EntityConflictException,
                                            org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidEntityException,
                                            org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException,
                                            org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
        Save the entity as a reference copy. The id of the home metadata collection is already set up in the entity.
        Specified by:
        saveEntityReferenceCopy in class OMRSMetadataCollection
        Parameters:
        userId - unique identifier for requesting server.
        entity - details of the entity to save.
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - the entity is null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeErrorException - the requested type is not known, or not supported in the metadata repository hosting the metadata collection.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.PropertyErrorException - one or more of the requested properties are not defined, or have different characteristics in the TypeDef for this entity's type.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.HomeEntityException - the entity belongs to the local repository so creating a reference copy would be invalid.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.EntityConflictException - the new entity conflicts with an existing entity.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidEntityException - the new entity has invalid contents.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException - the repository does not support reference copies of instances.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
      • getHomeClassifications

        public java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.Classification> getHomeClassifications​(java.lang.String userId,
                                                                                                                                                                             java.lang.String entityGUID)
                                                                                                                                                                      throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                                                                                                                                             org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                                                                                                                                                             org.odpi.openmetadata.repositoryservices.ffdc.exception.EntityNotKnownException,
                                                                                                                                                                             org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException,
                                                                                                                                                                             org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException
        Retrieve any locally homed classifications assigned to the requested entity. This method is implemented by repository connectors that are able to store classifications for entities that are homed in another repository.
        Overrides:
        getHomeClassifications in class OMRSMetadataCollection
        Parameters:
        userId - unique identifier for requesting user.
        entityGUID - unique identifier of the entity with classifications to retrieve
        Returns:
        list of all the classifications for this entity that are homed in this repository
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - the entity is null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.EntityNotKnownException - the entity is not recognized by this repository
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - to calling user is not authorized to retrieve this metadata
        org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException - this method is not supported
      • getHomeClassifications

        public java.util.List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.Classification> getHomeClassifications​(java.lang.String userId,
                                                                                                                                                                             java.lang.String entityGUID,
                                                                                                                                                                             java.util.Date asOfTime)
                                                                                                                                                                      throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                                                                                                                                             org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                                                                                                                                                             org.odpi.openmetadata.repositoryservices.ffdc.exception.EntityNotKnownException,
                                                                                                                                                                             org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException,
                                                                                                                                                                             org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException
        Retrieve any locally homed classifications assigned to the requested entity. This method is implemented by repository connectors that are able to store classifications for entities that are homed in another repository.
        Overrides:
        getHomeClassifications in class OMRSMetadataCollection
        Parameters:
        userId - unique identifier for requesting user.
        entityGUID - unique identifier of the entity with classifications to retrieve
        asOfTime - the time used to determine which version of the entity that is desired.
        Returns:
        list of all the classifications for this entity that are homed in this repository
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - the entity is null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.EntityNotKnownException - the entity is not recognized by this repository
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - to calling user is not authorized to retrieve this metadata
        org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException - this method is not supported
      • deleteEntityReferenceCopy

        public void deleteEntityReferenceCopy​(java.lang.String userId,
                                              org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.EntityDetail entity)
                                       throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                              org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                              org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeErrorException,
                                              org.odpi.openmetadata.repositoryservices.ffdc.exception.PropertyErrorException,
                                              org.odpi.openmetadata.repositoryservices.ffdc.exception.HomeEntityException,
                                              org.odpi.openmetadata.repositoryservices.ffdc.exception.EntityConflictException,
                                              org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidEntityException,
                                              org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException,
                                              org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
        Remove a reference copy of the entity from the local repository. This method can be used to remove reference copies from the local cohort, repositories that have left the cohort, or entities that have come from open metadata archives. It is also an opportunity to remove or soft delete relationships attached to the entity
        Overrides:
        deleteEntityReferenceCopy in class OMRSMetadataCollection
        Parameters:
        userId - unique identifier for requesting server.
        entity - details of the entity to purge.
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - the entity is null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeErrorException - the requested type is not known, or not supported in the metadata repository hosting the metadata collection.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.PropertyErrorException - one or more of the requested properties are not defined, or have different characteristics in the TypeDef for this entity's type.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.HomeEntityException - the entity belongs to the local repository so creating a reference copy would be invalid.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.EntityConflictException - the new entity conflicts with an existing entity.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidEntityException - the new entity has invalid contents.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException - the repository does not support reference copies of instances.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
      • purgeEntityReferenceCopy

        public void purgeEntityReferenceCopy​(java.lang.String userId,
                                             org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.EntityDetail entity)
                                      throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                             org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                             org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeErrorException,
                                             org.odpi.openmetadata.repositoryservices.ffdc.exception.PropertyErrorException,
                                             org.odpi.openmetadata.repositoryservices.ffdc.exception.HomeEntityException,
                                             org.odpi.openmetadata.repositoryservices.ffdc.exception.EntityConflictException,
                                             org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidEntityException,
                                             org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException,
                                             org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
        Remove a reference copy of the entity from the local repository. This method can be used to remove reference copies from the local cohort, repositories that have left the cohort, or entities that have come from open metadata archives. It is also an opportunity to remove or soft delete relationships attached to the entity
        Overrides:
        purgeEntityReferenceCopy in class OMRSMetadataCollection
        Parameters:
        userId - unique identifier for requesting server.
        entity - details of the entity to purge.
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - the entity is null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeErrorException - the requested type is not known, or not supported in the metadata repository hosting the metadata collection.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.PropertyErrorException - one or more of the requested properties are not defined, or have different characteristics in the TypeDef for this entity's type.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.HomeEntityException - the entity belongs to the local repository so creating a reference copy would be invalid.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.EntityConflictException - the new entity conflicts with an existing entity.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidEntityException - the new entity has invalid contents.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException - the repository does not support reference copies of instances.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
      • purgeEntityReferenceCopy

        public void purgeEntityReferenceCopy​(java.lang.String userId,
                                             java.lang.String entityGUID,
                                             java.lang.String typeDefGUID,
                                             java.lang.String typeDefName,
                                             java.lang.String homeMetadataCollectionId)
                                      throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                             org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                             org.odpi.openmetadata.repositoryservices.ffdc.exception.EntityNotKnownException,
                                             org.odpi.openmetadata.repositoryservices.ffdc.exception.HomeEntityException,
                                             org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException,
                                             org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
        Remove a reference copy of the entity from the local repository. This method can be used to remove reference copies from the local cohort, repositories that have left the cohort, or entities that have come from open metadata archives.
        Specified by:
        purgeEntityReferenceCopy in class OMRSMetadataCollection
        Parameters:
        userId - unique identifier for requesting server.
        entityGUID - the unique identifier for the entity.
        typeDefGUID - the guid of the TypeDef for the relationship used to verify the relationship identity.
        typeDefName - the name of the TypeDef for the relationship used to verify the relationship identity.
        homeMetadataCollectionId - identifier of the metadata collection that is the home to this entity.
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - one of the parameters is invalid or null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.EntityNotKnownException - the entity identified by the guid is either a proxy or not found in the metadata collection.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.HomeEntityException - the entity belongs to the local repository so creating a reference copy would be invalid.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException - the repository does not support reference copies of instances.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
      • refreshEntityReferenceCopy

        public void refreshEntityReferenceCopy​(java.lang.String userId,
                                               java.lang.String entityGUID,
                                               java.lang.String typeDefGUID,
                                               java.lang.String typeDefName,
                                               java.lang.String homeMetadataCollectionId)
                                        throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                               org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                               org.odpi.openmetadata.repositoryservices.ffdc.exception.EntityNotKnownException,
                                               org.odpi.openmetadata.repositoryservices.ffdc.exception.HomeEntityException,
                                               org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException,
                                               org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
        The local repository has requested that the repository that hosts the home metadata collection for the specified entity sends out the details of this entity so the local repository can create a reference copy.
        Specified by:
        refreshEntityReferenceCopy in class OMRSMetadataCollection
        Parameters:
        userId - unique identifier for requesting server.
        entityGUID - unique identifier of requested entity.
        typeDefGUID - unique identifier of requested entity's TypeDef.
        typeDefName - unique name of requested entity's TypeDef.
        homeMetadataCollectionId - identifier of the metadata collection that is the home to this entity.
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - one of the parameters is invalid or null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.EntityNotKnownException - the entity identified by the guid is not found in the metadata collection.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.HomeEntityException - the entity belongs to the local repository so creating a reference copy would be invalid.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException - the repository does not support reference copies of instances.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
      • saveClassificationReferenceCopy

        public void saveClassificationReferenceCopy​(java.lang.String userId,
                                                    org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.EntityDetail entity,
                                                    org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.Classification classification)
                                             throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                    org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                                    org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeErrorException,
                                                    org.odpi.openmetadata.repositoryservices.ffdc.exception.EntityConflictException,
                                                    org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidEntityException,
                                                    org.odpi.openmetadata.repositoryservices.ffdc.exception.PropertyErrorException,
                                                    org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException,
                                                    org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException
        Save the classification as a reference copy. The id of the home metadata collection is already set up in the classification. The entity may be either a locally homed entity or a reference copy.
        Overrides:
        saveClassificationReferenceCopy in class OMRSMetadataCollection
        Parameters:
        userId - unique identifier for requesting user.
        entity - entity that the classification is attached to.
        classification - classification to save.
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - one of the parameters is invalid or null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.PropertyErrorException - one or more of the requested properties are not defined, or have different characteristics in the TypeDef for this classification type.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException - the repository does not support maintenance of metadata.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeErrorException - the requested type is not known, or not supported in the metadata repository hosting the metadata collection.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.EntityConflictException - the new entity conflicts with an existing entity.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidEntityException - the new entity has invalid contents.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException - the repository does not support reference copies of instances.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
      • saveClassificationReferenceCopy

        public void saveClassificationReferenceCopy​(java.lang.String userId,
                                                    org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.EntityProxy entity,
                                                    org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.Classification classification)
                                             throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                    org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                                    org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeErrorException,
                                                    org.odpi.openmetadata.repositoryservices.ffdc.exception.EntityConflictException,
                                                    org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidEntityException,
                                                    org.odpi.openmetadata.repositoryservices.ffdc.exception.PropertyErrorException,
                                                    org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException,
                                                    org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException
        Save the classification as a reference copy. The id of the home metadata collection is already set up in the classification. The entity may be either a locally homed entity or a reference copy.
        Overrides:
        saveClassificationReferenceCopy in class OMRSMetadataCollection
        Parameters:
        userId - unique identifier for requesting user.
        entity - entity that the classification is attached to.
        classification - classification to save.
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - one of the parameters is invalid or null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.PropertyErrorException - one or more of the requested properties are not defined, or have different characteristics in the TypeDef for this classification type.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException - the repository does not support maintenance of metadata.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeErrorException - the requested type is not known, or not supported in the metadata repository hosting the metadata collection.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.EntityConflictException - the new entity conflicts with an existing entity.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidEntityException - the new entity has invalid contents.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException - the repository does not support reference copies of instances.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
      • purgeClassificationReferenceCopy

        public void purgeClassificationReferenceCopy​(java.lang.String userId,
                                                     org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.EntityDetail entity,
                                                     org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.Classification classification)
                                              throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                     org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeErrorException,
                                                     org.odpi.openmetadata.repositoryservices.ffdc.exception.PropertyErrorException,
                                                     org.odpi.openmetadata.repositoryservices.ffdc.exception.EntityConflictException,
                                                     org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidEntityException,
                                                     org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                                     org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException,
                                                     org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException
        Remove the reference copy of the classification from the local repository. This method can be used to remove reference copies from the local cohort, repositories that have left the cohort, or relationships that have come from open metadata archives.
        Overrides:
        purgeClassificationReferenceCopy in class OMRSMetadataCollection
        Parameters:
        userId - unique identifier for requesting user.
        entity - entity that the classification is attached to.
        classification - classification to purge.
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - one of the parameters is invalid or null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.PropertyErrorException - one or more of the requested properties are not defined, or have different characteristics in the TypeDef for this classification type.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeErrorException - the requested type is not known, or not supported in the metadata repository hosting the metadata collection.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.EntityConflictException - the new entity conflicts with an existing entity.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidEntityException - the new entity has invalid contents.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException - the repository does not support maintenance of metadata.
      • saveRelationshipReferenceCopy

        public void saveRelationshipReferenceCopy​(java.lang.String userId,
                                                  org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.Relationship relationship)
                                           throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                  org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                                  org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeErrorException,
                                                  org.odpi.openmetadata.repositoryservices.ffdc.exception.EntityNotKnownException,
                                                  org.odpi.openmetadata.repositoryservices.ffdc.exception.PropertyErrorException,
                                                  org.odpi.openmetadata.repositoryservices.ffdc.exception.HomeRelationshipException,
                                                  org.odpi.openmetadata.repositoryservices.ffdc.exception.RelationshipConflictException,
                                                  org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidRelationshipException,
                                                  org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException,
                                                  org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
        Save the relationship as a reference copy. The id of the home metadata collection is already set up in the relationship.
        Specified by:
        saveRelationshipReferenceCopy in class OMRSMetadataCollection
        Parameters:
        userId - unique identifier for requesting server.
        relationship - relationship to save.
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - the relationship is null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeErrorException - the requested type is not known, or not supported in the metadata repository hosting the metadata collection.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.EntityNotKnownException - one of the entities identified by the relationship is not found in the metadata collection.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.PropertyErrorException - one or more of the requested properties are not defined, or have different characteristics in the TypeDef for this relationship's type.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.HomeRelationshipException - the relationship belongs to the local repository so creating a reference copy would be invalid.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RelationshipConflictException - the new relationship conflicts with an existing relationship.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidRelationshipException - the new relationship has invalid contents.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException - the repository does not support reference copies of instances.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
      • deleteRelationshipReferenceCopy

        public void deleteRelationshipReferenceCopy​(java.lang.String userId,
                                                    org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.Relationship relationship)
                                             throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                    org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                                    org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeErrorException,
                                                    org.odpi.openmetadata.repositoryservices.ffdc.exception.EntityNotKnownException,
                                                    org.odpi.openmetadata.repositoryservices.ffdc.exception.PropertyErrorException,
                                                    org.odpi.openmetadata.repositoryservices.ffdc.exception.HomeRelationshipException,
                                                    org.odpi.openmetadata.repositoryservices.ffdc.exception.RelationshipConflictException,
                                                    org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidRelationshipException,
                                                    org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException,
                                                    org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
        Remove the reference copy of the relationship from the local repository. This method can be used to remove reference copies from the local cohort, repositories that have left the cohort, or relationships that have come from open metadata archives.
        Overrides:
        deleteRelationshipReferenceCopy in class OMRSMetadataCollection
        Parameters:
        userId - unique identifier for requesting server.
        relationship - relationship to purge.
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - the relationship is null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeErrorException - the requested type is not known, or not supported in the metadata repository hosting the metadata collection.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.EntityNotKnownException - one of the entities identified by the relationship is not found in the metadata collection.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.PropertyErrorException - one or more of the requested properties are not defined, or have different characteristics in the TypeDef for this relationship's type.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.HomeRelationshipException - the relationship belongs to the local repository so creating a reference copy would be invalid.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RelationshipConflictException - the new relationship conflicts with an existing relationship.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidRelationshipException - the new relationship has invalid contents.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException - the repository does not support reference copies of instances.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
      • purgeRelationshipReferenceCopy

        public void purgeRelationshipReferenceCopy​(java.lang.String userId,
                                                   org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.Relationship relationship)
                                            throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                   org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                                   org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeErrorException,
                                                   org.odpi.openmetadata.repositoryservices.ffdc.exception.EntityNotKnownException,
                                                   org.odpi.openmetadata.repositoryservices.ffdc.exception.PropertyErrorException,
                                                   org.odpi.openmetadata.repositoryservices.ffdc.exception.HomeRelationshipException,
                                                   org.odpi.openmetadata.repositoryservices.ffdc.exception.RelationshipConflictException,
                                                   org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidRelationshipException,
                                                   org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException,
                                                   org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
        Remove the reference copy of the relationship from the local repository. This method can be used to remove reference copies from the local cohort, repositories that have left the cohort, or relationships that have come from open metadata archives.
        Overrides:
        purgeRelationshipReferenceCopy in class OMRSMetadataCollection
        Parameters:
        userId - unique identifier for requesting server.
        relationship - relationship to purge.
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - the relationship is null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeErrorException - the requested type is not known, or not supported in the metadata repository hosting the metadata collection.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.EntityNotKnownException - one of the entities identified by the relationship is not found in the metadata collection.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.PropertyErrorException - one or more of the requested properties are not defined, or have different characteristics in the TypeDef for this relationship's type.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.HomeRelationshipException - the relationship belongs to the local repository so creating a reference copy would be invalid.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RelationshipConflictException - the new relationship conflicts with an existing relationship.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidRelationshipException - the new relationship has invalid contents.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException - the repository does not support reference copies of instances.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
      • purgeRelationshipReferenceCopy

        public void purgeRelationshipReferenceCopy​(java.lang.String userId,
                                                   java.lang.String relationshipGUID,
                                                   java.lang.String typeDefGUID,
                                                   java.lang.String typeDefName,
                                                   java.lang.String homeMetadataCollectionId)
                                            throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                   org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                                   org.odpi.openmetadata.repositoryservices.ffdc.exception.RelationshipNotKnownException,
                                                   org.odpi.openmetadata.repositoryservices.ffdc.exception.HomeRelationshipException,
                                                   org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException,
                                                   org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
        Remove the reference copy of the relationship from the local repository. This method can be used to remove reference copies from the local cohort, repositories that have left the cohort, or relationships that have come from open metadata archives.
        Specified by:
        purgeRelationshipReferenceCopy in class OMRSMetadataCollection
        Parameters:
        userId - unique identifier for requesting server.
        relationshipGUID - the unique identifier for the relationship.
        typeDefGUID - the guid of the TypeDef for the relationship used to verify the relationship identity.
        typeDefName - the name of the TypeDef for the relationship used to verify the relationship identity.
        homeMetadataCollectionId - unique identifier for the home repository for this relationship.
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - one of the parameters is invalid or null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RelationshipNotKnownException - the relationship is not know in the metadata collection.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.HomeRelationshipException - the relationship belongs to the local repository so creating a reference copy would be invalid.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException - the repository does not support reference copies of instances.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
      • refreshRelationshipReferenceCopy

        public void refreshRelationshipReferenceCopy​(java.lang.String userId,
                                                     java.lang.String relationshipGUID,
                                                     java.lang.String typeDefGUID,
                                                     java.lang.String typeDefName,
                                                     java.lang.String homeMetadataCollectionId)
                                              throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException,
                                                     org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException,
                                                     org.odpi.openmetadata.repositoryservices.ffdc.exception.RelationshipNotKnownException,
                                                     org.odpi.openmetadata.repositoryservices.ffdc.exception.HomeRelationshipException,
                                                     org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException,
                                                     org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
        The local server has requested that the repository that hosts the home metadata collection for the specified relationship sends out the details of this relationship so the local repository can create a reference copy.
        Specified by:
        refreshRelationshipReferenceCopy in class OMRSMetadataCollection
        Parameters:
        userId - unique identifier for requesting server.
        relationshipGUID - unique identifier of the relationship.
        typeDefGUID - the guid of the TypeDef for the relationship used to verify the relationship identity.
        typeDefName - the name of the TypeDef for the relationship used to verify the relationship identity.
        homeMetadataCollectionId - unique identifier for the home repository for this relationship.
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - one of the parameters is invalid or null.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - there is a problem communicating with the metadata repository where the metadata collection is stored.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RelationshipNotKnownException - the relationship identifier is not recognized.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.HomeRelationshipException - the relationship belongs to the local repository so creating a reference copy would be invalid.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException - the repository does not support reference copies of instances.
        org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.
      • getTypeDefForInstance

        protected org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDef getTypeDefForInstance​(org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceHeader header,
                                                                                                                                                       java.lang.String methodName)
                                                                                                                                                throws org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException
        Extract the typeDef for an instance
        Parameters:
        header - this is the header of the instance
        methodName - calling method
        Returns:
        TypeDef
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - logic error - this call should not fail
      • reportUnsupportedAsOfTimeFunction

        protected void reportUnsupportedAsOfTimeFunction​(java.lang.String methodName,
                                                         java.util.Date asOfTime)
                                                  throws org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException,
                                                         org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException
        Return an exception to indicate that the method is unsupported but this is ok because it is optional.
        Parameters:
        methodName - calling method
        asOfTime - time warp value
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.FunctionNotSupportedException - optional function not supported
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException - mandatory function not supported
      • reportUnknownTypeGUID

        protected void reportUnknownTypeGUID​(java.lang.String guid,
                                             java.lang.String guidParameterName,
                                             java.lang.String methodName)
                                      throws org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeDefNotKnownException
        Throw exception to indicate that a type unique identifier is not recognized.
        Parameters:
        guid - guid of type
        guidParameterName - parameter that the guid was passed in on
        methodName - calling method
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeDefNotKnownException - unknown type definition
      • reportUnknownTypeName

        protected void reportUnknownTypeName​(java.lang.String name,
                                             java.lang.String methodName)
                                      throws org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeDefNotKnownException
        Throw exception to indicate that a type unique identifier is not recognized.
        Parameters:
        name - name of type
        methodName - calling method
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeDefNotKnownException - unknown type definition
      • reportEntityNotKnown

        protected void reportEntityNotKnown​(java.lang.String entityGUID,
                                            java.lang.String methodName)
                                     throws org.odpi.openmetadata.repositoryservices.ffdc.exception.EntityNotKnownException
        Throw exception to indicate that an entity unique identifier is not recognized.
        Parameters:
        entityGUID - unknown unique identifier
        methodName - calling method
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.EntityNotKnownException - unknown entity
      • reportRelationshipNotKnown

        protected void reportRelationshipNotKnown​(java.lang.String relationshipGUID,
                                                  java.lang.String methodName)
                                           throws org.odpi.openmetadata.repositoryservices.ffdc.exception.RelationshipNotKnownException
        Throw exception to indicate that a relationship unique identifier is not recognized.
        Parameters:
        relationshipGUID - unknown unique identifier
        methodName - calling method
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.RelationshipNotKnownException - unknown relationship
      • reportTypeDefNotSupported

        protected void reportTypeDefNotSupported​(java.lang.String typeName,
                                                 java.lang.String methodName)
                                          throws org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeDefNotSupportedException
        Throw exception to indicate that a relationship unique identifier is not recognized.
        Parameters:
        typeName - type name not supported
        methodName - calling method
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeDefNotSupportedException - unsupported type
      • reportTypeDefAlreadyDefined

        protected void reportTypeDefAlreadyDefined​(java.lang.String typeGUID,
                                                   java.lang.String typeName,
                                                   java.lang.String methodName)
                                            throws org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeDefKnownException
        Report that the type can not be created because it is already defined.
        Parameters:
        typeGUID - unique identifier of type
        typeName - unique name of type
        methodName - calling method
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeDefKnownException - the type is already defined.
      • reportTypeDefConflict

        protected void reportTypeDefConflict​(java.lang.String typeGUID,
                                             java.lang.String typeName,
                                             java.lang.String methodName)
                                      throws org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeDefConflictException
        Report a type conflict error.
        Parameters:
        typeGUID - unique identifier of type
        typeName - unique name of type
        methodName - calling method
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeDefConflictException - more than one definitions for the same type name/guid
      • reportTypeDefInUse

        protected void reportTypeDefInUse​(java.lang.String typeGUID,
                                          java.lang.String typeName,
                                          java.lang.String methodName)
                                   throws org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeDefInUseException
        Report that a type can not be deleted.
        Parameters:
        typeGUID - unique identifier of type
        typeName - unique name of type
        methodName - calling method
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.TypeDefInUseException - type in use
      • reportEntityProxyOnly

        protected void reportEntityProxyOnly​(java.lang.String guid,
                                             java.lang.String guidParameterName,
                                             java.lang.String methodName)
                                      throws org.odpi.openmetadata.repositoryservices.ffdc.exception.EntityProxyOnlyException
        Throw an exception for the situation where there is only a proxy and the caller wants an entity details.
        Parameters:
        guid - unique identity of the entity
        guidParameterName - parameter name of the entity guid
        methodName - calling method
        Throws:
        org.odpi.openmetadata.repositoryservices.ffdc.exception.EntityProxyOnlyException - only a proxy