org.odpi.openmetadata.accessservices.dataengine.client

Interface DataEngineClient

All Known Implementing Classes:

DataEngineEventClient, DataEngineRESTClient, DataEngineRESTConfigurationClient

public interface DataEngineClient

DataEngineClient provides the client-side interface for a data engine tool to create processes with ports, schemas and relationships.

Method Summary

Modifier and Type	Method and Description
void	addLineageMappings(String userId, List<LineageMapping> lineageMappings) Add lineage mapping relationships between schema types
String	addProcessHierarchy(String userId, ProcessHierarchy processHierarchy) Add a ProcessHierarchy relationship to a process
String	createExternalDataEngine(String userId, SoftwareServerCapability softwareServerCapability) Create or update the software server capability entity
String	createOrUpdatePortAlias(String userId, PortAlias portAlias, String processQualifiedName) Create or update the port alias entity with a PortDelegation relationship.
String	createOrUpdatePortImplementation(String userId, PortImplementation portImplementation, String processQualifiedName) Create or update the port implementation entity,with the corresponding schema type and port schema relationship.
List<String>	createOrUpdateProcesses(String userId, List<Process> processes) Create or update the processes, with all the ports, schema types and corresponding relationships including process hierarchy relationships.
String	createOrUpdateSchemaType(String userId, SchemaType schemaType) Create or update the schema type entity, with the corresponding schema attributes and relationships
void	deleteExternalDataEngine(String userId, String qualifiedName, String guid) Delete the external data engine
void	deletePortAlias(String userId, String qualifiedName, String guid) Delete the port alias
void	deletePortImplementation(String userId, String qualifiedName, String guid) Delete the port implementation
void	deleteProcesses(String userId, List<String> qualifiedNames, List<String> guids) Delete a list of processes
void	deleteSchemaType(String userId, String qualifiedName, String guid) Delete the schema type
String	getExternalSourceName() Returns the name of the source system using data engine client
void	setExternalSourceName(String externalSourceName) Sets external source system name using the data engine client

Method Detail

createOrUpdateProcesses

List<String> createOrUpdateProcesses(String userId,
                                     List<Process> processes)
                              throws InvalidParameterException,
                                     PropertyServerException,
                                     UserNotAuthorizedException,
                                     ConnectorCheckedException

Create or update the processes, with all the ports, schema types and corresponding relationships including process hierarchy relationships.

Parameters:

userId - the name of the calling user

processes - list of processes

Returns:

unique identifier of the process in the repository

Throws:

InvalidParameterException - the bean properties are invalid

UserNotAuthorizedException - user not authorized to issue this request

PropertyServerException - problem accessing the property server

ConnectorCheckedException - problem with the underlying connector (if used)

deleteProcesses

void deleteProcesses(String userId,
                     List<String> qualifiedNames,
                     List<String> guids)
              throws InvalidParameterException,
                     PropertyServerException,
                     UserNotAuthorizedException,
                     ConnectorCheckedException

Delete a list of processes

Parameters:

userId - the name of the calling user

qualifiedNames - the qualified names of the processes to be deleted

guids - the unique identifiers of the processes to be deleted

Throws:

InvalidParameterException - the bean properties are invalid

UserNotAuthorizedException - user not authorized to issue this request

PropertyServerException - problem accessing the property server

ConnectorCheckedException - problem with the underlying connector (if used)

createExternalDataEngine

String createExternalDataEngine(String userId,
                                SoftwareServerCapability softwareServerCapability)
                         throws InvalidParameterException,
                                UserNotAuthorizedException,
                                PropertyServerException,
                                ConnectorCheckedException

Create or update the software server capability entity

Parameters:

userId - the name of the calling user

softwareServerCapability - the software server capability bean

Returns:

unique identifier of the server in the repository

Throws:

InvalidParameterException - the bean properties are invalid

UserNotAuthorizedException - user not authorized to issue this request

PropertyServerException - problem accessing the property server

ConnectorCheckedException - problem with the underlying connector (if used)

deleteExternalDataEngine

void deleteExternalDataEngine(String userId,
                              String qualifiedName,
                              String guid)
                       throws InvalidParameterException,
                              UserNotAuthorizedException,
                              PropertyServerException,
                              ConnectorCheckedException

Delete the external data engine

Parameters:

userId - the name of the calling user

qualifiedName - the qualified name of the external data engine

guid - the unique identifier of the external data engine

Throws:

InvalidParameterException - the bean properties are invalid

UserNotAuthorizedException - user not authorized to issue this request

PropertyServerException - problem accessing the property server

ConnectorCheckedException - problem with the underlying connector (if used)

createOrUpdateSchemaType

String createOrUpdateSchemaType(String userId,
                                SchemaType schemaType)
                         throws InvalidParameterException,
                                PropertyServerException,
                                UserNotAuthorizedException,
                                ConnectorCheckedException

Create or update the schema type entity, with the corresponding schema attributes and relationships

Parameters:

userId - the name of the calling user

schemaType - the schema type bean

Returns:

unique identifier of the schema type in the repository

Throws:

InvalidParameterException - the bean properties are invalid

UserNotAuthorizedException - user not authorized to issue this request

PropertyServerException - problem accessing the property server

ConnectorCheckedException - problem with the underlying connector (if used)

deleteSchemaType

void deleteSchemaType(String userId,
                      String qualifiedName,
                      String guid)
               throws InvalidParameterException,
                      PropertyServerException,
                      UserNotAuthorizedException,
                      ConnectorCheckedException

Delete the schema type

Parameters:

userId - the name of the calling user

qualifiedName - the qualified name of schema type

guid - the unique identifier of the external data engine

Throws:

InvalidParameterException - the bean properties are invalid

UserNotAuthorizedException - user not authorized to issue this request

PropertyServerException - problem accessing the property server

ConnectorCheckedException - problem with the underlying connector (if used)

createOrUpdatePortImplementation

String createOrUpdatePortImplementation(String userId,
                                        PortImplementation portImplementation,
                                        String processQualifiedName)
                                 throws InvalidParameterException,
                                        UserNotAuthorizedException,
                                        PropertyServerException,
                                        ConnectorCheckedException

Create or update the port implementation entity,with the corresponding schema type and port schema relationship. It attaches the port implementation to the provided process

Parameters:

userId - the name of the calling user

portImplementation - the port implementation bean

processQualifiedName - the process qualified name

Returns:

unique identifier of the port implementation in the repository

Throws:

InvalidParameterException - the bean properties are invalid

UserNotAuthorizedException - user not authorized to issue this request

PropertyServerException - problem accessing the property server

ConnectorCheckedException - internal problem with the connector

deletePortImplementation

void deletePortImplementation(String userId,
                              String qualifiedName,
                              String guid)
                       throws InvalidParameterException,
                              PropertyServerException,
                              UserNotAuthorizedException,
                              ConnectorCheckedException

Delete the port implementation

Parameters:

userId - the name of the calling user

qualifiedName - the qualified name of port

guid - the unique identifier of the external data engine

Throws:

InvalidParameterException - the bean properties are invalid

UserNotAuthorizedException - user not authorized to issue this request

PropertyServerException - problem accessing the property server

ConnectorCheckedException - problem with the underlying connector (if used)

createOrUpdatePortAlias

String createOrUpdatePortAlias(String userId,
                               PortAlias portAlias,
                               String processQualifiedName)
                        throws InvalidParameterException,
                               UserNotAuthorizedException,
                               PropertyServerException,
                               ConnectorCheckedException

Create or update the port alias entity with a PortDelegation relationship. It attaches the port alias to the provided process

Parameters:

userId - the name of the calling user

portAlias - the port alias bean

processQualifiedName - the process qualified name

Returns:

unique identifier of the port alias in the repository

Throws:

InvalidParameterException - the bean properties are invalid

UserNotAuthorizedException - user not authorized to issue this request

PropertyServerException - problem accessing the property server

ConnectorCheckedException - internal problem with the connector

deletePortAlias

void deletePortAlias(String userId,
                     String qualifiedName,
                     String guid)
              throws InvalidParameterException,
                     PropertyServerException,
                     UserNotAuthorizedException,
                     ConnectorCheckedException

Delete the port alias

Parameters:

userId - the name of the calling user

qualifiedName - the qualified name of port

guid - the unique identifier of the external data engine

Throws:

InvalidParameterException - the bean properties are invalid

UserNotAuthorizedException - user not authorized to issue this request

PropertyServerException - problem accessing the property server

ConnectorCheckedException - problem with the underlying connector (if used)

addProcessHierarchy

String addProcessHierarchy(String userId,
                           ProcessHierarchy processHierarchy)
                    throws InvalidParameterException,
                           UserNotAuthorizedException,
                           PropertyServerException,
                           ConnectorCheckedException

Add a ProcessHierarchy relationship to a process

Parameters:

userId - the name of the calling user

processHierarchy - the process hierarchy bean

Returns:

the unique identifier (guid) of the child of the process hierarchy that was updated

Throws:

InvalidParameterException - the bean properties are invalid

UserNotAuthorizedException - user not authorized to issue this request

PropertyServerException - problem accessing the property server

ConnectorCheckedException - internal problem with the connector

addLineageMappings

void addLineageMappings(String userId,
                        List<LineageMapping> lineageMappings)
                 throws InvalidParameterException,
                        UserNotAuthorizedException,
                        PropertyServerException,
                        ConnectorCheckedException

Add lineage mapping relationships between schema types

Parameters:

userId - the name of the calling user

lineageMappings - list of lineage mappings

Throws:

InvalidParameterException - the bean properties are invalid

UserNotAuthorizedException - user not authorized to issue this request

PropertyServerException - problem accessing the property server

ConnectorCheckedException - internal problem with the connector

setExternalSourceName

void setExternalSourceName(String externalSourceName)

Sets external source system name using the data engine client

Parameters:

externalSourceName - Source system name

getExternalSourceName

String getExternalSourceName()

Returns the name of the source system using data engine client

Returns:

Source system name