Class AssetHandler<B>
- java.lang.Object
-
- org.odpi.openmetadata.commonservices.generichandlers.OpenMetadataAPIGenericHandler<B>
-
- org.odpi.openmetadata.commonservices.generichandlers.ReferenceableHandler<B>
-
- org.odpi.openmetadata.commonservices.generichandlers.AssetHandler<B>
-
- Type Parameters:
B- class that represents the asset
- Direct Known Subclasses:
ITInfrastructureHandler
public class AssetHandler<B> extends ReferenceableHandler<B>
AssetHandler manages B objects and optionally connections in the property server. It runs server-side in the OMAG Server Platform and retrieves Assets and Connections through the OMRSRepositoryConnector.
-
-
Field Summary
-
Fields inherited from class org.odpi.openmetadata.commonservices.generichandlers.OpenMetadataAPIGenericHandler
auditLog, beanClass, converter, defaultZones, errorHandler, invalidParameterHandler, localServerUserId, publishZones, repositoryHandler, repositoryHelper, securityVerifier, serverName, serviceName, supportedZones
-
-
Constructor Summary
Constructors Constructor Description AssetHandler(OpenMetadataAPIGenericConverter<B> converter, Class<B> beanClass, String serviceName, String serverName, InvalidParameterHandler invalidParameterHandler, RepositoryHandler repositoryHandler, OMRSRepositoryHelper repositoryHelper, String localServerUserId, OpenMetadataServerSecurityVerifier securityVerifier, List<String> supportedZones, List<String> defaultZones, List<String> publishZones, AuditLog auditLog)Construct the handler with information needed to work with B objects.
-
Method Summary
All Methods Instance Methods Concrete Methods Deprecated Methods Modifier and Type Method Description StringaddAssetFromTemplate(String userId, String externalSourceGUID, String externalSourceName, String templateGUID, String templateGUIDParameterName, String expectedTypeGUID, String expectedTypeName, String qualifiedName, String qualifiedNameParameterName, String displayName, String description, String networkAddress, String methodName)Add a simple asset description to the metadata repository.voidaddAssetOrigin(String userId, String assetGUID, String assetGUIDParameterName, String organizationGUID, String organizationGUIDParameterName, String businessCapabilityGUID, String businessCapabilityGUIDParameterName, Map<String,String> otherOriginValues, Date effectiveFromTime, Date effectiveToTime, String methodName)Add the asset origin classification to an asset.List<String>assetGUIDsScan(String userId, String subTypeGUID, String subTypeName, int startFrom, int pageSize, Date effectiveTime, String methodName)Scan through the repository looking for assets by type.List<String>assetGUIDsScan(String userId, String subTypeGUID, String subTypeName, List<String> suppliedSupportedZones, int startFrom, int pageSize, Date effectiveTime, String methodName)Scan through the repository looking for assets by type.List<String>assetGUIDZoneScan(String userId, String zoneName, String subTypeGUID, String subTypeName, List<String> suppliedSupportedZones, int startFrom, int pageSize, Date effectiveTime, String methodName)Scan through the repository looking for assets by type and/or zone.List<B>assetScan(String userId, String subTypeGUID, String subTypeName, int startFrom, int pageSize, Date effectiveTime, String methodName)Scan through the repository looking for assets by type.List<B>assetScan(String userId, String subTypeGUID, String subTypeName, List<String> suppliedSupportedZones, int startFrom, int pageSize, Date effectiveTime, String methodName)Scan through the repository looking for assets by type.List<B>assetZoneScan(String userId, String zoneName, String subTypeGUID, String subTypeName, List<String> suppliedSupportedZones, int startFrom, int pageSize, Date effectiveTime, String methodName)Scan through the repository looking for assets by type and/or zone.voidattachAssetToSoftwareServerCapability(String userId, String externalSourceGUID, String externalSourceName, String assetGUID, String assetGUIDParameterName, String softwareServerCapabilityGUID, String softwareServerCapabilityGUIDParameterName, String methodName)Link the asset to the associated software server capability if supplied.voidattachSchemaTypeToAsset(String userId, String externalSourceGUID, String externalSourceName, String assetGUID, String assetGUIDParameterName, String schemaTypeGUID, String schemaTypeGUIDParameterName, String methodName)Link the schema type and asset.voidclassifyAssetAsReferenceData(String userId, String assetGUID, String assetGUIDParameterName, String methodName)Add the ReferenceData classification to an asset.StringcreateAssetInRepository(String userId, String externalSourceGUID, String externalSourceName, String qualifiedName, String technicalName, String technicalDescription, List<String> zoneMembership, String owner, int ownerType, String originOrganizationCapabilityGUID, String originBusinessCapabilityGUID, Map<String,String> otherOriginValues, Map<String,String> additionalProperties, String typeGUID, String typeName, Map<String,Object> extendedProperties, String methodName)Add a simple asset description to the metadata repository.StringcreateAssetInRepository(String userId, String externalSourceGUID, String externalSourceName, String qualifiedName, String technicalName, String technicalDescription, List<String> zoneMembership, String owner, int ownerType, String originOrganizationCapabilityGUID, String originBusinessCapabilityGUID, Map<String,String> otherOriginValues, Map<String,String> additionalProperties, String typeGUID, String typeName, Map<String,Object> extendedProperties, InstanceStatus instanceStatus, String methodName)Add a simple asset description to the metadata repository.StringcreateAssetInRepository(String userId, String externalSourceGUID, String externalSourceName, String qualifiedName, String technicalName, String technicalDescription, Map<String,String> additionalProperties, String typeName, Map<String,Object> extendedProperties, InstanceStatus instanceStatus, String methodName)Add a simple asset description to the metadata repository.StringcreateAssetWithConnection(String userId, String externalSourceGUID, String externalSourceName, String assetGUIDParameterName, String assetQualifiedName, String technicalName, String technicalDescription, Map<String,String> additionalProperties, String assetTypeName, Map<String,Object> extendedProperties, InstanceStatus instanceStatus, boolean anchorEndpointToAsset, Map<String,Object> configurationProperties, String connectorProviderClassName, String networkAddress, String protocol, String encryptionMethod, String methodName)Add a simple asset description to the metadata repository.voiddeclassifyAssetAsReferenceData(String userId, String assetGUID, String assetGUIDParameterName, String methodName)Remove the ReferenceData classification from an Asset.StringdetachSchemaTypeFromAsset(String userId, String externalSourceGUID, String externalSourceName, String assetGUID, String assetGUIDParameterName, String methodName)Remove any associated schema type.List<String>findAssetGUIDs(String userId, String searchString, String searchStringParameter, int startFrom, int pageSize, Date effectiveTime, String methodName)Return a list of assets with the requested search string in their name, qualified name or description.List<String>findAssetGUIDs(String userId, String typeGUID, String typeName, String searchString, String searchStringParameter, int startFrom, int pageSize, Date effectiveTime, String methodName)Return a list of assets with the requested search string in their name, qualified name or description.List<B>findAssets(String userId, String searchString, String searchStringParameter, int startFrom, int pageSize, Date effectiveTime, String methodName)Return a list of assets with the requested search string in their name, qualified name or description.List<B>findAssets(String userId, String typeGUID, String typeName, String searchString, String searchStringParameter, int startFrom, int pageSize, Date effectiveTime, String methodName)Return a list of assets with the requested search string in their name, qualified name or description.List<B>findAssetsByName(String userId, String typeGUID, String typeName, String name, String nameParameterName, int startFrom, int pageSize, Date effectiveTime, String methodName)Return a list of assets with the requested name in either the display name or qualified name.List<B>findAssetsByName(String userId, String typeGUID, String typeName, String name, String nameParameterName, List<String> serviceSupportedZones, int startFrom, int pageSize, Date effectiveTime, String methodName)Return a list of assets with the requested name in either the display name or qualified name.List<B>getAllAssetsWithConnection(String userId, String assetTypeGUID, String assetTypeName, int startFrom, int pageSize, Date effectiveTime, String methodName)Return the list of assets that are stored.BgetAssetByNameWithConnection(String userId, String name, String nameParameterName, String assetTypeGUID, String assetTypeName, Date effectiveTime, String methodName)Return an asset along with any associated connection.StringgetAssetForConnection(String userId, String connectionGUID, String connectionGUIDParameterName, List<String> serviceSupportedZones, String methodName)Returns the unique identifier for the asset connected to the requested connection.StringgetAssetForConnectionName(String userId, String connectionName, String connectionNameParameter, String methodName)Returns the asset corresponding to the supplied connection name.List<String>getAssetGUIDsByEndpoint(String userId, String networkAddress, String networkAddressParameterName, int startFrom, int pageSize, Date effectiveTime, String methodName)Return the list of assets that have the same endpoint address.List<String>getAssetGUIDsByKeyword(String userId, String keywordGUID, String keywordGUIDParameterName, int startFrom, int pageSize, Date effectiveTime, String methodName)Return the list of unique identifiers for assets that are linked to a specific keyword either directly, or via one of its schema elements.List<String>getAssetGUIDsByName(String userId, String typeGUID, String typeName, String name, String nameParameterName, int startFrom, int pageSize, Date effectiveTime, String methodName)Return a list of assets with the requested name in either the display name or qualified name.List<String>getAssetGUIDsByName(String userId, String typeGUID, String typeName, String name, String nameParameterName, List<String> serviceSupportedZones, int startFrom, int pageSize, Date effectiveTime, String methodName)Return a list of assets with the requested name in either the display name or qualified name.List<String>getAssetGUIDsByTag(String userId, String tagGUID, String tagGUIDParameterName, int startFrom, int pageSize, Date effectiveTime, String methodName)Return the list of unique identifiers for assets that are linked to a specific tag either directly, or via one of its schema elements.List<B>getAssetsByEndpoint(String userId, String networkAddress, String networkAddressParameterName, String suppliedTypeName, int startFrom, int pageSize, Date effectiveTime, String methodName)Return the list of assets that have the same endpoint address.List<B>getAssetsByGlossaryTerm(String userId, String termGUID, String termGUIDParameterName, int startFrom, int pageSize, Date effectiveTime, String methodName)Return the list of assets that are linked to a specific glossary term.List<B>getAssetsByKeyword(String userId, String keywordGUID, String keywordGUIDParameterName, int startFrom, int pageSize, Date effectiveTime, String methodName)Return the list of assets that are linked to a specific keyword.List<B>getAssetsByName(String userId, String typeGUID, String typeName, String name, String nameParameterName, int startFrom, int pageSize, Date effectiveTime, String methodName)Return a list of assets with the requested name in either the display name or qualified name.List<B>getAssetsByName(String userId, String typeGUID, String typeName, String name, String nameParameterName, List<String> serviceSupportedZones, int startFrom, int pageSize, Date effectiveTime, String methodName)Return a list of assets with the requested name in either the display name or qualified name.List<B>getAssetsByTag(String userId, String tagGUID, String tagGUIDParameterName, int startFrom, int pageSize, Date effectiveTime, String methodName)Return the list of assets that are linked to a specific tag either directly, or via one of its schema elements.BgetAssetWithConnection(String userId, String assetGUID, String assetGUIDParameterName, String assetTypeName, Date effectiveTime, String methodName)Return an asset along with any associated connection.StringgetExternalSourceID(boolean externalSourceIsHome, String externalSourceID)The externalSource identifier is supplied on the APIs that supply external source identifiers for two purposes.Map<String,String>getTypesOfAssetDescriptions()Return the list of asset subtype names mapped to their descriptions.List<String>getTypesOfAssetList()Return the list of asset subtype names.voidpublishAsset(String userId, String assetGUID, String assetGUIDParameterName, String methodName)Update the zones for a specific asset to the list set up in publish zones.voidremoveAssetOrigin(String userId, String assetGUID, String assetGUIDParameterName, String methodName)Remove the asset origin classification to an asset.voidremoveAssociatedSchemaType(String userId, String externalSourceGUID, String externalSourceName, String assetGUID, String assetGUIDParameterName, String methodName)Remove any associated schema type.voidremoveLinkedDataSet(String userId, String externalSourceGUID, String externalSourceName, String assetGUID, String assetTypeName, Date effectiveTime, String methodName)Remove any data sets connected to the asset by the DataContentForDataSet relationship.voidsaveSemanticAssignments(String userId, String externalSourceGUID, String externalSourceName, String beanGUID, String beanGUIDParameter, List<String> glossaryTermGUIDs, String glossaryTermGUIDsParameter, String methodName)Create relationships between the identified glossary terms and an Asset.voidupdateAsset(String userId, String externalSourceGUID, String externalSourceName, String assetGUID, String assetGUIDParameterName, String qualifiedName, String technicalName, String technicalDescription, Map<String,String> additionalProperties, String typeGUID, String typeName, List<String> suppliedSupportedZones, Map<String,Object> extendedProperties, boolean isMergeUpdate, String methodName)Update an asset's properties.voidupdateAsset(String userId, String externalSourceGUID, String externalSourceName, String assetGUID, String assetGUIDParameterName, String qualifiedName, String technicalName, String technicalDescription, Map<String,String> additionalProperties, String typeGUID, String typeName, Map<String,Object> extendedProperties, boolean isMergeUpdate, String methodName)Update an asset's properties.voidupdateAsset(String userId, String externalSourceGUID, String externalSourceName, String assetGUID, String assetGUIDParameterName, String qualifiedName, String technicalName, String technicalDescription, Map<String,String> additionalProperties, String typeGUID, String typeName, Map<String,Object> extendedProperties, String methodName)Update an asset's properties.voidupdateAsset(String userId, String externalSourceGUID, String externalSourceName, String assetGUID, String assetGUIDParameterName, String qualifiedName, String technicalName, String technicalDescription, Map<String,String> additionalProperties, String typeName, Map<String,Object> extendedProperties, boolean isMergeUpdate, String methodName)Update an asset's properties.voidupdateAssetOwner(String userId, String assetGUID, String assetGUIDParameterName, String ownerId, int ownerType, String methodName)Deprecated.voidupdateAssetWithConnection(String userId, String externalSourceGUID, String externalSourceName, String assetGUID, String assetGUIDParameterName, String qualifiedName, String displayName, String description, Map<String,String> additionalProperties, String typeGUID, String typeName, Map<String,Object> extendedProperties, String assetSummary, Connection connection, String methodName)Update an asset's properties.voidupdateAssetZones(String userId, String assetGUID, String assetGUIDParameterName, List<String> assetZones, String methodName)Update the zones for a specific asset.voidwithdrawAsset(String userId, String assetGUID, String assetGUIDParameterName, String methodName)Update the zones for a specific asset to the list set up in publish zones.-
Methods inherited from class org.odpi.openmetadata.commonservices.generichandlers.ReferenceableHandler
addOwner, addSecurityTags, addTemplateClassification, clearBusinessSignificant, findBeanGUIDsByQualifiedName, findBeansByQualifiedName, findBeansByQualifiedName, getBeanByQualifiedName, getBeanByQualifiedName, getBeanGUIDByQualifiedName, getBeanGUIDByQualifiedName, getBeanGUIDsByQualifiedName, getBeanGUIDsByQualifiedName, getBeansByQualifiedName, getBeansByQualifiedName, getCollectionMembers, getEntityByUniqueQualifiedName, getMoreInformation, getMoreInformation, getVendorProperties, linkElementsAsPeerDuplicates, removeOwner, removeResourceListMember, removeSecurityTags, removeSemanticAssignment, removeTemplateClassification, saveResourceListMember, saveSemanticAssignment, saveSemanticAssignment, setBusinessSignificant, setVendorProperties, unlinkElementsAsPeerDuplicates
-
Methods inherited from class org.odpi.openmetadata.commonservices.generichandlers.OpenMetadataAPIGenericHandler
addAnchorsClassification, archiveBeanInRepository, archiveBeanInRepository, countAttachments, createBeanFromTemplate, createBeanInRepository, deleteAnchoredEntity, deleteBeanInRepository, deleteBeanInRepository, deleteBeanInRepository, deleteBeanInRepository, deleteRelationship, entityMatchSearchCriteria, findAttachmentLinks, findBeanGUIDs, findBeans, findBeans, findBeans, findEntities, findEntities, getAllAttachmentLinks, getAnchorGUIDFromAnchorsClassification, getAttachedElement, getAttachedElementGUID, getAttachedElementGUID, getAttachedElementGUIDs, getAttachedElementGUIDs, getAttachedElements, getAttachedElements, getAttachedElements, getAttachedEntities, getAttachedEntities, getAttachedEntitiesFromUser, getAttachedEntity, getAttachedEntity, getAttachedEntity, getAttachedEntityFromUser, getAttachedFilteredEntities, getAttachedFilteredEntities, getAttachedFilteredEntities, getAttachmentLink, getAttachmentLinks, getAttachmentLinks, getAttachmentLinks, getBeanByUniqueName, getBeanByUniqueName, getBeanByValue, getBeanFromEntity, getBeanFromRepository, getBeanFromRepository, getBeanFromRepository, getBeanGUIDByUniqueName, getBeanGUIDByUniqueName, getBeanGUIDsByClassification, getBeanGUIDsByType, getBeanGUIDsByType, getBeanGUIDsByValue, getBeansByClassification, getBeansByCreator, getBeansByIntValue, getBeansByType, getBeansByType, getBeansByValue, getBeansByValue, getBeansByValue, getBeansByValue, getEffectiveTime, getEffectiveTime, getEntitiesByIntValue, getEntitiesByType, getEntitiesByType, getEntitiesByValue, getEntitiesByValue, getEntitiesByValue, getEntitiesByValue, getEntitiesByValue, getEntityByValue, getEntityFromRepository, getEntityFromRepository, getEntityGUIDByValue, getEntityGUIDsByValue, getRepositoryHandler, getRepositoryHelper, getServerName, getServiceName, getTypeDefByName, getUniqueAttachmentLink, getUniqueAttachmentLink, isBeanIsolated, isEntityATypeOf, linkElementToElement, linkElementToElement, linkElementToElement, linkElementToElement, maintainSupplementaryProperties, multiLinkElementToElement, regexSearchCriteria, relinkElementToNewElement, relinkElementToNewElement, removeClassificationFromRepository, removeClassificationFromRepository, setClassificationInRepository, setClassificationInRepository, setClassificationInRepository, setClassificationInRepository, setClassificationInRepository, setSecurityVerifier, unlinkAllElements, unlinkConnectedElement, unlinkElementFromElement, unlinkElementFromElement, unlinkElementFromElement, unlinkElementFromElement, updateBeanEffectivityDates, updateBeanEffectivityDates, updateBeanInRepository, updateBeanInRepository, updateBeanInRepository, updateBeanPropertyInRepository, updateBeanStatusInRepository, updateBeanStatusInRepository, updateBeanStatusInRepository, updateClassificationEffectivityDates, updateClassificationEffectivityDates, updateElementToElementLink, updateElementToElementLink, updateElementToElementLink, updateElementToElementLink, updateRelationshipEffectivityDates, updateRelationshipEffectivityDates, updateRelationshipProperties, validateAnchorEntity, validateAnchorEntity, validateUniqueProperty, verifyExternalSourceIdentity
-
-
-
-
Constructor Detail
-
AssetHandler
public AssetHandler(OpenMetadataAPIGenericConverter<B> converter, Class<B> beanClass, String serviceName, String serverName, InvalidParameterHandler invalidParameterHandler, RepositoryHandler repositoryHandler, OMRSRepositoryHelper repositoryHelper, String localServerUserId, OpenMetadataServerSecurityVerifier securityVerifier, List<String> supportedZones, List<String> defaultZones, List<String> publishZones, AuditLog auditLog)
Construct the handler with information needed to work with B objects.- Parameters:
converter- specific converter for this bean classbeanClass- name of bean class that is represented by the generic class BserviceName- name of this serviceserverName- name of the local serverinvalidParameterHandler- handler for managing parameter errorsrepositoryHandler- manages calls to the repository servicesrepositoryHelper- provides utilities for manipulating the repository services objectslocalServerUserId- userId for this serversecurityVerifier- open metadata security services verifiersupportedZones- list of zones that the access service is allowed to serve B instances from.defaultZones- list of zones that the access service should set in all new B instances.publishZones- list of zones that the access service sets up in published B instances.auditLog- destination for audit log events.
-
-
Method Detail
-
getTypesOfAssetList
public List<String> getTypesOfAssetList()
Return the list of asset subtype names.- Returns:
- list of type names that are subtypes of asset
-
getTypesOfAssetDescriptions
public Map<String,String> getTypesOfAssetDescriptions()
Return the list of asset subtype names mapped to their descriptions.- Returns:
- list of type names that are subtypes of asset
-
getExternalSourceID
public String getExternalSourceID(boolean externalSourceIsHome, String externalSourceID)
The externalSource identifier is supplied on the APIs that supply external source identifiers for two purposes. The first is the standard mechanism to control the ownership/provenance of the resulting elements. The second is to enable a relationship between an asset and the software server capability to be created. The externalSourceIsHome boolean determines whether the identifier is used to control ownership or not. The relationship is set up if the externalSourceGUID is not null.- Parameters:
externalSourceIsHome- use the external source GUID as the owner of this elementexternalSourceID- supplied external source unique identifier/name- Returns:
- externalSource
-
attachSchemaTypeToAsset
public void attachSchemaTypeToAsset(String userId, String externalSourceGUID, String externalSourceName, String assetGUID, String assetGUIDParameterName, String schemaTypeGUID, String schemaTypeGUIDParameterName, String methodName) throws InvalidParameterException, PropertyServerException, UserNotAuthorizedException
Link the schema type and asset. This is called from outside of AssetHandler. The assetGUID is checked to ensure the asset exists and updates are allowed. If there is already a schema attached, it is deleted.- Parameters:
userId- calling userexternalSourceGUID- guid of the software server capability entity that represented the external source - null for localexternalSourceName- name of the software server capability entity that represented the external source - null for localassetGUID- unique identifier of the asset to connect the schema toassetGUIDParameterName- parameter providing the assetGUIDschemaTypeGUID- identifier for schema Type objectschemaTypeGUIDParameterName- parameter providing the schemaTypeGUIDmethodName- calling method- Throws:
InvalidParameterException- the bean properties are invalidUserNotAuthorizedException- user not authorized to issue this requestPropertyServerException- problem accessing the property server
-
removeAssociatedSchemaType
public void removeAssociatedSchemaType(String userId, String externalSourceGUID, String externalSourceName, String assetGUID, String assetGUIDParameterName, String methodName) throws InvalidParameterException, PropertyServerException, UserNotAuthorizedException
Remove any associated schema type. This may be called from outside of AssetHandler. The assetGUID is checked to ensure the asset exists and updates are allowed. If there is a schema attached, it is deleted.- Parameters:
userId- calling userexternalSourceGUID- guid of the software server capability entity that represented the external source - null for localexternalSourceName- name of the software server capability entity that represented the external source - null for localassetGUID- unique identifier of the asset to connect the schema toassetGUIDParameterName- parameter providing the assetGUIDmethodName- calling method- Throws:
InvalidParameterException- the bean properties are invalidUserNotAuthorizedException- user not authorized to issue this requestPropertyServerException- problem accessing the property server
-
attachAssetToSoftwareServerCapability
public void attachAssetToSoftwareServerCapability(String userId, String externalSourceGUID, String externalSourceName, String assetGUID, String assetGUIDParameterName, String softwareServerCapabilityGUID, String softwareServerCapabilityGUIDParameterName, String methodName) throws InvalidParameterException, PropertyServerException, UserNotAuthorizedException
Link the asset to the associated software server capability if supplied. This is called from outside of AssetHandler. The assetGUID and softwareServerCapabilityGUID are checked to ensure they are not null snd if all is well, the relationship is established.- Parameters:
userId- calling userexternalSourceGUID- guid of the software server capability entity that represented the external source - null for localexternalSourceName- name of the software server capability entity that represented the external source - null for localassetGUID- unique identifier of the asset to connect the schema toassetGUIDParameterName- parameter providing the assetGUIDsoftwareServerCapabilityGUID- identifier for schema Type objectsoftwareServerCapabilityGUIDParameterName- parameter providing the softwareServerCapabilityGUIDmethodName- calling method- Throws:
InvalidParameterException- the bean properties are invalidUserNotAuthorizedException- user not authorized to issue this requestPropertyServerException- problem accessing the property server
-
detachSchemaTypeFromAsset
public String detachSchemaTypeFromAsset(String userId, String externalSourceGUID, String externalSourceName, String assetGUID, String assetGUIDParameterName, String methodName) throws InvalidParameterException, PropertyServerException, UserNotAuthorizedException
Remove any associated schema type. This may be called from outside of AssetHandler. The assetGUID is checked to ensure the asset exists and updates are allowed. If there is a schema attached, it is deleted.- Parameters:
userId- calling userexternalSourceGUID- guid of the software server capability entity that represented the external source - null for localexternalSourceName- name of the software server capability entity that represented the external source - null for localassetGUID- unique identifier of the asset to connect the schema toassetGUIDParameterName- parameter providing the assetGUIDmethodName- calling method- Returns:
- guid of previously attached schema type or null if there is no schema
- Throws:
InvalidParameterException- the bean properties are invalidUserNotAuthorizedException- user not authorized to issue this requestPropertyServerException- problem accessing the property server
-
saveSemanticAssignments
public void saveSemanticAssignments(String userId, String externalSourceGUID, String externalSourceName, String beanGUID, String beanGUIDParameter, List<String> glossaryTermGUIDs, String glossaryTermGUIDsParameter, String methodName) throws InvalidParameterException, PropertyServerException, UserNotAuthorizedException
Create relationships between the identified glossary terms and an Asset.- Parameters:
userId- calling userexternalSourceGUID- guid of the software server capability entity that represented the external source - null for localexternalSourceName- name of the software server capability entity that represented the external source - null for localbeanGUID- unique identifier of the referenceable that is being describedbeanGUIDParameter- parameter supply the beanGUIDglossaryTermGUIDs- list of unique identifiers of the glossary termsglossaryTermGUIDsParameter- parameter supplying the list of GlossaryTermGUIDsmethodName- calling method- Throws:
InvalidParameterException- the guid properties are invalidUserNotAuthorizedException- user not authorized to issue this requestPropertyServerException- problem accessing the property server
-
addAssetFromTemplate
public String addAssetFromTemplate(String userId, String externalSourceGUID, String externalSourceName, String templateGUID, String templateGUIDParameterName, String expectedTypeGUID, String expectedTypeName, String qualifiedName, String qualifiedNameParameterName, String displayName, String description, String networkAddress, String methodName) throws InvalidParameterException, PropertyServerException, UserNotAuthorizedException
Add a simple asset description to the metadata repository. Null values for requested typename, ownership, zone membership and latest change are filled in with default values.- Parameters:
userId- calling userIdexternalSourceGUID- guid of the software server capability entity that represented the external source - null for localexternalSourceName- name of the software server capability entity that represented the external sourcetemplateGUID- unique identifier of the metadata element to copytemplateGUIDParameterName- name of parameter providing the templateGUIDexpectedTypeGUID- unique identifier of type (or super type of asset identified by templateGUID)expectedTypeName- unique name of type (or super type of asset identified by templateGUID)qualifiedName- unique name for this asset - must not be nullqualifiedNameParameterName- parameter name providing qualifiedNamedisplayName- the stored display name property for the database - if null, the value from the template is useddescription- the stored description property associated with the database - if null, the value from the template is usednetworkAddress- if there is a connection object for this asset - update the endpoint network addressmethodName- calling method- Returns:
- unique identifier of the asset in the repository. If a connection or schema object is provided, it is stored linked to the asset.
- Throws:
InvalidParameterException- the bean properties are invalidUserNotAuthorizedException- user not authorized to issue this requestPropertyServerException- problem accessing the property server
-
createAssetInRepository
public String createAssetInRepository(String userId, String externalSourceGUID, String externalSourceName, String qualifiedName, String technicalName, String technicalDescription, List<String> zoneMembership, String owner, int ownerType, String originOrganizationCapabilityGUID, String originBusinessCapabilityGUID, Map<String,String> otherOriginValues, Map<String,String> additionalProperties, String typeGUID, String typeName, Map<String,Object> extendedProperties, String methodName) throws InvalidParameterException, PropertyServerException, UserNotAuthorizedException
Add a simple asset description to the metadata repository. Null values for requested typename, ownership, zone membership and latest change are filled in with default values.- Parameters:
userId- calling userexternalSourceGUID- unique identifier of software server capability representing the callerexternalSourceName- unique name of software server capability representing the callerqualifiedName- unique name for this assettechnicalName- the stored display name property for the assettechnicalDescription- the stored description property associated with the assetzoneMembership- initial zones for the asset - or null to allow the security module to set it upowner- identifier of the ownerownerType- is the owner identifier a user id, personal profile or team profileoriginOrganizationCapabilityGUID- unique identifier of originating organizationoriginBusinessCapabilityGUID- unique identifier of originating business capabilityotherOriginValues- the properties that characterize where this asset is fromadditionalProperties- any arbitrary properties not part of the type systemtypeGUID- identifier of the type that is a subtype of asset - or null to create standard typetypeName- name of the type that is a subtype of asset - or null to create standard typeextendedProperties- properties from any subtypemethodName- calling method- Returns:
- unique identifier of the new asset
- Throws:
InvalidParameterException- the bean properties are invalidUserNotAuthorizedException- user not authorized to issue this requestPropertyServerException- problem accessing the property server
-
createAssetInRepository
public String createAssetInRepository(String userId, String externalSourceGUID, String externalSourceName, String qualifiedName, String technicalName, String technicalDescription, List<String> zoneMembership, String owner, int ownerType, String originOrganizationCapabilityGUID, String originBusinessCapabilityGUID, Map<String,String> otherOriginValues, Map<String,String> additionalProperties, String typeGUID, String typeName, Map<String,Object> extendedProperties, InstanceStatus instanceStatus, String methodName) throws InvalidParameterException, PropertyServerException, UserNotAuthorizedException
Add a simple asset description to the metadata repository. Null values for requested typename, ownership, zone membership and latest change are filled in with default values.- Parameters:
userId- calling userexternalSourceGUID- unique identifier of software server capability representing the callerexternalSourceName- unique name of software server capability representing the callerqualifiedName- unique name for this assettechnicalName- the stored display name property for the assettechnicalDescription- the stored description property associated with the assetzoneMembership- initial zones for the asset - or null to allow the security module to set it upowner- identifier of the ownerownerType- is the owner identifier a user id, personal profile or team profileoriginOrganizationCapabilityGUID- unique identifier of originating organizationoriginBusinessCapabilityGUID- unique identifier of originating business capabilityotherOriginValues- the properties that characterize where this asset is fromadditionalProperties- any arbitrary properties not part of the type systemtypeGUID- identifier of the type that is a subtype of asset - or null to create standard typetypeName- name of the type that is a subtype of asset - or null to create standard typeextendedProperties- properties from any subtypeinstanceStatus- initial status of the Asset in the metadata repositorymethodName- calling method- Returns:
- unique identifier of the new asset
- Throws:
InvalidParameterException- the bean properties are invalidUserNotAuthorizedException- user not authorized to issue this requestPropertyServerException- problem accessing the property server
-
createAssetInRepository
public String createAssetInRepository(String userId, String externalSourceGUID, String externalSourceName, String qualifiedName, String technicalName, String technicalDescription, Map<String,String> additionalProperties, String typeName, Map<String,Object> extendedProperties, InstanceStatus instanceStatus, String methodName) throws InvalidParameterException, PropertyServerException, UserNotAuthorizedException
Add a simple asset description to the metadata repository. Null values for requested typename, ownership, zone membership and latest change are filled in with default values.- Parameters:
userId- calling userexternalSourceGUID- unique identifier of software server capability representing the callerexternalSourceName- unique name of software server capability representing the callerqualifiedName- unique name for this assettechnicalName- the stored display name property for the assettechnicalDescription- the stored description property associated with the assetadditionalProperties- any arbitrary properties not part of the type systemtypeName- name of the type that is a subtype of asset - or null to create standard typeextendedProperties- properties from any subtypeinstanceStatus- initial status of the Asset in the metadata repositorymethodName- calling method- Returns:
- unique identifier of the new asset
- Throws:
InvalidParameterException- the bean properties are invalidUserNotAuthorizedException- user not authorized to issue this requestPropertyServerException- problem accessing the property server
-
createAssetWithConnection
public String createAssetWithConnection(String userId, String externalSourceGUID, String externalSourceName, String assetGUIDParameterName, String assetQualifiedName, String technicalName, String technicalDescription, Map<String,String> additionalProperties, String assetTypeName, Map<String,Object> extendedProperties, InstanceStatus instanceStatus, boolean anchorEndpointToAsset, Map<String,Object> configurationProperties, String connectorProviderClassName, String networkAddress, String protocol, String encryptionMethod, String methodName) throws InvalidParameterException, PropertyServerException, UserNotAuthorizedException
Add a simple asset description to the metadata repository. Null values for requested typename, ownership, zone membership and latest change are filled in with default values.- Parameters:
userId- calling userexternalSourceGUID- unique identifier of software server capability representing the callerexternalSourceName- unique name of software server capability representing the callerassetGUIDParameterName- parameter name of the resulting asset's GUIDassetQualifiedName- unique name for this assettechnicalName- the stored display name property for the assettechnicalDescription- the stored description property associated with the assetadditionalProperties- any arbitrary properties not part of the type systemassetTypeName- name of the type that is a subtype of asset - or null to create standard typeextendedProperties- properties from any subtypeinstanceStatus- initial status of the Asset in the metadata repositoryanchorEndpointToAsset- set to true if the network address is unique for the asset and should not be reused. False if this is an endpoint that is relevant for multiple assets.configurationProperties- configuration properties for the connectionconnectorProviderClassName- Java class name for the connector providernetworkAddress- the network address (typically the URL but this depends on the protocol)protocol- the name of the protocol to use to connect to the endpointencryptionMethod- encryption method to use when passing data to this endpointmethodName- calling method- Returns:
- unique identifier of the new asset
- Throws:
InvalidParameterException- the bean properties are invalidUserNotAuthorizedException- user not authorized to issue this requestPropertyServerException- problem accessing the property server
-
updateAsset
public void updateAsset(String userId, String externalSourceGUID, String externalSourceName, String assetGUID, String assetGUIDParameterName, String qualifiedName, String technicalName, String technicalDescription, Map<String,String> additionalProperties, String typeName, Map<String,Object> extendedProperties, boolean isMergeUpdate, String methodName) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException
Update an asset's properties.- Parameters:
userId- calling userexternalSourceGUID- unique identifier of software server capability representing the callerexternalSourceName- unique name of software server capability representing the callerassetGUID- unique identifier of the metadata element to updateassetGUIDParameterName- parameter name that supplied the assetGUIDqualifiedName- unique name for this databasetechnicalName- the stored display name property for the assettechnicalDescription- the stored description property associated with the assetadditionalProperties- any arbitrary properties not part of the type systemtypeName- name of the type that is a subtype of Database - or null to create standard typeextendedProperties- properties from any subtypeisMergeUpdate- should the new properties be merged with the existing properties of overlay them?methodName- calling method- Throws:
InvalidParameterException- one of the parameters is invalidUserNotAuthorizedException- the user is not authorized to issue this requestPropertyServerException- there is a problem reported in the open metadata server(s)
-
updateAsset
public void updateAsset(String userId, String externalSourceGUID, String externalSourceName, String assetGUID, String assetGUIDParameterName, String qualifiedName, String technicalName, String technicalDescription, Map<String,String> additionalProperties, String typeGUID, String typeName, Map<String,Object> extendedProperties, String methodName) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException
Update an asset's properties.- Parameters:
userId- calling userexternalSourceGUID- unique identifier of software server capability representing the callerexternalSourceName- unique name of software server capability representing the callerassetGUID- unique identifier of the metadata element to updateassetGUIDParameterName- parameter name that supplied the assetGUIDqualifiedName- unique name for this databasetechnicalName- the stored display name property for the assettechnicalDescription- the stored description property associated with the assetadditionalProperties- any arbitrary properties not part of the type systemtypeGUID- identifier of the type that is a subtype of Database - or null to create standard typetypeName- name of the type that is a subtype of Database - or null to create standard typeextendedProperties- properties from any subtypemethodName- calling method- Throws:
InvalidParameterException- one of the parameters is invalidUserNotAuthorizedException- the user is not authorized to issue this requestPropertyServerException- there is a problem reported in the open metadata server(s)
-
updateAsset
public void updateAsset(String userId, String externalSourceGUID, String externalSourceName, String assetGUID, String assetGUIDParameterName, String qualifiedName, String technicalName, String technicalDescription, Map<String,String> additionalProperties, String typeGUID, String typeName, Map<String,Object> extendedProperties, boolean isMergeUpdate, String methodName) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException
Update an asset's properties.- Parameters:
userId- calling userexternalSourceGUID- unique identifier of software server capability representing the callerexternalSourceName- unique name of software server capability representing the callerassetGUID- unique identifier of the metadata element to updateassetGUIDParameterName- parameter name that supplied the assetGUIDqualifiedName- unique name for this databasetechnicalName- the stored display name property for the assettechnicalDescription- the stored description property associated with the assetadditionalProperties- any arbitrary properties not part of the type systemtypeGUID- identifier of the type that is a subtype of Database - or null to create standard typetypeName- name of the type that is a subtype of Database - or null to create standard typeisMergeUpdate- indicates whether supplied properties should replaceextendedProperties- properties from any subtypemethodName- calling method- Throws:
InvalidParameterException- one of the parameters is invalidUserNotAuthorizedException- the user is not authorized to issue this requestPropertyServerException- there is a problem reported in the open metadata server(s)
-
updateAsset
public void updateAsset(String userId, String externalSourceGUID, String externalSourceName, String assetGUID, String assetGUIDParameterName, String qualifiedName, String technicalName, String technicalDescription, Map<String,String> additionalProperties, String typeGUID, String typeName, List<String> suppliedSupportedZones, Map<String,Object> extendedProperties, boolean isMergeUpdate, String methodName) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException
Update an asset's properties.- Parameters:
userId- calling userexternalSourceGUID- unique identifier of software server capability representing the callerexternalSourceName- unique name of software server capability representing the callerassetGUID- unique identifier of the metadata element to updateassetGUIDParameterName- parameter name that supplied the assetGUIDqualifiedName- unique name for this databasetechnicalName- the stored display name property for the assettechnicalDescription- the stored description property associated with the assetadditionalProperties- any arbitrary properties not part of the type systemtypeGUID- identifier of the type that is a subtype of Asset - or null to create standard typetypeName- name of the type that is a subtype of Asset - or null to create standard typesuppliedSupportedZones- supported zones that are specific to the callerextendedProperties- properties from any subtypeisMergeUpdate- should the new properties be merged with the existing properties of overlay them?methodName- calling method- Throws:
InvalidParameterException- one of the parameters is invalidUserNotAuthorizedException- the user is not authorized to issue this requestPropertyServerException- there is a problem reported in the open metadata server(s)
-
updateAssetWithConnection
public void updateAssetWithConnection(String userId, String externalSourceGUID, String externalSourceName, String assetGUID, String assetGUIDParameterName, String qualifiedName, String displayName, String description, Map<String,String> additionalProperties, String typeGUID, String typeName, Map<String,Object> extendedProperties, String assetSummary, Connection connection, String methodName) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException
Update an asset's properties.- Parameters:
userId- calling userexternalSourceGUID- unique identifier of software server capability representing the callerexternalSourceName- unique name of software server capability representing the callerassetGUID- unique identifier of the metadata element to updateassetGUIDParameterName- parameter name that supplied the assetGUIDqualifiedName- unique name for this databasedisplayName- the stored display name property for the databasedescription- the stored description property associated with the databaseadditionalProperties- any arbitrary properties not part of the type systemtypeGUID- identifier of the type that is a subtype of Database - or null to create standard typetypeName- name of the type that is a subtype of Database - or null to create standard typeextendedProperties- properties from any subtypeconnection- connection associated with the assetassetSummary- description of the asset from the perspective of the connectionmethodName- calling method- Throws:
InvalidParameterException- one of the parameters is invalidUserNotAuthorizedException- the user is not authorized to issue this requestPropertyServerException- there is a problem reported in the open metadata server(s)
-
classifyAssetAsReferenceData
public void classifyAssetAsReferenceData(String userId, String assetGUID, String assetGUIDParameterName, String methodName) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException
Add the ReferenceData classification to an asset. If the asset is already classified in this way, the method is a no-op.- Parameters:
userId- calling user.assetGUID- unique identifier of the asset that contains reference data.assetGUIDParameterName- name of parameter providing assetGUIDmethodName- calling method- Throws:
InvalidParameterException- one of the parameters is invalid.UserNotAuthorizedException- the user is not authorized to make this request.PropertyServerException- the repository is not available or not working properly.
-
declassifyAssetAsReferenceData
public void declassifyAssetAsReferenceData(String userId, String assetGUID, String assetGUIDParameterName, String methodName) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException
Remove the ReferenceData classification from an Asset. If the asset was not classified in this way, this call is a no-op.- Parameters:
userId- calling user.assetGUID- unique identifier of asset.assetGUIDParameterName- name of parameter providing assetGUIDmethodName- calling method- Throws:
InvalidParameterException- one of the parameters is invalid.UserNotAuthorizedException- the user is not authorized to make this request.PropertyServerException- the repository is not available or not working properly.
-
addAssetOrigin
public void addAssetOrigin(String userId, String assetGUID, String assetGUIDParameterName, String organizationGUID, String organizationGUIDParameterName, String businessCapabilityGUID, String businessCapabilityGUIDParameterName, Map<String,String> otherOriginValues, Date effectiveFromTime, Date effectiveToTime, String methodName) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException
Add the asset origin classification to an asset. The method needs to build a before an after image of the asset to perform a security check before the update is pushed to the repository.- Parameters:
userId- calling userassetGUID- unique identifier of assetassetGUIDParameterName- parameter name supplying assetGUIDorganizationGUID- Unique identifier (GUID) of the organization where this asset originated from - or nullorganizationGUIDParameterName- parameter name supplying organizationGUIDbusinessCapabilityGUID- Unique identifier (GUID) of the business capability where this asset originated from.businessCapabilityGUIDParameterName- parameter name supplying businessCapabilityGUIDotherOriginValues- Descriptive labels describing origin of the asseteffectiveFromTime- the time that the elements must be effective from (null for any time)effectiveToTime- the time that the elements must be effective from (null for any time)methodName- calling method- Throws:
InvalidParameterException- entity not known, null userId or guidPropertyServerException- problem accessing property serverUserNotAuthorizedException- security access problem
-
removeAssetOrigin
public void removeAssetOrigin(String userId, String assetGUID, String assetGUIDParameterName, String methodName) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException
Remove the asset origin classification to an asset.- Parameters:
userId- calling userassetGUID- unique identifier of assetassetGUIDParameterName- parameter name supplying assetGUIDmethodName- calling method- Throws:
InvalidParameterException- entity not known, null userId or guidPropertyServerException- problem accessing property serverUserNotAuthorizedException- security access problem
-
publishAsset
public void publishAsset(String userId, String assetGUID, String assetGUIDParameterName, String methodName) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException
Update the zones for a specific asset to the list set up in publish zones.- Parameters:
userId- calling userassetGUID- unique identifier for the asset to updateassetGUIDParameterName- parameter name supplying assetGUIDmethodName- calling method- Throws:
InvalidParameterException- guid or userId is nullPropertyServerException- problem accessing property serverUserNotAuthorizedException- security access problem
-
withdrawAsset
public void withdrawAsset(String userId, String assetGUID, String assetGUIDParameterName, String methodName) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException
Update the zones for a specific asset to the list set up in publish zones.- Parameters:
userId- calling userassetGUID- unique identifier for the asset to updateassetGUIDParameterName- parameter name supplying assetGUIDmethodName- calling method- Throws:
InvalidParameterException- guid or userId is nullPropertyServerException- problem accessing property serverUserNotAuthorizedException- security access problem
-
updateAssetZones
public void updateAssetZones(String userId, String assetGUID, String assetGUIDParameterName, List<String> assetZones, String methodName) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException
Update the zones for a specific asset. The method needs to build a before an after image of the asset to perform a security check before the update is pushed to the repository.- Parameters:
userId- calling userassetGUID- unique identifier for the asset to updateassetGUIDParameterName- parameter name supplying assetGUIDassetZones- list of zones for the asset - these values override the current values - null means belongs to all zones.methodName- calling method- Throws:
InvalidParameterException- guid or userId is nullPropertyServerException- problem accessing property serverUserNotAuthorizedException- security access problem
-
updateAssetOwner
@Deprecated public void updateAssetOwner(String userId, String assetGUID, String assetGUIDParameterName, String ownerId, int ownerType, String methodName) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException
Deprecated.Update the owner information for a specific asset.- Parameters:
userId- calling userassetGUID- unique identifier for the asset to updateassetGUIDParameterName- parameter name supplying assetGUIDownerId- userId or profileGUID of the owner - or null to clear the fieldownerType- indicator of the type of Id provides above - or null to clear the fieldmethodName- calling method- Throws:
InvalidParameterException- userId is nullPropertyServerException- problem accessing property serverUserNotAuthorizedException- security access problem
-
getAssetForConnection
public String getAssetForConnection(String userId, String connectionGUID, String connectionGUIDParameterName, List<String> serviceSupportedZones, String methodName) throws InvalidParameterException, PropertyServerException, UserNotAuthorizedException
Returns the unique identifier for the asset connected to the requested connection.- Parameters:
userId- the userId of the requesting userconnectionGUID- unique identifier for the connectionconnectionGUIDParameterName- name of parameter supplying connectionGUIDserviceSupportedZones- list of supported zones for any connected assetmethodName- calling method- Returns:
- unique identifier of asset.
- Throws:
InvalidParameterException- one of the parameters is null or invalid.PropertyServerException- there is a problem retrieving information from the property server.UserNotAuthorizedException- the requesting user is not authorized to issue this request.
-
removeLinkedDataSet
public void removeLinkedDataSet(String userId, String externalSourceGUID, String externalSourceName, String assetGUID, String assetTypeName, Date effectiveTime, String methodName) throws InvalidParameterException, PropertyServerException, UserNotAuthorizedException
Remove any data sets connected to the asset by the DataContentForDataSet relationship.- Parameters:
userId- calling userexternalSourceGUID- unique identifier of software server capability representing the callerexternalSourceName- unique name of software server capability representing the callerassetGUID- unique identifier for assetassetTypeName- type of asseteffectiveTime- the time that the retrieved elements must be effective for (null for any time, new Date() for now)methodName- calling method- Throws:
InvalidParameterException- one of the parameters is null or invalid.PropertyServerException- there is a problem retrieving information from the property server(s).UserNotAuthorizedException- the requesting user is not authorized to issue this request.
-
getAssetForConnectionName
public String getAssetForConnectionName(String userId, String connectionName, String connectionNameParameter, String methodName) throws InvalidParameterException, PropertyServerException, UserNotAuthorizedException
Returns the asset corresponding to the supplied connection name.- Parameters:
userId- userId of user making request.connectionName- this may be the qualifiedName or displayName of the connection.connectionNameParameter- name of parameter supplyingmethodName- calling method- Returns:
- unique identifier of asset.
- Throws:
InvalidParameterException- one of the parameters is null or invalid.PropertyServerException- there is a problem retrieving information from the property server(s).UserNotAuthorizedException- the requesting user is not authorized to issue this request.
-
getAssetWithConnection
public B getAssetWithConnection(String userId, String assetGUID, String assetGUIDParameterName, String assetTypeName, Date effectiveTime, String methodName) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException
Return an asset along with any associated connection.- Parameters:
userId- calling userassetGUID- unique identifier of the assetassetGUIDParameterName- name of parameter supplying assetGUIDassetTypeName- type name of asseteffectiveTime- the time that the retrieved elements must be effective for (null for any time, new Date() for now)methodName- calling method- Returns:
- an asset bean (with embedded connection details if available)
- Throws:
InvalidParameterException- one of the parameters is null or invalid.PropertyServerException- there is a problem retrieving information from the property server(s).UserNotAuthorizedException- the requesting user is not authorized to issue this request.
-
getAssetByNameWithConnection
public B getAssetByNameWithConnection(String userId, String name, String nameParameterName, String assetTypeGUID, String assetTypeName, Date effectiveTime, String methodName) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException
Return an asset along with any associated connection.- Parameters:
userId- calling username- unique identifier of the assetnameParameterName- name of parameter supplying nameassetTypeGUID- type identifier of assetassetTypeName- type name of asseteffectiveTime- the time that the retrieved elements must be effective for (null for any time, new Date() for now)methodName- calling method- Returns:
- an asset bean (with embedded connection details if available)
- Throws:
InvalidParameterException- one of the parameters is null or invalid.PropertyServerException- there is a problem retrieving information from the property server(s).UserNotAuthorizedException- the requesting user is not authorized to issue this request.
-
getAllAssetsWithConnection
public List<B> getAllAssetsWithConnection(String userId, String assetTypeGUID, String assetTypeName, int startFrom, int pageSize, Date effectiveTime, String methodName) throws InvalidParameterException, UserNotAuthorizedException, PropertyServerException
Return the list of assets that are stored.- Parameters:
userId- identifier of calling userassetTypeGUID- subtype of asset requiredassetTypeName- subtype of asset requiredstartFrom- initial position in the stored listpageSize- maximum number of definitions to return on this calleffectiveTime- the time that the retrieved elements must be effective for (null for any time, new Date() for now)methodName- calling method- Returns:
- list of beans.
- Throws:
InvalidParameterException- one of the parameters is null or invalid.UserNotAuthorizedException- user not authorized to issue this request.PropertyServerException- problem retrieving the discovery service definitions.
-
assetGUIDsScan
public List<String> assetGUIDsScan(String userId, String subTypeGUID, String subTypeName, int startFrom, int pageSize, Date effectiveTime, String methodName) throws InvalidParameterException, PropertyServerException, UserNotAuthorizedException
Scan through the repository looking for assets by type. The type name may be null which means, all assets will be returned.- Parameters:
userId- calling usersubTypeGUID- type of asset to scan for (null for all asset types)subTypeName- type of asset to scan for (null for all asset types)startFrom- scan pointerpageSize- maximum number of resultseffectiveTime- the time that the retrieved elements must be effective for (null for any time, new Date() for now)methodName- calling method- Returns:
- list of matching assets
- Throws:
InvalidParameterException- one of the parameters is null or invalid.PropertyServerException- there is a problem retrieving information from the property server(s).UserNotAuthorizedException- the requesting user is not authorized to issue this request.
-
assetGUIDsScan
public List<String> assetGUIDsScan(String userId, String subTypeGUID, String subTypeName, List<String> suppliedSupportedZones, int startFrom, int pageSize, Date effectiveTime, String methodName) throws InvalidParameterException, PropertyServerException, UserNotAuthorizedException
Scan through the repository looking for assets by type. The type name may be null which means, all assets will be returned.- Parameters:
userId- calling usersubTypeGUID- type of asset to scan for (null for all asset types)subTypeName- type of asset to scan for (null for all asset types)suppliedSupportedZones- list of supported zones from calling servicestartFrom- scan pointerpageSize- maximum number of resultseffectiveTime- the time that the retrieved elements must be effective for (null for any time, new Date() for now)methodName- calling method- Returns:
- list of matching assets
- Throws:
InvalidParameterException- one of the parameters is null or invalid.PropertyServerException- there is a problem retrieving information from the property server(s).UserNotAuthorizedException- the requesting user is not authorized to issue this request.
-
assetScan
public List<B> assetScan(String userId, String subTypeGUID, String subTypeName, int startFrom, int pageSize, Date effectiveTime, String methodName) throws InvalidParameterException, PropertyServerException, UserNotAuthorizedException
Scan through the repository looking for assets by type. The type name may be null which means, all assets will be returned.- Parameters:
userId- calling usersubTypeGUID- type of asset to scan for (null for all asset types)subTypeName- type of asset to scan for (null for all asset types)startFrom- scan pointerpageSize- maximum number of resultseffectiveTime- the time that the retrieved elements must be effective for (null for any time, new Date() for now)methodName- calling method- Returns:
- list of matching assets
- Throws:
InvalidParameterException- one of the parameters is null or invalid.PropertyServerException- there is a problem retrieving information from the property server(s).UserNotAuthorizedException- the requesting user is not authorized to issue this request.
-
assetScan
public List<B> assetScan(String userId, String subTypeGUID, String subTypeName, List<String> suppliedSupportedZones, int startFrom, int pageSize, Date effectiveTime, String methodName) throws InvalidParameterException, PropertyServerException, UserNotAuthorizedException
Scan through the repository looking for assets by type. The type name may be null which means, all assets will be returned.- Parameters:
userId- calling usersubTypeGUID- type of asset to scan for (null for all asset types)subTypeName- type of asset to scan for (null for all asset types)startFrom- scan pointerpageSize- maximum number of resultssuppliedSupportedZones- list of supported zones from calling serviceeffectiveTime- the time that the retrieved elements must be effective for (null for any time, new Date() for now)methodName- calling method- Returns:
- list of matching assets
- Throws:
InvalidParameterException- one of the parameters is null or invalid.PropertyServerException- there is a problem retrieving information from the property server(s).UserNotAuthorizedException- the requesting user is not authorized to issue this request.
-
assetZoneScan
public List<B> assetZoneScan(String userId, String zoneName, String subTypeGUID, String subTypeName, List<String> suppliedSupportedZones, int startFrom, int pageSize, Date effectiveTime, String methodName) throws InvalidParameterException, PropertyServerException, UserNotAuthorizedException
Scan through the repository looking for assets by type and/or zone. The type name may be null which means, all types of assets will be returned. The zone name may be null which means all supportedZones for the service are returned.- Parameters:
userId- calling userzoneName- name of zone to scansubTypeGUID- type of asset to scan for (null for all asset types)subTypeName- type of asset to scan for (null for all asset types)suppliedSupportedZones- list of supported zones from calling servicestartFrom- scan pointerpageSize- maximum number of resultseffectiveTime- the time that the retrieved elements must be effective for (null for any time, new Date() for now)methodName- calling method- Returns:
- list of matching assets
- Throws:
InvalidParameterException- one of the parameters is null or invalid.PropertyServerException- there is a problem retrieving information from the property server(s).UserNotAuthorizedException- the requesting user is not authorized to issue this request.
-
assetGUIDZoneScan
public List<String> assetGUIDZoneScan(String userId, String zoneName, String subTypeGUID, String subTypeName, List<String> suppliedSupportedZones, int startFrom, int pageSize, Date effectiveTime, String methodName) throws InvalidParameterException, PropertyServerException, UserNotAuthorizedException
Scan through the repository looking for assets by type and/or zone. The type name may be null which means, all types of assets will be returned. The zone name may be null which means all supportedZones for the service are returned.- Parameters:
userId- calling userzoneName- name of zone to scansubTypeGUID- type of asset to scan for (null for all asset types)subTypeName- type of asset to scan for (null for all asset types)suppliedSupportedZones- list of supported zones from calling servicestartFrom- scan pointerpageSize- maximum number of resultseffectiveTime- the time that the retrieved elements must be effective for (null for any time, new Date() for now)methodName- calling method- Returns:
- list of GUIDs for matching assets
- Throws:
InvalidParameterException- one of the parameters is null or invalid.PropertyServerException- there is a problem retrieving information from the property server(s).UserNotAuthorizedException- the requesting user is not authorized to issue this request.
-
findAssetsByName
public List<B> findAssetsByName(String userId, String typeGUID, String typeName, String name, String nameParameterName, int startFrom, int pageSize, Date effectiveTime, String methodName) throws InvalidParameterException, PropertyServerException, UserNotAuthorizedException
Return a list of assets with the requested name in either the display name or qualified name. The match must be exact. SupportedZones set up for this service is used.- Parameters:
userId- calling usertypeGUID- unique identifier of the asset type to search for (null for the generic Asset type)typeName- unique identifier of the asset type to search for (null for the generic Asset type)name- name to search for - this is a regular expression (RegEx)nameParameterName- property that provided the namestartFrom- starting element (used in paging through large result sets)pageSize- maximum number of results to returneffectiveTime- the time that the retrieved elements must be effective for (null for any time, new Date() for now)methodName- calling method- Returns:
- list of B beans
- Throws:
InvalidParameterException- one of the parameters is null or invalid.PropertyServerException- there is a problem retrieving information from the property server(s).UserNotAuthorizedException- the requesting user is not authorized to issue this request.
-
findAssetsByName
public List<B> findAssetsByName(String userId, String typeGUID, String typeName, String name, String nameParameterName, List<String> serviceSupportedZones, int startFrom, int pageSize, Date effectiveTime, String methodName) throws InvalidParameterException, PropertyServerException, UserNotAuthorizedException
Return a list of assets with the requested name in either the display name or qualified name.- Parameters:
userId- calling usertypeGUID- unique identifier of the asset type to search for (null for the generic Asset type)typeName- unique identifier of the asset type to search for (null for the generic Asset type)name- name to search for - this is a regular expression (RegEx)nameParameterName- property that provided the nameserviceSupportedZones- list of supported zones for this servicestartFrom- starting element (used in paging through large result sets)pageSize- maximum number of results to returneffectiveTime- the time that the retrieved elements must be effective for (null for any time, new Date() for now)methodName- calling method- Returns:
- list of B beans
- Throws:
InvalidParameterException- one of the parameters is null or invalid.PropertyServerException- there is a problem retrieving information from the property server(s).UserNotAuthorizedException- the requesting user is not authorized to issue this request.
-
getAssetGUIDsByName
public List<String> getAssetGUIDsByName(String userId, String typeGUID, String typeName, String name, String nameParameterName, int startFrom, int pageSize, Date effectiveTime, String methodName) throws InvalidParameterException, PropertyServerException, UserNotAuthorizedException
Return a list of assets with the requested name in either the display name or qualified name. The match must be exact. SupportedZones set up for this service is used.- Parameters:
userId- calling usertypeGUID- unique identifier of the asset type to search for (null for the generic Asset type)typeName- unique identifier of the asset type to search for (null for the generic Asset type)name- name to search for - this must be an exact match either on the display name or the qualified namenameParameterName- property that provided the namestartFrom- starting element (used in paging through large result sets)pageSize- maximum number of results to returneffectiveTime- the time that the retrieved elements must be effective for (null for any time, new Date() for now)methodName- calling method- Returns:
- list of B beans
- Throws:
InvalidParameterException- one of the parameters is null or invalid.PropertyServerException- there is a problem retrieving information from the property server(s).UserNotAuthorizedException- the requesting user is not authorized to issue this request.
-
getAssetGUIDsByName
public List<String> getAssetGUIDsByName(String userId, String typeGUID, String typeName, String name, String nameParameterName, List<String> serviceSupportedZones, int startFrom, int pageSize, Date effectiveTime, String methodName) throws InvalidParameterException, PropertyServerException, UserNotAuthorizedException
Return a list of assets with the requested name in either the display name or qualified name. The match must be exact.- Parameters:
userId- calling usertypeGUID- unique identifier of the asset type to search for (null for the generic Asset type)typeName- unique identifier of the asset type to search for (null for the generic Asset type)name- name to search fornameParameterName- property that provided the nameserviceSupportedZones- list of supported zones for this servicestartFrom- starting element (used in paging through large result sets)pageSize- maximum number of results to returneffectiveTime- the time that the retrieved elements must be effective for (null for any time, new Date() for now)methodName- calling method- Returns:
- list of B beans
- Throws:
InvalidParameterException- one of the parameters is null or invalid.PropertyServerException- there is a problem retrieving information from the property server(s).UserNotAuthorizedException- the requesting user is not authorized to issue this request.
-
getAssetsByName
public List<B> getAssetsByName(String userId, String typeGUID, String typeName, String name, String nameParameterName, int startFrom, int pageSize, Date effectiveTime, String methodName) throws InvalidParameterException, PropertyServerException, UserNotAuthorizedException
Return a list of assets with the requested name in either the display name or qualified name. The match must be exact. SupportedZones set up for this service is used.- Parameters:
userId- calling usertypeGUID- unique identifier of the asset type to search for (null for the generic Asset type)typeName- unique identifier of the asset type to search for (null for the generic Asset type)name- name to search fornameParameterName- property that provided the namestartFrom- starting element (used in paging through large result sets)pageSize- maximum number of results to returneffectiveTime- the time that the retrieved elements must be effective for (null for any time, new Date() for now)methodName- calling method- Returns:
- list of B beans
- Throws:
InvalidParameterException- one of the parameters is null or invalid.PropertyServerException- there is a problem retrieving information from the property server(s).UserNotAuthorizedException- the requesting user is not authorized to issue this request.
-
getAssetsByName
public List<B> getAssetsByName(String userId, String typeGUID, String typeName, String name, String nameParameterName, List<String> serviceSupportedZones, int startFrom, int pageSize, Date effectiveTime, String methodName) throws InvalidParameterException, PropertyServerException, UserNotAuthorizedException
Return a list of assets with the requested name in either the display name or qualified name. The match must be exact.- Parameters:
userId- calling usertypeGUID- unique identifier of the asset type to search for (null for the generic Asset type)typeName- unique identifier of the asset type to search for (null for the generic Asset type)name- name to search for - this must be an exact match on the display name or qualified namenameParameterName- property that provided the nameserviceSupportedZones- list of supported zones for this servicestartFrom- starting element (used in paging through large result sets)pageSize- maximum number of results to returneffectiveTime- the time that the retrieved elements must be effective for (null for any time, new Date() for now)methodName- calling method- Returns:
- list of B beans
- Throws:
InvalidParameterException- one of the parameters is null or invalid.PropertyServerException- there is a problem retrieving information from the property server(s).UserNotAuthorizedException- the requesting user is not authorized to issue this request.
-
getAssetGUIDsByEndpoint
public List<String> getAssetGUIDsByEndpoint(String userId, String networkAddress, String networkAddressParameterName, int startFrom, int pageSize, Date effectiveTime, String methodName) throws InvalidParameterException, PropertyServerException, UserNotAuthorizedException
Return the list of assets that have the same endpoint address.- Parameters:
userId- calling usernetworkAddress- address to query onnetworkAddressParameterName- parameter name supplying networkAddressstartFrom- place to start in querypageSize- number of results to returneffectiveTime- the time that the retrieved elements must be effective for (null for any time, new Date() for now)methodName- calling method- Returns:
- list of unique identifiers for matching assets
- Throws:
InvalidParameterException- the networkAddress is invalidPropertyServerException- there is a problem access in the property serverUserNotAuthorizedException- the user does not have access to the properties
-
getAssetsByEndpoint
public List<B> getAssetsByEndpoint(String userId, String networkAddress, String networkAddressParameterName, String suppliedTypeName, int startFrom, int pageSize, Date effectiveTime, String methodName) throws InvalidParameterException, PropertyServerException, UserNotAuthorizedException
Return the list of assets that have the same endpoint address.- Parameters:
userId- calling usernetworkAddress- address to query onnetworkAddressParameterName- name of parameter passing the network addresssuppliedTypeName- name of asset subtype to validatestartFrom- place to start in querypageSize- number of results to returneffectiveTime- the time that the retrieved elements must be effective for (null for any time, new Date() for now)methodName- calling method- Returns:
- list of matching assets
- Throws:
InvalidParameterException- the networkAddress is invalidPropertyServerException- there is a problem access in the property serverUserNotAuthorizedException- the user does not have access to the properties
-
findAssetGUIDs
public List<String> findAssetGUIDs(String userId, String searchString, String searchStringParameter, int startFrom, int pageSize, Date effectiveTime, String methodName) throws InvalidParameterException, PropertyServerException, UserNotAuthorizedException
Return a list of assets with the requested search string in their name, qualified name or description.- Parameters:
userId- calling usersearchString- string to search for in textsearchStringParameter- name of parameter supplying the search stringstartFrom- starting element (used in paging through large result sets)pageSize- maximum number of results to returneffectiveTime- the time that the retrieved elements must be effective for (null for any time, new Date() for now)methodName- calling method- Returns:
- list of unique identifiers for assets that match the search string.
- Throws:
InvalidParameterException- the searchString is invalidPropertyServerException- there is a problem access in the property serverUserNotAuthorizedException- the user does not have access to the properties
-
findAssetGUIDs
public List<String> findAssetGUIDs(String userId, String typeGUID, String typeName, String searchString, String searchStringParameter, int startFrom, int pageSize, Date effectiveTime, String methodName) throws InvalidParameterException, PropertyServerException, UserNotAuthorizedException
Return a list of assets with the requested search string in their name, qualified name or description.- Parameters:
userId- calling usertypeGUID- unique identifier of the asset type to search for - null for generic AssettypeName- unique name of the asset type to search for - null for generic AssetsearchString- string to search for in textsearchStringParameter- parameter providing search stringstartFrom- starting element (used in paging through large result sets)pageSize- maximum number of results to returneffectiveTime- the time that the retrieved elements must be effective for (null for any time, new Date() for now)methodName- calling method- Returns:
- list of unique identifiers for assets that match the search string.
- Throws:
InvalidParameterException- the searchString is invalidPropertyServerException- there is a problem access in the property serverUserNotAuthorizedException- the user does not have access to the properties
-
findAssets
public List<B> findAssets(String userId, String searchString, String searchStringParameter, int startFrom, int pageSize, Date effectiveTime, String methodName) throws InvalidParameterException, PropertyServerException, UserNotAuthorizedException
Return a list of assets with the requested search string in their name, qualified name or description.- Parameters:
userId- calling usersearchString- string to search for in textsearchStringParameter- parameter providing search stringstartFrom- starting element (used in paging through large result sets)pageSize- maximum number of results to returneffectiveTime- the time that the retrieved elements must be effective for (null for any time, new Date() for now)methodName- calling method- Returns:
- list of assets that match the search string.
- Throws:
InvalidParameterException- the searchString is invalidPropertyServerException- there is a problem access in the property serverUserNotAuthorizedException- the user does not have access to the properties
-
findAssets
public List<B> findAssets(String userId, String typeGUID, String typeName, String searchString, String searchStringParameter, int startFrom, int pageSize, Date effectiveTime, String methodName) throws InvalidParameterException, PropertyServerException, UserNotAuthorizedException
Return a list of assets with the requested search string in their name, qualified name or description.- Parameters:
userId- calling usertypeGUID- unique identifier of the asset type to search fortypeName- unique name of the asset type to search forsearchString- string to search for in textsearchStringParameter- parameter providing search stringstartFrom- starting element (used in paging through large result sets)pageSize- maximum number of results to returneffectiveTime- the time that the retrieved elements must be effective for (null for any time, new Date() for now)methodName- calling method- Returns:
- list of assets that match the search string.
- Throws:
InvalidParameterException- the searchString is invalidPropertyServerException- there is a problem access in the property serverUserNotAuthorizedException- the user does not have access to the properties
-
getAssetGUIDsByTag
public List<String> getAssetGUIDsByTag(String userId, String tagGUID, String tagGUIDParameterName, int startFrom, int pageSize, Date effectiveTime, String methodName) throws InvalidParameterException, PropertyServerException, UserNotAuthorizedException
Return the list of unique identifiers for assets that are linked to a specific tag either directly, or via one of its schema elements.- Parameters:
userId- the name of the calling user.tagGUID- unique identifier of tag.tagGUIDParameterName- name of parameter supplying the GUIDstartFrom- index of the list to start from (0 for start)pageSize- maximum number of elements to return.effectiveTime- the time that the retrieved elements must be effective for (null for any time, new Date() for now)methodName- calling method- Returns:
- asset guid list
- Throws:
InvalidParameterException- the userId is null or invalid.PropertyServerException- there is a problem retrieving information from the property server(s).UserNotAuthorizedException- the requesting user is not authorized to issue this request.
-
getAssetsByTag
public List<B> getAssetsByTag(String userId, String tagGUID, String tagGUIDParameterName, int startFrom, int pageSize, Date effectiveTime, String methodName) throws InvalidParameterException, PropertyServerException, UserNotAuthorizedException
Return the list of assets that are linked to a specific tag either directly, or via one of its schema elements.- Parameters:
userId- the name of the calling user.tagGUID- unique identifier of tag.tagGUIDParameterName- name of parameter supplying the GUIDstartFrom- index of the list to start from (0 for start)pageSize- maximum number of elements to return.effectiveTime- the time that the retrieved elements must be effective for (null for any time, new Date() for now)methodName- calling method- Returns:
- asset guid list
- Throws:
InvalidParameterException- the userId is null or invalid.PropertyServerException- there is a problem retrieving information from the property server(s).UserNotAuthorizedException- the requesting user is not authorized to issue this request.
-
getAssetGUIDsByKeyword
public List<String> getAssetGUIDsByKeyword(String userId, String keywordGUID, String keywordGUIDParameterName, int startFrom, int pageSize, Date effectiveTime, String methodName) throws InvalidParameterException, PropertyServerException, UserNotAuthorizedException
Return the list of unique identifiers for assets that are linked to a specific keyword either directly, or via one of its schema elements.- Parameters:
userId- the name of the calling user.keywordGUID- unique identifier of keyword.keywordGUIDParameterName- name of parameter supplying the guidstartFrom- index of the list to start from (0 for start)pageSize- maximum number of elements to return.effectiveTime- the time that the retrieved elements must be effective for (null for any time, new Date() for now)methodName- calling method- Returns:
- asset guid list
- Throws:
InvalidParameterException- the userId is null or invalid.PropertyServerException- there is a problem retrieving information from the property server(s).UserNotAuthorizedException- the requesting user is not authorized to issue this request.
-
getAssetsByKeyword
public List<B> getAssetsByKeyword(String userId, String keywordGUID, String keywordGUIDParameterName, int startFrom, int pageSize, Date effectiveTime, String methodName) throws InvalidParameterException, PropertyServerException, UserNotAuthorizedException
Return the list of assets that are linked to a specific keyword.- Parameters:
userId- the name of the calling user.keywordGUID- unique identifier of keyword.keywordGUIDParameterName- name of parameter supplying the guidstartFrom- index of the list to start from (0 for start)pageSize- maximum number of elements to return.effectiveTime- the time that the retrieved elements must be effective for (null for any time, new Date() for now)methodName- calling method- Returns:
- asset guid list
- Throws:
InvalidParameterException- the userId is null or invalid.PropertyServerException- there is a problem retrieving information from the property server(s).UserNotAuthorizedException- the requesting user is not authorized to issue this request.
-
getAssetsByGlossaryTerm
public List<B> getAssetsByGlossaryTerm(String userId, String termGUID, String termGUIDParameterName, int startFrom, int pageSize, Date effectiveTime, String methodName) throws InvalidParameterException, PropertyServerException, UserNotAuthorizedException
Return the list of assets that are linked to a specific glossary term.- Parameters:
userId- the name of the calling user.termGUID- unique identifier of term.termGUIDParameterName- name of parameter supplying the guidstartFrom- index of the list to start from (0 for start)pageSize- maximum number of elements to return.effectiveTime- the time that the retrieved elements must be effective for (null for any time, new Date() for now)methodName- calling method- Returns:
- asset guid list
- Throws:
InvalidParameterException- the userId is null or invalid.PropertyServerException- there is a problem retrieving information from the property server(s).UserNotAuthorizedException- the requesting user is not authorized to issue this request.
-
-