Package org.odpi.openmetadata.engineservices.repositorygovernance.handlers

Class RepositoryGovernanceServiceContext

java.lang.Object
org.odpi.openmetadata.engineservices.repositorygovernance.connector.RepositoryGovernanceContext
org.odpi.openmetadata.engineservices.repositorygovernance.handlers.RepositoryGovernanceServiceContext
public class RepositoryGovernanceServiceContext extends org.odpi.openmetadata.engineservices.repositorygovernance.connector.RepositoryGovernanceContext
RepositoryGovernanceContext provides the archive service with access to information about the archive request along with the open metadata repository interfaces.

  • Constructor Summary

    Constructors
    Constructor
    Description
    RepositoryGovernanceServiceContext(String userId, String repositoryGovernanceServiceName, String requestType, Map<String,String> requestParameters, List<org.odpi.openmetadata.frameworks.governanceaction.properties.RequestSourceElement> requestSourceElements, List<org.odpi.openmetadata.frameworks.governanceaction.properties.ActionTargetElement> actionTargetElements, org.odpi.openmetadata.repositoryservices.clients.EnterpriseRepositoryServicesClient repositoryServicesClient)
    Constructor sets up the key parameters for processing the request to the repository governance service.

  • Method Summary

    Modifier and Type
    Method
    Description
    void
    disconnectFromEnterpriseTopic()
    Disconnect from the topic connector - events will no longer be passed to the registered listeners.
    List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.AttributeTypeDef>
    findAttributeTypeDefsByCategory(org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.AttributeTypeDefCategory category)
    Returns all the AttributeTypeDefs for a specific category.
    List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.EntityDetail>
    findEntities(String entityTypeGUID, List<String> entitySubtypeGUIDs, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.search.SearchProperties matchProperties, int fromEntityElement, List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceStatus> limitResultsByStatus, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.search.SearchClassifications matchClassifications, Date asOfTime, String sequencingProperty, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.SequencingOrder sequencingOrder, int pageSize)
    Return a list of entities that match the supplied criteria.
    List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.EntityDetail>
    findEntitiesByClassification(String entityTypeGUID, String classificationName, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceProperties matchClassificationProperties, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.MatchCriteria matchCriteria, int fromEntityElement, List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceStatus> limitResultsByStatus, Date asOfTime, String sequencingProperty, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.SequencingOrder sequencingOrder, int pageSize)
    Return a list of entities that have the requested type of classifications attached.
    List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.EntityDetail>
    findEntitiesByProperty(String entityTypeGUID, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceProperties matchProperties, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.MatchCriteria matchCriteria, int fromEntityElement, List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceStatus> limitResultsByStatus, List<String> limitResultsByClassification, Date asOfTime, String sequencingProperty, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.SequencingOrder sequencingOrder, int pageSize)
    Return a list of entities that match the supplied properties according to the match criteria.
    List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.EntityDetail>
    findEntitiesByPropertyValue(String entityTypeGUID, String searchCriteria, int fromEntityElement, List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceStatus> limitResultsByStatus, List<String> limitResultsByClassification, Date asOfTime, String sequencingProperty, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.SequencingOrder sequencingOrder, int pageSize)
    Return a list of entities whose string based property values match the search criteria.
    List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.Relationship>
    findRelationships(String relationshipTypeGUID, List<String> relationshipSubtypeGUIDs, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.search.SearchProperties matchProperties, int fromRelationshipElement, List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceStatus> limitResultsByStatus, Date asOfTime, String sequencingProperty, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.SequencingOrder sequencingOrder, int pageSize)
    Return a list of relationships that match the requested conditions.
    List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.Relationship>
    findRelationshipsByProperty(String relationshipTypeGUID, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceProperties matchProperties, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.MatchCriteria matchCriteria, int fromRelationshipElement, List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceStatus> limitResultsByStatus, Date asOfTime, String sequencingProperty, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.SequencingOrder sequencingOrder, int pageSize)
    Return a list of relationships that match the requested properties by the matching criteria.
    List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.Relationship>
    findRelationshipsByPropertyValue(String relationshipTypeGUID, String searchCriteria, int fromRelationshipElement, List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceStatus> limitResultsByStatus, Date asOfTime, String sequencingProperty, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.SequencingOrder sequencingOrder, int pageSize)
    Return a list of relationships whose string based property values match the search criteria.
    List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDef>
    findTypeDefsByCategory(org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDefCategory category)
    Returns all the TypeDefs for a specific category.
    List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDef>
    findTypeDefsByProperty(org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDefProperties matchCriteria)
    Return the TypeDefs that have the properties matching the supplied match criteria.
    List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDef>
    findTypesByExternalID(String standard, String organization, 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(String name)
    Returns a list of type definitions that have the specified name.
    org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDefGallery
    getAllTypes()
    Returns the list of different types of metadata organized into two groups.
    org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.AttributeTypeDef
    getAttributeTypeDefByGUID(String guid)
    Return the AttributeTypeDef identified by the GUID.
    org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.AttributeTypeDef
    getAttributeTypeDefByName(String name)
    Return the AttributeTypeDef identified by the unique name.
    org.odpi.openmetadata.frameworks.governanceaction.properties.CompletionStatus
    getCompletionStatus()
    Return any completion status from the archive service.
    org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.EntityDetail
    getEntityDetail(String guid)
    Return the header, classifications and properties of a specific entity.
    org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.EntityDetail
    getEntityDetail(String guid, Date asOfTime)
    Return a historical version of an entity includes the header, classifications and properties of the entity.
    List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.EntityDetail>
    getEntityDetailHistory(String guid, Date fromTime, Date toTime, int startFromElement, int pageSize, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.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.EntitySummary
    getEntitySummary(String guid)
    Return the header and classifications for a specific entity.
    String
    getMetadataCollectionId()
    Returns the identifier of the metadata repository.
    org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.Relationship
    getRelationship(String guid)
    Return a requested relationship.
    org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.Relationship
    getRelationship(String guid, Date asOfTime)
    Return a historical version of a relationship.
    List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.Relationship>
    getRelationshipHistory(String guid, Date fromTime, Date toTime, int startFromElement, int pageSize, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.HistorySequencingOrder sequencingOrder)
    Return all historical versions of a relationship within the bounds of the provided timestamps.
    List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.Relationship>
    getRelationshipsForEntity(String entityGUID, String relationshipTypeGUID, int fromRelationshipElement, List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceStatus> limitResultsByStatus, Date asOfTime, String sequencingProperty, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.SequencingOrder sequencingOrder, int pageSize)
    Return the relationships for a specific entity.
    org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDef
    getTypeDefByGUID(String guid)
    Return the TypeDef identified by the GUID.
    org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDef
    getTypeDefByName(String name)
    Return the TypeDef identified by the unique name.
    org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.EntityDetail
    isEntityKnown(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(String guid)
    Returns a boolean indicating if the relationship is stored in the metadata collection.
    void
    recordCompletionStatus(org.odpi.openmetadata.frameworks.governanceaction.properties.CompletionStatus status, List<String> outputGuards, Map<String,String> newRequestParameters, List<org.odpi.openmetadata.frameworks.governanceaction.properties.NewActionTarget> newActionTargets, String completionMessage)
    Declare that all the processing for the archive service is finished and the status of the work.
    void
    registerListener(org.odpi.openmetadata.repositoryservices.connectors.omrstopic.OMRSTopicRepositoryEventListener listener)
    Register a listener to receive events about changes to metadata elements in the open metadata repositories.
    List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDef>
    searchForTypeDefs(String searchCriteria)
    Return the TypeDefs that match the search criteria.
    void
    setRepositoryGovernanceServiceHandler(RepositoryGovernanceServiceHandler archiveServiceHandler)
    Set up the archive service handler.
    String
    toString()
    Standard toString method.

    Methods inherited from class org.odpi.openmetadata.engineservices.repositorygovernance.connector.RepositoryGovernanceContext

    getActionTargetElements, getRequestParameters, getRequestSourceElements, getRequestType

    Methods inherited from class java.lang.Object

    equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

  • Constructor Details

    • RepositoryGovernanceServiceContext

      public RepositoryGovernanceServiceContext(String userId, String repositoryGovernanceServiceName, String requestType, Map<String,String> requestParameters, List<org.odpi.openmetadata.frameworks.governanceaction.properties.RequestSourceElement> requestSourceElements, List<org.odpi.openmetadata.frameworks.governanceaction.properties.ActionTargetElement> actionTargetElements, org.odpi.openmetadata.repositoryservices.clients.EnterpriseRepositoryServicesClient repositoryServicesClient)
      Constructor sets up the key parameters for processing the request to the repository governance service.
      Parameters:
      userId - calling user
      repositoryGovernanceServiceName - name os service using this context - for error messages.
      requestType - unique identifier of the asset that the annotations should be attached to
      requestParameters - name-value properties to control the archive service
      requestSourceElements - metadata elements associated with the request to the archive service
      actionTargetElements - metadata elements that need to be worked on by the archive service
      repositoryServicesClient - client to the metadata store for use by the archive service

  • Method Details

    • setRepositoryGovernanceServiceHandler

      public void setRepositoryGovernanceServiceHandler(RepositoryGovernanceServiceHandler archiveServiceHandler)
      Set up the archive service handler.
      Parameters:
      archiveServiceHandler - handler

    • registerListener

      public void registerListener(org.odpi.openmetadata.repositoryservices.connectors.omrstopic.OMRSTopicRepositoryEventListener listener) throws org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException, org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException, org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException, org.odpi.openmetadata.frameworks.connectors.ffdc.ConnectionCheckedException, org.odpi.openmetadata.frameworks.connectors.ffdc.ConnectorCheckedException
      Register a listener to receive events about changes to metadata elements in the open metadata repositories.
      Specified by:
      registerListener in class org.odpi.openmetadata.engineservices.repositorygovernance.connector.RepositoryGovernanceContext
      Parameters:
      listener - listener object to receive events
      Throws:
      org.odpi.openmetadata.repositoryservices.ffdc.exception.InvalidParameterException - one or more of the type names are unrecognized
      org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException
      org.odpi.openmetadata.repositoryservices.ffdc.exception.RepositoryErrorException
      org.odpi.openmetadata.frameworks.connectors.ffdc.ConnectionCheckedException
      org.odpi.openmetadata.frameworks.connectors.ffdc.ConnectorCheckedException

    • disconnectFromEnterpriseTopic

      public void disconnectFromEnterpriseTopic() throws org.odpi.openmetadata.frameworks.connectors.ffdc.ConnectorCheckedException
      Disconnect from the topic connector - events will no longer be passed to the registered listeners.
      Specified by:
      disconnectFromEnterpriseTopic in class org.odpi.openmetadata.engineservices.repositorygovernance.connector.RepositoryGovernanceContext
      Throws:
      org.odpi.openmetadata.frameworks.connectors.ffdc.ConnectorCheckedException - problem with the topic connector

    • getMetadataCollectionId

      public String getMetadataCollectionId() 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.
      Specified by:
      getMetadataCollectionId in class org.odpi.openmetadata.engineservices.repositorygovernance.connector.RepositoryGovernanceContext
      Returns:
      String metadata collection id.
      Throws:
      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() 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 org.odpi.openmetadata.engineservices.repositorygovernance.connector.RepositoryGovernanceContext
      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.

    • findTypesByName

      public org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDefGallery findTypesByName(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 org.odpi.openmetadata.engineservices.repositorygovernance.connector.RepositoryGovernanceContext
      Parameters:
      name - name of the TypeDefs to return (including wildcard characters).
      Returns:
      TypeDefGallery 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.

    • findTypeDefsByCategory

      public List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDef> findTypeDefsByCategory(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 org.odpi.openmetadata.engineservices.repositorygovernance.connector.RepositoryGovernanceContext
      Parameters:
      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.

    • findAttributeTypeDefsByCategory

      public List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.AttributeTypeDef> findAttributeTypeDefsByCategory(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 org.odpi.openmetadata.engineservices.repositorygovernance.connector.RepositoryGovernanceContext
      Parameters:
      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.

    • findTypeDefsByProperty

      public List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDef> findTypeDefsByProperty(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 org.odpi.openmetadata.engineservices.repositorygovernance.connector.RepositoryGovernanceContext
      Parameters:
      matchCriteria - TypeDefProperties 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.

    • findTypesByExternalID

      public List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDef> findTypesByExternalID(String standard, String organization, 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 org.odpi.openmetadata.engineservices.repositorygovernance.connector.RepositoryGovernanceContext
      Parameters:
      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.

    • searchForTypeDefs

      public List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDef> searchForTypeDefs(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 org.odpi.openmetadata.engineservices.repositorygovernance.connector.RepositoryGovernanceContext
      Parameters:
      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.
      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.

    • getTypeDefByGUID

      public org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDef getTypeDefByGUID(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 org.odpi.openmetadata.engineservices.repositorygovernance.connector.RepositoryGovernanceContext
      Parameters:
      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.

    • getAttributeTypeDefByGUID

      public org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.AttributeTypeDef getAttributeTypeDefByGUID(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 org.odpi.openmetadata.engineservices.repositorygovernance.connector.RepositoryGovernanceContext
      Parameters:
      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.

    • getTypeDefByName

      public org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.TypeDef getTypeDefByName(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 org.odpi.openmetadata.engineservices.repositorygovernance.connector.RepositoryGovernanceContext
      Parameters:
      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.

    • getAttributeTypeDefByName

      public org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.typedefs.AttributeTypeDef getAttributeTypeDefByName(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 org.odpi.openmetadata.engineservices.repositorygovernance.connector.RepositoryGovernanceContext
      Parameters:
      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.

    • isEntityKnown

      public org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.EntityDetail isEntityKnown(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 org.odpi.openmetadata.engineservices.repositorygovernance.connector.RepositoryGovernanceContext
      Parameters:
      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(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. The returned entity summary may be from a full entity object or an entity proxy.
      Specified by:
      getEntitySummary in class org.odpi.openmetadata.engineservices.repositorygovernance.connector.RepositoryGovernanceContext
      Parameters:
      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(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 org.odpi.openmetadata.engineservices.repositorygovernance.connector.RepositoryGovernanceContext
      Parameters:
      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(String guid, 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 includes the header, classifications and properties of the entity.
      Specified by:
      getEntityDetail in class org.odpi.openmetadata.engineservices.repositorygovernance.connector.RepositoryGovernanceContext
      Parameters:
      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 the asOfTime property 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 List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.EntityDetail> getEntityDetailHistory(String guid, Date fromTime, Date toTime, int startFromElement, int pageSize, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.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 org.odpi.openmetadata.engineservices.repositorygovernance.connector.RepositoryGovernanceContext
      Parameters:
      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 List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.Relationship> getRelationshipsForEntity(String entityGUID, String relationshipTypeGUID, int fromRelationshipElement, List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceStatus> limitResultsByStatus, Date asOfTime, String sequencingProperty, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.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 org.odpi.openmetadata.engineservices.repositorygovernance.connector.RepositoryGovernanceContext
      Parameters:
      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 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.
      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 attached classifications.
      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 List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.EntityDetail> findEntities(String entityTypeGUID, List<String> entitySubtypeGUIDs, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.search.SearchProperties matchProperties, int fromEntityElement, List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceStatus> limitResultsByStatus, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.search.SearchClassifications matchClassifications, Date asOfTime, String sequencingProperty, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.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 org.odpi.openmetadata.engineservices.repositorygovernance.connector.RepositoryGovernanceContext
      Parameters:
      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 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.
      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 List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.EntityDetail> findEntitiesByProperty(String entityTypeGUID, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceProperties matchProperties, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.MatchCriteria matchCriteria, int fromEntityElement, List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceStatus> limitResultsByStatus, List<String> limitResultsByClassification, Date asOfTime, String sequencingProperty, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.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 org.odpi.openmetadata.engineservices.repositorygovernance.connector.RepositoryGovernanceContext
      Parameters:
      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 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.
      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.

    • findEntitiesByClassification

      public List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.EntityDetail> findEntitiesByClassification(String entityTypeGUID, String classificationName, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceProperties matchClassificationProperties, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.MatchCriteria matchCriteria, int fromEntityElement, List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceStatus> limitResultsByStatus, Date asOfTime, String sequencingProperty, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.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 org.odpi.openmetadata.engineservices.repositorygovernance.connector.RepositoryGovernanceContext
      Parameters:
      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 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.
      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.

    • findEntitiesByPropertyValue

      public List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.EntityDetail> findEntitiesByPropertyValue(String entityTypeGUID, String searchCriteria, int fromEntityElement, List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceStatus> limitResultsByStatus, List<String> limitResultsByClassification, Date asOfTime, String sequencingProperty, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.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 org.odpi.openmetadata.engineservices.repositorygovernance.connector.RepositoryGovernanceContext
      Parameters:
      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 the entities of the supplied type, even if it should be an exact match. (Retrieve all entities of the supplied type if this is either null or an empty string.)
      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 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.
      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.

    • isRelationshipKnown

      public org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.Relationship isRelationshipKnown(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 org.odpi.openmetadata.engineservices.repositorygovernance.connector.RepositoryGovernanceContext
      Parameters:
      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(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 org.odpi.openmetadata.engineservices.repositorygovernance.connector.RepositoryGovernanceContext
      Parameters:
      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(String guid, 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 org.odpi.openmetadata.engineservices.repositorygovernance.connector.RepositoryGovernanceContext
      Parameters:
      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 asOfTime property 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 List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.Relationship> getRelationshipHistory(String guid, Date fromTime, Date toTime, int startFromElement, int pageSize, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.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 org.odpi.openmetadata.engineservices.repositorygovernance.connector.RepositoryGovernanceContext
      Parameters:
      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 List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.Relationship> findRelationships(String relationshipTypeGUID, List<String> relationshipSubtypeGUIDs, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.search.SearchProperties matchProperties, int fromRelationshipElement, List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceStatus> limitResultsByStatus, Date asOfTime, String sequencingProperty, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.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 org.odpi.openmetadata.engineservices.repositorygovernance.connector.RepositoryGovernanceContext
      Parameters:
      relationshipTypeGUID - unique identifier (guid) for the new 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 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.
      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.

    • findRelationshipsByProperty

      public List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.Relationship> findRelationshipsByProperty(String relationshipTypeGUID, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceProperties matchProperties, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.MatchCriteria matchCriteria, int fromRelationshipElement, List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceStatus> limitResultsByStatus, Date asOfTime, String sequencingProperty, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.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 org.odpi.openmetadata.engineservices.repositorygovernance.connector.RepositoryGovernanceContext
      Parameters:
      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 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.
      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.

    • findRelationshipsByPropertyValue

      public List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.Relationship> findRelationshipsByPropertyValue(String relationshipTypeGUID, String searchCriteria, int fromRelationshipElement, List<org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.instances.InstanceStatus> limitResultsByStatus, Date asOfTime, String sequencingProperty, org.odpi.openmetadata.repositoryservices.connectors.stores.metadatacollectionstore.properties.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 org.odpi.openmetadata.engineservices.repositorygovernance.connector.RepositoryGovernanceContext
      Parameters:
      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 relationships of the supplied type, even if it should be an exact match.
      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 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.
      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 one of the provided parameters.
      org.odpi.openmetadata.repositoryservices.ffdc.exception.UserNotAuthorizedException - the userId is not permitted to perform this operation.

    • recordCompletionStatus

      public void recordCompletionStatus(org.odpi.openmetadata.frameworks.governanceaction.properties.CompletionStatus status, List<String> outputGuards, Map<String,String> newRequestParameters, List<org.odpi.openmetadata.frameworks.governanceaction.properties.NewActionTarget> newActionTargets, String completionMessage) throws org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException
      Declare that all the processing for the archive service is finished and the status of the work.
      Specified by:
      recordCompletionStatus in class org.odpi.openmetadata.engineservices.repositorygovernance.connector.RepositoryGovernanceContext
      Parameters:
      status - completion status enum value
      outputGuards - optional guard strings for triggering subsequent action(s)
      newRequestParameters - additional request parameters. These override/augment any request parameters defined for the next invoked service
      newActionTargets - list of action target names to GUIDs for the resulting archive service
      completionMessage - message to describe completion results or reasons for failure
      Throws:
      org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException - there is a problem connecting to the metadata store

    • getCompletionStatus

      public org.odpi.openmetadata.frameworks.governanceaction.properties.CompletionStatus getCompletionStatus()
      Return any completion status from the archive service.
      Specified by:
      getCompletionStatus in class org.odpi.openmetadata.engineservices.repositorygovernance.connector.RepositoryGovernanceContext
      Returns:
      completion status enum

    • toString

      public String toString()
      Standard toString method.
      Overrides:
      toString in class org.odpi.openmetadata.engineservices.repositorygovernance.connector.RepositoryGovernanceContext
      Returns:
      print out of variables in a JSON-style