Class GlossaryExchangeHandler
java.lang.Object
org.odpi.openmetadata.accessservices.assetmanager.handlers.GlossaryExchangeHandler
GlossaryExchangeHandler is the server side handler for managing glossary content.
-
Field Summary
-
Constructor Summary
ConstructorDescriptionGlossaryExchangeHandler
(String serviceName, String serverName, InvalidParameterHandler invalidParameterHandler, RepositoryHandler repositoryHandler, OMRSRepositoryHelper repositoryHelper, String localServerUserId, OpenMetadataServerSecurityVerifier securityVerifier, List<String> supportedZones, List<String> defaultZones, List<String> publishZones, AuditLog auditLog) Construct the glossary exchange handler with information needed to work with glossary related objects for Asset Manager OMAS. -
Method Summary
Modifier and TypeMethodDescriptionvoid
archiveGlossaryTerm
(String userId, MetadataCorrelationProperties correlationProperties, String glossaryTermGUID, ArchiveProperties archiveProperties, boolean forDuplicateProcessing, Date effectiveTime, String methodName) Classify the glossary term in the repository to show that it has been archived and is only needed for lineage.void
attachExternalCategoryLink
(String userId, String assetManagerGUID, String assetManagerName, String glossaryCategoryGUID, String externalLinkGUID, ExternalGlossaryElementLinkProperties linkProperties, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) Create a link to an external glossary category resource.void
attachExternalLinkToGlossary
(String userId, String assetManagerGUID, String assetManagerName, String glossaryGUID, String externalLinkGUID, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) Connect a glossary to a reference to an external glossary resource.void
attachExternalTermLink
(String userId, String assetManagerGUID, String assetManagerName, String glossaryTermGUID, String externalLinkGUID, ExternalGlossaryElementLinkProperties linkProperties, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) Create a link to an external glossary term resource.void
clearCategoryParent
(String userId, String assetManagerGUID, String assetManagerName, String glossaryParentCategoryGUID, String glossaryChildCategoryGUID, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) Remove a parent-child relationship between two categories.void
clearElementAsDataField
(String userId, MetadataCorrelationProperties correlationProperties, String elementGUID, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) Remove the data field designation from the element.void
clearGlossaryAsCanonical
(String userId, MetadataCorrelationProperties correlationProperties, String glossaryGUID, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) Remove the canonical designation from the glossary.void
clearGlossaryAsEditingGlossary
(String userId, MetadataCorrelationProperties correlationProperties, String glossaryGUID, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) Remove the editing glossary designation from the glossary.void
clearGlossaryAsStagingGlossary
(String userId, MetadataCorrelationProperties correlationProperties, String glossaryGUID, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) Remove the staging glossary designation from the glossary.void
clearGlossaryAsTaxonomy
(String userId, MetadataCorrelationProperties correlationProperties, String glossaryGUID, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) Remove the taxonomy designation from the glossary.void
clearTermAsAbstractConcept
(String userId, MetadataCorrelationProperties correlationProperties, String glossaryTermGUID, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) Remove the abstract concept designation from the glossary term.void
clearTermAsActivity
(String userId, MetadataCorrelationProperties correlationProperties, String glossaryTermGUID, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) Remove the activity designation from the glossary term.void
clearTermAsContext
(String userId, MetadataCorrelationProperties correlationProperties, String glossaryTermGUID, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) Remove the context definition designation from the glossary term.void
clearTermAsDataField
(String userId, MetadataCorrelationProperties correlationProperties, String glossaryTermGUID, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) Remove the data field designation from the glossary term.void
clearTermAsDataValue
(String userId, MetadataCorrelationProperties correlationProperties, String glossaryTermGUID, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) Remove the data value designation from the glossary term.void
clearTermAsObjectIdentifier
(String userId, MetadataCorrelationProperties correlationProperties, String glossaryTermGUID, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) Remove the object identifier designation from the glossary term.void
clearTermAsSpineAttribute
(String userId, MetadataCorrelationProperties correlationProperties, String glossaryTermGUID, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) Remove the spine attribute designation from the glossary term.void
clearTermAsSpineObject
(String userId, MetadataCorrelationProperties correlationProperties, String glossaryTermGUID, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) Remove the spine object designation from the glossary term.void
clearTermCategory
(String userId, String assetManagerGUID, String assetManagerName, String glossaryCategoryGUID, String glossaryTermGUID, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) Unlink a term from a category.void
clearTermRelationship
(String userId, String assetManagerGUID, String assetManagerName, String glossaryTermOneGUID, String relationshipTypeName, String glossaryTermTwoGUID, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) Remove the relationship between two terms.createControlledGlossaryTerm
(String userId, String glossaryGUID, MetadataCorrelationProperties correlationProperties, boolean assetManagerIsHome, GlossaryTermProperties glossaryTermProperties, GlossaryTermStatus initialStatus, String updateDescription, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing, String methodName) Create a new metadata element to represent a glossary term whose lifecycle is managed through a controlled workflow.createExternalGlossaryLink
(String userId, String assetManagerGUID, String assetManagerName, ExternalGlossaryLinkProperties linkProperties, String methodName) Create a link to an external glossary resource.createGlossary
(String userId, MetadataCorrelationProperties correlationProperties, boolean assetManagerIsHome, GlossaryProperties glossaryProperties, String methodName) Create a new metadata element to represent the root of a glossary.createGlossaryCategory
(String userId, String glossaryGUID, MetadataCorrelationProperties correlationProperties, boolean assetManagerIsHome, GlossaryCategoryProperties glossaryCategoryProperties, boolean isRootCategory, String updateDescription, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) Create a new metadata element to represent a glossary category.createGlossaryCategoryFromTemplate
(String userId, MetadataCorrelationProperties correlationProperties, boolean assetManagerIsHome, String glossaryGUID, String templateGUID, TemplateProperties templateProperties, boolean deepCopy, String methodName) Create a new metadata element to represent a glossary category using an existing metadata element as a template.createGlossaryFromTemplate
(String userId, MetadataCorrelationProperties correlationProperties, boolean assetManagerIsHome, String templateGUID, TemplateProperties templateProperties, boolean deepCopy, String methodName) Create a new metadata element to represent a glossary using an existing metadata element as a template.createGlossaryTerm
(String userId, String glossaryGUID, MetadataCorrelationProperties correlationProperties, boolean assetManagerIsHome, GlossaryTermProperties glossaryTermProperties, String updateDescription, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing, String methodName) Create a new metadata element to represent a glossary term.createGlossaryTermFromTemplate
(String userId, MetadataCorrelationProperties correlationProperties, boolean assetManagerIsHome, String glossaryGUID, String templateGUID, TemplateProperties templateProperties, GlossaryTermStatus initialStatus, boolean deepCopy, boolean templateSubstitute, String methodName) Create a new metadata element to represent a glossary term using an existing metadata element as a template.void
detachExternalCategoryLink
(String userId, String assetManagerGUID, String assetManagerName, String glossaryCategoryGUID, String externalLinkGUID, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) Remove the link to an external glossary category resource.void
detachExternalLinkFromGlossary
(String userId, String assetManagerGUID, String assetManagerName, String glossaryGUID, String externalLinkGUID, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) Disconnect a glossary from a reference to an external glossary resource.void
detachExternalTermLink
(String userId, String assetManagerGUID, String assetManagerName, String glossaryTermGUID, String externalLinkGUID, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) Remove the link to an external glossary term resource.findGlossaries
(String userId, String assetManagerGUID, String assetManagerName, String searchString, String searchStringParameterName, int startFrom, int pageSize, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) Retrieve the list of glossary metadata elements that contain the search string.findGlossaryCategories
(String userId, String assetManagerGUID, String assetManagerName, String glossaryGUID, String searchString, String searchStringParameterName, int startFrom, int pageSize, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing, String methodName) Retrieve the list of glossary category metadata elements that contain the search string.findGlossaryTerms
(String userId, String assetManagerGUID, String assetManagerName, String glossaryGUID, String searchString, List<GlossaryTermStatus> limitResultsByStatus, int startFrom, int pageSize, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) Retrieve the list of glossary term metadata elements that contain the search string.getCategoriesForGlossary
(String userId, String assetManagerGUID, String assetManagerName, String glossaryGUID, int startFrom, int pageSize, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) Return the list of categories associated with a glossary.getCategoriesForTerm
(String userId, String assetManagerGUID, String assetManagerName, String glossaryTermGUID, int startFrom, int pageSize, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) Return the list of categories associated with a glossary term.getExternalLinksForGlossary
(String userId, String glossaryGUID, int startFrom, int pageSize, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) Retrieve the list of links to external glossary resources attached to a glossary.getGlossariesByName
(String userId, String assetManagerGUID, String assetManagerName, String name, String nameParameterName, int startFrom, int pageSize, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) Retrieve the list of glossary metadata elements with a matching qualified or display name.getGlossariesForAssetManager
(String userId, String assetManagerGUID, String assetManagerName, int startFrom, int pageSize, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) Retrieve the list of glossaries created by this caller.getGlossariesForExternalLink
(String userId, String assetManagerGUID, String assetManagerName, String externalLinkGUID, int startFrom, int pageSize, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) Return the glossaries connected to an external glossary source.getGlossaryByGUID
(String userId, String assetManagerGUID, String assetManagerName, String glossaryGUID, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) Retrieve the glossary metadata element with the supplied unique identifier.getGlossaryCategoriesByName
(String userId, String assetManagerGUID, String assetManagerName, String glossaryGUID, String name, String nameParameterName, int startFrom, int pageSize, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) Retrieve the list of glossary category metadata elements with a matching qualified or display name.getGlossaryCategoryByGUID
(String userId, String assetManagerGUID, String assetManagerName, String openMetadataGUID, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) Retrieve the glossary category metadata element with the supplied unique identifier.getGlossaryCategoryParent
(String userId, String assetManagerGUID, String assetManagerName, String glossaryCategoryGUID, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) Retrieve the glossary category metadata element with the supplied unique identifier.getGlossaryForCategory
(String userId, String assetManagerGUID, String assetManagerName, String glossaryCategoryGUID, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) Retrieve the glossary metadata element for the requested category.getGlossaryForTerm
(String userId, String assetManagerGUID, String assetManagerName, String glossaryTermGUID, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) Retrieve the glossary metadata element for the requested term.getGlossarySubCategories
(String userId, String assetManagerGUID, String assetManagerName, String glossaryCategoryGUID, int startFrom, int pageSize, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) Retrieve the glossary category metadata element with the supplied unique identifier.getGlossaryTermByGUID
(String userId, String assetManagerGUID, String assetManagerName, String guid, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) Retrieve the glossary term metadata element with the supplied unique identifier.getGlossaryTermHistory
(String userId, String assetManagerGUID, String assetManagerName, String guid, Date fromTime, Date toTime, int startFrom, int pageSize, boolean oldestFirst, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) Retrieve all the versions of a glossary term.getGlossaryTermsByName
(String userId, String assetManagerGUID, String assetManagerName, String glossaryGUID, String name, List<GlossaryTermStatus> limitResultsByStatus, int startFrom, int pageSize, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) Retrieve the list of glossary term metadata elements with a matching qualified or display name.getMeanings
(String userId, String assetManagerGUID, String assetManagerName, String glossaryTermGUID, int startFrom, int pageSize, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) Retrieve the glossary terms linked via a "SemanticAssignment" relationship to the requested element.getRelatedTerms
(String userId, String assetManagerGUID, String assetManagerName, String glossaryTermGUID, String relationshipTypeName, List<GlossaryTermRelationshipStatus> limitResultsByStatus, int startFrom, int pageSize, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) Retrieve the list of glossary terms associated with the requested glossary term.Return the list of term-to-term relationship names.getTermsForGlossary
(String userId, String assetManagerGUID, String assetManagerName, String glossaryGUID, int startFrom, int pageSize, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) Retrieve the list of glossary terms associated with a glossary.getTermsForGlossaryCategory
(String userId, String assetManagerGUID, String assetManagerName, String glossaryCategoryGUID, List<GlossaryTermRelationshipStatus> limitResultsByStatus, int startFrom, int pageSize, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) Retrieve the list of glossary terms associated with a glossary category.void
moveGlossaryTerm
(String userId, MetadataCorrelationProperties correlationProperties, String glossaryTermGUID, String newGlossaryGUID, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) Move a glossary term from one glossary to another.void
removeExternalGlossaryLink
(String userId, String assetManagerGUID, String assetManagerName, String externalLinkGUID, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) Remove information about a link to an external glossary resource (and the relationships that attached it to the glossaries).void
removeGlossary
(String userId, MetadataCorrelationProperties correlationProperties, String glossaryGUID, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) Remove the metadata element representing a glossary.void
removeGlossaryCategory
(String userId, MetadataCorrelationProperties correlationProperties, String glossaryCategoryGUID, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) Remove the metadata element representing a glossary category.void
removeGlossaryTerm
(String userId, MetadataCorrelationProperties correlationProperties, String glossaryTermGUID, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) Remove the metadata element representing a glossary term.void
setElementAsDataField
(String userId, MetadataCorrelationProperties correlationProperties, String elementGUID, DataFieldValuesProperties properties, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) Classify the element to indicate that it describes a data field and supply properties that describe the characteristics of the data values found within.void
setGlossaryAsCanonical
(String userId, MetadataCorrelationProperties correlationProperties, String glossaryGUID, CanonicalVocabularyProperties properties, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) Classify a glossary to declare that it has no two GlossaryTerm definitions with the same name.void
setGlossaryAsEditingGlossary
(String userId, MetadataCorrelationProperties correlationProperties, String glossaryGUID, EditingGlossaryProperties properties, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) Classify the glossary to indicate that it is an editing glossary - this means it is a collection of glossary updates that will be merged into its source glossary.void
setGlossaryAsStagingGlossary
(String userId, MetadataCorrelationProperties correlationProperties, String glossaryGUID, StagingGlossaryProperties properties, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) Classify the glossary to indicate that it is an editing glossary - this means it is a collection of glossary updates that will be merged into another glossary.void
setGlossaryAsTaxonomy
(String userId, MetadataCorrelationProperties correlationProperties, String glossaryGUID, TaxonomyProperties properties, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) Classify the glossary to indicate that it can be used as a taxonomy.void
setTermAsAbstractConcept
(String userId, MetadataCorrelationProperties correlationProperties, String glossaryTermGUID, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) Classify the glossary term to indicate that it describes an abstract concept.void
setTermAsActivity
(String userId, MetadataCorrelationProperties correlationProperties, String glossaryTermGUID, GlossaryTermActivityType activityType, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) Classify the glossary term to indicate that it describes a data value.void
setTermAsContext
(String userId, MetadataCorrelationProperties correlationProperties, String glossaryTermGUID, GlossaryTermContextDefinition contextDefinition, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) Classify the glossary term to indicate that it describes a context.void
setTermAsDataField
(String userId, MetadataCorrelationProperties correlationProperties, String glossaryTermGUID, DataFieldValuesProperties properties, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) Classify the glossary term to indicate that it describes a data field and supply properties that describe the characteristics of the data values found within.void
setTermAsDataValue
(String userId, MetadataCorrelationProperties correlationProperties, String glossaryTermGUID, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) Classify the glossary term to indicate that it describes a data value.void
setTermAsObjectIdentifier
(String userId, MetadataCorrelationProperties correlationProperties, String glossaryTermGUID, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) Classify the glossary term to indicate that it describes an object identifier.void
setTermAsSpineAttribute
(String userId, MetadataCorrelationProperties correlationProperties, String glossaryTermGUID, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) Classify the glossary term to indicate that it describes a spine attribute.void
setTermAsSpineObject
(String userId, MetadataCorrelationProperties correlationProperties, String glossaryTermGUID, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) Classify the glossary term to indicate that it describes a spine object.void
setupCategoryParent
(String userId, String assetManagerGUID, String assetManagerName, String glossaryParentCategoryGUID, String glossaryChildCategoryGUID, Date effectiveFrom, Date effectiveTo, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) Create a parent-child relationship between two categories.void
setupTermCategory
(String userId, String assetManagerGUID, String assetManagerName, String glossaryCategoryGUID, String glossaryTermGUID, GlossaryTermCategorization categorizationProperties, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) Link a term to a category.void
setupTermRelationship
(String userId, String assetManagerGUID, String assetManagerName, String glossaryTermOneGUID, String relationshipTypeName, String glossaryTermTwoGUID, GlossaryTermRelationship relationshipsProperties, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) Link two terms together using a specialist relationship.undoGlossaryTermUpdate
(String userId, MetadataCorrelationProperties correlationProperties, String glossaryTermGUID, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) Undo the last update to the glossary term.void
updateExternalGlossaryLink
(String userId, String assetManagerGUID, String assetManagerName, String externalLinkGUID, ExternalGlossaryLinkProperties linkProperties, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) Update the properties of a reference to an external glossary resource.void
updateGlossary
(String userId, MetadataCorrelationProperties correlationProperties, String glossaryGUID, GlossaryProperties glossaryProperties, String updateDescription, boolean isMergeUpdate, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) Update the metadata element representing a glossary.void
updateGlossaryCategory
(String userId, MetadataCorrelationProperties correlationProperties, String glossaryCategoryGUID, GlossaryCategoryProperties glossaryCategoryProperties, String updateDescription, boolean isMergeUpdate, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) Update the metadata element representing a glossary category.void
updateGlossaryTerm
(String userId, MetadataCorrelationProperties correlationProperties, String glossaryTermGUID, GlossaryTermProperties glossaryTermProperties, String updateDescription, boolean isMergeUpdate, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) Update the properties of the metadata element representing a glossary term.void
updateGlossaryTermFromTemplate
(String userId, MetadataCorrelationProperties correlationProperties, String glossaryTermGUID, String templateGUID, boolean isMergeClassifications, boolean isMergeProperties, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) Update the glossary term using the properties and classifications from the parentGUID stored in the request body.void
updateGlossaryTermStatus
(String userId, MetadataCorrelationProperties correlationProperties, String glossaryTermGUID, GlossaryTermStatus glossaryTermStatus, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) Update the status of the metadata element representing a glossary term.void
updateTermRelationship
(String userId, String assetManagerGUID, String assetManagerName, String glossaryTermOneGUID, String relationshipTypeName, String glossaryTermTwoGUID, GlossaryTermRelationship relationshipsProperties, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) Update the relationship properties for the two terms.
-
Field Details
-
elementGUIDParameterName
- See Also:
-
-
Constructor Details
-
GlossaryExchangeHandler
public GlossaryExchangeHandler(String serviceName, String serverName, InvalidParameterHandler invalidParameterHandler, RepositoryHandler repositoryHandler, OMRSRepositoryHelper repositoryHelper, String localServerUserId, OpenMetadataServerSecurityVerifier securityVerifier, List<String> supportedZones, List<String> defaultZones, List<String> publishZones, AuditLog auditLog) Construct the glossary exchange handler with information needed to work with glossary related objects for Asset Manager OMAS.- Parameters:
serviceName
- name of this serviceserverName
- name of the local serverinvalidParameterHandler
- handler for managing parameter errorsrepositoryHandler
- manages calls to the repository servicesrepositoryHelper
- provides utilities for manipulating the repository services objectslocalServerUserId
- userId for this serversecurityVerifier
- open metadata security services verifiersupportedZones
- list of zones that the access service is allowed to serve instances from.defaultZones
- list of zones that the access service should set in all new instances.publishZones
- list of zones that the access service sets up in published instances.auditLog
- destination for audit log events.
-
-
Method Details
-
createGlossary
public String createGlossary(String userId, MetadataCorrelationProperties correlationProperties, boolean assetManagerIsHome, GlossaryProperties glossaryProperties, String methodName) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Create a new metadata element to represent the root of a glossary. All categories and terms are linked to a single glossary. They are owned by this glossary and if the glossary is deleted, any linked terms and categories are deleted as well.- Parameters:
userId
- calling usercorrelationProperties
- properties to help with the mapping of the elements in the external asset manager and open metadataassetManagerIsHome
- ensure that only the asset manager can update this elementglossaryProperties
- properties to storemethodName
- calling method- Returns:
- unique identifier of the new metadata element
- Throws:
InvalidParameterException
- one of the parameters is invalidUserNotAuthorizedException
- the user is not authorized to issue this requestPropertyServerException
- there is a problem reported in the open metadata server(s)
-
createGlossaryFromTemplate
public String createGlossaryFromTemplate(String userId, MetadataCorrelationProperties correlationProperties, boolean assetManagerIsHome, String templateGUID, TemplateProperties templateProperties, boolean deepCopy, String methodName) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Create a new metadata element to represent a glossary using an existing metadata element as a template. The template defines additional classifications and relationships that should be added to the new glossary. All categories and terms are linked to a single glossary. They are owned by this glossary and if the glossary is deleted, any linked terms and categories are deleted as well.- Parameters:
userId
- calling usercorrelationProperties
- properties to help with the mapping of the elements in the external asset manager and open metadataassetManagerIsHome
- ensure that only the asset manager can update this elementtemplateGUID
- unique identifier of the metadata element to copytemplateProperties
- properties that override the templatedeepCopy
- should the template creation extend to the anchored elements or just the direct entity?methodName
- calling method- Returns:
- unique identifier of the new metadata element
- Throws:
InvalidParameterException
- one of the parameters is invalidUserNotAuthorizedException
- the user is not authorized to issue this requestPropertyServerException
- there is a problem reported in the open metadata server(s)
-
updateGlossary
public void updateGlossary(String userId, MetadataCorrelationProperties correlationProperties, String glossaryGUID, GlossaryProperties glossaryProperties, String updateDescription, boolean isMergeUpdate, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Update the metadata element representing a glossary.- Parameters:
userId
- calling usercorrelationProperties
- properties to help with the mapping of the elements in the external asset manager and open metadataglossaryGUID
- unique identifier of the metadata element to updateglossaryProperties
- new properties for this elementupdateDescription
- description of the update for the revision historyisMergeUpdate
- should the properties be merged with the existing properties or completely over-write themforLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?effectiveTime
- when should the elements be effected for - null is anytime; new Date() is nowmethodName
- calling method- Throws:
InvalidParameterException
- one of the parameters is invalidUserNotAuthorizedException
- the user is not authorized to issue this requestPropertyServerException
- there is a problem reported in the open metadata server(s)
-
removeGlossary
public void removeGlossary(String userId, MetadataCorrelationProperties correlationProperties, String glossaryGUID, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Remove the metadata element representing a glossary. This will delete the glossary and all categories and terms because the Anchors classifications are set up in these elements.- Parameters:
userId
- calling usercorrelationProperties
- properties to help with the mapping of the elements in the external asset manager and open metadataglossaryGUID
- unique identifier of the metadata element to removeforLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?effectiveTime
- when should the elements be effected for - null is anytime; new Date() is nowmethodName
- calling method- Throws:
InvalidParameterException
- one of the parameters is invalidUserNotAuthorizedException
- the user is not authorized to issue this requestPropertyServerException
- there is a problem reported in the open metadata server(s)
-
setGlossaryAsEditingGlossary
public void setGlossaryAsEditingGlossary(String userId, MetadataCorrelationProperties correlationProperties, String glossaryGUID, EditingGlossaryProperties properties, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Classify the glossary to indicate that it is an editing glossary - this means it is a collection of glossary updates that will be merged into its source glossary.- Parameters:
userId
- calling usercorrelationProperties
- properties to help with the mapping of the elements in the external asset manager and open metadataglossaryGUID
- unique identifier of the metadata element to removeproperties
- description of how the glossary is organizedforLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?effectiveTime
- when should the elements be effected for - null is anytime; new Date() is nowmethodName
- calling method- Throws:
InvalidParameterException
- one of the parameters is invalidUserNotAuthorizedException
- the user is not authorized to issue this requestPropertyServerException
- there is a problem reported in the open metadata server(s)
-
clearGlossaryAsEditingGlossary
public void clearGlossaryAsEditingGlossary(String userId, MetadataCorrelationProperties correlationProperties, String glossaryGUID, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Remove the editing glossary designation from the glossary.- Parameters:
userId
- calling usercorrelationProperties
- properties to help with the mapping of the elements in the external asset manager and open metadataglossaryGUID
- unique identifier of the metadata element to removeforLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?effectiveTime
- when should the elements be effected for - null is anytime; new Date() is nowmethodName
- calling method- Throws:
InvalidParameterException
- one of the parameters is invalidUserNotAuthorizedException
- the user is not authorized to issue this requestPropertyServerException
- there is a problem reported in the open metadata server(s)
-
setGlossaryAsStagingGlossary
public void setGlossaryAsStagingGlossary(String userId, MetadataCorrelationProperties correlationProperties, String glossaryGUID, StagingGlossaryProperties properties, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Classify the glossary to indicate that it is an editing glossary - this means it is a collection of glossary updates that will be merged into another glossary.- Parameters:
userId
- calling usercorrelationProperties
- properties to help with the mapping of the elements in the external asset manager and open metadataglossaryGUID
- unique identifier of the metadata element to removeproperties
- description of how the glossary is organizedforLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?effectiveTime
- when should the elements be effected for - null is anytime; new Date() is nowmethodName
- calling method- Throws:
InvalidParameterException
- one of the parameters is invalidUserNotAuthorizedException
- the user is not authorized to issue this requestPropertyServerException
- there is a problem reported in the open metadata server(s)
-
clearGlossaryAsStagingGlossary
public void clearGlossaryAsStagingGlossary(String userId, MetadataCorrelationProperties correlationProperties, String glossaryGUID, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Remove the staging glossary designation from the glossary.- Parameters:
userId
- calling usercorrelationProperties
- properties to help with the mapping of the elements in the external asset manager and open metadataglossaryGUID
- unique identifier of the metadata element to removeforLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?effectiveTime
- when should the elements be effected for - null is anytime; new Date() is nowmethodName
- calling method- Throws:
InvalidParameterException
- one of the parameters is invalidUserNotAuthorizedException
- the user is not authorized to issue this requestPropertyServerException
- there is a problem reported in the open metadata server(s)
-
setGlossaryAsTaxonomy
public void setGlossaryAsTaxonomy(String userId, MetadataCorrelationProperties correlationProperties, String glossaryGUID, TaxonomyProperties properties, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Classify the glossary to indicate that it can be used as a taxonomy. This means each term is attached to one, and only one category and the categories are organized as a hierarchy with a single root category. Taxonomies are used as a way of organizing assets and other related metadata. The terms in the taxonomy are linked to the assets etc. and as such they are logically categorized by the linked category.- Parameters:
userId
- calling usercorrelationProperties
- properties to help with the mapping of the elements in the external asset manager and open metadataglossaryGUID
- unique identifier of the metadata element to removeproperties
- description of how the glossary is organizedforLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?effectiveTime
- when should the elements be effected for - null is anytime; new Date() is nowmethodName
- calling method- Throws:
InvalidParameterException
- one of the parameters is invalidUserNotAuthorizedException
- the user is not authorized to issue this requestPropertyServerException
- there is a problem reported in the open metadata server(s)
-
clearGlossaryAsTaxonomy
public void clearGlossaryAsTaxonomy(String userId, MetadataCorrelationProperties correlationProperties, String glossaryGUID, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Remove the taxonomy designation from the glossary.- Parameters:
userId
- calling usercorrelationProperties
- properties to help with the mapping of the elements in the external asset manager and open metadataglossaryGUID
- unique identifier of the metadata element to removeforLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?effectiveTime
- when should the elements be effected for - null is anytime; new Date() is nowmethodName
- calling method- Throws:
InvalidParameterException
- one of the parameters is invalidUserNotAuthorizedException
- the user is not authorized to issue this requestPropertyServerException
- there is a problem reported in the open metadata server(s)
-
setGlossaryAsCanonical
public void setGlossaryAsCanonical(String userId, MetadataCorrelationProperties correlationProperties, String glossaryGUID, CanonicalVocabularyProperties properties, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Classify a glossary to declare that it has no two GlossaryTerm definitions with the same name. This means there is only one definition for each term. Typically, the terms are also of a similar level of granularity and are limited to a specific scope of use. Canonical vocabularies are used to semantically classify assets in an unambiguous way.- Parameters:
userId
- calling usercorrelationProperties
- properties to help with the mapping of the elements in the external asset manager and open metadataglossaryGUID
- unique identifier of the metadata element to removeproperties
- description of the situations where this glossary is relevant.forLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?effectiveTime
- when should the elements be effected for - null is anytime; new Date() is nowmethodName
- calling method- Throws:
InvalidParameterException
- one of the parameters is invalidUserNotAuthorizedException
- the user is not authorized to issue this requestPropertyServerException
- there is a problem reported in the open metadata server(s)
-
clearGlossaryAsCanonical
public void clearGlossaryAsCanonical(String userId, MetadataCorrelationProperties correlationProperties, String glossaryGUID, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Remove the canonical designation from the glossary.- Parameters:
userId
- calling usercorrelationProperties
- properties to help with the mapping of the elements in the external asset manager and open metadataglossaryGUID
- unique identifier of the metadata element to removeforLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?effectiveTime
- when should the elements be effected for - null is anytime; new Date() is nowmethodName
- calling method- Throws:
InvalidParameterException
- one of the parameters is invalidUserNotAuthorizedException
- the user is not authorized to issue this requestPropertyServerException
- there is a problem reported in the open metadata server(s)
-
findGlossaries
public List<GlossaryElement> findGlossaries(String userId, String assetManagerGUID, String assetManagerName, String searchString, String searchStringParameterName, int startFrom, int pageSize, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Retrieve the list of glossary metadata elements that contain the search string. The search string is treated as a regular expression.- Parameters:
userId
- calling userassetManagerGUID
- unique identifier of software server capability representing the callerassetManagerName
- unique name of software server capability representing the callersearchString
- string to find in the propertiessearchStringParameterName
- name of parameter for search stringstartFrom
- paging start pointpageSize
- maximum results that can be returnedforLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?effectiveTime
- when should the elements be effected for - null is anytime; new Date() is nowmethodName
- calling method- Returns:
- list of matching metadata elements
- Throws:
InvalidParameterException
- one of the parameters is invalidUserNotAuthorizedException
- the user is not authorized to issue this requestPropertyServerException
- there is a problem reported in the open metadata server(s)
-
getGlossariesByName
public List<GlossaryElement> getGlossariesByName(String userId, String assetManagerGUID, String assetManagerName, String name, String nameParameterName, int startFrom, int pageSize, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Retrieve the list of glossary metadata elements with a matching qualified or display name. There are no wildcards supported on this request.- Parameters:
userId
- calling userassetManagerGUID
- unique identifier of software server capability representing the callerassetManagerName
- unique name of software server capability representing the callername
- name to search fornameParameterName
- name of parameter supplying name valuestartFrom
- paging start pointpageSize
- maximum results that can be returnedforLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?effectiveTime
- when should the elements be effected for - null is anytime; new Date() is nowmethodName
- calling method- Returns:
- list of matching metadata elements
- Throws:
InvalidParameterException
- one of the parameters is invalidUserNotAuthorizedException
- the user is not authorized to issue this requestPropertyServerException
- there is a problem reported in the open metadata server(s)
-
getGlossariesForAssetManager
public List<GlossaryElement> getGlossariesForAssetManager(String userId, String assetManagerGUID, String assetManagerName, int startFrom, int pageSize, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Retrieve the list of glossaries created by this caller.- Parameters:
userId
- calling userassetManagerGUID
- unique identifier of software server capability representing the callerassetManagerName
- unique name of software server capability representing the callerstartFrom
- paging start pointpageSize
- maximum results that can be returnedforLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?effectiveTime
- when should the elements be effected for - null is anytime; new Date() is nowmethodName
- calling method- Returns:
- list of matching metadata elements
- Throws:
InvalidParameterException
- one of the parameters is invalidUserNotAuthorizedException
- the user is not authorized to issue this requestPropertyServerException
- there is a problem reported in the open metadata server(s)
-
getGlossaryByGUID
public GlossaryElement getGlossaryByGUID(String userId, String assetManagerGUID, String assetManagerName, String glossaryGUID, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Retrieve the glossary metadata element with the supplied unique identifier.- Parameters:
userId
- calling userassetManagerGUID
- unique identifier of software server capability representing the callerassetManagerName
- unique name of software server capability representing the callerglossaryGUID
- unique identifier of the requested metadata elementforLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?effectiveTime
- when should the elements be effected for - null is anytime; new Date() is nowmethodName
- calling method- Returns:
- matching metadata element
- Throws:
InvalidParameterException
- one of the parameters is invalidUserNotAuthorizedException
- the user is not authorized to issue this requestPropertyServerException
- there is a problem reported in the open metadata server(s)
-
getGlossaryForCategory
public GlossaryElement getGlossaryForCategory(String userId, String assetManagerGUID, String assetManagerName, String glossaryCategoryGUID, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Retrieve the glossary metadata element for the requested category.- Parameters:
userId
- calling userassetManagerGUID
- unique identifier of software server capability representing the callerassetManagerName
- unique name of software server capability representing the callerglossaryCategoryGUID
- unique identifier of the requested metadata elementforLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?effectiveTime
- when should the elements be effected for - null is anytime; new Date() is nowmethodName
- calling method- Returns:
- matching metadata element
- Throws:
InvalidParameterException
- one of the parameters is invalidUserNotAuthorizedException
- the user is not authorized to issue this requestPropertyServerException
- there is a problem reported in the open metadata server(s)
-
getGlossaryForTerm
public GlossaryElement getGlossaryForTerm(String userId, String assetManagerGUID, String assetManagerName, String glossaryTermGUID, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Retrieve the glossary metadata element for the requested term.- Parameters:
userId
- calling userassetManagerGUID
- unique identifier of software server capability representing the callerassetManagerName
- unique name of software server capability representing the callerglossaryTermGUID
- unique identifier of the requested metadata elementforLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?effectiveTime
- when should the elements be effected for - null is anytime; new Date() is nowmethodName
- calling method- Returns:
- matching metadata element
- Throws:
InvalidParameterException
- one of the parameters is invalidUserNotAuthorizedException
- the user is not authorized to issue this requestPropertyServerException
- there is a problem reported in the open metadata server(s)
-
createGlossaryCategory
public String createGlossaryCategory(String userId, String glossaryGUID, MetadataCorrelationProperties correlationProperties, boolean assetManagerIsHome, GlossaryCategoryProperties glossaryCategoryProperties, boolean isRootCategory, String updateDescription, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Create a new metadata element to represent a glossary category.- Parameters:
userId
- calling userglossaryGUID
- unique identifier of the glossary where the category is locatedcorrelationProperties
- properties to help with the mapping of the elements in the external asset manager and open metadataassetManagerIsHome
- ensure that only the asset manager can update this elementglossaryCategoryProperties
- properties about the glossary category to storeisRootCategory
- is this category a root category?updateDescription
- description of the update for the revision historyeffectiveTime
- the time that the retrieved elements must be effective forforLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?methodName
- calling method- Returns:
- unique identifier of the new glossary category
- Throws:
InvalidParameterException
- one of the parameters is invalidUserNotAuthorizedException
- the user is not authorized to issue this requestPropertyServerException
- there is a problem reported in the open metadata server(s)
-
createGlossaryCategoryFromTemplate
public String createGlossaryCategoryFromTemplate(String userId, MetadataCorrelationProperties correlationProperties, boolean assetManagerIsHome, String glossaryGUID, String templateGUID, TemplateProperties templateProperties, boolean deepCopy, String methodName) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Create a new metadata element to represent a glossary category using an existing metadata element as a template.- Parameters:
userId
- calling usercorrelationProperties
- properties to help with the mapping of the elements in the external asset manager and open metadataassetManagerIsHome
- ensure that only the asset manager can update this elementglossaryGUID
- unique identifier of the glossary where the category is locatedtemplateGUID
- unique identifier of the metadata element to copytemplateProperties
- properties that override the templatedeepCopy
- should the template creation extend to the anchored elements or just the direct entity?methodName
- calling method- Returns:
- unique identifier of the new glossary category
- Throws:
InvalidParameterException
- one of the parameters is invalidUserNotAuthorizedException
- the user is not authorized to issue this requestPropertyServerException
- there is a problem reported in the open metadata server(s)
-
updateGlossaryCategory
public void updateGlossaryCategory(String userId, MetadataCorrelationProperties correlationProperties, String glossaryCategoryGUID, GlossaryCategoryProperties glossaryCategoryProperties, String updateDescription, boolean isMergeUpdate, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Update the metadata element representing a glossary category.- Parameters:
userId
- calling usercorrelationProperties
- properties to help with the mapping of the elements in the external asset manager and open metadataglossaryCategoryGUID
- unique identifier of the metadata element to updateglossaryCategoryProperties
- new properties for the metadata elementupdateDescription
- description of the update for the revision historyisMergeUpdate
- should the new properties be merged with existing properties (true) or completely replace them (false)?forLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?effectiveTime
- optional date for effective time of the query. Null means any effective timemethodName
- calling method- Throws:
InvalidParameterException
- one of the parameters is invalidUserNotAuthorizedException
- the user is not authorized to issue this requestPropertyServerException
- there is a problem reported in the open metadata server(s)
-
setupCategoryParent
public void setupCategoryParent(String userId, String assetManagerGUID, String assetManagerName, String glossaryParentCategoryGUID, String glossaryChildCategoryGUID, Date effectiveFrom, Date effectiveTo, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Create a parent-child relationship between two categories.- Parameters:
userId
- calling userassetManagerGUID
- unique identifier of software server capability representing the callerassetManagerName
- unique name of software server capability representing the callerglossaryParentCategoryGUID
- unique identifier of the glossary category in the external asset manager that is to be the super-categoryglossaryChildCategoryGUID
- unique identifier of the glossary category in the external asset manager that is to be the subcategoryeffectiveFrom
- the time that the relationship element must be effective from (null for any time, new Date() for now)effectiveTo
- the time that the relationship must be effective to (null for any time, new Date() for now)forLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?effectiveTime
- optional date for effective time of the query. Null means any effective timemethodName
- calling method- Throws:
InvalidParameterException
- one of the parameters is invalidUserNotAuthorizedException
- the user is not authorized to issue this requestPropertyServerException
- there is a problem reported in the open metadata server(s)
-
clearCategoryParent
public void clearCategoryParent(String userId, String assetManagerGUID, String assetManagerName, String glossaryParentCategoryGUID, String glossaryChildCategoryGUID, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Remove a parent-child relationship between two categories.- Parameters:
userId
- calling userassetManagerGUID
- unique identifier of software server capability representing the callerassetManagerName
- unique name of software server capability representing the callerglossaryParentCategoryGUID
- unique identifier of the glossary category in the external asset manager that is to be the super-categoryglossaryChildCategoryGUID
- unique identifier of the glossary category in the external asset manager that is to be the subcategoryforLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?effectiveTime
- optional date for effective time of the query. Null means any effective timemethodName
- calling method- Throws:
InvalidParameterException
- one of the parameters is invalidUserNotAuthorizedException
- the user is not authorized to issue this requestPropertyServerException
- there is a problem reported in the open metadata server(s)
-
removeGlossaryCategory
public void removeGlossaryCategory(String userId, MetadataCorrelationProperties correlationProperties, String glossaryCategoryGUID, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Remove the metadata element representing a glossary category.- Parameters:
userId
- calling usercorrelationProperties
- properties to help with the mapping of the elements in the external asset manager and open metadataglossaryCategoryGUID
- unique identifier of the metadata element to removeforLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?effectiveTime
- optional date for effective time of the query. Null means any effective timemethodName
- calling method- Throws:
InvalidParameterException
- one of the parameters is invalidUserNotAuthorizedException
- the user is not authorized to issue this requestPropertyServerException
- there is a problem reported in the open metadata server(s)
-
findGlossaryCategories
public List<GlossaryCategoryElement> findGlossaryCategories(String userId, String assetManagerGUID, String assetManagerName, String glossaryGUID, String searchString, String searchStringParameterName, int startFrom, int pageSize, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing, String methodName) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Retrieve the list of glossary category metadata elements that contain the search string. The search string is treated as a regular expression.- Parameters:
userId
- calling userassetManagerGUID
- unique identifier of software server capability representing the callerassetManagerName
- unique name of software server capability representing the callerglossaryGUID
- unique identifier of the glossary to querysearchString
- string to find in the propertiessearchStringParameterName
- name of parameter for searchStringstartFrom
- paging start pointpageSize
- maximum results that can be returnedeffectiveTime
- optional date for effective time of the query. Null means any effective timeforLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?methodName
- calling method- Returns:
- list of matching metadata elements
- Throws:
InvalidParameterException
- one of the parameters is invalidUserNotAuthorizedException
- the user is not authorized to issue this requestPropertyServerException
- there is a problem reported in the open metadata server(s)
-
getCategoriesForGlossary
public List<GlossaryCategoryElement> getCategoriesForGlossary(String userId, String assetManagerGUID, String assetManagerName, String glossaryGUID, int startFrom, int pageSize, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Return the list of categories associated with a glossary.- Parameters:
userId
- calling userassetManagerGUID
- unique identifier of software server capability representing the callerassetManagerName
- unique name of software server capability representing the callerglossaryGUID
- unique identifier of the glossary to querystartFrom
- paging start pointpageSize
- maximum results that can be returnedforLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?effectiveTime
- optional date for effective time of the query. Null means any effective timemethodName
- calling method- Returns:
- list of metadata elements describing the categories associated with the requested glossary
- Throws:
InvalidParameterException
- one of the parameters is invalidUserNotAuthorizedException
- the user is not authorized to issue this requestPropertyServerException
- there is a problem reported in the open metadata server(s)
-
getCategoriesForTerm
public List<GlossaryCategoryElement> getCategoriesForTerm(String userId, String assetManagerGUID, String assetManagerName, String glossaryTermGUID, int startFrom, int pageSize, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Return the list of categories associated with a glossary term.- Parameters:
userId
- calling userassetManagerGUID
- unique identifier of software server capability representing the callerassetManagerName
- unique name of software server capability representing the callerglossaryTermGUID
- unique identifier of the glossary term to querystartFrom
- paging start pointpageSize
- maximum results that can be returnedforLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?effectiveTime
- optional date for effective time of the query. Null means any effective timemethodName
- calling method- Returns:
- list of metadata elements describing the categories associated with the requested term
- Throws:
InvalidParameterException
- one of the parameters is invalidUserNotAuthorizedException
- the user is not authorized to issue this requestPropertyServerException
- there is a problem reported in the open metadata server(s)
-
getGlossaryCategoriesByName
public List<GlossaryCategoryElement> getGlossaryCategoriesByName(String userId, String assetManagerGUID, String assetManagerName, String glossaryGUID, String name, String nameParameterName, int startFrom, int pageSize, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Retrieve the list of glossary category metadata elements with a matching qualified or display name. There are no wildcards supported on this request.- Parameters:
userId
- calling userassetManagerGUID
- unique identifier of software server capability representing the callerassetManagerName
- unique name of software server capability representing the callerglossaryGUID
- unique identifier of the glossary to queryname
- name to search fornameParameterName
- parameter namestartFrom
- paging start pointpageSize
- maximum results that can be returnedforLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?effectiveTime
- optional date for effective time of the query. Null means any effective timemethodName
- calling method- Returns:
- list of matching metadata elements
- Throws:
InvalidParameterException
- one of the parameters is invalidUserNotAuthorizedException
- the user is not authorized to issue this requestPropertyServerException
- there is a problem reported in the open metadata server(s)
-
getGlossaryCategoryParent
public GlossaryCategoryElement getGlossaryCategoryParent(String userId, String assetManagerGUID, String assetManagerName, String glossaryCategoryGUID, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Retrieve the glossary category metadata element with the supplied unique identifier.- Parameters:
userId
- calling userassetManagerGUID
- unique identifier of software server capability representing the callerassetManagerName
- unique name of software server capability representing the callerglossaryCategoryGUID
- unique identifier of the requested metadata elementforLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?effectiveTime
- optional date for effective time of the query. Null means any effective timemethodName
- calling method- Returns:
- parent glossary category element
- Throws:
InvalidParameterException
- one of the parameters is invalidUserNotAuthorizedException
- the user is not authorized to issue this requestPropertyServerException
- there is a problem reported in the open metadata server(s)
-
getGlossarySubCategories
public List<GlossaryCategoryElement> getGlossarySubCategories(String userId, String assetManagerGUID, String assetManagerName, String glossaryCategoryGUID, int startFrom, int pageSize, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Retrieve the glossary category metadata element with the supplied unique identifier.- Parameters:
userId
- calling userassetManagerGUID
- unique identifier of software server capability representing the callerassetManagerName
- unique name of software server capability representing the callerglossaryCategoryGUID
- unique identifier of the requested metadata elementstartFrom
- paging start pointpageSize
- maximum results that can be returnedforLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?effectiveTime
- optional date for effective time of the query. Null means any effective timemethodName
- calling method- Returns:
- list of glossary category element
- Throws:
InvalidParameterException
- one of the parameters is invalidUserNotAuthorizedException
- the user is not authorized to issue this requestPropertyServerException
- there is a problem reported in the open metadata server(s)
-
getGlossaryCategoryByGUID
public GlossaryCategoryElement getGlossaryCategoryByGUID(String userId, String assetManagerGUID, String assetManagerName, String openMetadataGUID, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Retrieve the glossary category metadata element with the supplied unique identifier.- Parameters:
userId
- calling userassetManagerGUID
- unique identifier of software server capability representing the callerassetManagerName
- unique name of software server capability representing the calleropenMetadataGUID
- unique identifier of the requested metadata elementforLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?effectiveTime
- optional date for effective time of the query. Null means any effective timemethodName
- calling method- Returns:
- requested metadata element
- Throws:
InvalidParameterException
- one of the parameters is invalidUserNotAuthorizedException
- the user is not authorized to issue this requestPropertyServerException
- there is a problem reported in the open metadata server(s)
-
createGlossaryTerm
public String createGlossaryTerm(String userId, String glossaryGUID, MetadataCorrelationProperties correlationProperties, boolean assetManagerIsHome, GlossaryTermProperties glossaryTermProperties, String updateDescription, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing, String methodName) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Create a new metadata element to represent a glossary term.- Parameters:
userId
- calling userglossaryGUID
- unique identifier of the glossary where the term is locatedcorrelationProperties
- properties to help with the mapping of the elements in the external asset manager and open metadataassetManagerIsHome
- ensure that only the asset manager can update this elementglossaryTermProperties
- properties for the glossary termupdateDescription
- description of the update for the revision historyeffectiveTime
- the time that the retrieved elements must be effective forforLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?methodName
- calling method- Returns:
- unique identifier of the new metadata element for the glossary term
- Throws:
InvalidParameterException
- one of the parameters is invalidUserNotAuthorizedException
- the user is not authorized to issue this requestPropertyServerException
- there is a problem reported in the open metadata server(s)
-
createControlledGlossaryTerm
public String createControlledGlossaryTerm(String userId, String glossaryGUID, MetadataCorrelationProperties correlationProperties, boolean assetManagerIsHome, GlossaryTermProperties glossaryTermProperties, GlossaryTermStatus initialStatus, String updateDescription, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing, String methodName) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Create a new metadata element to represent a glossary term whose lifecycle is managed through a controlled workflow.- Parameters:
userId
- calling usercorrelationProperties
- properties to help with the mapping of the elements in the external asset manager and open metadataassetManagerIsHome
- ensure that only the asset manager can update this elementglossaryGUID
- unique identifier of the glossary where the term is locatedglossaryTermProperties
- properties for the glossary termupdateDescription
- description of the update for the revision historyinitialStatus
- glossary term status to use when the object is createdeffectiveTime
- the time that the retrieved elements must be effective forforLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?methodName
- calling method- Returns:
- unique identifier of the new metadata element for the glossary term
- Throws:
InvalidParameterException
- one of the parameters is invalidUserNotAuthorizedException
- the user is not authorized to issue this requestPropertyServerException
- there is a problem reported in the open metadata server(s)
-
createGlossaryTermFromTemplate
public String createGlossaryTermFromTemplate(String userId, MetadataCorrelationProperties correlationProperties, boolean assetManagerIsHome, String glossaryGUID, String templateGUID, TemplateProperties templateProperties, GlossaryTermStatus initialStatus, boolean deepCopy, boolean templateSubstitute, String methodName) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Create a new metadata element to represent a glossary term using an existing metadata element as a template.- Parameters:
userId
- calling usercorrelationProperties
- properties to help with the mapping of the elements in the external asset manager and open metadataassetManagerIsHome
- ensure that only the asset manager can update this elementglossaryGUID
- unique identifier of the glossary where the term is locatedtemplateGUID
- unique identifier of the metadata element to copytemplateProperties
- properties that override the templateinitialStatus
- glossary term status to use when the object is createddeepCopy
- should the template creation extend to the anchored elements or just the direct entity?templateSubstitute
- is this element a template substitute (used as the "other end" of a new/updated relationship)methodName
- calling method- Returns:
- unique identifier of the new metadata element for the glossary term
- Throws:
InvalidParameterException
- one of the parameters is invalidUserNotAuthorizedException
- the user is not authorized to issue this requestPropertyServerException
- there is a problem reported in the open metadata server(s)
-
updateGlossaryTerm
public void updateGlossaryTerm(String userId, MetadataCorrelationProperties correlationProperties, String glossaryTermGUID, GlossaryTermProperties glossaryTermProperties, String updateDescription, boolean isMergeUpdate, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Update the properties of the metadata element representing a glossary term.- Parameters:
userId
- calling usercorrelationProperties
- properties to help with the mapping of the elements in the external asset manager and open metadataglossaryTermGUID
- unique identifier of the glossary term to updateglossaryTermProperties
- new properties for the glossary termupdateDescription
- description of the update for the revision historyisMergeUpdate
- should the properties be merged with the existing properties or completely over-write themforLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?effectiveTime
- optional date for effective time of the query. Null means any effective timemethodName
- calling method- Throws:
InvalidParameterException
- one of the parameters is invalidUserNotAuthorizedException
- the user is not authorized to issue this requestPropertyServerException
- there is a problem reported in the open metadata server(s)
-
updateGlossaryTermStatus
public void updateGlossaryTermStatus(String userId, MetadataCorrelationProperties correlationProperties, String glossaryTermGUID, GlossaryTermStatus glossaryTermStatus, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Update the status of the metadata element representing a glossary term. This is only valid on a controlled glossary term.- Parameters:
userId
- calling usercorrelationProperties
- properties to help with the mapping of the elements in the external asset manager and open metadataglossaryTermGUID
- unique identifier of the glossary term to updateglossaryTermStatus
- new properties for the glossary termforLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?effectiveTime
- optional date for effective time of the query. Null means any effective timemethodName
- calling method- Throws:
InvalidParameterException
- one of the parameters is invalidUserNotAuthorizedException
- the user is not authorized to issue this requestPropertyServerException
- there is a problem reported in the open metadata server(s)
-
updateGlossaryTermFromTemplate
public void updateGlossaryTermFromTemplate(String userId, MetadataCorrelationProperties correlationProperties, String glossaryTermGUID, String templateGUID, boolean isMergeClassifications, boolean isMergeProperties, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Update the glossary term using the properties and classifications from the parentGUID stored in the request body.- Parameters:
userId
- calling usercorrelationProperties
- properties to help with the mapping of the elements in the external asset manager and open metadataglossaryTermGUID
- unique identifier of the glossary term to updatetemplateGUID
- identifier for the template glossary termisMergeClassifications
- should the classification be merged or replace the target entity?isMergeProperties
- should the properties be merged with the existing ones or replace themforLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?effectiveTime
- optional date for effective time of the query. Null means any effective timemethodName
- calling method- Throws:
InvalidParameterException
- one of the parameters is invalidUserNotAuthorizedException
- the user is not authorized to issue this requestPropertyServerException
- there is a problem reported in the open metadata server(s)
-
moveGlossaryTerm
public void moveGlossaryTerm(String userId, MetadataCorrelationProperties correlationProperties, String glossaryTermGUID, String newGlossaryGUID, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Move a glossary term from one glossary to another.- Parameters:
userId
- calling usercorrelationProperties
- properties to help with the mapping of the elements in the external asset manager and open metadataglossaryTermGUID
- unique identifier of the glossary term to updatenewGlossaryGUID
- identifier for the new glossaryforLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?effectiveTime
- optional date for effective time of the query. Null means any effective timemethodName
- calling method- Throws:
InvalidParameterException
- one of the parameters is invalidUserNotAuthorizedException
- the user is not authorized to issue this requestPropertyServerException
- there is a problem reported in the open metadata server(s)
-
setupTermCategory
public void setupTermCategory(String userId, String assetManagerGUID, String assetManagerName, String glossaryCategoryGUID, String glossaryTermGUID, GlossaryTermCategorization categorizationProperties, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Link a term to a category.- Parameters:
userId
- calling userassetManagerGUID
- unique identifier of software server capability representing the callerassetManagerName
- unique name of software server capability representing the callerglossaryCategoryGUID
- unique identifier of the glossary categoryglossaryTermGUID
- unique identifier of the glossary termcategorizationProperties
- properties for the categorization relationshipforLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?effectiveTime
- optional date for effective time of the query. Null means any effective timemethodName
- calling method- Throws:
InvalidParameterException
- one of the parameters is invalidUserNotAuthorizedException
- the user is not authorized to issue this requestPropertyServerException
- there is a problem reported in the open metadata server(s)
-
clearTermCategory
public void clearTermCategory(String userId, String assetManagerGUID, String assetManagerName, String glossaryCategoryGUID, String glossaryTermGUID, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Unlink a term from a category.- Parameters:
userId
- calling userassetManagerGUID
- unique identifier of software server capability representing the callerassetManagerName
- unique name of software server capability representing the callerglossaryCategoryGUID
- unique identifier of the glossary categoryglossaryTermGUID
- unique identifier of the glossary termforLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?effectiveTime
- optional date for effective time of the query. Null means any effective timemethodName
- calling method- Throws:
InvalidParameterException
- one of the parameters is invalidUserNotAuthorizedException
- the user is not authorized to issue this requestPropertyServerException
- there is a problem reported in the open metadata server(s)
-
getTermRelationshipTypeNames
Return the list of term-to-term relationship names.- Returns:
- list of type names that are subtypes of asset
-
setupTermRelationship
public void setupTermRelationship(String userId, String assetManagerGUID, String assetManagerName, String glossaryTermOneGUID, String relationshipTypeName, String glossaryTermTwoGUID, GlossaryTermRelationship relationshipsProperties, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Link two terms together using a specialist relationship. If there are no relationship properties then the status is set to ACTIVE and other properties are null.- Parameters:
userId
- calling userassetManagerGUID
- unique identifier of software server capability representing the callerassetManagerName
- unique name of software server capability representing the callerglossaryTermOneGUID
- unique identifier of the glossary term at end 1relationshipTypeName
- name of the type of relationship to createglossaryTermTwoGUID
- unique identifier of the glossary term at end 2relationshipsProperties
- properties for the categorization relationshipforLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?effectiveTime
- optional date for effective time of the query. Null means any effective timemethodName
- calling method- Throws:
InvalidParameterException
- one of the parameters is invalidUserNotAuthorizedException
- the user is not authorized to issue this requestPropertyServerException
- there is a problem reported in the open metadata server(s)
-
updateTermRelationship
public void updateTermRelationship(String userId, String assetManagerGUID, String assetManagerName, String glossaryTermOneGUID, String relationshipTypeName, String glossaryTermTwoGUID, GlossaryTermRelationship relationshipsProperties, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Update the relationship properties for the two terms.- Parameters:
userId
- calling userassetManagerGUID
- unique identifier of software server capability representing the callerassetManagerName
- unique name of software server capability representing the callerglossaryTermOneGUID
- unique identifier of the glossary term at end 1relationshipTypeName
- name of the type of relationship to createglossaryTermTwoGUID
- unique identifier of the glossary term at end 2relationshipsProperties
- properties for the categorization relationshipforLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?effectiveTime
- optional date for effective time of the query. Null means any effective timemethodName
- calling method- Throws:
InvalidParameterException
- one of the parameters is invalidUserNotAuthorizedException
- the user is not authorized to issue this requestPropertyServerException
- there is a problem reported in the open metadata server(s)
-
clearTermRelationship
public void clearTermRelationship(String userId, String assetManagerGUID, String assetManagerName, String glossaryTermOneGUID, String relationshipTypeName, String glossaryTermTwoGUID, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Remove the relationship between two terms.- Parameters:
userId
- calling userassetManagerGUID
- unique identifier of software server capability representing the callerassetManagerName
- unique name of software server capability representing the callerglossaryTermOneGUID
- unique identifier of the glossary term at end 1relationshipTypeName
- name of the type of relationship to createglossaryTermTwoGUID
- unique identifier of the glossary term at end 2forLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?effectiveTime
- optional date for effective time of the query. Null means any effective timemethodName
- calling method- Throws:
InvalidParameterException
- one of the parameters is invalidUserNotAuthorizedException
- the user is not authorized to issue this requestPropertyServerException
- there is a problem reported in the open metadata server(s)
-
setTermAsAbstractConcept
public void setTermAsAbstractConcept(String userId, MetadataCorrelationProperties correlationProperties, String glossaryTermGUID, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Classify the glossary term to indicate that it describes an abstract concept.- Parameters:
userId
- calling usercorrelationProperties
- properties to help with the mapping of the elements in the external asset manager and open metadataglossaryTermGUID
- unique identifier of the metadata element to updateforLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?effectiveTime
- optional date for effective time of the query. Null means any effective timemethodName
- calling method- Throws:
InvalidParameterException
- one of the parameters is invalidUserNotAuthorizedException
- the user is not authorized to issue this requestPropertyServerException
- there is a problem reported in the open metadata server(s)
-
clearTermAsAbstractConcept
public void clearTermAsAbstractConcept(String userId, MetadataCorrelationProperties correlationProperties, String glossaryTermGUID, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Remove the abstract concept designation from the glossary term.- Parameters:
userId
- calling usercorrelationProperties
- properties to help with the mapping of the elements in the external asset manager and open metadataglossaryTermGUID
- unique identifier of the metadata element to updateforLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?effectiveTime
- optional date for effective time of the query. Null means any effective timemethodName
- calling method- Throws:
InvalidParameterException
- one of the parameters is invalidUserNotAuthorizedException
- the user is not authorized to issue this requestPropertyServerException
- there is a problem reported in the open metadata server(s)
-
setTermAsDataField
public void setTermAsDataField(String userId, MetadataCorrelationProperties correlationProperties, String glossaryTermGUID, DataFieldValuesProperties properties, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Classify the glossary term to indicate that it describes a data field and supply properties that describe the characteristics of the data values found within.- Parameters:
userId
- calling usercorrelationProperties
- properties to help with the mapping of the elements in the external asset manager and open metadataglossaryTermGUID
- unique identifier of the metadata element to updateproperties
- characterizations of the data values stored in the data fieldforLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?effectiveTime
- optional date for effective time of the query. Null means any effective timemethodName
- calling method- Throws:
InvalidParameterException
- one of the parameters is invalidUserNotAuthorizedException
- the user is not authorized to issue this requestPropertyServerException
- there is a problem reported in the open metadata server(s)
-
clearTermAsDataField
public void clearTermAsDataField(String userId, MetadataCorrelationProperties correlationProperties, String glossaryTermGUID, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Remove the data field designation from the glossary term.- Parameters:
userId
- calling usercorrelationProperties
- properties to help with the mapping of the elements in the external asset manager and open metadataglossaryTermGUID
- unique identifier of the metadata element to updateforLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?effectiveTime
- optional date for effective time of the query. Null means any effective timemethodName
- calling method- Throws:
InvalidParameterException
- one of the parameters is invalidUserNotAuthorizedException
- the user is not authorized to issue this requestPropertyServerException
- there is a problem reported in the open metadata server(s)
-
setTermAsDataValue
public void setTermAsDataValue(String userId, MetadataCorrelationProperties correlationProperties, String glossaryTermGUID, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Classify the glossary term to indicate that it describes a data value.- Parameters:
userId
- calling usercorrelationProperties
- properties to help with the mapping of the elements in the external asset manager and open metadataglossaryTermGUID
- unique identifier of the metadata element to updateforLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?effectiveTime
- optional date for effective time of the query. Null means any effective timemethodName
- calling method- Throws:
InvalidParameterException
- one of the parameters is invalidUserNotAuthorizedException
- the user is not authorized to issue this requestPropertyServerException
- there is a problem reported in the open metadata server(s)
-
clearTermAsDataValue
public void clearTermAsDataValue(String userId, MetadataCorrelationProperties correlationProperties, String glossaryTermGUID, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Remove the data value designation from the glossary term.- Parameters:
userId
- calling usercorrelationProperties
- properties to help with the mapping of the elements in the external asset manager and open metadataglossaryTermGUID
- unique identifier of the metadata element to updateforLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?effectiveTime
- optional date for effective time of the query. Null means any effective timemethodName
- calling method- Throws:
InvalidParameterException
- one of the parameters is invalidUserNotAuthorizedException
- the user is not authorized to issue this requestPropertyServerException
- there is a problem reported in the open metadata server(s)
-
setTermAsActivity
public void setTermAsActivity(String userId, MetadataCorrelationProperties correlationProperties, String glossaryTermGUID, GlossaryTermActivityType activityType, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Classify the glossary term to indicate that it describes a data value.- Parameters:
userId
- calling usercorrelationProperties
- properties to help with the mapping of the elements in the external asset manager and open metadataglossaryTermGUID
- unique identifier of the metadata element to updateactivityType
- type of activityforLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?effectiveTime
- optional date for effective time of the query. Null means any effective timemethodName
- calling method- Throws:
InvalidParameterException
- one of the parameters is invalidUserNotAuthorizedException
- the user is not authorized to issue this requestPropertyServerException
- there is a problem reported in the open metadata server(s)
-
clearTermAsActivity
public void clearTermAsActivity(String userId, MetadataCorrelationProperties correlationProperties, String glossaryTermGUID, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Remove the activity designation from the glossary term.- Parameters:
userId
- calling usercorrelationProperties
- properties to help with the mapping of the elements in the external asset manager and open metadataglossaryTermGUID
- unique identifier of the metadata element to updateforLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?effectiveTime
- optional date for effective time of the query. Null means any effective timemethodName
- calling method- Throws:
InvalidParameterException
- one of the parameters is invalidUserNotAuthorizedException
- the user is not authorized to issue this requestPropertyServerException
- there is a problem reported in the open metadata server(s)
-
setTermAsContext
public void setTermAsContext(String userId, MetadataCorrelationProperties correlationProperties, String glossaryTermGUID, GlossaryTermContextDefinition contextDefinition, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Classify the glossary term to indicate that it describes a context.- Parameters:
userId
- calling usercorrelationProperties
- properties to help with the mapping of the elements in the external asset manager and open metadataglossaryTermGUID
- unique identifier of the metadata element to updatecontextDefinition
- more details of the contextforLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?effectiveTime
- optional date for effective time of the query. Null means any effective timemethodName
- calling method- Throws:
InvalidParameterException
- one of the parameters is invalidUserNotAuthorizedException
- the user is not authorized to issue this requestPropertyServerException
- there is a problem reported in the open metadata server(s)
-
clearTermAsContext
public void clearTermAsContext(String userId, MetadataCorrelationProperties correlationProperties, String glossaryTermGUID, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Remove the context definition designation from the glossary term.- Parameters:
userId
- calling usercorrelationProperties
- properties to help with the mapping of the elements in the external asset manager and open metadataglossaryTermGUID
- unique identifier of the metadata element to updateforLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?effectiveTime
- optional date for effective time of the query. Null means any effective timemethodName
- calling method- Throws:
InvalidParameterException
- one of the parameters is invalidUserNotAuthorizedException
- the user is not authorized to issue this requestPropertyServerException
- there is a problem reported in the open metadata server(s)
-
setTermAsSpineObject
public void setTermAsSpineObject(String userId, MetadataCorrelationProperties correlationProperties, String glossaryTermGUID, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Classify the glossary term to indicate that it describes a spine object.- Parameters:
userId
- calling usercorrelationProperties
- properties to help with the mapping of the elements in the external asset manager and open metadataglossaryTermGUID
- unique identifier of the metadata element to updateforLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?effectiveTime
- optional date for effective time of the query. Null means any effective timemethodName
- calling method- Throws:
InvalidParameterException
- one of the parameters is invalidUserNotAuthorizedException
- the user is not authorized to issue this requestPropertyServerException
- there is a problem reported in the open metadata server(s)
-
clearTermAsSpineObject
public void clearTermAsSpineObject(String userId, MetadataCorrelationProperties correlationProperties, String glossaryTermGUID, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Remove the spine object designation from the glossary term.- Parameters:
userId
- calling usercorrelationProperties
- properties to help with the mapping of the elements in the external asset manager and open metadataglossaryTermGUID
- unique identifier of the metadata element to updateforLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?effectiveTime
- optional date for effective time of the query. Null means any effective timemethodName
- calling method- Throws:
InvalidParameterException
- one of the parameters is invalidUserNotAuthorizedException
- the user is not authorized to issue this requestPropertyServerException
- there is a problem reported in the open metadata server(s)
-
setTermAsSpineAttribute
public void setTermAsSpineAttribute(String userId, MetadataCorrelationProperties correlationProperties, String glossaryTermGUID, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Classify the glossary term to indicate that it describes a spine attribute.- Parameters:
userId
- calling usercorrelationProperties
- properties to help with the mapping of the elements in the external asset manager and open metadataglossaryTermGUID
- unique identifier of the metadata element to updateforLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?effectiveTime
- optional date for effective time of the query. Null means any effective timemethodName
- calling method- Throws:
InvalidParameterException
- one of the parameters is invalidUserNotAuthorizedException
- the user is not authorized to issue this requestPropertyServerException
- there is a problem reported in the open metadata server(s)
-
clearTermAsSpineAttribute
public void clearTermAsSpineAttribute(String userId, MetadataCorrelationProperties correlationProperties, String glossaryTermGUID, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Remove the spine attribute designation from the glossary term.- Parameters:
userId
- calling usercorrelationProperties
- properties to help with the mapping of the elements in the external asset manager and open metadataglossaryTermGUID
- unique identifier of the metadata element to updateforLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?effectiveTime
- optional date for effective time of the query. Null means any effective timemethodName
- calling method- Throws:
InvalidParameterException
- one of the parameters is invalidUserNotAuthorizedException
- the user is not authorized to issue this requestPropertyServerException
- there is a problem reported in the open metadata server(s)
-
setTermAsObjectIdentifier
public void setTermAsObjectIdentifier(String userId, MetadataCorrelationProperties correlationProperties, String glossaryTermGUID, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Classify the glossary term to indicate that it describes an object identifier.- Parameters:
userId
- calling usercorrelationProperties
- properties to help with the mapping of the elements in the external asset manager and open metadataglossaryTermGUID
- unique identifier of the metadata element to updateforLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?effectiveTime
- optional date for effective time of the query. Null means any effective timemethodName
- calling method- Throws:
InvalidParameterException
- one of the parameters is invalidUserNotAuthorizedException
- the user is not authorized to issue this requestPropertyServerException
- there is a problem reported in the open metadata server(s)
-
clearTermAsObjectIdentifier
public void clearTermAsObjectIdentifier(String userId, MetadataCorrelationProperties correlationProperties, String glossaryTermGUID, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Remove the object identifier designation from the glossary term.- Parameters:
userId
- calling usercorrelationProperties
- properties to help with the mapping of the elements in the external asset manager and open metadataglossaryTermGUID
- unique identifier of the metadata element to updateforLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?effectiveTime
- optional date for effective time of the query. Null means any effective timemethodName
- calling method- Throws:
InvalidParameterException
- one of the parameters is invalidUserNotAuthorizedException
- the user is not authorized to issue this requestPropertyServerException
- there is a problem reported in the open metadata server(s)
-
undoGlossaryTermUpdate
public GlossaryTermElement undoGlossaryTermUpdate(String userId, MetadataCorrelationProperties correlationProperties, String glossaryTermGUID, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) throws InvalidParameterException, PropertyServerException, UserNotAuthorizedException Undo the last update to the glossary term.- Parameters:
userId
- calling usercorrelationProperties
- properties to help with the mapping of the elements in the external asset manager and open metadataglossaryTermGUID
- unique identifier of the metadata element to updateforLineage
- the request is to support lineage retrieval this means entities with the Memento classification can be returnedforDuplicateProcessing
- the request is for duplicate processing and so must not deduplicateeffectiveTime
- the time that the retrieved elements must be effective for (null for any time, new Date() for now)methodName
- calling method- Returns:
- glossary term after undo
- Throws:
InvalidParameterException
- one of the parameters is null or invalid.PropertyServerException
- there is a problem adding the new properties to the repositories.UserNotAuthorizedException
- the requesting user is not authorized to issue this request.
-
archiveGlossaryTerm
public void archiveGlossaryTerm(String userId, MetadataCorrelationProperties correlationProperties, String glossaryTermGUID, ArchiveProperties archiveProperties, boolean forDuplicateProcessing, Date effectiveTime, String methodName) throws InvalidParameterException, PropertyServerException, UserNotAuthorizedException Classify the glossary term in the repository to show that it has been archived and is only needed for lineage.- Parameters:
userId
- calling usercorrelationProperties
- properties to help with the mapping of the elements in the external asset manager and open metadataglossaryTermGUID
- unique identifier of the metadata element to updatearchiveProperties
- properties describing the archiverforDuplicateProcessing
- the request is for duplicate processing and so must not deduplicateeffectiveTime
- the time that the retrieved elements must be effective for (null for any time, new Date() for now)methodName
- calling method- Throws:
InvalidParameterException
- one of the parameters is null or invalid.PropertyServerException
- there is a problem removing the properties from the repositories.UserNotAuthorizedException
- the requesting user is not authorized to issue this request.
-
removeGlossaryTerm
public void removeGlossaryTerm(String userId, MetadataCorrelationProperties correlationProperties, String glossaryTermGUID, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Remove the metadata element representing a glossary term.- Parameters:
userId
- calling usercorrelationProperties
- properties to help with the mapping of the elements in the external asset manager and open metadataglossaryTermGUID
- unique identifier of the metadata element to updateforLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?effectiveTime
- optional date for effective time of the query. Null means any effective timemethodName
- calling method- Throws:
InvalidParameterException
- one of the parameters is invalidUserNotAuthorizedException
- the user is not authorized to issue this requestPropertyServerException
- there is a problem reported in the open metadata server(s)
-
findGlossaryTerms
public List<GlossaryTermElement> findGlossaryTerms(String userId, String assetManagerGUID, String assetManagerName, String glossaryGUID, String searchString, List<GlossaryTermStatus> limitResultsByStatus, int startFrom, int pageSize, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Retrieve the list of glossary term metadata elements that contain the search string. The search string is treated as a regular expression.- Parameters:
userId
- calling userassetManagerGUID
- unique identifier of software server capability representing the callerassetManagerName
- unique name of software server capability representing the callerglossaryGUID
- unique identifier of the glossary to querysearchString
- string to find in the propertieslimitResultsByStatus
- By default, terms 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.startFrom
- paging start pointpageSize
- maximum results that can be returnedforLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?effectiveTime
- optional date for effective time of the query. Null means any effective timemethodName
- calling method- Returns:
- list of matching metadata elements
- Throws:
InvalidParameterException
- one of the parameters is invalidUserNotAuthorizedException
- the user is not authorized to issue this requestPropertyServerException
- there is a problem reported in the open metadata server(s)
-
getTermsForGlossary
public List<GlossaryTermElement> getTermsForGlossary(String userId, String assetManagerGUID, String assetManagerName, String glossaryGUID, int startFrom, int pageSize, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Retrieve the list of glossary terms associated with a glossary.- Parameters:
userId
- calling userassetManagerGUID
- unique identifier of software server capability representing the callerassetManagerName
- unique name of software server capability representing the callerglossaryGUID
- unique identifier of the glossary of intereststartFrom
- paging start pointpageSize
- maximum results that can be returnedforLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?effectiveTime
- optional date for effective time of the query. Null means any effective timemethodName
- calling method- Returns:
- list of associated metadata elements
- Throws:
InvalidParameterException
- one of the parameters is invalidUserNotAuthorizedException
- the user is not authorized to issue this requestPropertyServerException
- there is a problem reported in the open metadata server(s)
-
getTermsForGlossaryCategory
public List<GlossaryTermElement> getTermsForGlossaryCategory(String userId, String assetManagerGUID, String assetManagerName, String glossaryCategoryGUID, List<GlossaryTermRelationshipStatus> limitResultsByStatus, int startFrom, int pageSize, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Retrieve the list of glossary terms associated with a glossary category.- Parameters:
userId
- calling userassetManagerGUID
- unique identifier of software server capability representing the callerassetManagerName
- unique name of software server capability representing the callerglossaryCategoryGUID
- unique identifier of the glossary category of interestlimitResultsByStatus
- By default, term 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.startFrom
- paging start pointpageSize
- maximum results that can be returnedforLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?effectiveTime
- optional date for effective time of the query. Null means any effective timemethodName
- calling method- Returns:
- list of associated metadata elements
- Throws:
InvalidParameterException
- one of the parameters is invalidUserNotAuthorizedException
- the user is not authorized to issue this requestPropertyServerException
- there is a problem reported in the open metadata server(s)
-
getRelatedTerms
public List<GlossaryTermElement> getRelatedTerms(String userId, String assetManagerGUID, String assetManagerName, String glossaryTermGUID, String relationshipTypeName, List<GlossaryTermRelationshipStatus> limitResultsByStatus, int startFrom, int pageSize, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Retrieve the list of glossary terms associated with the requested glossary term.- Parameters:
userId
- calling userassetManagerGUID
- unique identifier of software server capability representing the callerassetManagerName
- unique name of software server capability representing the callerglossaryTermGUID
- unique identifier of the glossary term of interestrelationshipTypeName
- optional name of relationshiplimitResultsByStatus
- By default, term 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.startFrom
- paging start pointpageSize
- maximum results that can be returnedforLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?effectiveTime
- optional date for effective time of the query. Null means any effective timemethodName
- calling method- Returns:
- list of associated metadata elements
- Throws:
InvalidParameterException
- one of the parameters is invalidUserNotAuthorizedException
- the user is not authorized to issue this requestPropertyServerException
- there is a problem reported in the open metadata server(s)
-
getGlossaryTermsByName
public List<GlossaryTermElement> getGlossaryTermsByName(String userId, String assetManagerGUID, String assetManagerName, String glossaryGUID, String name, List<GlossaryTermStatus> limitResultsByStatus, int startFrom, int pageSize, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Retrieve the list of glossary term metadata elements with a matching qualified or display name. There are no wildcards supported on this request.- Parameters:
userId
- calling userassetManagerGUID
- unique identifier of software server capability representing the callerassetManagerName
- unique name of software server capability representing the callerglossaryGUID
- unique identifier of the glossary to queryname
- name to search forlimitResultsByStatus
- By default, terms 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.startFrom
- paging start pointpageSize
- maximum results that can be returnedforLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?effectiveTime
- optional date for effective time of the query. Null means any effective timemethodName
- calling method- Returns:
- list of matching metadata elements
- Throws:
InvalidParameterException
- one of the parameters is invalidUserNotAuthorizedException
- the user is not authorized to issue this requestPropertyServerException
- there is a problem reported in the open metadata server(s)
-
getGlossaryTermByGUID
public GlossaryTermElement getGlossaryTermByGUID(String userId, String assetManagerGUID, String assetManagerName, String guid, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Retrieve the glossary term metadata element with the supplied unique identifier.- Parameters:
userId
- calling userassetManagerGUID
- unique identifier of software server capability representing the callerassetManagerName
- unique name of software server capability representing the callerguid
- unique identifier of the requested metadata elementforLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?effectiveTime
- optional date for effective time of the query. Null means any effective timemethodName
- calling method- Returns:
- matching metadata element
- Throws:
InvalidParameterException
- one of the parameters is invalidUserNotAuthorizedException
- the user is not authorized to issue this requestPropertyServerException
- there is a problem reported in the open metadata server(s)
-
getGlossaryTermHistory
public List<GlossaryTermElement> getGlossaryTermHistory(String userId, String assetManagerGUID, String assetManagerName, String guid, Date fromTime, Date toTime, int startFrom, int pageSize, boolean oldestFirst, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) throws InvalidParameterException, PropertyServerException, UserNotAuthorizedException Retrieve all the versions of a glossary term.- Parameters:
userId
- calling userassetManagerGUID
- unique identifier of software server capability representing the callerassetManagerName
- unique name of software server capability representing the callerguid
- unique identifier of object to retrievefromTime
- 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)startFrom
- 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.oldestFirst
- defining how the results should be ordered.forLineage
- the request is to support lineage retrieval this means entities with the Memento classification can be returnedforDuplicateProcessing
- the request is for duplicate processing and so must not deduplicateeffectiveTime
- the time that the retrieved elements must be effective for (null for any time, new Date() for now)methodName
- calling method- Returns:
- list of beans
- Throws:
InvalidParameterException
- one of the parameters is null or invalid.PropertyServerException
- there is a problem removing the properties from the repositories.UserNotAuthorizedException
- the requesting user is not authorized to issue this request.
-
getMeanings
public List<GlossaryTermElement> getMeanings(String userId, String assetManagerGUID, String assetManagerName, String glossaryTermGUID, int startFrom, int pageSize, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) throws InvalidParameterException, PropertyServerException, UserNotAuthorizedException Retrieve the glossary terms linked via a "SemanticAssignment" relationship to the requested element.- Parameters:
userId
- calling userassetManagerGUID
- unique identifier of software server capability representing the callerassetManagerName
- unique name of software server capability representing the callerglossaryTermGUID
- unique identifier of object to retrievestartFrom
- 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.forLineage
- the request is to support lineage retrieval this means entities with the Memento classification can be returnedforDuplicateProcessing
- the request is for duplicate processing and so must not deduplicateeffectiveTime
- the time that the retrieved elements must be effective for (null for any time, new Date() for now)methodName
- calling method- Returns:
- list of beans
- Throws:
InvalidParameterException
- one of the parameters is null or invalid.PropertyServerException
- there is a problem removing the properties from the repositories.UserNotAuthorizedException
- the requesting user is not authorized to issue this request.
-
createExternalGlossaryLink
public String createExternalGlossaryLink(String userId, String assetManagerGUID, String assetManagerName, ExternalGlossaryLinkProperties linkProperties, String methodName) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Create a link to an external glossary resource. This is associated with a glossary to show that they have equivalent content. It is possible that this resource was generated from the glossary content or was the source for it.- Parameters:
userId
- calling userassetManagerGUID
- unique identifier of software server capability representing the callerassetManagerName
- unique name of software server capability representing the callerlinkProperties
- properties of the linkmethodName
- calling method- Returns:
- unique identifier of the external reference
- Throws:
InvalidParameterException
- one of the parameters is invalidUserNotAuthorizedException
- the user is not authorized to issue this requestPropertyServerException
- there is a problem reported in the open metadata server(s)
-
updateExternalGlossaryLink
public void updateExternalGlossaryLink(String userId, String assetManagerGUID, String assetManagerName, String externalLinkGUID, ExternalGlossaryLinkProperties linkProperties, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Update the properties of a reference to an external glossary resource.- Parameters:
userId
- calling userassetManagerGUID
- unique identifier of software server capability representing the callerassetManagerName
- unique name of software server capability representing the callerexternalLinkGUID
- unique identifier of the external referencelinkProperties
- properties of the linkforLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?effectiveTime
- optional date for effective time of the query. Null means any effective timemethodName
- calling method- Throws:
InvalidParameterException
- one of the parameters is invalidUserNotAuthorizedException
- the user is not authorized to issue this requestPropertyServerException
- there is a problem reported in the open metadata server(s)
-
removeExternalGlossaryLink
public void removeExternalGlossaryLink(String userId, String assetManagerGUID, String assetManagerName, String externalLinkGUID, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Remove information about a link to an external glossary resource (and the relationships that attached it to the glossaries).- Parameters:
userId
- calling userassetManagerGUID
- unique identifier of software server capability representing the callerassetManagerName
- unique name of software server capability representing the callerexternalLinkGUID
- unique identifier of the external referenceforLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?effectiveTime
- optional date for effective time of the query. Null means any effective timemethodName
- calling method- Throws:
InvalidParameterException
- one of the parameters is invalidUserNotAuthorizedException
- the user is not authorized to issue this requestPropertyServerException
- there is a problem reported in the open metadata server(s)
-
attachExternalLinkToGlossary
public void attachExternalLinkToGlossary(String userId, String assetManagerGUID, String assetManagerName, String glossaryGUID, String externalLinkGUID, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Connect a glossary to a reference to an external glossary resource.- Parameters:
userId
- calling userassetManagerGUID
- unique identifier of software server capability representing the callerassetManagerName
- unique name of software server capability representing the callerexternalLinkGUID
- unique identifier of the external referenceglossaryGUID
- unique identifier of the metadata element to attachforLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?effectiveTime
- optional date for effective time of the query. Null means any effective timemethodName
- calling method- Throws:
InvalidParameterException
- one of the parameters is invalidUserNotAuthorizedException
- the user is not authorized to issue this requestPropertyServerException
- there is a problem reported in the open metadata server(s)
-
detachExternalLinkFromGlossary
public void detachExternalLinkFromGlossary(String userId, String assetManagerGUID, String assetManagerName, String glossaryGUID, String externalLinkGUID, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Disconnect a glossary from a reference to an external glossary resource.- Parameters:
userId
- calling userassetManagerGUID
- unique identifier of software server capability representing the callerassetManagerName
- unique name of software server capability representing the callerexternalLinkGUID
- unique identifier of the external referenceglossaryGUID
- unique identifier of the metadata element to removeforLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?effectiveTime
- optional date for effective time of the query. Null means any effective timemethodName
- calling method- Throws:
InvalidParameterException
- one of the parameters is invalidUserNotAuthorizedException
- the user is not authorized to issue this requestPropertyServerException
- there is a problem reported in the open metadata server(s)
-
getExternalLinksForGlossary
public List<ExternalGlossaryLinkElement> getExternalLinksForGlossary(String userId, String glossaryGUID, int startFrom, int pageSize, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Retrieve the list of links to external glossary resources attached to a glossary.- Parameters:
userId
- calling userglossaryGUID
- unique identifier of the metadata element for the glossary of intereststartFrom
- paging start pointpageSize
- maximum results that can be returnedforLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?effectiveTime
- optional date for effective time of the query. Null means any effective timemethodName
- calling method- Returns:
- list of attached links to external glossary resources
- Throws:
InvalidParameterException
- one of the parameters is invalidUserNotAuthorizedException
- the user is not authorized to issue this requestPropertyServerException
- there is a problem reported in the open metadata server(s)
-
getGlossariesForExternalLink
public List<GlossaryElement> getGlossariesForExternalLink(String userId, String assetManagerGUID, String assetManagerName, String externalLinkGUID, int startFrom, int pageSize, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Return the glossaries connected to an external glossary source.- Parameters:
userId
- calling userassetManagerGUID
- unique identifier of software server capability representing the callerassetManagerName
- unique name of software server capability representing the callerexternalLinkGUID
- unique identifier of the metadata element for the external glossary link of intereststartFrom
- paging start pointpageSize
- maximum results that can be returnedforLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?effectiveTime
- optional date for effective time of the query. Null means any effective timemethodName
- calling method- Returns:
- list of glossaries
- Throws:
InvalidParameterException
- one of the parameters is invalidUserNotAuthorizedException
- the user is not authorized to issue this requestPropertyServerException
- there is a problem reported in the open metadata server(s)
-
attachExternalCategoryLink
public void attachExternalCategoryLink(String userId, String assetManagerGUID, String assetManagerName, String glossaryCategoryGUID, String externalLinkGUID, ExternalGlossaryElementLinkProperties linkProperties, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Create a link to an external glossary category resource. This is associated with a category to show that they have equivalent content. It is possible that this resource was generated from the glossary content or was the source for it.- Parameters:
userId
- calling userassetManagerGUID
- unique identifier of software server capability representing the callerassetManagerName
- unique name of software server capability representing the callerexternalLinkGUID
- unique identifier of the external referenceglossaryCategoryGUID
- unique identifier for the glossary categorylinkProperties
- properties of the linkforLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?effectiveTime
- optional date for effective time of the query. Null means any effective timemethodName
- calling method- Throws:
InvalidParameterException
- one of the parameters is invalidUserNotAuthorizedException
- the user is not authorized to issue this requestPropertyServerException
- there is a problem reported in the open metadata server(s)
-
detachExternalCategoryLink
public void detachExternalCategoryLink(String userId, String assetManagerGUID, String assetManagerName, String glossaryCategoryGUID, String externalLinkGUID, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Remove the link to an external glossary category resource.- Parameters:
userId
- calling userassetManagerGUID
- unique identifier of software server capability representing the callerassetManagerName
- unique name of software server capability representing the callerexternalLinkGUID
- unique identifier of the external referenceglossaryCategoryGUID
- unique identifier for the glossary categoryforLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?effectiveTime
- optional date for effective time of the query. Null means any effective timemethodName
- calling method- Throws:
InvalidParameterException
- one of the parameters is invalidUserNotAuthorizedException
- the user is not authorized to issue this requestPropertyServerException
- there is a problem reported in the open metadata server(s)
-
attachExternalTermLink
public void attachExternalTermLink(String userId, String assetManagerGUID, String assetManagerName, String glossaryTermGUID, String externalLinkGUID, ExternalGlossaryElementLinkProperties linkProperties, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Create a link to an external glossary term resource. This is associated with a term to show that they have equivalent content. It is possible that this resource was generated from the glossary content or was the source for it.- Parameters:
userId
- calling userassetManagerGUID
- unique identifier of software server capability representing the callerassetManagerName
- unique name of software server capability representing the callerexternalLinkGUID
- unique identifier of the external referenceglossaryTermGUID
- unique identifier for the glossary categorylinkProperties
- properties of the linkforLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?effectiveTime
- optional date for effective time of the query. Null means any effective timemethodName
- calling method- Throws:
InvalidParameterException
- one of the parameters is invalidUserNotAuthorizedException
- the user is not authorized to issue this requestPropertyServerException
- there is a problem reported in the open metadata server(s)
-
detachExternalTermLink
public void detachExternalTermLink(String userId, String assetManagerGUID, String assetManagerName, String glossaryTermGUID, String externalLinkGUID, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Remove the link to an external glossary term resource.- Parameters:
userId
- calling userassetManagerGUID
- unique identifier of software server capability representing the callerassetManagerName
- unique name of software server capability representing the callerexternalLinkGUID
- unique identifier of the external referenceglossaryTermGUID
- unique identifier for the glossary categoryforLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?effectiveTime
- optional date for effective time of the query. Null means any effective timemethodName
- calling method- Throws:
InvalidParameterException
- one of the parameters is invalidUserNotAuthorizedException
- the user is not authorized to issue this requestPropertyServerException
- there is a problem reported in the open metadata server(s)
-
setElementAsDataField
public void setElementAsDataField(String userId, MetadataCorrelationProperties correlationProperties, String elementGUID, DataFieldValuesProperties properties, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Classify the element to indicate that it describes a data field and supply properties that describe the characteristics of the data values found within.- Parameters:
userId
- calling usercorrelationProperties
- properties to help with the mapping of the elements in the external asset manager and open metadataelementGUID
- unique identifier of the metadata element to updateproperties
- characterizations of the data values stored in the data fieldforLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?effectiveTime
- optional date for effective time of the query. Null means any effective timemethodName
- calling method- Throws:
InvalidParameterException
- one of the parameters is invalidUserNotAuthorizedException
- the user is not authorized to issue this requestPropertyServerException
- there is a problem reported in the open metadata server(s)
-
clearElementAsDataField
public void clearElementAsDataField(String userId, MetadataCorrelationProperties correlationProperties, String elementGUID, boolean forLineage, boolean forDuplicateProcessing, Date effectiveTime, String methodName) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Remove the data field designation from the element.- Parameters:
userId
- calling usercorrelationProperties
- properties to help with the mapping of the elements in the external asset manager and open metadataelementGUID
- unique identifier of the metadata element to updateforLineage
- return elements marked with the Memento classification?forDuplicateProcessing
- do not merge elements marked as duplicates?effectiveTime
- optional date for effective time of the query. Null means any effective timemethodName
- calling method- Throws:
InvalidParameterException
- one of the parameters is invalidUserNotAuthorizedException
- the user is not authorized to issue this requestPropertyServerException
- there is a problem reported in the open metadata server(s)
-