Class GlossaryExchangeService
java.lang.Object
org.odpi.openmetadata.integrationservices.catalog.connector.GlossaryExchangeService
GlossaryExchangeService is the client for managing resources from a glossary. This includes
the glossary container, glossary categories and terms as well as relationships between them.
-
Method Summary
Modifier and TypeMethodDescriptionvoid
attachExternalCategoryLink
(String externalLinkGUID, String glossaryCategoryGUID, ExternalGlossaryElementLinkProperties linkProperties, Date effectiveTime) Create a link to an external glossary category resource.void
attachExternalLinkToGlossary
(String externalLinkGUID, String glossaryGUID, Date effectiveTime) Connect a glossary to a reference to an external glossary resource.void
attachExternalTermLink
(String externalLinkGUID, String glossaryTermGUID, ExternalGlossaryElementLinkProperties linkProperties, Date effectiveTime) Create a link to an external glossary term resource.void
clearCategoryParent
(String glossaryParentCategoryGUID, String glossaryChildCategoryGUID, Date effectiveTime) Remove a parent-child relationship between two categories.void
clearGlossaryAsCanonical
(String glossaryGUID, String glossaryExternalIdentifier, Date effectiveTime) Remove the canonical designation from the glossary.void
clearGlossaryAsTaxonomy
(String glossaryGUID, String glossaryExternalIdentifier, Date effectiveTime) Remove the taxonomy designation from the glossary.void
clearTermAsAbstractConcept
(String glossaryTermGUID, String glossaryTermExternalIdentifier, Date effectiveTime) Remove the abstract concept designation from the glossary term.void
clearTermAsActivity
(String glossaryTermGUID, String glossaryTermExternalIdentifier, Date effectiveTime) Remove the activity designation from the glossary term.void
clearTermAsContext
(String glossaryTermGUID, String glossaryTermExternalIdentifier, Date effectiveTime) Remove the context definition designation from the glossary term.void
clearTermAsDataValue
(String glossaryTermGUID, String glossaryTermExternalIdentifier, Date effectiveTime) Remove the data value designation from the glossary term.void
clearTermAsObjectIdentifier
(String glossaryTermGUID, String glossaryTermExternalIdentifier, Date effectiveTime) Remove the object identifier designation from the glossary term.void
clearTermAsSpineAttribute
(String glossaryTermGUID, String glossaryTermExternalIdentifier, Date effectiveTime) Remove the spine attribute designation from the glossary term.void
clearTermAsSpineObject
(String glossaryTermGUID, String glossaryTermExternalIdentifier, Date effectiveTime) Remove the spine object designation from the glossary term.void
clearTermCategory
(String glossaryCategoryGUID, String glossaryTermGUID, Date effectiveTime) Unlink a term from a category.void
clearTermRelationship
(String relationshipTypeName, String glossaryTermOneGUID, String glossaryTermTwoGUID, Date effectiveTime) Remove the relationship between two terms.createControlledGlossaryTerm
(boolean assetManagerIsHome, String glossaryGUID, ExternalIdentifierProperties externalIdentifierProperties, GlossaryTermProperties glossaryTermProperties, GlossaryTermStatus initialStatus, Date effectiveTime) Create a new metadata element to represent a glossary term whose lifecycle is managed through a controlled workflow.createExternalGlossaryLink
(ExternalGlossaryLinkProperties linkProperties) Create a link to an external glossary resource.createGlossary
(boolean assetManagerIsHome, ExternalIdentifierProperties externalIdentifierProperties, GlossaryProperties glossaryProperties) Create a new metadata element to represent the root of a glossary.createGlossaryCategory
(String glossaryGUID, boolean assetManagerIsHome, ExternalIdentifierProperties externalIdentifierProperties, GlossaryCategoryProperties glossaryCategoryProperties, boolean isRootCategory, Date effectiveTime) Create a new metadata element to represent a glossary category.createGlossaryCategoryFromTemplate
(String glossaryGUID, boolean assetManagerIsHome, String templateGUID, ExternalIdentifierProperties externalIdentifierProperties, TemplateProperties templateProperties, boolean deepCopy) Create a new metadata element to represent a glossary category using an existing metadata element as a template.createGlossaryFromTemplate
(boolean assetManagerIsHome, String templateGUID, ExternalIdentifierProperties externalIdentifierProperties, TemplateProperties templateProperties, boolean deepCopy) Create a new metadata element to represent a glossary using an existing metadata element as a template.createGlossaryTerm
(String glossaryGUID, boolean assetManagerIsHome, ExternalIdentifierProperties externalIdentifierProperties, GlossaryTermProperties glossaryTermProperties, Date effectiveTime) Create a new metadata element to represent a glossary term.createGlossaryTermFromTemplate
(String glossaryGUID, boolean assetManagerIsHome, String templateGUID, ExternalIdentifierProperties externalIdentifierProperties, TemplateProperties templateProperties, boolean deepCopy, GlossaryTermStatus initialStatus) Create a new metadata element to represent a glossary term using an existing metadata element as a template.void
detachExternalCategoryLink
(String externalLinkGUID, String glossaryCategoryGUID, Date effectiveTime) Remove the link to an external glossary category resource.void
detachExternalLinkFromGlossary
(String externalLinkGUID, String glossaryGUID, Date effectiveTime) Disconnect a glossary from a reference to an external glossary resource.void
detachExternalTermLink
(String externalLinkGUID, String glossaryTermGUID, Date effectiveTime) Remove the link to an external glossary term resource.findGlossaries
(String searchString, int startFrom, int pageSize, Date effectiveTime) Retrieve the list of glossary metadata elements that contain the search string.findGlossaryCategories
(String searchString, int startFrom, int pageSize, Date effectiveTime) Retrieve the list of glossary category metadata elements that contain the search string.findGlossaryCategories
(String glossaryGUID, String searchString, int startFrom, int pageSize, Date effectiveTime) Retrieve the list of glossary category metadata elements that contain the search string.findGlossaryTerms
(String searchString, int startFrom, int pageSize, Date effectiveTime) Retrieve the list of glossary term metadata elements that contain the search string.findGlossaryTerms
(String glossaryGUID, String searchString, List<GlossaryTermStatus> limitResultsByStatus, int startFrom, int pageSize, Date effectiveTime) Retrieve the list of glossary term metadata elements that contain the search string.getCategoriesForGlossary
(String glossaryGUID, int startFrom, int pageSize, Date effectiveTime) Return the list of categories associated with a glossary.getCategoriesForTerm
(String glossaryTermGUID, int startFrom, int pageSize, Date effectiveTime) Return the list of categories associated with a glossary term.getExternalLinksForGlossary
(String glossaryGUID, int startFrom, int pageSize, Date effectiveTime) Retrieve the list of links to external glossary resources attached to a glossary.getGlossariesByName
(String name, int startFrom, int pageSize, Date effectiveTime) Retrieve the list of glossary metadata elements with a matching qualified or display name.getGlossariesForAssetManager
(int startFrom, int pageSize, Date effectiveTime) Retrieve the list of glossaries created on behalf of this asset manager.getGlossariesForExternalLink
(String externalLinkGUID, int startFrom, int pageSize, Date effectiveTime) Return the glossaries connected to an external glossary source.getGlossaryByGUID
(String glossaryGUID, Date effectiveTime) Retrieve the glossary metadata element with the supplied unique identifier.getGlossaryCategoriesByName
(String name, int startFrom, int pageSize, Date effectiveTime) Retrieve the list of glossary category metadata elements with a matching qualified or display name.getGlossaryCategoriesByName
(String glossaryGUID, String name, int startFrom, int pageSize, Date effectiveTime) Retrieve the list of glossary category metadata elements with a matching qualified or display name.getGlossaryCategoryByGUID
(String guid, Date effectiveTime) Retrieve the glossary category metadata element with the supplied unique identifier.getGlossaryCategoryParent
(String glossaryCategoryGUID, Date effectiveTime) Retrieve the glossary category metadata element with the supplied unique identifier.getGlossaryForCategory
(String glossaryCategoryGUID, Date effectiveTime) Retrieve the glossary metadata element for the requested category.getGlossaryForTerm
(String glossaryTermGUID, Date effectiveTime) Retrieve the glossary metadata element for the requested term.getGlossarySubCategories
(String glossaryCategoryGUID, int startFrom, int pageSize, Date effectiveTime) Retrieve the glossary category metadata element with the supplied unique identifier.getGlossaryTermByGUID
(String guid, Date effectiveTime) Retrieve the glossary term metadata element with the supplied unique identifier.getGlossaryTermsByName
(String name, int startFrom, int pageSize, Date effectiveTime) Retrieve the list of glossary term metadata elements with a matching qualified or display name.getGlossaryTermsByName
(String glossaryGUID, String name, List<GlossaryTermStatus> limitResultsByStatus, int startFrom, int pageSize, Date effectiveTime) Retrieve the list of glossary term metadata elements with a matching qualified or display name.getRelatedTerms
(String glossaryTermGUID, String relationshipTypeName, List<GlossaryTermRelationshipStatus> limitResultsByStatus, int startFrom, int pageSize, Date effectiveTime) Retrieve the list of glossary terms associated with the requested glossary term.getTermsForGlossary
(String glossaryGUID, int startFrom, int pageSize, Date effectiveTime) Retrieve the list of glossary terms associated with a glossary.getTermsForGlossaryCategory
(String glossaryCategoryGUID, List<GlossaryTermRelationshipStatus> limitResultsByStatus, int startFrom, int pageSize, Date effectiveTime) Retrieve the list of glossary terms associated with a glossary category.boolean
Return whether retrieval requests from this service are to avoid merging duplicates or not.boolean
Return whether retrieval requests from this service are to include elements with the Memento classification attached or not.void
removeExternalGlossaryLink
(String externalLinkGUID, Date effectiveTime) Remove information about a link to an external glossary resource (and the relationships that attached it to the glossaries).void
removeGlossary
(String glossaryGUID, String glossaryExternalIdentifier, Date effectiveTime) Remove the metadata element representing a glossary.void
removeGlossaryCategory
(String glossaryCategoryGUID, String glossaryCategoryExternalIdentifier, Date effectiveTime) Remove the metadata element representing a glossary category.void
removeGlossaryTerm
(String glossaryTermGUID, String glossaryTermExternalIdentifier, Date effectiveTime) Remove the metadata element representing a glossary term.void
setForDuplicateProcessing
(boolean forDuplicateProcessing) Set up whether retrieval requests from this service are to avoid merging duplicates or not.void
setForLineage
(boolean forLineage) Set up whether retrieval requests from this service are to include elements with the Memento classification attached or not.void
setGlossaryAsCanonical
(String glossaryGUID, String glossaryExternalIdentifier, CanonicalVocabularyProperties properties, Date effectiveTime) Classify a glossary to declare that it has no two GlossaryTerm definitions with the same name.void
setGlossaryAsTaxonomy
(String glossaryGUID, String glossaryExternalIdentifier, TaxonomyProperties properties, Date effectiveTime) Classify the glossary to indicate that it can be used as a taxonomy.void
setTermAsAbstractConcept
(String glossaryTermGUID, String glossaryTermExternalIdentifier, Date effectiveTime) Classify the glossary term to indicate that it describes an abstract concept.void
setTermAsActivity
(String glossaryTermGUID, String glossaryTermExternalIdentifier, ActivityDescriptionProperties properties, Date effectiveTime) Classify the glossary term to indicate that it describes a data value.void
setTermAsContext
(String glossaryTermGUID, String glossaryTermExternalIdentifier, GlossaryTermContextDefinition contextDefinition, Date effectiveTime) Classify the glossary term to indicate that it describes a context.void
setTermAsDataValue
(String glossaryTermGUID, String glossaryTermExternalIdentifier, Date effectiveTime) Classify the glossary term to indicate that it describes a data value.void
setTermAsObjectIdentifier
(String glossaryTermGUID, String glossaryTermExternalIdentifier, Date effectiveTime) Classify the glossary term to indicate that it describes an object identifier.void
setTermAsSpineAttribute
(String glossaryTermGUID, String glossaryTermExternalIdentifier, Date effectiveTime) Classify the glossary term to indicate that it describes a spine attribute.void
setTermAsSpineObject
(String glossaryTermGUID, String glossaryTermExternalIdentifier, Date effectiveTime) Classify the glossary term to indicate that it describes a spine object.void
setupCategoryParent
(String glossaryParentCategoryGUID, String glossaryChildCategoryGUID, Date effectiveTime) Create a parent-child relationship between two categories.void
setupTermCategory
(String glossaryCategoryGUID, String glossaryTermGUID, GlossaryTermCategorization categorizationProperties, Date effectiveTime) Link a term to a category.void
setupTermRelationship
(String relationshipTypeName, String glossaryTermOneGUID, String glossaryTermTwoGUID, GlossaryTermRelationship relationshipsProperties, Date effectiveTime) Link two terms together using a specialist relationship.void
updateExternalGlossaryLink
(String externalLinkGUID, boolean isMergeUpdate, ExternalGlossaryLinkProperties linkProperties, Date effectiveTime) Update the properties of a reference to an external glossary resource.void
updateGlossary
(String glossaryGUID, String glossaryExternalIdentifier, boolean isMergeUpdate, GlossaryProperties glossaryProperties, Date effectiveTime) Update the metadata element representing a glossary.void
updateGlossaryCategory
(String glossaryCategoryGUID, String glossaryCategoryExternalIdentifier, boolean isMergeUpdate, GlossaryCategoryProperties glossaryCategoryProperties, Date effectiveTime) Update the metadata element representing a glossary category.void
updateGlossaryTerm
(String glossaryTermGUID, String glossaryTermExternalIdentifier, boolean isMergeUpdate, GlossaryTermProperties glossaryTermProperties, Date effectiveTime) Update the properties of the metadata element representing a glossary term.void
updateGlossaryTermStatus
(String glossaryTermGUID, String glossaryTermExternalIdentifier, GlossaryTermStatus glossaryTermStatus, Date effectiveTime) Update the status of the metadata element representing a glossary term.void
updateTermRelationship
(String relationshipTypeName, String glossaryTermOneGUID, String glossaryTermTwoGUID, GlossaryTermRelationship relationshipsProperties, Date effectiveTime) Update the relationship properties for the two terms.
-
Method Details
-
isForLineage
public boolean isForLineage()Return whether retrieval requests from this service are to include elements with the Memento classification attached or not.- Returns:
- boolean flag
-
setForLineage
public void setForLineage(boolean forLineage) Set up whether retrieval requests from this service are to include elements with the Memento classification attached or not.- Parameters:
forLineage
- boolean flag
-
isForDuplicateProcessing
public boolean isForDuplicateProcessing()Return whether retrieval requests from this service are to avoid merging duplicates or not.- Returns:
- boolean flag
-
setForDuplicateProcessing
public void setForDuplicateProcessing(boolean forDuplicateProcessing) Set up whether retrieval requests from this service are to avoid merging duplicates or not.- Parameters:
forDuplicateProcessing
- boolean flag
-
createGlossary
public String createGlossary(boolean assetManagerIsHome, ExternalIdentifierProperties externalIdentifierProperties, GlossaryProperties glossaryProperties) 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:
assetManagerIsHome
- ensure that only the asset manager can update this assetexternalIdentifierProperties
- optional properties used to define an external identifierglossaryProperties
- properties to store- 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(boolean assetManagerIsHome, String templateGUID, ExternalIdentifierProperties externalIdentifierProperties, TemplateProperties templateProperties, boolean deepCopy) 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:
assetManagerIsHome
- ensure that only the asset manager can update this elementtemplateGUID
- unique identifier of the metadata element to copyexternalIdentifierProperties
- optional properties used to define an external identifiertemplateProperties
- properties that override the templatedeepCopy
- should the template creation extend to the anchored elements or just the direct entity?- 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 glossaryGUID, String glossaryExternalIdentifier, boolean isMergeUpdate, GlossaryProperties glossaryProperties, Date effectiveTime) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Update the metadata element representing a glossary.- Parameters:
glossaryGUID
- unique identifier of the metadata element to updateglossaryExternalIdentifier
- unique identifier of the glossary in the external asset managerisMergeUpdate
- should the new properties be merged with existing properties (true) or completely replace them (false)?glossaryProperties
- new properties for this elementeffectiveTime
- the time that the retrieved elements must be effective for- 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 glossaryGUID, String glossaryExternalIdentifier, Date effectiveTime) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Remove the metadata element representing a glossary. This will delete the glossary and all categories and terms - use with care :)- Parameters:
glossaryGUID
- unique identifier of the metadata element to removeglossaryExternalIdentifier
- unique identifier of the glossary in the external asset managereffectiveTime
- the time that the retrieved elements must be effective for- 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 glossaryGUID, String glossaryExternalIdentifier, TaxonomyProperties properties, Date effectiveTime) 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:
glossaryGUID
- unique identifier of the metadata element to removeglossaryExternalIdentifier
- unique identifier of the glossary in the external asset managerproperties
- description of how the glossary is organizedeffectiveTime
- the time that the retrieved elements must be effective for- 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 glossaryGUID, String glossaryExternalIdentifier, Date effectiveTime) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Remove the taxonomy designation from the glossary.- Parameters:
glossaryGUID
- unique identifier of the metadata element to removeglossaryExternalIdentifier
- unique identifier of the glossary in the external asset managereffectiveTime
- the time that the retrieved elements must be effective for- 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 glossaryGUID, String glossaryExternalIdentifier, CanonicalVocabularyProperties properties, Date effectiveTime) 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:
glossaryGUID
- unique identifier of the metadata element to removeglossaryExternalIdentifier
- unique identifier of the glossary in the external asset managerproperties
- description of the situations where this glossary is relevant.effectiveTime
- the time that the retrieved elements must be effective for- 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 glossaryGUID, String glossaryExternalIdentifier, Date effectiveTime) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Remove the canonical designation from the glossary.- Parameters:
glossaryGUID
- unique identifier of the metadata element to removeglossaryExternalIdentifier
- unique identifier of the glossary in the external asset managereffectiveTime
- the time that the retrieved elements must be effective for- 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 searchString, int startFrom, int pageSize, Date effectiveTime) 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:
searchString
- string to find in the propertiesstartFrom
- paging start pointpageSize
- maximum results that can be returnedeffectiveTime
- the time that the retrieved elements must be effective for- 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 name, int startFrom, int pageSize, Date effectiveTime) 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:
name
- name to search forstartFrom
- paging start pointpageSize
- maximum results that can be returnedeffectiveTime
- the time that the retrieved elements must be effective for- 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(int startFrom, int pageSize, Date effectiveTime) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Retrieve the list of glossaries created on behalf of this asset manager.- Parameters:
startFrom
- paging start pointpageSize
- maximum results that can be returnedeffectiveTime
- the time that the retrieved elements must be effective for- 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 glossaryGUID, Date effectiveTime) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Retrieve the glossary metadata element with the supplied unique identifier.- Parameters:
glossaryGUID
- unique identifier of the requested metadata elementeffectiveTime
- the time that the retrieved elements must be effective for- 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 glossaryCategoryGUID, Date effectiveTime) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Retrieve the glossary metadata element for the requested category.- Parameters:
glossaryCategoryGUID
- unique identifier of the requested metadata elementeffectiveTime
- the time that the retrieved elements must be effective for- 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 glossaryTermGUID, Date effectiveTime) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Retrieve the glossary metadata element for the requested term.- Parameters:
glossaryTermGUID
- unique identifier of the requested metadata elementeffectiveTime
- the time that the retrieved elements must be effective for- 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 glossaryGUID, boolean assetManagerIsHome, ExternalIdentifierProperties externalIdentifierProperties, GlossaryCategoryProperties glossaryCategoryProperties, boolean isRootCategory, Date effectiveTime) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Create a new metadata element to represent a glossary category.- Parameters:
glossaryGUID
- unique identifier of anchor glossaryassetManagerIsHome
- ensure that only the asset manager can update this elementexternalIdentifierProperties
- optional properties used to define an external identifierglossaryCategoryProperties
- properties about the glossary category to storeisRootCategory
- is this category a root category?effectiveTime
- the time that the retrieved elements must be effective for- 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 glossaryGUID, boolean assetManagerIsHome, String templateGUID, ExternalIdentifierProperties externalIdentifierProperties, TemplateProperties templateProperties, boolean deepCopy) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Create a new metadata element to represent a glossary category using an existing metadata element as a template.- Parameters:
glossaryGUID
- unique identifier of the glossary where the category is locatedassetManagerIsHome
- ensure that only the asset manager can update this elementtemplateGUID
- unique identifier of the metadata element to copyexternalIdentifierProperties
- optional properties used to define an external identifiertemplateProperties
- properties that override the templatedeepCopy
- should the template creation extend to the anchored elements or just the direct entity?- 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 glossaryCategoryGUID, String glossaryCategoryExternalIdentifier, boolean isMergeUpdate, GlossaryCategoryProperties glossaryCategoryProperties, Date effectiveTime) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Update the metadata element representing a glossary category.- Parameters:
glossaryCategoryGUID
- unique identifier of the metadata element to updateglossaryCategoryExternalIdentifier
- unique identifier of the glossary category in the external asset managerisMergeUpdate
- should the new properties be merged with existing properties (true) or completely replace them (false)?glossaryCategoryProperties
- new properties for the metadata elementeffectiveTime
- the time that the retrieved elements must be effective for- 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 glossaryParentCategoryGUID, String glossaryChildCategoryGUID, Date effectiveTime) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Create a parent-child relationship between two categories.- Parameters:
glossaryParentCategoryGUID
- 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 subcategoryeffectiveTime
- the time that the retrieved elements must be effective for- 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 glossaryParentCategoryGUID, String glossaryChildCategoryGUID, Date effectiveTime) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Remove a parent-child relationship between two categories.- Parameters:
glossaryParentCategoryGUID
- 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 subcategoryeffectiveTime
- the time that the retrieved elements must be effective for- 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 glossaryCategoryGUID, String glossaryCategoryExternalIdentifier, Date effectiveTime) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Remove the metadata element representing a glossary category.- Parameters:
glossaryCategoryGUID
- unique identifier of the metadata element to removeglossaryCategoryExternalIdentifier
- unique identifier of the glossary category in the external asset managereffectiveTime
- the time that the retrieved elements must be effective for- 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 searchString, int startFrom, int pageSize, Date effectiveTime) 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:
searchString
- string to find in the propertiesstartFrom
- paging start pointpageSize
- maximum results that can be returnedeffectiveTime
- the time that the retrieved elements must be effective for- 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)
-
findGlossaryCategories
public List<GlossaryCategoryElement> findGlossaryCategories(String glossaryGUID, String searchString, int startFrom, int pageSize, Date effectiveTime) 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:
glossaryGUID
- optional glossary unique identifier to scope the search to a glossary.searchString
- string to find in the propertiesstartFrom
- paging start pointpageSize
- maximum results that can be returnedeffectiveTime
- the time that the retrieved elements must be effective for- 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 glossaryGUID, int startFrom, int pageSize, Date effectiveTime) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Return the list of categories associated with a glossary.- Parameters:
glossaryGUID
- unique identifier of the glossary to querystartFrom
- paging start pointpageSize
- maximum results that can be returnedeffectiveTime
- the time that the retrieved elements must be effective for- 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 glossaryTermGUID, int startFrom, int pageSize, Date effectiveTime) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Return the list of categories associated with a glossary term.- Parameters:
glossaryTermGUID
- unique identifier of the glossary term to querystartFrom
- paging start pointpageSize
- maximum results that can be returnedeffectiveTime
- the time that the retrieved elements must be effective for- 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 name, int startFrom, int pageSize, Date effectiveTime) 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:
name
- name to search forstartFrom
- paging start pointpageSize
- maximum results that can be returnedeffectiveTime
- the time that the retrieved elements must be effective for- 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)
-
getGlossaryCategoriesByName
public List<GlossaryCategoryElement> getGlossaryCategoriesByName(String glossaryGUID, String name, int startFrom, int pageSize, Date effectiveTime) 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:
glossaryGUID
- optional glossary unique identifier to scope the search to a glossary.name
- name to search forstartFrom
- paging start pointpageSize
- maximum results that can be returnedeffectiveTime
- the time that the retrieved elements must be effective for- 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)
-
getGlossaryCategoryByGUID
public GlossaryCategoryElement getGlossaryCategoryByGUID(String guid, Date effectiveTime) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Retrieve the glossary category metadata element with the supplied unique identifier.- Parameters:
guid
- unique identifier of the requested metadata elementeffectiveTime
- the time that the retrieved elements must be effective for- 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)
-
getGlossaryCategoryParent
public GlossaryCategoryElement getGlossaryCategoryParent(String glossaryCategoryGUID, Date effectiveTime) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Retrieve the glossary category metadata element with the supplied unique identifier.- Parameters:
glossaryCategoryGUID
- unique identifier of the requested metadata elementeffectiveTime
- the time that the retrieved elements must be effective for- 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 glossaryCategoryGUID, int startFrom, int pageSize, Date effectiveTime) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Retrieve the glossary category metadata element with the supplied unique identifier.- Parameters:
glossaryCategoryGUID
- unique identifier of the requested metadata elementstartFrom
- paging start pointpageSize
- maximum results that can be returnedeffectiveTime
- the time that the retrieved elements must be effective for- 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)
-
createGlossaryTerm
public String createGlossaryTerm(String glossaryGUID, boolean assetManagerIsHome, ExternalIdentifierProperties externalIdentifierProperties, GlossaryTermProperties glossaryTermProperties, Date effectiveTime) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Create a new metadata element to represent a glossary term.- Parameters:
assetManagerIsHome
- ensure that only the asset manager can update this elementglossaryGUID
- unique identifier of the glossary where the term is locatedexternalIdentifierProperties
- optional properties used to define an external identifierglossaryTermProperties
- properties for the glossary termeffectiveTime
- the time that the retrieved elements must be effective for- 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(boolean assetManagerIsHome, String glossaryGUID, ExternalIdentifierProperties externalIdentifierProperties, GlossaryTermProperties glossaryTermProperties, GlossaryTermStatus initialStatus, Date effectiveTime) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Create a new metadata element to represent a glossary term whose lifecycle is managed through a controlled workflow.- Parameters:
assetManagerIsHome
- ensure that only the asset manager can update this elementglossaryGUID
- unique identifier of the glossary where the term is locatedexternalIdentifierProperties
- optional properties used to define an external identifierglossaryTermProperties
- properties for the glossary terminitialStatus
- glossary term status to use when the object is createdeffectiveTime
- the time that the retrieved elements must be effective for- 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 glossaryGUID, boolean assetManagerIsHome, String templateGUID, ExternalIdentifierProperties externalIdentifierProperties, TemplateProperties templateProperties, boolean deepCopy, GlossaryTermStatus initialStatus) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Create a new metadata element to represent a glossary term using an existing metadata element as a template.- Parameters:
glossaryGUID
- unique identifier of the glossary where the category is locatedassetManagerIsHome
- ensure that only the asset manager can update this elementtemplateGUID
- unique identifier of the metadata element to copyexternalIdentifierProperties
- optional properties used to define an external identifiertemplateProperties
- properties that override the templatedeepCopy
- should the template creation extend to the anchored elements or just the direct entity?initialStatus
- what status should the copy be set to- 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 glossaryTermGUID, String glossaryTermExternalIdentifier, boolean isMergeUpdate, GlossaryTermProperties glossaryTermProperties, Date effectiveTime) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Update the properties of the metadata element representing a glossary term.- Parameters:
glossaryTermGUID
- unique identifier of the glossary term to updateglossaryTermExternalIdentifier
- unique identifier of the glossary term in the external asset managerisMergeUpdate
- should the new properties be merged with existing properties (true) or completely replace them (false)?glossaryTermProperties
- new properties for the glossary termeffectiveTime
- the time that the retrieved elements must be effective for- 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 glossaryTermGUID, String glossaryTermExternalIdentifier, GlossaryTermStatus glossaryTermStatus, Date effectiveTime) 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:
glossaryTermGUID
- unique identifier of the glossary term to updateglossaryTermExternalIdentifier
- unique identifier of the glossary term in the external asset managerglossaryTermStatus
- new properties for the glossary termeffectiveTime
- the time that the retrieved elements must be effective for- 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 glossaryCategoryGUID, String glossaryTermGUID, GlossaryTermCategorization categorizationProperties, Date effectiveTime) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Link a term to a category.- Parameters:
glossaryCategoryGUID
- unique identifier of the glossary categoryglossaryTermGUID
- unique identifier of the glossary termcategorizationProperties
- properties for the categorization relationshipeffectiveTime
- the time that the retrieved elements must be effective for- 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 glossaryCategoryGUID, String glossaryTermGUID, Date effectiveTime) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Unlink a term from a category.- Parameters:
glossaryCategoryGUID
- unique identifier of the glossary categoryglossaryTermGUID
- unique identifier of the glossary termeffectiveTime
- the time that the retrieved elements must be effective for- 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)
-
setupTermRelationship
public void setupTermRelationship(String relationshipTypeName, String glossaryTermOneGUID, String glossaryTermTwoGUID, GlossaryTermRelationship relationshipsProperties, Date effectiveTime) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Link two terms together using a specialist relationship.- Parameters:
relationshipTypeName
- name of the type of relationship to createglossaryTermOneGUID
- unique identifier of the glossary term at end 1glossaryTermTwoGUID
- unique identifier of the glossary term at end 2relationshipsProperties
- properties for the categorization relationshipeffectiveTime
- the time that the retrieved elements must be effective for- 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 relationshipTypeName, String glossaryTermOneGUID, String glossaryTermTwoGUID, GlossaryTermRelationship relationshipsProperties, Date effectiveTime) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Update the relationship properties for the two terms.- Parameters:
relationshipTypeName
- name of the type of relationship to createglossaryTermOneGUID
- unique identifier of the glossary term at end 1glossaryTermTwoGUID
- unique identifier of the glossary term at end 2relationshipsProperties
- properties for the categorization relationshipeffectiveTime
- the time that the retrieved elements must be effective for- 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 relationshipTypeName, String glossaryTermOneGUID, String glossaryTermTwoGUID, Date effectiveTime) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Remove the relationship between two terms.- Parameters:
relationshipTypeName
- name of the type of relationship to createglossaryTermOneGUID
- unique identifier of the glossary term at end 1glossaryTermTwoGUID
- unique identifier of the glossary term at end 2effectiveTime
- the time that the retrieved elements must be effective for- 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 glossaryTermGUID, String glossaryTermExternalIdentifier, Date effectiveTime) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Classify the glossary term to indicate that it describes an abstract concept.- Parameters:
glossaryTermGUID
- unique identifier of the metadata element to updateglossaryTermExternalIdentifier
- unique identifier of the glossary term in the external asset managereffectiveTime
- the time that the retrieved elements must be effective for- 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 glossaryTermGUID, String glossaryTermExternalIdentifier, Date effectiveTime) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Remove the abstract concept designation from the glossary term.- Parameters:
glossaryTermGUID
- unique identifier of the metadata element to updateglossaryTermExternalIdentifier
- unique identifier of the glossary term in the external asset managereffectiveTime
- the time that the retrieved elements must be effective for- 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 glossaryTermGUID, String glossaryTermExternalIdentifier, Date effectiveTime) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Classify the glossary term to indicate that it describes a data value.- Parameters:
glossaryTermGUID
- unique identifier of the metadata element to updateglossaryTermExternalIdentifier
- unique identifier of the glossary term in the external asset managereffectiveTime
- the time that the retrieved elements must be effective for- 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 glossaryTermGUID, String glossaryTermExternalIdentifier, Date effectiveTime) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Remove the data value designation from the glossary term.- Parameters:
glossaryTermGUID
- unique identifier of the metadata element to updateglossaryTermExternalIdentifier
- unique identifier of the glossary term in the external asset managereffectiveTime
- the time that the retrieved elements must be effective for- 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 glossaryTermGUID, String glossaryTermExternalIdentifier, ActivityDescriptionProperties properties, Date effectiveTime) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Classify the glossary term to indicate that it describes a data value.- Parameters:
glossaryTermGUID
- unique identifier of the metadata element to updateglossaryTermExternalIdentifier
- unique identifier of the glossary term in the external asset managerproperties
- type of activityeffectiveTime
- the time that the retrieved elements must be effective for- 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 glossaryTermGUID, String glossaryTermExternalIdentifier, Date effectiveTime) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Remove the activity designation from the glossary term.- Parameters:
glossaryTermGUID
- unique identifier of the metadata element to updateglossaryTermExternalIdentifier
- unique identifier of the glossary term in the external asset managereffectiveTime
- the time that the retrieved elements must be effective for- 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 glossaryTermGUID, String glossaryTermExternalIdentifier, GlossaryTermContextDefinition contextDefinition, Date effectiveTime) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Classify the glossary term to indicate that it describes a context.- Parameters:
glossaryTermGUID
- unique identifier of the metadata element to updateglossaryTermExternalIdentifier
- unique identifier of the glossary term in the external asset managercontextDefinition
- more details of the contexteffectiveTime
- the time that the retrieved elements must be effective for- 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 glossaryTermGUID, String glossaryTermExternalIdentifier, Date effectiveTime) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Remove the context definition designation from the glossary term.- Parameters:
glossaryTermGUID
- unique identifier of the metadata element to updateglossaryTermExternalIdentifier
- unique identifier of the glossary term in the external asset managereffectiveTime
- the time that the retrieved elements must be effective for- 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 glossaryTermGUID, String glossaryTermExternalIdentifier, Date effectiveTime) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Classify the glossary term to indicate that it describes a spine object.- Parameters:
glossaryTermGUID
- unique identifier of the metadata element to updateglossaryTermExternalIdentifier
- unique identifier of the glossary term in the external asset managereffectiveTime
- the time that the retrieved elements must be effective for- 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 glossaryTermGUID, String glossaryTermExternalIdentifier, Date effectiveTime) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Remove the spine object designation from the glossary term.- Parameters:
glossaryTermGUID
- unique identifier of the metadata element to updateglossaryTermExternalIdentifier
- unique identifier of the glossary term in the external asset managereffectiveTime
- the time that the retrieved elements must be effective for- 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 glossaryTermGUID, String glossaryTermExternalIdentifier, Date effectiveTime) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Classify the glossary term to indicate that it describes a spine attribute.- Parameters:
glossaryTermGUID
- unique identifier of the metadata element to updateglossaryTermExternalIdentifier
- unique identifier of the glossary term in the external asset managereffectiveTime
- the time that the retrieved elements must be effective for- 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 glossaryTermGUID, String glossaryTermExternalIdentifier, Date effectiveTime) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Remove the spine attribute designation from the glossary term.- Parameters:
glossaryTermGUID
- unique identifier of the metadata element to updateglossaryTermExternalIdentifier
- unique identifier of the glossary term in the external asset managereffectiveTime
- the time that the retrieved elements must be effective for- 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 glossaryTermGUID, String glossaryTermExternalIdentifier, Date effectiveTime) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Classify the glossary term to indicate that it describes an object identifier.- Parameters:
glossaryTermGUID
- unique identifier of the metadata element to updateglossaryTermExternalIdentifier
- unique identifier of the glossary term in the external asset managereffectiveTime
- the time that the retrieved elements must be effective for- 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 glossaryTermGUID, String glossaryTermExternalIdentifier, Date effectiveTime) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Remove the object identifier designation from the glossary term.- Parameters:
glossaryTermGUID
- unique identifier of the metadata element to updateglossaryTermExternalIdentifier
- unique identifier of the glossary term in the external asset managereffectiveTime
- the time that the retrieved elements must be effective for- 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)
-
removeGlossaryTerm
public void removeGlossaryTerm(String glossaryTermGUID, String glossaryTermExternalIdentifier, Date effectiveTime) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Remove the metadata element representing a glossary term.- Parameters:
glossaryTermGUID
- unique identifier of the metadata element to removeglossaryTermExternalIdentifier
- unique identifier of the glossary term in the external asset managereffectiveTime
- the time that the retrieved elements must be effective for- 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 searchString, int startFrom, int pageSize, Date effectiveTime) 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:
searchString
- string to find in the propertiesstartFrom
- paging start pointpageSize
- maximum results that can be returnedeffectiveTime
- the time that the retrieved elements must be effective for- 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)
-
findGlossaryTerms
public List<GlossaryTermElement> findGlossaryTerms(String glossaryGUID, String searchString, List<GlossaryTermStatus> limitResultsByStatus, int startFrom, int pageSize, Date effectiveTime) 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:
glossaryGUID
- 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 returnedeffectiveTime
- the time that the retrieved elements must be effective for- 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 glossaryGUID, int startFrom, int pageSize, Date effectiveTime) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Retrieve the list of glossary terms associated with a glossary.- Parameters:
glossaryGUID
- unique identifier of the glossary of intereststartFrom
- paging start pointpageSize
- maximum results that can be returnedeffectiveTime
- the time that the retrieved elements must be effective for- 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 glossaryCategoryGUID, List<GlossaryTermRelationshipStatus> limitResultsByStatus, int startFrom, int pageSize, Date effectiveTime) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Retrieve the list of glossary terms associated with a glossary category.- Parameters:
glossaryCategoryGUID
- 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 returnedeffectiveTime
- the time that the retrieved elements must be effective for- 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 glossaryTermGUID, String relationshipTypeName, List<GlossaryTermRelationshipStatus> limitResultsByStatus, int startFrom, int pageSize, Date effectiveTime) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Retrieve the list of glossary terms associated with the requested glossary term.- Parameters:
glossaryTermGUID
- unique identifier of the glossary 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 returnedeffectiveTime
- the time that the retrieved elements must be effective for- 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 name, int startFrom, int pageSize, Date effectiveTime) 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:
name
- name to search forstartFrom
- paging start pointpageSize
- maximum results that can be returnedeffectiveTime
- the time that the retrieved elements must be effective for- 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)
-
getGlossaryTermsByName
public List<GlossaryTermElement> getGlossaryTermsByName(String glossaryGUID, String name, List<GlossaryTermStatus> limitResultsByStatus, int startFrom, int pageSize, Date effectiveTime) 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:
glossaryGUID
- 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 returnedeffectiveTime
- the time that the retrieved elements must be effective for- 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 guid, Date effectiveTime) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Retrieve the glossary term metadata element with the supplied unique identifier.- Parameters:
guid
- unique identifier of the requested metadata elementeffectiveTime
- the time that the retrieved elements must be effective for- 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)
-
createExternalGlossaryLink
public String createExternalGlossaryLink(ExternalGlossaryLinkProperties linkProperties) 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:
linkProperties
- properties of the link- 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 externalLinkGUID, boolean isMergeUpdate, ExternalGlossaryLinkProperties linkProperties, Date effectiveTime) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Update the properties of a reference to an external glossary resource.- Parameters:
externalLinkGUID
- unique identifier of the external referencelinkProperties
- properties of the linkisMergeUpdate
- should the new properties be merged with existing properties (true) or completely replace them (false)?effectiveTime
- the time that the retrieved elements must be effective for- 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 externalLinkGUID, Date effectiveTime) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Remove information about a link to an external glossary resource (and the relationships that attached it to the glossaries).- Parameters:
externalLinkGUID
- unique identifier of the external referenceeffectiveTime
- the time that the retrieved elements must be effective for- 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 externalLinkGUID, String glossaryGUID, Date effectiveTime) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Connect a glossary to a reference to an external glossary resource.- Parameters:
externalLinkGUID
- unique identifier of the external referenceglossaryGUID
- unique identifier of the metadata element to attacheffectiveTime
- the time that the retrieved elements must be effective for- 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 externalLinkGUID, String glossaryGUID, Date effectiveTime) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Disconnect a glossary from a reference to an external glossary resource.- Parameters:
externalLinkGUID
- unique identifier of the external referenceglossaryGUID
- unique identifier of the metadata element to removeeffectiveTime
- the time that the retrieved elements must be effective for- 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 glossaryGUID, int startFrom, int pageSize, Date effectiveTime) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Retrieve the list of links to external glossary resources attached to a glossary.- Parameters:
glossaryGUID
- unique identifier of the metadata element for the glossary of intereststartFrom
- paging start pointpageSize
- maximum results that can be returnedeffectiveTime
- the time that the retrieved elements must be effective for- 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 externalLinkGUID, int startFrom, int pageSize, Date effectiveTime) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Return the glossaries connected to an external glossary source.- Parameters:
externalLinkGUID
- unique identifier of the metadata element for the external glossary link of intereststartFrom
- paging start pointpageSize
- maximum results that can be returnedeffectiveTime
- the time that the retrieved elements must be effective for- 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 externalLinkGUID, String glossaryCategoryGUID, ExternalGlossaryElementLinkProperties linkProperties, Date effectiveTime) 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:
externalLinkGUID
- unique identifier of the external referenceglossaryCategoryGUID
- unique identifier for the glossary categorylinkProperties
- properties of the linkeffectiveTime
- the time that the retrieved elements must be effective for- 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 externalLinkGUID, String glossaryCategoryGUID, Date effectiveTime) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Remove the link to an external glossary category resource.- Parameters:
externalLinkGUID
- unique identifier of the external referenceglossaryCategoryGUID
- unique identifier for the glossary categoryeffectiveTime
- the time that the retrieved elements must be effective for- 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 externalLinkGUID, String glossaryTermGUID, ExternalGlossaryElementLinkProperties linkProperties, Date effectiveTime) 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:
externalLinkGUID
- unique identifier of the external referenceglossaryTermGUID
- unique identifier for the glossary categorylinkProperties
- properties of the linkeffectiveTime
- the time that the retrieved elements must be effective for- 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 externalLinkGUID, String glossaryTermGUID, Date effectiveTime) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException Remove the link to an external glossary term resource.- Parameters:
externalLinkGUID
- unique identifier of the external referenceglossaryTermGUID
- unique identifier for the glossary categoryeffectiveTime
- the time that the retrieved elements must be effective for- 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)
-