Class GlossaryExchangeClient
- java.lang.Object
-
- org.odpi.openmetadata.accessservices.assetmanager.client.ExchangeClientBase
-
- org.odpi.openmetadata.accessservices.assetmanager.client.GlossaryExchangeClient
-
- All Implemented Interfaces:
GlossaryExchangeInterface
public class GlossaryExchangeClient extends ExchangeClientBase implements GlossaryExchangeInterface
GlossaryExchangeClient is the client for managing resources from a glossary.
-
-
Constructor Summary
Constructors Constructor Description GlossaryExchangeClient(String serverName, String serverPlatformURLRoot)Create a new client with no authentication embedded in the HTTP request.GlossaryExchangeClient(String serverName, String serverPlatformURLRoot, String userId, String password)Create a new client that passes userId and password in each HTTP request.GlossaryExchangeClient(String serverName, String serverPlatformURLRoot, String userId, String password, AuditLog auditLog)Create a new client that passes userId and password in each HTTP request.GlossaryExchangeClient(String serverName, String serverPlatformURLRoot, AssetManagerRESTClient restClient, int maxPageSize, AuditLog auditLog)Create a new client that is going to be used in an OMAG Server.GlossaryExchangeClient(String serverName, String serverPlatformURLRoot, AuditLog auditLog)Create a new client with no authentication embedded in the HTTP request.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description voidattachExternalCategoryLink(String userId, String assetManagerGUID, String assetManagerName, String externalLinkGUID, String glossaryCategoryGUID, ExternalGlossaryElementLinkProperties linkProperties, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)Create a link to an external glossary category resource.voidattachExternalLinkToGlossary(String userId, String assetManagerGUID, String assetManagerName, String externalLinkGUID, String glossaryGUID, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)Connect a glossary to a reference to an external glossary resource.voidattachExternalTermLink(String userId, String assetManagerGUID, String assetManagerName, String externalLinkGUID, String glossaryTermGUID, ExternalGlossaryElementLinkProperties linkProperties, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)Create a link to an external glossary term resource.voidclearCategoryParent(String userId, String assetManagerGUID, String assetManagerName, String glossaryParentCategoryGUID, String glossaryChildCategoryGUID, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)Remove a parent-child relationship between two categories.voidclearGlossaryAsCanonical(String userId, String assetManagerGUID, String assetManagerName, String glossaryGUID, String glossaryExternalIdentifier)Remove the canonical designation from the glossary.voidclearGlossaryAsTaxonomy(String userId, String assetManagerGUID, String assetManagerName, String glossaryGUID, String glossaryExternalIdentifier)Remove the taxonomy designation from the glossary.voidclearTermAsAbstractConcept(String userId, String assetManagerGUID, String assetManagerName, String glossaryTermGUID, String glossaryTermExternalIdentifier, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)Remove the abstract concept designation from the glossary term.voidclearTermAsActivity(String userId, String assetManagerGUID, String assetManagerName, String glossaryTermGUID, String glossaryTermExternalIdentifier, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)Remove the activity designation from the glossary term.voidclearTermAsContext(String userId, String assetManagerGUID, String assetManagerName, String glossaryTermGUID, String glossaryTermExternalIdentifier, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)Remove the context definition designation from the glossary term.voidclearTermAsDataValue(String userId, String assetManagerGUID, String assetManagerName, String glossaryTermGUID, String glossaryTermExternalIdentifier, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)Remove the data value designation from the glossary term.voidclearTermAsObjectIdentifier(String userId, String assetManagerGUID, String assetManagerName, String glossaryTermGUID, String glossaryTermExternalIdentifier, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)Remove the object identifier designation from the glossary term.voidclearTermAsSpineAttribute(String userId, String assetManagerGUID, String assetManagerName, String glossaryTermGUID, String glossaryTermExternalIdentifier, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)Remove the spine attribute designation from the glossary term.voidclearTermAsSpineObject(String userId, String assetManagerGUID, String assetManagerName, String glossaryTermGUID, String glossaryTermExternalIdentifier, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)Remove the spine object designation from the glossary term.voidclearTermCategory(String userId, String assetManagerGUID, String assetManagerName, String glossaryCategoryGUID, String glossaryTermGUID, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)Unlink a term from a category.voidclearTermRelationship(String userId, String assetManagerGUID, String assetManagerName, String relationshipTypeName, String glossaryTermOneGUID, String glossaryTermTwoGUID, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)Remove the relationship between two terms.StringcreateControlledGlossaryTerm(String userId, String assetManagerGUID, String assetManagerName, String glossaryGUID, ExternalIdentifierProperties externalIdentifierProperties, GlossaryTermProperties glossaryTermProperties, GlossaryTermStatus initialStatus)Create a new metadata element to represent a glossary term whose lifecycle is managed through a controlled workflow.StringcreateExternalGlossaryLink(String userId, String assetManagerGUID, String assetManagerName, ExternalGlossaryLinkProperties linkProperties)Create a link to an external glossary resource.StringcreateGlossary(String userId, String assetManagerGUID, String assetManagerName, ExternalIdentifierProperties externalIdentifierProperties, GlossaryProperties glossaryProperties)Create a new metadata element to represent the root of a glossary.StringcreateGlossaryCategory(String userId, String assetManagerGUID, String assetManagerName, String glossaryGUID, ExternalIdentifierProperties externalIdentifierProperties, GlossaryCategoryProperties glossaryCategoryProperties)Create a new metadata element to represent a glossary category.StringcreateGlossaryCategoryFromTemplate(String userId, String assetManagerGUID, String assetManagerName, String templateGUID, ExternalIdentifierProperties externalIdentifierProperties, TemplateProperties templateProperties)Create a new metadata element to represent a glossary category using an existing metadata element as a template.StringcreateGlossaryFromTemplate(String userId, String assetManagerGUID, String assetManagerName, String templateGUID, ExternalIdentifierProperties externalIdentifierProperties, TemplateProperties templateProperties)Create a new metadata element to represent a glossary using an existing metadata element as a template.StringcreateGlossaryTerm(String userId, String assetManagerGUID, String assetManagerName, String glossaryGUID, ExternalIdentifierProperties externalIdentifierProperties, GlossaryTermProperties glossaryTermProperties)Create a new metadata element to represent a glossary term.StringcreateGlossaryTermFromTemplate(String userId, String assetManagerGUID, String assetManagerName, String templateGUID, ExternalIdentifierProperties externalIdentifierProperties, TemplateProperties templateProperties)Create a new metadata element to represent a glossary term using an existing metadata element as a template.voiddetachExternalCategoryLink(String userId, String assetManagerGUID, String assetManagerName, String externalLinkGUID, String glossaryCategoryGUID, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)Remove the link to an external glossary category resource.voiddetachExternalLinkFromGlossary(String userId, String assetManagerGUID, String assetManagerName, String externalLinkGUID, String glossaryGUID, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)Disconnect a glossary from a reference to an external glossary resource.voiddetachExternalTermLink(String userId, String assetManagerGUID, String assetManagerName, String externalLinkGUID, String glossaryTermGUID, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)Remove the link to an external glossary term resource.List<GlossaryElement>findGlossaries(String userId, String assetManagerGUID, String assetManagerName, String searchString, int startFrom, int pageSize)Retrieve the list of glossary metadata elements that contain the search string.List<GlossaryCategoryElement>findGlossaryCategories(String userId, String assetManagerGUID, String assetManagerName, String searchString, int startFrom, int pageSize, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)Retrieve the list of glossary category metadata elements that contain the search string.List<GlossaryTermElement>findGlossaryTerms(String userId, String assetManagerGUID, String assetManagerName, String searchString, int startFrom, int pageSize, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)Retrieve the list of glossary term metadata elements that contain the search string.List<GlossaryCategoryElement>getCategoriesForGlossary(String userId, String assetManagerGUID, String assetManagerName, String glossaryGUID, int startFrom, int pageSize, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)Return the list of categories associated with a glossary.List<ExternalGlossaryLinkElement>getExternalLinksForGlossary(String userId, String assetManagerGUID, String assetManagerName, String glossaryGUID, int startFrom, int pageSize, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)Retrieve the list of links to external glossary resources attached to a glossary.List<GlossaryElement>getGlossariesByName(String userId, String assetManagerGUID, String assetManagerName, String name, int startFrom, int pageSize)Retrieve the list of glossary metadata elements with a matching qualified or display name.List<GlossaryElement>getGlossariesForAssetManager(String userId, String assetManagerGUID, String assetManagerName, int startFrom, int pageSize)Retrieve the list of glossaries created on behalf of the named asset manager.List<GlossaryElement>getGlossariesForExternalLink(String userId, String assetManagerGUID, String assetManagerName, String externalLinkGUID, int startFrom, int pageSize, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)Return the glossaries connected to an external glossary source.GlossaryElementgetGlossaryByGUID(String userId, String assetManagerGUID, String assetManagerName, String guid)Retrieve the glossary metadata element with the supplied unique identifier.List<GlossaryCategoryElement>getGlossaryCategoriesByName(String userId, String assetManagerGUID, String assetManagerName, String name, int startFrom, int pageSize, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)Retrieve the list of glossary category metadata elements with a matching qualified or display name.GlossaryCategoryElementgetGlossaryCategoryByGUID(String userId, String assetManagerGUID, String assetManagerName, String glossaryCategoryGUID, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)Retrieve the glossary category metadata element with the supplied unique identifier.GlossaryCategoryElementgetGlossaryCategoryParent(String userId, String assetManagerGUID, String assetManagerName, String glossaryCategoryGUID, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)Retrieve the glossary category metadata element with the supplied unique identifier.List<GlossaryCategoryElement>getGlossarySubCategories(String userId, String assetManagerGUID, String assetManagerName, String glossaryCategoryGUID, int startFrom, int pageSize, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)Retrieve the glossary category metadata element with the supplied unique identifier.GlossaryTermElementgetGlossaryTermByGUID(String userId, String assetManagerGUID, String assetManagerName, String glossaryTermGUID, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)Retrieve the glossary term metadata element with the supplied unique identifier.List<GlossaryTermElement>getGlossaryTermsByName(String userId, String assetManagerGUID, String assetManagerName, String name, int startFrom, int pageSize, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)Retrieve the list of glossary term metadata elements with a matching qualified or display name.List<GlossaryTermElement>getTermsForGlossary(String userId, String assetManagerGUID, String assetManagerName, String glossaryGUID, int startFrom, int pageSize, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)Retrieve the list of glossary terms associated with a glossary.List<GlossaryTermElement>getTermsForGlossaryCategory(String userId, String assetManagerGUID, String assetManagerName, String glossaryCategoryGUID, int startFrom, int pageSize, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)Retrieve the list of glossary terms associated with a glossary category.voidremoveExternalGlossaryLink(String userId, String assetManagerGUID, String assetManagerName, String externalLinkGUID, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)Remove information about a link to an external glossary resource (and the relationships that attached it to the glossaries).voidremoveGlossary(String userId, String assetManagerGUID, String assetManagerName, String glossaryGUID, String glossaryExternalIdentifier)Remove the metadata element representing a glossary.voidremoveGlossaryCategory(String userId, String assetManagerGUID, String assetManagerName, String glossaryCategoryGUID, String glossaryCategoryExternalIdentifier, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)Remove the metadata element representing a glossary category.voidremoveGlossaryTerm(String userId, String assetManagerGUID, String assetManagerName, String glossaryTermGUID, String glossaryTermExternalIdentifier, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)Remove the metadata element representing a glossary term.voidsetGlossaryAsCanonical(String userId, String assetManagerGUID, String assetManagerName, String glossaryGUID, String glossaryExternalIdentifier, String scope)Classify a glossary to declare that it has no two GlossaryTerm definitions with the same name.voidsetGlossaryAsTaxonomy(String userId, String assetManagerGUID, String assetManagerName, String glossaryGUID, String glossaryExternalIdentifier, String organizingPrinciple)Classify the glossary to indicate that it can be used as a taxonomy.voidsetTermAsAbstractConcept(String userId, String assetManagerGUID, String assetManagerName, String glossaryTermGUID, String glossaryTermExternalIdentifier, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)Classify the glossary term to indicate that it describes an abstract concept.voidsetTermAsActivity(String userId, String assetManagerGUID, String assetManagerName, String glossaryTermGUID, String glossaryTermExternalIdentifier, GlossaryTermActivityType activityType, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)Classify the glossary term to indicate that it describes a data value.voidsetTermAsContext(String userId, String assetManagerGUID, String assetManagerName, String glossaryTermGUID, String glossaryTermExternalIdentifier, GlossaryTermContextDefinition contextDefinition, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)Classify the glossary term to indicate that it describes a context.voidsetTermAsDataValue(String userId, String assetManagerGUID, String assetManagerName, String glossaryTermGUID, String glossaryTermExternalIdentifier, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)Classify the glossary term to indicate that it describes a data value.voidsetTermAsObjectIdentifier(String userId, String assetManagerGUID, String assetManagerName, String glossaryTermGUID, String glossaryTermExternalIdentifier, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)Classify the glossary term to indicate that it describes an object identifier.voidsetTermAsSpineAttribute(String userId, String assetManagerGUID, String assetManagerName, String glossaryTermGUID, String glossaryTermExternalIdentifier, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)Classify the glossary term to indicate that it describes a spine attribute.voidsetTermAsSpineObject(String userId, String assetManagerGUID, String assetManagerName, String glossaryTermGUID, String glossaryTermExternalIdentifier, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)Classify the glossary term to indicate that it describes a spine object.voidsetupCategoryParent(String userId, String assetManagerGUID, String assetManagerName, String glossaryParentCategoryGUID, String glossaryChildCategoryGUID, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)Create a parent-child relationship between two categories.voidsetupTermCategory(String userId, String assetManagerGUID, String assetManagerName, String glossaryCategoryGUID, String glossaryTermGUID, GlossaryTermCategorization categorizationProperties, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)Link a term to a category.voidsetupTermRelationship(String userId, String assetManagerGUID, String assetManagerName, String relationshipTypeName, String glossaryTermOneGUID, String glossaryTermTwoGUID, GlossaryTermRelationship relationshipsProperties, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)Link two terms together using a specialist relationship.voidupdateExternalGlossaryLink(String userId, String assetManagerGUID, String assetManagerName, String externalLinkGUID, boolean isMergeUpdate, ExternalGlossaryLinkProperties linkProperties, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)Update the properties of a reference to an external glossary resource.voidupdateGlossary(String userId, String assetManagerGUID, String assetManagerName, String glossaryGUID, String glossaryExternalIdentifier, GlossaryProperties glossaryProperties)Update the metadata element representing a glossary.voidupdateGlossaryCategory(String userId, String assetManagerGUID, String assetManagerName, String glossaryCategoryGUID, String glossaryCategoryExternalIdentifier, boolean isMergeUpdate, GlossaryCategoryProperties glossaryCategoryProperties, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)Update the metadata element representing a glossary category.voidupdateGlossaryTerm(String userId, String assetManagerGUID, String assetManagerName, String glossaryTermGUID, String glossaryTermExternalIdentifier, boolean isMergeUpdate, GlossaryTermProperties glossaryTermProperties, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)Update the metadata element representing a glossary term.voidupdateGlossaryTermStatus(String userId, String assetManagerGUID, String assetManagerName, String glossaryTermGUID, String glossaryTermExternalIdentifier, GlossaryTermStatus glossaryTermStatus, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)Update the status of the metadata element representing a glossary term.voidupdateTermRelationship(String userId, String assetManagerGUID, String assetManagerName, String relationshipTypeName, String glossaryTermOneGUID, String glossaryTermTwoGUID, GlossaryTermRelationship relationshipsProperties, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)Update the relationship properties for the two terms.
-
-
-
Constructor Detail
-
GlossaryExchangeClient
public GlossaryExchangeClient(String serverName, String serverPlatformURLRoot, AuditLog auditLog) throws InvalidParameterException
Create a new client with no authentication embedded in the HTTP request.- Parameters:
serverName- name of the server to connect toserverPlatformURLRoot- the network address of the server running the OMAS REST serversauditLog- logging destination- Throws:
InvalidParameterException- there is a problem creating the client-side components to issue any REST API calls.
-
GlossaryExchangeClient
public GlossaryExchangeClient(String serverName, String serverPlatformURLRoot) throws InvalidParameterException
Create a new client with no authentication embedded in the HTTP request.- Parameters:
serverName- name of the server to connect toserverPlatformURLRoot- the network address of the server running the OMAS REST servers- Throws:
InvalidParameterException- there is a problem creating the client-side components to issue any REST API calls.
-
GlossaryExchangeClient
public GlossaryExchangeClient(String serverName, String serverPlatformURLRoot, String userId, String password, AuditLog auditLog) throws InvalidParameterException
Create a new client that passes userId and password in each HTTP request. This is the userId/password of the calling server. The end user's userId is sent on each request.- Parameters:
serverName- name of the server to connect toserverPlatformURLRoot- the network address of the server running the OMAS REST serversuserId- caller's userId embedded in all HTTP requestspassword- caller's userId embedded in all HTTP requestsauditLog- logging destination- Throws:
InvalidParameterException- there is a problem creating the client-side components to issue any REST API calls.
-
GlossaryExchangeClient
public GlossaryExchangeClient(String serverName, String serverPlatformURLRoot, AssetManagerRESTClient restClient, int maxPageSize, AuditLog auditLog) throws InvalidParameterException
Create a new client that is going to be used in an OMAG Server.- Parameters:
serverName- name of the server to connect toserverPlatformURLRoot- the network address of the server running the OMAS REST serversrestClient- client that issues the REST API callsmaxPageSize- maximum number of results supported by this serverauditLog- logging destination- Throws:
InvalidParameterException- there is a problem creating the client-side components to issue any REST API calls.
-
GlossaryExchangeClient
public GlossaryExchangeClient(String serverName, String serverPlatformURLRoot, String userId, String password) throws InvalidParameterException
Create a new client that passes userId and password in each HTTP request. This is the userId/password of the calling server. The end user's userId is sent on each request.- Parameters:
serverName- name of the server to connect toserverPlatformURLRoot- the network address of the server running the OMAS REST serversuserId- caller's userId embedded in all HTTP requestspassword- caller's userId embedded in all HTTP requests- Throws:
InvalidParameterException- there is a problem creating the client-side components to issue any REST API calls.
-
-
Method Detail
-
createGlossary
public String createGlossary(String userId, String assetManagerGUID, String assetManagerName, 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.- Specified by:
createGlossaryin interfaceGlossaryExchangeInterface- Parameters:
userId- calling userassetManagerGUID- unique identifier of software server capability representing the callerassetManagerName- unique name of software server capability representing the callerexternalIdentifierProperties- 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(String userId, String assetManagerGUID, String assetManagerName, String templateGUID, ExternalIdentifierProperties externalIdentifierProperties, TemplateProperties templateProperties) 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.- Specified by:
createGlossaryFromTemplatein interfaceGlossaryExchangeInterface- Parameters:
userId- calling userassetManagerGUID- unique identifier of software server capability representing the callerassetManagerName- unique name of software server capability representing the callertemplateGUID- unique identifier of the metadata element to copyexternalIdentifierProperties- optional properties used to define an external identifiertemplateProperties- properties that override the template- 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, String assetManagerGUID, String assetManagerName, String glossaryGUID, String glossaryExternalIdentifier, GlossaryProperties glossaryProperties) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException
Update the metadata element representing a glossary.- Specified by:
updateGlossaryin interfaceGlossaryExchangeInterface- 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 metadata element to updateglossaryExternalIdentifier- unique identifier of the glossary in the external asset managerglossaryProperties- new properties for this 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)
-
setGlossaryAsTaxonomy
public void setGlossaryAsTaxonomy(String userId, String assetManagerGUID, String assetManagerName, String glossaryGUID, String glossaryExternalIdentifier, String organizingPrinciple) 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.- Specified by:
setGlossaryAsTaxonomyin interfaceGlossaryExchangeInterface- 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 metadata element to removeglossaryExternalIdentifier- unique identifier of the glossary in the external asset managerorganizingPrinciple- description of how the glossary is organized- 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, String assetManagerGUID, String assetManagerName, String glossaryGUID, String glossaryExternalIdentifier) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException
Remove the taxonomy designation from the glossary.- Specified by:
clearGlossaryAsTaxonomyin interfaceGlossaryExchangeInterface- 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 metadata element to removeglossaryExternalIdentifier- unique identifier of the glossary in the external asset manager- 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, String assetManagerGUID, String assetManagerName, String glossaryGUID, String glossaryExternalIdentifier, String scope) 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.- Specified by:
setGlossaryAsCanonicalin interfaceGlossaryExchangeInterface- 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 metadata element to removeglossaryExternalIdentifier- unique identifier of the glossary in the external asset managerscope- description of the situations where this glossary is relevant.- 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, String assetManagerGUID, String assetManagerName, String glossaryGUID, String glossaryExternalIdentifier) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException
Remove the canonical designation from the glossary.- Specified by:
clearGlossaryAsCanonicalin interfaceGlossaryExchangeInterface- 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 metadata element to removeglossaryExternalIdentifier- unique identifier of the glossary in the external asset manager- 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, String assetManagerGUID, String assetManagerName, String glossaryGUID, String glossaryExternalIdentifier) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException
Remove the metadata element representing a glossary. This will delete the glossary and all categories and terms.- Specified by:
removeGlossaryin interfaceGlossaryExchangeInterface- 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 metadata element to removeglossaryExternalIdentifier- unique identifier of the glossary in the external asset manager- 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, int startFrom, int pageSize) 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.- Specified by:
findGlossariesin interfaceGlossaryExchangeInterface- 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 propertiesstartFrom- paging start pointpageSize- maximum results that can be returned*- 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, int startFrom, int pageSize) 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.- Specified by:
getGlossariesByNamein interfaceGlossaryExchangeInterface- 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 forstartFrom- paging start pointpageSize- maximum results that can be returned- 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) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException
Retrieve the list of glossaries created on behalf of the named asset manager.- Specified by:
getGlossariesForAssetManagerin interfaceGlossaryExchangeInterface- 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 returned- 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 guid) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException
Retrieve the glossary metadata element with the supplied unique identifier.- Specified by:
getGlossaryByGUIDin interfaceGlossaryExchangeInterface- 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 element- 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 assetManagerGUID, String assetManagerName, String glossaryGUID, ExternalIdentifierProperties externalIdentifierProperties, GlossaryCategoryProperties glossaryCategoryProperties) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException
Create a new metadata element to represent a glossary category.- Specified by:
createGlossaryCategoryin interfaceGlossaryExchangeInterface- 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 where the category is locatedexternalIdentifierProperties- optional properties used to define an external identifierglossaryCategoryProperties- properties about the glossary category to store- 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, String assetManagerGUID, String assetManagerName, String templateGUID, ExternalIdentifierProperties externalIdentifierProperties, TemplateProperties templateProperties) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException
Create a new metadata element to represent a glossary category using an existing metadata element as a template.- Specified by:
createGlossaryCategoryFromTemplatein interfaceGlossaryExchangeInterface- Parameters:
userId- calling userassetManagerGUID- unique identifier of software server capability representing the callerassetManagerName- unique name of software server capability representing the callertemplateGUID- unique identifier of the metadata element to copyexternalIdentifierProperties- optional properties used to define an external identifiertemplateProperties- properties that override the template- 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, String assetManagerGUID, String assetManagerName, String glossaryCategoryGUID, String glossaryCategoryExternalIdentifier, boolean isMergeUpdate, GlossaryCategoryProperties glossaryCategoryProperties, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException
Update the metadata element representing a glossary category.- Specified by:
updateGlossaryCategoryin interfaceGlossaryExchangeInterface- 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 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 forforLineage- return elements marked with the Memento classification?forDuplicateProcessing- do not merge elements marked as duplicates?- 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 effectiveTime, boolean forLineage, boolean forDuplicateProcessing) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException
Create a parent-child relationship between two categories.- Specified by:
setupCategoryParentin interfaceGlossaryExchangeInterface- 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 subcategoryeffectiveTime- 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?- 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, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException
Remove a parent-child relationship between two categories.- Specified by:
clearCategoryParentin interfaceGlossaryExchangeInterface- 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 subcategoryeffectiveTime- 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?- 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, String assetManagerGUID, String assetManagerName, String glossaryCategoryGUID, String glossaryCategoryExternalIdentifier, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException
Remove the metadata element representing a glossary category.- Specified by:
removeGlossaryCategoryin interfaceGlossaryExchangeInterface- 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 metadata element to removeglossaryCategoryExternalIdentifier- unique identifier of the glossary category in the external asset managereffectiveTime- 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?- 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 searchString, int startFrom, int pageSize, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing) 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.- Specified by:
findGlossaryCategoriesin interfaceGlossaryExchangeInterface- 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 propertiesstartFrom- paging start pointpageSize- maximum results that can be returnedeffectiveTime- 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?- 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, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException
Return the list of categories associated with a glossary.- Specified by:
getCategoriesForGlossaryin interfaceGlossaryExchangeInterface- 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 returnedeffectiveTime- 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?- 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)
-
getGlossaryCategoriesByName
public List<GlossaryCategoryElement> getGlossaryCategoriesByName(String userId, String assetManagerGUID, String assetManagerName, String name, int startFrom, int pageSize, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing) 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.- Specified by:
getGlossaryCategoriesByNamein interfaceGlossaryExchangeInterface- 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 forstartFrom- paging start pointpageSize- maximum results that can be returnedeffectiveTime- 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?- 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 userId, String assetManagerGUID, String assetManagerName, String glossaryCategoryGUID, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException
Retrieve the glossary category metadata element with the supplied unique identifier.- Specified by:
getGlossaryCategoryByGUIDin interfaceGlossaryExchangeInterface- 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 elementeffectiveTime- 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?- 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 userId, String assetManagerGUID, String assetManagerName, String glossaryCategoryGUID, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException
Retrieve the glossary category metadata element with the supplied unique identifier.- Specified by:
getGlossaryCategoryParentin interfaceGlossaryExchangeInterface- 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 elementeffectiveTime- 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?- 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, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException
Retrieve the glossary category metadata element with the supplied unique identifier.- Specified by:
getGlossarySubCategoriesin interfaceGlossaryExchangeInterface- 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 returnedeffectiveTime- 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?- 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 userId, String assetManagerGUID, String assetManagerName, String glossaryGUID, ExternalIdentifierProperties externalIdentifierProperties, GlossaryTermProperties glossaryTermProperties) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException
Create a new metadata element to represent a glossary term.- Specified by:
createGlossaryTermin interfaceGlossaryExchangeInterface- 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 where the term is locatedexternalIdentifierProperties- optional properties used to define an external identifierglossaryTermProperties- properties for the glossary term- 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 assetManagerGUID, String assetManagerName, String glossaryGUID, ExternalIdentifierProperties externalIdentifierProperties, GlossaryTermProperties glossaryTermProperties, GlossaryTermStatus initialStatus) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException
Create a new metadata element to represent a glossary term whose lifecycle is managed through a controlled workflow.- Specified by:
createControlledGlossaryTermin interfaceGlossaryExchangeInterface- 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 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 created- 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, String assetManagerGUID, String assetManagerName, String templateGUID, ExternalIdentifierProperties externalIdentifierProperties, TemplateProperties templateProperties) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException
Create a new metadata element to represent a glossary term using an existing metadata element as a template.- Specified by:
createGlossaryTermFromTemplatein interfaceGlossaryExchangeInterface- Parameters:
userId- calling userassetManagerGUID- unique identifier of software server capability representing the callerassetManagerName- unique name of software server capability representing the callertemplateGUID- unique identifier of the metadata element to copyexternalIdentifierProperties- optional properties used to define an external identifiertemplateProperties- properties that override the template- 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, String assetManagerGUID, String assetManagerName, String glossaryTermGUID, String glossaryTermExternalIdentifier, boolean isMergeUpdate, GlossaryTermProperties glossaryTermProperties, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException
Update the metadata element representing a glossary term.- Specified by:
updateGlossaryTermin interfaceGlossaryExchangeInterface- 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 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 forforLineage- return elements marked with the Memento classification?forDuplicateProcessing- do not merge elements marked as duplicates?- 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, String assetManagerGUID, String assetManagerName, String glossaryTermGUID, String glossaryTermExternalIdentifier, GlossaryTermStatus glossaryTermStatus, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException
Update the status of the metadata element representing a glossary term. This is only valid on a controlled glossary term.- Specified by:
updateGlossaryTermStatusin interfaceGlossaryExchangeInterface- 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 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 forforLineage- return elements marked with the Memento classification?forDuplicateProcessing- do not merge elements marked as duplicates?- 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, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException
Link a term to a category.- Specified by:
setupTermCategoryin interfaceGlossaryExchangeInterface- 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 relationshipeffectiveTime- 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?- 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, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException
Unlink a term from a category.- Specified by:
clearTermCategoryin interfaceGlossaryExchangeInterface- 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 termeffectiveTime- 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?- 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 userId, String assetManagerGUID, String assetManagerName, String relationshipTypeName, String glossaryTermOneGUID, String glossaryTermTwoGUID, GlossaryTermRelationship relationshipsProperties, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException
Link two terms together using a specialist relationship.- Specified by:
setupTermRelationshipin interfaceGlossaryExchangeInterface- Parameters:
userId- calling userassetManagerGUID- unique identifier of software server capability representing the callerassetManagerName- unique name of software server capability representing the callerrelationshipTypeName- 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 relationshipeffectiveTime- 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?- 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 relationshipTypeName, String glossaryTermOneGUID, String glossaryTermTwoGUID, GlossaryTermRelationship relationshipsProperties, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException
Update the relationship properties for the two terms.- Specified by:
updateTermRelationshipin interfaceGlossaryExchangeInterface- Parameters:
userId- calling userassetManagerGUID- unique identifier of software server capability representing the callerassetManagerName- unique name of software server capability representing the callerrelationshipTypeName- 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 relationshipeffectiveTime- 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?- 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 relationshipTypeName, String glossaryTermOneGUID, String glossaryTermTwoGUID, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException
Remove the relationship between two terms.- Specified by:
clearTermRelationshipin interfaceGlossaryExchangeInterface- Parameters:
userId- calling userassetManagerGUID- unique identifier of software server capability representing the callerassetManagerName- unique name of software server capability representing the callerrelationshipTypeName- 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 forforLineage- return elements marked with the Memento classification?forDuplicateProcessing- do not merge elements marked as duplicates?- 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, String assetManagerGUID, String assetManagerName, String glossaryTermGUID, String glossaryTermExternalIdentifier, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException
Classify the glossary term to indicate that it describes an abstract concept.- Specified by:
setTermAsAbstractConceptin interfaceGlossaryExchangeInterface- 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 metadata element to updateglossaryTermExternalIdentifier- unique identifier of the glossary term in the external asset managereffectiveTime- 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?- 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, String assetManagerGUID, String assetManagerName, String glossaryTermGUID, String glossaryTermExternalIdentifier, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException
Remove the abstract concept designation from the glossary term.- Specified by:
clearTermAsAbstractConceptin interfaceGlossaryExchangeInterface- 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 metadata element to updateglossaryTermExternalIdentifier- unique identifier of the glossary term in the external asset managereffectiveTime- 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?- 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, String assetManagerGUID, String assetManagerName, String glossaryTermGUID, String glossaryTermExternalIdentifier, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException
Classify the glossary term to indicate that it describes a data value.- Specified by:
setTermAsDataValuein interfaceGlossaryExchangeInterface- 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 metadata element to updateglossaryTermExternalIdentifier- unique identifier of the glossary term in the external asset managereffectiveTime- 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?- 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, String assetManagerGUID, String assetManagerName, String glossaryTermGUID, String glossaryTermExternalIdentifier, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException
Remove the data value designation from the glossary term.- Specified by:
clearTermAsDataValuein interfaceGlossaryExchangeInterface- 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 metadata element to updateglossaryTermExternalIdentifier- unique identifier of the glossary term in the external asset managereffectiveTime- 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?- 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, String assetManagerGUID, String assetManagerName, String glossaryTermGUID, String glossaryTermExternalIdentifier, GlossaryTermActivityType activityType, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException
Classify the glossary term to indicate that it describes a data value.- Specified by:
setTermAsActivityin interfaceGlossaryExchangeInterface- 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 metadata element to updateglossaryTermExternalIdentifier- unique identifier of the glossary term in the external asset manageractivityType- type of activityeffectiveTime- 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?- 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, String assetManagerGUID, String assetManagerName, String glossaryTermGUID, String glossaryTermExternalIdentifier, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException
Remove the activity designation from the glossary term.- Specified by:
clearTermAsActivityin interfaceGlossaryExchangeInterface- 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 metadata element to updateglossaryTermExternalIdentifier- unique identifier of the glossary term in the external asset managereffectiveTime- 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?- 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, String assetManagerGUID, String assetManagerName, String glossaryTermGUID, String glossaryTermExternalIdentifier, GlossaryTermContextDefinition contextDefinition, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException
Classify the glossary term to indicate that it describes a context.- Specified by:
setTermAsContextin interfaceGlossaryExchangeInterface- 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 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 forforLineage- return elements marked with the Memento classification?forDuplicateProcessing- do not merge elements marked as duplicates?- 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, String assetManagerGUID, String assetManagerName, String glossaryTermGUID, String glossaryTermExternalIdentifier, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException
Remove the context definition designation from the glossary term.- Specified by:
clearTermAsContextin interfaceGlossaryExchangeInterface- 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 metadata element to updateglossaryTermExternalIdentifier- unique identifier of the glossary term in the external asset managereffectiveTime- 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?- 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, String assetManagerGUID, String assetManagerName, String glossaryTermGUID, String glossaryTermExternalIdentifier, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException
Classify the glossary term to indicate that it describes a spine object.- Specified by:
setTermAsSpineObjectin interfaceGlossaryExchangeInterface- 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 metadata element to updateglossaryTermExternalIdentifier- unique identifier of the glossary term in the external asset managereffectiveTime- 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?- 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, String assetManagerGUID, String assetManagerName, String glossaryTermGUID, String glossaryTermExternalIdentifier, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException
Remove the spine object designation from the glossary term.- Specified by:
clearTermAsSpineObjectin interfaceGlossaryExchangeInterface- 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 metadata element to updateglossaryTermExternalIdentifier- unique identifier of the glossary term in the external asset managereffectiveTime- 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?- 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, String assetManagerGUID, String assetManagerName, String glossaryTermGUID, String glossaryTermExternalIdentifier, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException
Classify the glossary term to indicate that it describes a spine attribute.- Specified by:
setTermAsSpineAttributein interfaceGlossaryExchangeInterface- 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 metadata element to updateglossaryTermExternalIdentifier- unique identifier of the glossary term in the external asset managereffectiveTime- 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?- 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, String assetManagerGUID, String assetManagerName, String glossaryTermGUID, String glossaryTermExternalIdentifier, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException
Remove the spine attribute designation from the glossary term.- Specified by:
clearTermAsSpineAttributein interfaceGlossaryExchangeInterface- 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 metadata element to updateglossaryTermExternalIdentifier- unique identifier of the glossary term in the external asset managereffectiveTime- 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?- 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, String assetManagerGUID, String assetManagerName, String glossaryTermGUID, String glossaryTermExternalIdentifier, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException
Classify the glossary term to indicate that it describes an object identifier.- Specified by:
setTermAsObjectIdentifierin interfaceGlossaryExchangeInterface- 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 metadata element to updateglossaryTermExternalIdentifier- unique identifier of the glossary term in the external asset managereffectiveTime- 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?- 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, String assetManagerGUID, String assetManagerName, String glossaryTermGUID, String glossaryTermExternalIdentifier, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException
Remove the object identifier designation from the glossary term.- Specified by:
clearTermAsObjectIdentifierin interfaceGlossaryExchangeInterface- 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 metadata element to updateglossaryTermExternalIdentifier- unique identifier of the glossary term in the external asset managereffectiveTime- 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?- 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 userId, String assetManagerGUID, String assetManagerName, String glossaryTermGUID, String glossaryTermExternalIdentifier, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException
Remove the metadata element representing a glossary term.- Specified by:
removeGlossaryTermin interfaceGlossaryExchangeInterface- 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 metadata element to removeglossaryTermExternalIdentifier- unique identifier of the glossary term in the external asset managereffectiveTime- 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?- 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 searchString, int startFrom, int pageSize, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing) 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.- Specified by:
findGlossaryTermsin interfaceGlossaryExchangeInterface- 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 propertiesstartFrom- paging start pointpageSize- maximum results that can be returnedeffectiveTime- 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?- 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, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException
Retrieve the list of glossary terms associated with a glossary.- Specified by:
getTermsForGlossaryin interfaceGlossaryExchangeInterface- 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 returnedeffectiveTime- 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?- 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, int startFrom, int pageSize, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException
Retrieve the list of glossary terms associated with a glossary category.- Specified by:
getTermsForGlossaryCategoryin interfaceGlossaryExchangeInterface- 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 intereststartFrom- paging start pointpageSize- maximum results that can be returnedeffectiveTime- 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?- 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 name, int startFrom, int pageSize, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing) 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.- Specified by:
getGlossaryTermsByNamein interfaceGlossaryExchangeInterface- 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 forstartFrom- paging start pointpageSize- maximum results that can be returnedeffectiveTime- 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?- 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 glossaryTermGUID, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException
Retrieve the glossary term metadata element with the supplied unique identifier.- Specified by:
getGlossaryTermByGUIDin interfaceGlossaryExchangeInterface- 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 elementeffectiveTime- 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?- 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(String userId, String assetManagerGUID, String assetManagerName, 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.- Specified by:
createExternalGlossaryLinkin interfaceGlossaryExchangeInterface- 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 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 userId, String assetManagerGUID, String assetManagerName, String externalLinkGUID, boolean isMergeUpdate, ExternalGlossaryLinkProperties linkProperties, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException
Update the properties of a reference to an external glossary resource.- Specified by:
updateExternalGlossaryLinkin interfaceGlossaryExchangeInterface- 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 referenceisMergeUpdate- should the new properties be merged with existing properties (true) or completely replace them (false)?linkProperties- properties of the linkeffectiveTime- 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?- 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, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException
Remove information about a link to an external glossary resource (and the relationships that attached it to the glossaries).- Specified by:
removeExternalGlossaryLinkin interfaceGlossaryExchangeInterface- 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 referenceeffectiveTime- 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?- 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 externalLinkGUID, String glossaryGUID, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException
Connect a glossary to a reference to an external glossary resource.- Specified by:
attachExternalLinkToGlossaryin interfaceGlossaryExchangeInterface- 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 attacheffectiveTime- 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?- 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 externalLinkGUID, String glossaryGUID, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException
Disconnect a glossary from a reference to an external glossary resource.- Specified by:
detachExternalLinkFromGlossaryin interfaceGlossaryExchangeInterface- 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 removeeffectiveTime- 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?- 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 assetManagerGUID, String assetManagerName, String glossaryGUID, int startFrom, int pageSize, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException
Retrieve the list of links to external glossary resources attached to a glossary.- Specified by:
getExternalLinksForGlossaryin interfaceGlossaryExchangeInterface- Parameters:
userId- calling userglossaryGUID- 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 forforLineage- return elements marked with the Memento classification?forDuplicateProcessing- do not merge elements marked as duplicates?- 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, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException
Return the glossaries connected to an external glossary source.- Specified by:
getGlossariesForExternalLinkin interfaceGlossaryExchangeInterface- 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 returnedeffectiveTime- 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?- 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 externalLinkGUID, String glossaryCategoryGUID, ExternalGlossaryElementLinkProperties linkProperties, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing) 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.- Specified by:
attachExternalCategoryLinkin interfaceGlossaryExchangeInterface- 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 linkeffectiveTime- 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?- 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 externalLinkGUID, String glossaryCategoryGUID, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException
Remove the link to an external glossary category resource.- Specified by:
detachExternalCategoryLinkin interfaceGlossaryExchangeInterface- 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 categoryeffectiveTime- 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?- 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 externalLinkGUID, String glossaryTermGUID, ExternalGlossaryElementLinkProperties linkProperties, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing) 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.- Specified by:
attachExternalTermLinkin interfaceGlossaryExchangeInterface- 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 linkeffectiveTime- 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?- 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 externalLinkGUID, String glossaryTermGUID, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException
Remove the link to an external glossary term resource.- Specified by:
detachExternalTermLinkin interfaceGlossaryExchangeInterface- 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 categoryeffectiveTime- 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?- 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)
-
-