org.odpi.openmetadata.accessservices.assetowner.api

Interface AssetOnboardingInterface

public interface AssetOnboardingInterface

AssetOnboardingInterface provides the client-side interface for an asset owner to set up the metadata about their asset. This includes defining its name, source and license.

Method Summary

Modifier and Type	Method and Description
String	addAssetToCatalog(String userId, String typeName, String qualifiedName, String displayName, String description, Map<String,String> additionalProperties, Map<String,Object> extendedProperties) Add a simple asset description to the catalog.
String	addCombinedSchemaToAsset(String userId, String assetGUID, SchemaTypeProperties schemaType, List<SchemaAttributeProperties> schemaAttributes) Stores the supplied schema details in the catalog and attaches it to the asset.
void	addConnectionToAsset(String userId, String assetGUID, String assetSummary, Connection connection) Adds a connection to an asset.
String	addSchemaAttribute(String serverName, String userId, String assetGUID, String parentGUID, SchemaAttributeProperties schemaAttribute) Adds an attribute to a complex schema type like a relational table, avro schema or a structured document.
void	addSchemaAttributes(String serverName, String userId, String assetGUID, String parentGUID, List<SchemaAttributeProperties> schemaAttributes) Adds attributes to a complex schema type like a relational table, avro schema or a structured document.
void	addSchemaAttributesToSchema(String userId, String schemaTypeGUID, List<SchemaAttribute> schemaAttributes) Deprecated.
String	addSchemaToAsset(String userId, String assetGUID, SchemaType schemaType, List<SchemaAttribute> schemaAttributes) Deprecated.
String	addSchemaTypeToAsset(String userId, String assetGUID, SchemaTypeProperties schemaType) Stores the supplied schema type in the catalog and attaches it to the asset.
void	attachSchemaTypeToAsset(String userId, String assetGUID, String schemaTypeGUID) Links the supplied schema type directly to the asset.
void	deleteAssetSchemaType(String userId, String assetGUID) Detaches and deletes an asset's schema.
String	detachSchemaTypeFromAsset(String userId, String assetGUID) Unlinks the schema from the asset but does not delete it.

Method Detail

addAssetToCatalog

String addAssetToCatalog(String userId,
                         String typeName,
                         String qualifiedName,
                         String displayName,
                         String description,
                         Map<String,String> additionalProperties,
                         Map<String,Object> extendedProperties)
                  throws InvalidParameterException,
                         UserNotAuthorizedException,
                         PropertyServerException

Add a simple asset description to the catalog.

Parameters:

userId - calling user (assumed to be the owner)

typeName - specific type of the asset - this must match a defined subtype

qualifiedName - unique name for the asset in the catalog

displayName - display name for the asset in the catalog

description - description of the asset in the catalog

additionalProperties - additional properties added by the caller

extendedProperties - properties from the subtypes

Returns:

unique identifier (guid) of the asset

Throws:

InvalidParameterException - full path or userId is null

PropertyServerException - problem accessing property server

UserNotAuthorizedException - security access problem

addCombinedSchemaToAsset

String addCombinedSchemaToAsset(String userId,
                                String assetGUID,
                                SchemaTypeProperties schemaType,
                                List<SchemaAttributeProperties> schemaAttributes)
                         throws InvalidParameterException,
                                UserNotAuthorizedException,
                                PropertyServerException

Stores the supplied schema details in the catalog and attaches it to the asset. If another schema is currently attached to the asset, it is unlinked and deleted. If more attributes need to be added in addition to the ones supplied then this can be done with addSchemaAttributesToSchemaType().

Parameters:

userId - calling user

assetGUID - unique identifier of the asset that the schema is to be attached to

schemaType - schema type to create and attach directly to the asset.

schemaAttributes - optional schema attributes.

Returns:

guid of the schema type or

Throws:

InvalidParameterException - full path or userId is null

PropertyServerException - problem accessing property server

UserNotAuthorizedException - security access problem

addSchemaTypeToAsset

String addSchemaTypeToAsset(String userId,
                            String assetGUID,
                            SchemaTypeProperties schemaType)
                     throws InvalidParameterException,
                            UserNotAuthorizedException,
                            PropertyServerException

Stores the supplied schema type in the catalog and attaches it to the asset. If another schema is currently attached to the asset, it is unlinked and deleted.

Parameters:

userId - calling user

assetGUID - unique identifier of the asset that the schema is to be attached to

schemaType - schema type to create and attach directly to the asset.

Returns:

guid of the new schema type or

Throws:

InvalidParameterException - full path or userId is null

PropertyServerException - problem accessing property server

UserNotAuthorizedException - security access problem

attachSchemaTypeToAsset

void attachSchemaTypeToAsset(String userId,
                             String assetGUID,
                             String schemaTypeGUID)
                      throws InvalidParameterException,
                             UserNotAuthorizedException,
                             PropertyServerException

Links the supplied schema type directly to the asset. If this schema is either not found, or already attached to an asset, then an error occurs. If another schema is currently attached to the asset, it is unlinked and deleted.

Parameters:

userId - calling user

assetGUID - unique identifier of the asset that the schema is to be attached to

schemaTypeGUID - unique identifier of the schema type to attach

Throws:

InvalidParameterException - full path or userId is null

PropertyServerException - problem accessing property server

UserNotAuthorizedException - security access problem

detachSchemaTypeFromAsset

String detachSchemaTypeFromAsset(String userId,
                                 String assetGUID)
                          throws InvalidParameterException,
                                 UserNotAuthorizedException,
                                 PropertyServerException

Unlinks the schema from the asset but does not delete it. This means it can be be reattached to a different asset.

Parameters:

userId - calling user

assetGUID - unique identifier of the asset that the schema is to be attached to

Returns:

guid of detached schema type

Throws:

InvalidParameterException - full path or userId is null

PropertyServerException - problem accessing property server

UserNotAuthorizedException - security access problem

deleteAssetSchemaType

void deleteAssetSchemaType(String userId,
                           String assetGUID)
                    throws InvalidParameterException,
                           UserNotAuthorizedException,
                           PropertyServerException

Detaches and deletes an asset's schema.

Parameters:

userId - calling user

assetGUID - unique identifier of the asset that the schema is to be attached to

Throws:

InvalidParameterException - full path or userId is null

PropertyServerException - problem accessing property server

UserNotAuthorizedException - security access problem

addSchemaAttributes

void addSchemaAttributes(String serverName,
                         String userId,
                         String assetGUID,
                         String parentGUID,
                         List<SchemaAttributeProperties> schemaAttributes)
                  throws InvalidParameterException,
                         UserNotAuthorizedException,
                         PropertyServerException

Adds attributes to a complex schema type like a relational table, avro schema or a structured document. This method can be called repeatedly to add many attributes to a schema.

Parameters:

serverName - name of the server instance to connect to

userId - calling user

assetGUID - unique identifier of the asset that the schema is to be attached to

parentGUID - unique identifier of the schema element to anchor these attributes to.

schemaAttributes - list of schema attribute objects.

Throws:

InvalidParameterException - full path or userId is null

PropertyServerException - problem accessing property server

UserNotAuthorizedException - security access problem

addSchemaAttribute

String addSchemaAttribute(String serverName,
                          String userId,
                          String assetGUID,
                          String parentGUID,
                          SchemaAttributeProperties schemaAttribute)
                   throws InvalidParameterException,
                          UserNotAuthorizedException,
                          PropertyServerException

Adds an attribute to a complex schema type like a relational table, avro schema or a structured document. This method can be called repeatedly to add many attributes to a schema. Since the GUID is returned, it is possible to add nested schema attributes to another schema attribute.

Parameters:

serverName - name of the server instance to connect to

userId - calling user

assetGUID - unique identifier of the asset that the schema is to be attached to

parentGUID - unique identifier of the schema element to anchor these attributes to.

schemaAttribute - schema attribute object to add the the schema.

Returns:

list of unique identifiers for the new schema attributes returned in the same order as the supplied attribute or

Throws:

InvalidParameterException - full path or userId is null

PropertyServerException - problem accessing property server

UserNotAuthorizedException - security access problem

addSchemaToAsset

@Deprecated
String addSchemaToAsset(String userId,
                                    String assetGUID,
                                    SchemaType schemaType,
                                    List<SchemaAttribute> schemaAttributes)
                             throws InvalidParameterException,
                                    UserNotAuthorizedException,
                                    PropertyServerException

Deprecated.

Links the supplied schema to the asset. If the schema has the GUID set, it is assumed to refer to an existing schema defined in the metadata repository. If this schema is either not found, or already attached to an asset, then an error occurs. If the GUID is null then a new schemaType is added to the metadata repository and attached to the asset. If another schema is currently attached to the asset, it is unlinked and deleted.

Parameters:

userId - calling user

assetGUID - unique identifier of the asset that the schema is to be attached to

schemaType - schema to attach

schemaAttributes - list of schema attribute objects.

Returns:

unique identifier (guid) of the schema

Throws:

InvalidParameterException - full path or userId is null

PropertyServerException - problem accessing property server

UserNotAuthorizedException - security access problem

addSchemaAttributesToSchema

@Deprecated
void addSchemaAttributesToSchema(String userId,
                                             String schemaTypeGUID,
                                             List<SchemaAttribute> schemaAttributes)
                                      throws InvalidParameterException,
                                             UserNotAuthorizedException,
                                             PropertyServerException

Deprecated.

Adds attributes to a complex schema type like a relational table or a structured document. This method can be called repeatedly to add many attributes to a schema.

Parameters:

userId - calling user

schemaTypeGUID - unique identifier if the schema to anchor these attributes to.

schemaAttributes - list of schema attribute objects.

Throws:

InvalidParameterException - userId or schemaTypeGUID is null

PropertyServerException - problem accessing property server

UserNotAuthorizedException - security access problem

addConnectionToAsset

void addConnectionToAsset(String userId,
                          String assetGUID,
                          String assetSummary,
                          Connection connection)
                   throws InvalidParameterException,
                          UserNotAuthorizedException,
                          PropertyServerException

Adds a connection to an asset. Assets can have multiple connections attached.

Parameters:

userId - calling user

assetGUID - unique identifier of the attest to attach the connection to

assetSummary - summary of the asset that is stored in the relationship between the asset and the connection.

connection - connection object. If the connection is already stored (matching guid) then the existing connection is used.

Throws:

InvalidParameterException - full path or userId is null

PropertyServerException - problem accessing property server

UserNotAuthorizedException - security access problem