Class DataDesignerResource
java.lang.Object
org.odpi.openmetadata.viewservices.datadesigner.server.spring.DataDesignerResource
@RestController
@RequestMapping("/servers/{serverName}/api/open-metadata/data-designer")
public class DataDesignerResource
extends Object
The DataDesignerResource provides part of the server-side implementation of the Data Designer OMVS.
=
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionassignDataValueSpecification(String serverName, String elementGUID, String dataValueSpecificationGUID, NewRelationshipRequestBody requestBody) Connect an element to a data value specification that describes the data associated with this element.createDataField(String serverName, NewElementRequestBody requestBody) Create a data field.createDataFieldFromTemplate(String serverName, TemplateRequestBody requestBody) Create a new metadata element to represent a data field using an existing metadata element as a template.createDataStructure(String serverName, NewElementRequestBody requestBody) Create a data structure.createDataStructureFromTemplate(String serverName, TemplateRequestBody requestBody) Create a new metadata element to represent a data structure using an existing metadata element as a template.createDataValueSpecification(String serverName, NewElementRequestBody requestBody) Create a data value specification.createDataValueSpecificationFromTemplate(String serverName, TemplateRequestBody requestBody) Create a new metadata element to represent a data value specification using an existing metadata element as a template.deleteDataField(String serverName, String dataFieldGUID, DeleteElementRequestBody requestBody) Delete a data field.deleteDataStructure(String serverName, String dataStructureGUID, DeleteElementRequestBody requestBody) Delete a data structure.deleteDataValueSpecification(String serverName, String dataValueSpecificationGUID, DeleteElementRequestBody requestBody) Delete a data value specification.detachCertificationTypeToDataStructure(String serverName, String certificationTypeGUID, String dataStructureGUID, DeleteRelationshipRequestBody requestBody) Detach a data structure from a certification type.detachDataValueSpecificationAssignment(String serverName, String elementGUID, String dataValueSpecificationGUID, DeleteRelationshipRequestBody requestBody) Detach an element from one of its assigned data value specifications.detachDataValueSpecificationDefinition(String serverName, String dataDefinitionGUID, String dataValueSpecificationGUID, DeleteRelationshipRequestBody requestBody) Detach a data definition from a data value specification.detachMemberDataField(String serverName, String parentDataStructureGUID, String memberDataFieldGUID, DeleteRelationshipRequestBody requestBody) Detach a data field from a data structure.detachNestedDataClass(String serverName, String parentDataClassGUID, String childDataClassGUID, DeleteRelationshipRequestBody requestBody) Detach two nested data classes from one another.detachNestedDataFields(String serverName, String parentDataFieldGUID, String nestedDataFieldGUID, DeleteRelationshipRequestBody requestBody) Detach two data fields from one another.detachSemanticDefinition(String serverName, String dataDefinitionGUID, String glossaryTermGUID, DeleteRelationshipRequestBody requestBody) Detach a data definition from a glossary term.detachSpecializedDataValueSpecification(String serverName, String dataValueSpecificationGUID, String specializedDataValueSpecificationGUID, DeleteRelationshipRequestBody requestBody) Detach two data value specifications from one another.findDataFields(String serverName, SearchStringRequestBody requestBody) Retrieve the list of data field metadata elements that contain the search string.findDataStructures(String serverName, SearchStringRequestBody requestBody) Retrieve the list of data structure metadata elements that contain the search string.findDataValueSpecifications(String serverName, SearchStringRequestBody requestBody) Retrieve the list of data value specification metadata elements that contain the search string.getDataFieldByGUID(String serverName, String dataFieldGUID, GetRequestBody requestBody) Return the properties of a specific data field.getDataFieldsByName(String serverName, FilterRequestBody requestBody) Returns the list of data fields with a particular name.getDataStructureByGUID(String serverName, String dataStructureGUID, GetRequestBody requestBody) Return the properties of a specific data structure.getDataStructuresByName(String serverName, FilterRequestBody requestBody) Returns the list of data structures with a particular name.getDataValueSpecificationByGUID(String serverName, String dataValueSpecificationGUID, GetRequestBody requestBody) Return the properties of a specific data value specification.getDataValueSpecificationsByName(String serverName, FilterRequestBody requestBody) Returns the list of data value specifications with a particular name.linkCertificationTypeToDataStructure(String serverName, String certificationTypeGUID, String dataStructureGUID, NewRelationshipRequestBody requestBody) Connect a certification type to a data structure to guide the survey action service (that checks the data quality of a data resource as part of certifying it with the supplied certification type) to the definition of the data structure to use as a specification of how the data should be both structured and (if data value specifications are attached to the associated data fields using the DataValueSpecificationDefinition relationship) contain the valid values.linkDataValueSpecificationDefinition(String serverName, String dataDefinitionGUID, String dataValueSpecificationGUID, NewRelationshipRequestBody requestBody) Connect an element that is part of a data design to a data value specification to show that the data value specification should be used as the specification for the data values when interpreting the data definition.linkMemberDataField(String serverName, String dataStructureGUID, String dataFieldGUID, NewRelationshipRequestBody requestBody) Attach a data field to a data structure.linkNestedDataClass(String serverName, String parentDataClassGUID, String childDataClassGUID, NewRelationshipRequestBody requestBody) Connect two data classes to show that one is used by the other when it is validating (typically a complex data item).linkNestedDataFields(String serverName, String parentDataFieldGUID, String nestedDataFieldGUID, NewRelationshipRequestBody requestBody) Connect two data field as parent and child.linkSemanticDefinition(String serverName, String dataDefinitionGUID, String glossaryTermGUID, NewRelationshipRequestBody requestBody) Connect an element that is part of a data design to a glossary term to show that the term should be used as the semantic definition for the data values when interpreting the data definition.linkSpecializedDataValueSpecification(String serverName, String dataValueSpecificationGUID, String specializedDataValueSpecificationGUID, NewRelationshipRequestBody requestBody) Connect two data value specifications to show that one provides a more specialist evaluation.updateDataField(String serverName, String dataFieldGUID, UpdateElementRequestBody requestBody) Update the properties of a data field.updateDataStructure(String serverName, String dataStructureGUID, UpdateElementRequestBody requestBody) Update the properties of a data structure.updateDataValueSpecification(String serverName, String dataValueSpecificationGUID, UpdateElementRequestBody requestBody) Update the properties of a data value specification.
-
Constructor Details
-
DataDesignerResource
public DataDesignerResource()Default constructor
-
-
Method Details
-
createDataStructure
@PostMapping(path="/data-structures") public GUIDResponse createDataStructure(@PathVariable String serverName, @RequestBody(required=false) NewElementRequestBody requestBody) Create a data structure.- Parameters:
serverName- name of called server.requestBody- properties for the data structure.- Returns:
- unique identifier of the newly created element InvalidParameterException one of the parameters is invalid. PropertyServerException a problem retrieving information from the property server(s). UserNotAuthorizedException the requesting user is not authorized to issue this request.
-
createDataStructureFromTemplate
@PostMapping(path="/data-structures/from-template") public GUIDResponse createDataStructureFromTemplate(@PathVariable String serverName, @RequestBody(required=false) TemplateRequestBody requestBody) Create a new metadata element to represent a data structure using an existing metadata element as a template. The template defines additional classifications and relationships that should be added to the new element.- Parameters:
serverName- calling userrequestBody- properties that override the template- Returns:
- unique identifier of the new metadata element InvalidParameterException one of the parameters is invalid UserNotAuthorizedException the user is not authorized to issue this request PropertyServerException a problem reported in the open metadata server(s)
-
updateDataStructure
@PostMapping(path="/data-structures/{dataStructureGUID}/update") public BooleanResponse updateDataStructure(@PathVariable String serverName, @PathVariable String dataStructureGUID, @RequestBody(required=false) UpdateElementRequestBody requestBody) Update the properties of a data structure.- Parameters:
serverName- name of called server.dataStructureGUID- unique identifier of the data structure (returned from create)requestBody- properties for the new element.- Returns:
- boolean or InvalidParameterException one of the parameters is invalid. PropertyServerException a problem retrieving information from the property server(s). UserNotAuthorizedException the requesting user is not authorized to issue this request.
-
linkMemberDataField
@PostMapping(path="/data-structures/{dataStructureGUID}/member-data-fields/{dataFieldGUID}/attach") public VoidResponse linkMemberDataField(@PathVariable String serverName, @PathVariable String dataStructureGUID, @PathVariable String dataFieldGUID, @RequestBody(required=false) NewRelationshipRequestBody requestBody) Attach a data field to a data structure.- Parameters:
serverName- name of called serverdataStructureGUID- unique identifier of the first data structuredataFieldGUID- unique identifier of the second data structurerequestBody- description of the relationship.- Returns:
- void or InvalidParameterException one of the parameters is null or invalid. PropertyServerException a problem retrieving information from the property server(s). UserNotAuthorizedException the requesting user is not authorized to issue this request.
-
detachMemberDataField
@PostMapping(path="/data-structures/{parentDataStructureGUID}/member-data-fields/{memberDataFieldGUID}/detach") public VoidResponse detachMemberDataField(@PathVariable String serverName, @PathVariable String parentDataStructureGUID, @PathVariable String memberDataFieldGUID, @RequestBody(required=false) DeleteRelationshipRequestBody requestBody) Detach a data field from a data structure.- Parameters:
serverName- name of called serverparentDataStructureGUID- unique identifier of the first data structurememberDataFieldGUID- unique identifier of the second data structurerequestBody- description of the relationship.- Returns:
- void or InvalidParameterException one of the parameters is null or invalid. PropertyServerException a problem retrieving information from the property server(s). UserNotAuthorizedException the requesting user is not authorized to issue this request.
-
deleteDataStructure
@PostMapping(path="/data-structures/{dataStructureGUID}/delete") public VoidResponse deleteDataStructure(@PathVariable String serverName, @PathVariable String dataStructureGUID, @RequestBody(required=false) DeleteElementRequestBody requestBody) Delete a data structure.- Parameters:
serverName- name of called serverdataStructureGUID- unique identifier of the element to deleterequestBody- description of the relationship.- Returns:
- void or InvalidParameterException one of the parameters is null or invalid. PropertyServerException a problem retrieving information from the property server(s). UserNotAuthorizedException the requesting user is not authorized to issue this request.
-
getDataStructuresByName
@PostMapping(path="/data-structures/by-name") public OpenMetadataRootElementsResponse getDataStructuresByName(@PathVariable String serverName, @RequestBody(required=false) FilterRequestBody requestBody) Returns the list of data structures with a particular name.- Parameters:
serverName- name of the service to route the request torequestBody- string to find in the properties- Returns:
- list of matching metadata elements or InvalidParameterException one of the parameters is invalid UserNotAuthorizedException the user is not authorized to issue this request PropertyServerException a problem reported in the open metadata server(s)
-
findDataStructures
@PostMapping(path="/data-structures/by-search-string") public OpenMetadataRootElementsResponse findDataStructures(@PathVariable String serverName, @RequestBody(required=false) SearchStringRequestBody requestBody) Retrieve the list of data structure metadata elements that contain the search string.- Parameters:
serverName- name of the service to route the request torequestBody- string to find in the properties- Returns:
- list of matching metadata elements or InvalidParameterException one of the parameters is invalid UserNotAuthorizedException the user is not authorized to issue this request PropertyServerException a problem reported in the open metadata server(s)
-
getDataStructureByGUID
@PostMapping(path="/data-structures/{dataStructureGUID}/retrieve") public OpenMetadataRootElementResponse getDataStructureByGUID(@PathVariable String serverName, @PathVariable String dataStructureGUID, @RequestBody(required=false) GetRequestBody requestBody) Return the properties of a specific data structure.- Parameters:
serverName- name of the service to route the request todataStructureGUID- unique identifier of the required elementrequestBody- string to find in the properties- Returns:
- list of matching metadata elements or InvalidParameterException one of the parameters is invalid UserNotAuthorizedException the user is not authorized to issue this request PropertyServerException a problem reported in the open metadata server(s)
-
createDataField
@PostMapping(path="/data-fields") public GUIDResponse createDataField(@PathVariable String serverName, @RequestBody(required=false) NewElementRequestBody requestBody) Create a data field.- Parameters:
serverName- name of called server.requestBody- properties for the data field.- Returns:
- unique identifier of the newly created element InvalidParameterException one of the parameters is invalid. PropertyServerException a problem retrieving information from the property server(s). UserNotAuthorizedException the requesting user is not authorized to issue this request.
-
createDataFieldFromTemplate
@PostMapping(path="/data-fields/from-template") public GUIDResponse createDataFieldFromTemplate(@PathVariable String serverName, @RequestBody(required=false) TemplateRequestBody requestBody) Create a new metadata element to represent a data field using an existing metadata element as a template. The template defines additional classifications and relationships that should be added to the new element.- Parameters:
serverName- calling userrequestBody- properties that override the template- Returns:
- unique identifier of the new metadata element InvalidParameterException one of the parameters is invalid UserNotAuthorizedException the user is not authorized to issue this request PropertyServerException a problem reported in the open metadata server(s)
-
updateDataField
@PostMapping(path="/data-fields/{dataFieldGUID}/update") public BooleanResponse updateDataField(@PathVariable String serverName, @PathVariable String dataFieldGUID, @RequestBody(required=false) UpdateElementRequestBody requestBody) Update the properties of a data field.- Parameters:
serverName- name of called server.dataFieldGUID- unique identifier of the data field (returned from create)requestBody- properties for the new element.- Returns:
- boolean or InvalidParameterException one of the parameters is invalid. PropertyServerException a problem retrieving information from the property server(s). UserNotAuthorizedException the requesting user is not authorized to issue this request.
-
linkNestedDataFields
@PostMapping(path="/data-fields/{parentDataFieldGUID}/nested-data-fields/{nestedDataFieldGUID}/attach") public VoidResponse linkNestedDataFields(@PathVariable String serverName, @PathVariable String parentDataFieldGUID, @PathVariable String nestedDataFieldGUID, @RequestBody(required=false) NewRelationshipRequestBody requestBody) Connect two data field as parent and child.- Parameters:
serverName- name of called serverparentDataFieldGUID- unique identifier of the parent data fieldnestedDataFieldGUID- unique identifier of the child data fieldrequestBody- description of the relationship.- Returns:
- void or InvalidParameterException one of the parameters is null or invalid. PropertyServerException a problem retrieving information from the property server(s). UserNotAuthorizedException the requesting user is not authorized to issue this request.
-
detachNestedDataFields
@PostMapping(path="/data-fields/{parentDataFieldGUID}/nested-data-fields/{nestedDataFieldGUID}/detach") public VoidResponse detachNestedDataFields(@PathVariable String serverName, @PathVariable String parentDataFieldGUID, @PathVariable String nestedDataFieldGUID, @RequestBody(required=false) DeleteRelationshipRequestBody requestBody) Detach two data fields from one another.- Parameters:
serverName- name of called serverparentDataFieldGUID- unique identifier of the parent data fieldnestedDataFieldGUID- unique identifier of the child data fieldrequestBody- description of the relationship.- Returns:
- void or InvalidParameterException one of the parameters is null or invalid. PropertyServerException a problem retrieving information from the property server(s). UserNotAuthorizedException the requesting user is not authorized to issue this request.
-
deleteDataField
@PostMapping(path="/data-fields/{dataFieldGUID}/delete") public VoidResponse deleteDataField(@PathVariable String serverName, @PathVariable String dataFieldGUID, @RequestBody(required=false) DeleteElementRequestBody requestBody) Delete a data field.- Parameters:
serverName- name of called serverdataFieldGUID- unique identifier of the element to deleterequestBody- description of the relationship.- Returns:
- void or InvalidParameterException one of the parameters is null or invalid. PropertyServerException a problem retrieving information from the property server(s). UserNotAuthorizedException the requesting user is not authorized to issue this request.
-
getDataFieldsByName
@PostMapping(path="/data-fields/by-name") public OpenMetadataRootElementsResponse getDataFieldsByName(@PathVariable String serverName, @RequestBody(required=false) FilterRequestBody requestBody) Returns the list of data fields with a particular name.- Parameters:
serverName- name of the service to route the request torequestBody- string to find in the properties- Returns:
- list of matching metadata elements or InvalidParameterException one of the parameters is invalid UserNotAuthorizedException the user is not authorized to issue this request PropertyServerException a problem reported in the open metadata server(s)
-
findDataFields
@PostMapping(path="/data-fields/by-search-string") public OpenMetadataRootElementsResponse findDataFields(@PathVariable String serverName, @RequestBody(required=false) SearchStringRequestBody requestBody) Retrieve the list of data field metadata elements that contain the search string.- Parameters:
serverName- name of the service to route the request torequestBody- string to find in the properties- Returns:
- list of matching metadata elements or InvalidParameterException one of the parameters is invalid UserNotAuthorizedException the user is not authorized to issue this request PropertyServerException a problem reported in the open metadata server(s)
-
getDataFieldByGUID
@PostMapping(path="/data-fields/{dataFieldGUID}/retrieve") public OpenMetadataRootElementResponse getDataFieldByGUID(@PathVariable String serverName, @PathVariable String dataFieldGUID, @RequestBody(required=false) GetRequestBody requestBody) Return the properties of a specific data field.- Parameters:
serverName- name of the service to route the request todataFieldGUID- unique identifier of the required elementrequestBody- string to find in the properties- Returns:
- list of matching metadata elements or InvalidParameterException one of the parameters is invalid UserNotAuthorizedException the user is not authorized to issue this request PropertyServerException a problem reported in the open metadata server(s)
-
createDataValueSpecification
@PostMapping(path="/data-value-specifications") public GUIDResponse createDataValueSpecification(@PathVariable String serverName, @RequestBody(required=false) NewElementRequestBody requestBody) Create a data value specification.- Parameters:
serverName- name of called server.requestBody- properties for the data value specification.- Returns:
- unique identifier of the newly created element InvalidParameterException one of the parameters is invalid. PropertyServerException a problem retrieving information from the property server(s). UserNotAuthorizedException the requesting user is not authorized to issue this request.
-
createDataValueSpecificationFromTemplate
@PostMapping(path="/data-value-specifications/from-template") public GUIDResponse createDataValueSpecificationFromTemplate(@PathVariable String serverName, @RequestBody(required=false) TemplateRequestBody requestBody) Create a new metadata element to represent a data value specification using an existing metadata element as a template. The template defines additional classifications and relationships that should be added to the new element.- Parameters:
serverName- calling userrequestBody- properties that override the template- Returns:
- unique identifier of the new metadata element InvalidParameterException one of the parameters is invalid UserNotAuthorizedException the user is not authorized to issue this request PropertyServerException a problem reported in the open metadata server(s)
-
updateDataValueSpecification
@PostMapping(path="/data-value-specifications/{dataValueSpecificationGUID}/update") public BooleanResponse updateDataValueSpecification(@PathVariable String serverName, @PathVariable String dataValueSpecificationGUID, @RequestBody(required=false) UpdateElementRequestBody requestBody) Update the properties of a data value specification.- Parameters:
serverName- name of called server.dataValueSpecificationGUID- unique identifier of the data value specification (returned from create)requestBody- properties for the new element.- Returns:
- boolean or InvalidParameterException one of the parameters is invalid. PropertyServerException a problem retrieving information from the property server(s). UserNotAuthorizedException the requesting user is not authorized to issue this request.
-
linkNestedDataClass
@PostMapping(path="/data-classes/{parentDataClassGUID}/nested-data-classes/{childDataClassGUID}/attach") public VoidResponse linkNestedDataClass(@PathVariable String serverName, @PathVariable String parentDataClassGUID, @PathVariable String childDataClassGUID, @RequestBody(required=false) NewRelationshipRequestBody requestBody) Connect two data classes to show that one is used by the other when it is validating (typically a complex data item).- Parameters:
serverName- name of called serverparentDataClassGUID- unique identifier of the parent data classchildDataClassGUID- unique identifier of the child data classrequestBody- description of the relationship.- Returns:
- void or InvalidParameterException one of the parameters is null or invalid. PropertyServerException a problem retrieving information from the property server(s). UserNotAuthorizedException the requesting user is not authorized to issue this request.
-
detachNestedDataClass
@PostMapping(path="/data-classes/{parentDataClassGUID}/nested-data-classes/{childDataClassGUID}/detach") public VoidResponse detachNestedDataClass(@PathVariable String serverName, @PathVariable String parentDataClassGUID, @PathVariable String childDataClassGUID, @RequestBody(required=false) DeleteRelationshipRequestBody requestBody) Detach two nested data classes from one another.- Parameters:
serverName- name of called serverparentDataClassGUID- unique identifier of the parent data classchildDataClassGUID- unique identifier of the child data classrequestBody- description of the relationship.- Returns:
- void or InvalidParameterException one of the parameters is null or invalid. PropertyServerException a problem retrieving information from the property server(s). UserNotAuthorizedException the requesting user is not authorized to issue this request.
-
linkSpecializedDataValueSpecification
@PostMapping(path="/data-value-specifications/{dataValueSpecificationGUID}/specialized-data-value-specifications/{specializedDataValueSpecificationGUID}/attach") public VoidResponse linkSpecializedDataValueSpecification(@PathVariable String serverName, @PathVariable String dataValueSpecificationGUID, @PathVariable String specializedDataValueSpecificationGUID, @RequestBody(required=false) NewRelationshipRequestBody requestBody) Connect two data value specifications to show that one provides a more specialist evaluation.- Parameters:
serverName- name of called serverdataValueSpecificationGUID- unique identifier of the first data value specificationspecializedDataValueSpecificationGUID- unique identifier of the second data value specificationrequestBody- description of the relationship.- Returns:
- void or InvalidParameterException one of the parameters is null or invalid. PropertyServerException a problem retrieving information from the property server(s). UserNotAuthorizedException the requesting user is not authorized to issue this request.
-
detachSpecializedDataValueSpecification
@PostMapping(path="/data-value-specifications/{dataValueSpecificationGUID}/specialized-data-value-specifications/{specializedDataValueSpecificationGUID}/detach") public VoidResponse detachSpecializedDataValueSpecification(@PathVariable String serverName, @PathVariable String dataValueSpecificationGUID, @PathVariable String specializedDataValueSpecificationGUID, @RequestBody(required=false) DeleteRelationshipRequestBody requestBody) Detach two data value specifications from one another.- Parameters:
serverName- name of called serverdataValueSpecificationGUID- unique identifier of the first data value specificationspecializedDataValueSpecificationGUID- unique identifier of the second data value specificationrequestBody- description of the relationship.- Returns:
- void or InvalidParameterException one of the parameters is null or invalid. PropertyServerException a problem retrieving information from the property server(s). UserNotAuthorizedException the requesting user is not authorized to issue this request.
-
assignDataValueSpecification
@PostMapping(path="/elements/{elementGUID}/data-value-specifications/{dataValueSpecificationGUID}/attach") public VoidResponse assignDataValueSpecification(@PathVariable String serverName, @PathVariable String elementGUID, @PathVariable String dataValueSpecificationGUID, @RequestBody(required=false) NewRelationshipRequestBody requestBody) Connect an element to a data value specification that describes the data associated with this element.- Parameters:
serverName- name of called serverelementGUID- unique identifier of the first data value specificationdataValueSpecificationGUID- unique identifier of the second data value specificationrequestBody- description of the relationship.- Returns:
- void or InvalidParameterException one of the parameters is null or invalid. PropertyServerException a problem retrieving information from the property server(s). UserNotAuthorizedException the requesting user is not authorized to issue this request.
-
detachDataValueSpecificationAssignment
@PostMapping(path="/elements/{elementGUID}/data-value-specifications/{dataValueSpecificationGUID}/detach") public VoidResponse detachDataValueSpecificationAssignment(@PathVariable String serverName, @PathVariable String elementGUID, @PathVariable String dataValueSpecificationGUID, @RequestBody(required=false) DeleteRelationshipRequestBody requestBody) Detach an element from one of its assigned data value specifications.- Parameters:
serverName- name of called serverelementGUID- unique identifier of the first data value specificationdataValueSpecificationGUID- unique identifier of the second data value specificationrequestBody- description of the relationship.- Returns:
- void or InvalidParameterException one of the parameters is null or invalid. PropertyServerException a problem retrieving information from the property server(s). UserNotAuthorizedException the requesting user is not authorized to issue this request.
-
deleteDataValueSpecification
@PostMapping(path="/data-value-specifications/{dataValueSpecificationGUID}/delete") public VoidResponse deleteDataValueSpecification(@PathVariable String serverName, @PathVariable String dataValueSpecificationGUID, @RequestBody(required=false) DeleteElementRequestBody requestBody) Delete a data value specification.- Parameters:
serverName- name of called serverdataValueSpecificationGUID- unique identifier of the element to deleterequestBody- description of the relationship.- Returns:
- void or InvalidParameterException one of the parameters is null or invalid. PropertyServerException a problem retrieving information from the property server(s). UserNotAuthorizedException the requesting user is not authorized to issue this request.
-
getDataValueSpecificationsByName
@PostMapping(path="/data-value-specifications/by-name") public OpenMetadataRootElementsResponse getDataValueSpecificationsByName(@PathVariable String serverName, @RequestBody(required=false) FilterRequestBody requestBody) Returns the list of data value specifications with a particular name.- Parameters:
serverName- name of the service to route the request torequestBody- string to find in the properties- Returns:
- list of matching metadata elements or InvalidParameterException one of the parameters is invalid UserNotAuthorizedException the user is not authorized to issue this request PropertyServerException a problem reported in the open metadata server(s)
-
findDataValueSpecifications
@PostMapping(path="/data-value-specifications/by-search-string") public OpenMetadataRootElementsResponse findDataValueSpecifications(@PathVariable String serverName, @RequestBody(required=false) SearchStringRequestBody requestBody) Retrieve the list of data value specification metadata elements that contain the search string.- Parameters:
serverName- name of the service to route the request torequestBody- string to find in the properties- Returns:
- list of matching metadata elements or InvalidParameterException one of the parameters is invalid UserNotAuthorizedException the user is not authorized to issue this request PropertyServerException a problem reported in the open metadata server(s)
-
getDataValueSpecificationByGUID
@PostMapping(path="/data-value-specifications/{dataValueSpecificationGUID}/retrieve") public OpenMetadataRootElementResponse getDataValueSpecificationByGUID(@PathVariable String serverName, @PathVariable String dataValueSpecificationGUID, @RequestBody(required=false) GetRequestBody requestBody) Return the properties of a specific data value specification.- Parameters:
serverName- name of the service to route the request todataValueSpecificationGUID- unique identifier of the required elementrequestBody- string to find in the properties- Returns:
- list of matching metadata elements or InvalidParameterException one of the parameters is invalid UserNotAuthorizedException the user is not authorized to issue this request PropertyServerException a problem reported in the open metadata server(s)
-
linkDataValueSpecificationDefinition
@PostMapping(path="/data-definitions/{dataDefinitionGUID}/data-value-specification-definition/{dataValueSpecificationGUID}/attach") public VoidResponse linkDataValueSpecificationDefinition(@PathVariable String serverName, @PathVariable String dataDefinitionGUID, @PathVariable String dataValueSpecificationGUID, @RequestBody(required=false) NewRelationshipRequestBody requestBody) Connect an element that is part of a data design to a data value specification to show that the data value specification should be used as the specification for the data values when interpreting the data definition.- Parameters:
serverName- name of called serverdataDefinitionGUID- unique identifier of the data design element (eg data field) that uses the data value specificationdataValueSpecificationGUID- unique identifier of the data value specificationrequestBody- description of the relationship.- Returns:
- void or InvalidParameterException one of the parameters is null or invalid. PropertyServerException a problem retrieving information from the property server(s). UserNotAuthorizedException the requesting user is not authorized to issue this request.
-
detachDataValueSpecificationDefinition
@PostMapping(path="/data-definitions/{dataDefinitionGUID}/data-value-specification-definition/{dataValueSpecificationGUID}/detach") public VoidResponse detachDataValueSpecificationDefinition(@PathVariable String serverName, @PathVariable String dataDefinitionGUID, @PathVariable String dataValueSpecificationGUID, @RequestBody(required=false) DeleteRelationshipRequestBody requestBody) Detach a data definition from a data value specification.- Parameters:
serverName- name of called serverdataDefinitionGUID- unique identifier of the data design element (eg data field) that uses the data value specificationdataValueSpecificationGUID- unique identifier of the data value specificationrequestBody- description of the relationship.- Returns:
- void or InvalidParameterException one of the parameters is null or invalid. PropertyServerException a problem retrieving information from the property server(s). UserNotAuthorizedException the requesting user is not authorized to issue this request.
-
linkSemanticDefinition
@PostMapping(path="/data-definitions/{dataDefinitionGUID}/semantic-definition/{glossaryTermGUID}/attach") public VoidResponse linkSemanticDefinition(@PathVariable String serverName, @PathVariable String dataDefinitionGUID, @PathVariable String glossaryTermGUID, @RequestBody(required=false) NewRelationshipRequestBody requestBody) Connect an element that is part of a data design to a glossary term to show that the term should be used as the semantic definition for the data values when interpreting the data definition.- Parameters:
serverName- name of called serverdataDefinitionGUID- unique identifier of the data design element (eg data field) that uses the data value specificationglossaryTermGUID- unique identifier of the glossary termrequestBody- description of the relationship.- Returns:
- void or InvalidParameterException one of the parameters is null or invalid. PropertyServerException a problem retrieving information from the property server(s). UserNotAuthorizedException the requesting user is not authorized to issue this request.
-
detachSemanticDefinition
@PostMapping(path="/data-definitions/{dataDefinitionGUID}/semantic-definition/{glossaryTermGUID}/detach") public VoidResponse detachSemanticDefinition(@PathVariable String serverName, @PathVariable String dataDefinitionGUID, @PathVariable String glossaryTermGUID, @RequestBody(required=false) DeleteRelationshipRequestBody requestBody) Detach a data definition from a glossary term.- Parameters:
serverName- name of called serverdataDefinitionGUID- unique identifier of the data design element (eg data field) that uses the data value specificationglossaryTermGUID- unique identifier of the glossary termrequestBody- description of the relationship.- Returns:
- void or InvalidParameterException one of the parameters is null or invalid. PropertyServerException a problem retrieving information from the property server(s). UserNotAuthorizedException the requesting user is not authorized to issue this request.
-
linkCertificationTypeToDataStructure
@PostMapping(path="/certification-types/{certificationTypeGUID}/data-structure-definition/{dataStructureGUID}/attach") public VoidResponse linkCertificationTypeToDataStructure(@PathVariable String serverName, @PathVariable String certificationTypeGUID, @PathVariable String dataStructureGUID, @RequestBody(required=false) NewRelationshipRequestBody requestBody) Connect a certification type to a data structure to guide the survey action service (that checks the data quality of a data resource as part of certifying it with the supplied certification type) to the definition of the data structure to use as a specification of how the data should be both structured and (if data value specifications are attached to the associated data fields using the DataValueSpecificationDefinition relationship) contain the valid values.- Parameters:
serverName- name of called servercertificationTypeGUID- unique identifier of the certification typedataStructureGUID- unique identifier of the data structurerequestBody- description of the relationship.- Returns:
- void or InvalidParameterException one of the parameters is null or invalid. PropertyServerException a problem retrieving information from the property server(s). UserNotAuthorizedException the requesting user is not authorized to issue this request.
-
detachCertificationTypeToDataStructure
@PostMapping(path="/certification-types/{certificationTypeGUID}/data-structure-definition/{dataStructureGUID}/detach") public VoidResponse detachCertificationTypeToDataStructure(@PathVariable String serverName, @PathVariable String certificationTypeGUID, @PathVariable String dataStructureGUID, @RequestBody(required=false) DeleteRelationshipRequestBody requestBody) Detach a data structure from a certification type.- Parameters:
serverName- name of called servercertificationTypeGUID- unique identifier of the certification typedataStructureGUID- unique identifier of the data structurerequestBody- description of the relationship.- Returns:
- void or InvalidParameterException one of the parameters is null or invalid. PropertyServerException a problem retrieving information from the property server(s). UserNotAuthorizedException the requesting user is not authorized to issue this request.
-