Package org.odpi.openmetadata.accessservices.datamanager.server.spring

Class DataManagerValidValuesResource

java.lang.Object
org.odpi.openmetadata.accessservices.datamanager.server.spring.DataManagerValidValuesResource
@RestController @RequestMapping("/servers/{serverName}/open-metadata/access-services/data-manager/users/{userId}") public class DataManagerValidValuesResource extends Object
The DataManagerValidValuesResource provides a Spring based server-side REST API that supports the ValidValueManagementInterface. It delegates each request to the ValidValueRESTServices. This provides the server-side implementation of the Community Profile Open Metadata Assess Service (OMAS) which is used to manage information about people, roles and organizations.

  • Constructor Summary

    Constructors
    Constructor
    Description
    DataManagerValidValuesResource()
    Default constructor

  • Method Summary

    Modifier and Type
    Method
    Description
    org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse
    clearReferenceValueTag(String serverName, String userId, String elementGUID, String validValueGUID, org.odpi.openmetadata.accessservices.datamanager.rest.ExternalSourceRequestBody requestBody)
    Remove a reference value assignment relationship between an element and a valid value.
    org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse
    clearValidValueMember(String serverName, String userId, String validValueSetGUID, String validValueMemberGUID, org.odpi.openmetadata.accessservices.datamanager.rest.ExternalSourceRequestBody requestBody)
    Remove a membership relationship between a validValue and a validValueSet that it belongs to.
    org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse
    clearValidValues(String serverName, String userId, String elementGUID, String validValueGUID, org.odpi.openmetadata.accessservices.datamanager.rest.ExternalSourceRequestBody requestBody)
    Remove a valid value assignment relationship between an element and a valid value.
    org.odpi.openmetadata.commonservices.ffdc.rest.GUIDResponse
    createValidValue(String serverName, String userId, org.odpi.openmetadata.accessservices.datamanager.rest.ReferenceableRequestBody requestBody)
    Create a new metadata element to represent a validValues.
    org.odpi.openmetadata.accessservices.datamanager.rest.ValidValueListResponse
    findValidValues(String serverName, String userId, int startFrom, int pageSize, org.odpi.openmetadata.commonservices.ffdc.rest.SearchStringRequestBody requestBody)
    Retrieve the list of validValue metadata elements that contain the search string.
    org.odpi.openmetadata.accessservices.datamanager.rest.ValidValueListResponse
    getAllValidValues(String serverName, String userId, int startFrom, int pageSize)
    Retrieve the list of validValue metadata elements with a matching qualified or display name.
    org.odpi.openmetadata.accessservices.datamanager.rest.RelatedElementListResponse
    getAssigneesOfReferenceValue(String serverName, String userId, String validValueGUID, int startFrom, int pageSize)
    Return information about the consumers linked to a valid value.
    org.odpi.openmetadata.accessservices.datamanager.rest.RelatedElementListResponse
    getConsumersOfValidValue(String serverName, String userId, String validValueGUID, int startFrom, int pageSize)
    Return information about the consumers linked to a valid value.
    org.odpi.openmetadata.accessservices.datamanager.rest.ValidValueListResponse
    getReferenceValues(String serverName, String userId, String elementGUID, int startFrom, int pageSize)
    Return information about the valid values linked as reference value tags to an element.
    org.odpi.openmetadata.accessservices.datamanager.rest.ValidValueListResponse
    getSetsForValidValue(String serverName, String userId, String validValueGUID, int startFrom, int pageSize)
    Page through the list of valid value sets that a valid value definition/set belongs to.
    org.odpi.openmetadata.accessservices.datamanager.rest.ValidValueResponse
    getValidValueByGUID(String serverName, String userId, String guid)
    Retrieve the validValue metadata element with the supplied unique identifier.
    org.odpi.openmetadata.accessservices.datamanager.rest.ValidValueListResponse
    getValidValuesByName(String serverName, String userId, int startFrom, int pageSize, org.odpi.openmetadata.commonservices.ffdc.rest.NameRequestBody requestBody)
    Retrieve the list of validValue metadata elements with a matching qualified or display name.
    org.odpi.openmetadata.accessservices.datamanager.rest.ValidValueListResponse
    getValidValueSetMembers(String serverName, String userId, String validValueSetGUID, int startFrom, int pageSize)
    Page through the members of a valid value set.
    org.odpi.openmetadata.accessservices.datamanager.rest.ValidValueResponse
    getValidValuesForConsumer(String serverName, String userId, String elementGUID)
    Return information about the valid value set linked to an element as its set of valid values.
    org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse
    removeValidValue(String serverName, String userId, String validValueGUID, org.odpi.openmetadata.accessservices.datamanager.rest.ExternalSourceRequestBody requestBody)
    Remove the metadata element representing a validValue.
    org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse
    setupReferenceValueTag(String serverName, String userId, String elementGUID, String validValueGUID, org.odpi.openmetadata.accessservices.datamanager.rest.RelationshipRequestBody requestBody)
    Create a reference value assignment relationship between an element and a valid value to show that the valid value is a semiformal tag/classification.
    org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse
    setupValidValueMember(String serverName, String userId, String validValueSetGUID, String validValueMemberGUID, org.odpi.openmetadata.accessservices.datamanager.rest.RelationshipRequestBody requestBody)
    Create a membership relationship between a validValue and a validValueSet that it belongs to.
    org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse
    setupValidValues(String serverName, String userId, String elementGUID, String validValueGUID, org.odpi.openmetadata.accessservices.datamanager.rest.RelationshipRequestBody requestBody)
    Create a valid value assignment relationship between an element and a valid value (typically, a valid value set) to show that the valid value defines the values that can be stored in the data item that the element represents.
    org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse
    updateValidValue(String serverName, String userId, String validValueGUID, boolean isMergeUpdate, org.odpi.openmetadata.accessservices.datamanager.rest.ReferenceableRequestBody requestBody)
    Update the metadata element representing a validValues.

    Methods inherited from class java.lang.Object

    equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

  • Constructor Details

    • DataManagerValidValuesResource

      public DataManagerValidValuesResource()
      Default constructor

  • Method Details

    • createValidValue

      @PostMapping(path="/valid-values") public org.odpi.openmetadata.commonservices.ffdc.rest.GUIDResponse createValidValue(@PathVariable String serverName, @PathVariable String userId, @RequestBody org.odpi.openmetadata.accessservices.datamanager.rest.ReferenceableRequestBody requestBody)
      Create a new metadata element to represent a validValues.
      Parameters:
      serverName - name of the service to route the request to.
      userId - calling user
      requestBody - properties to store
      Returns:
      unique identifier of the new metadata element or InvalidParameterException one of the parameters is invalid or UserNotAuthorizedException the user is not authorized to issue this request or PropertyServerException there is a problem reported in the open metadata server(s)

    • updateValidValue

      @PostMapping(path="/valid-values/{validValueGUID}") public org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse updateValidValue(@PathVariable String serverName, @PathVariable String userId, @PathVariable String validValueGUID, @RequestParam boolean isMergeUpdate, @RequestBody org.odpi.openmetadata.accessservices.datamanager.rest.ReferenceableRequestBody requestBody)
      Update the metadata element representing a validValues.
      Parameters:
      serverName - name of the service to route the request to.
      userId - calling user
      validValueGUID - unique identifier of the metadata element to update
      isMergeUpdate - should the new properties be merged with the existing properties of overlay them?
      requestBody - new properties for this element
      Returns:
      void or InvalidParameterException one of the parameters is invalid or UserNotAuthorizedException the user is not authorized to issue this request or PropertyServerException there is a problem reported in the open metadata server(s)

    • setupValidValueMember

      @PostMapping(path="/valid-values/{validValueSetGUID}/valid-value-members/{validValueMemberGUID}") public org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse setupValidValueMember(@PathVariable String serverName, @PathVariable String userId, @PathVariable String validValueSetGUID, @PathVariable String validValueMemberGUID, @RequestBody org.odpi.openmetadata.accessservices.datamanager.rest.RelationshipRequestBody requestBody)
      Create a membership relationship between a validValue and a validValueSet that it belongs to.
      Parameters:
      serverName - name of the service to route the request to.
      userId - calling user
      validValueSetGUID - unique identifier of the valid value set
      validValueMemberGUID - unique identifier of the member
      requestBody - relationship properties
      Returns:
      void or InvalidParameterException one of the parameters is invalid or UserNotAuthorizedException the user is not authorized to issue this request or PropertyServerException there is a problem reported in the open metadata server(s)

    • clearValidValueMember

      @PostMapping(path="/valid-values/{validValueSetGUID}/valid-value-members/{validValueMemberGUID}/delete") public org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse clearValidValueMember(@PathVariable String serverName, @PathVariable String userId, @PathVariable String validValueSetGUID, @PathVariable String validValueMemberGUID, @RequestBody org.odpi.openmetadata.accessservices.datamanager.rest.ExternalSourceRequestBody requestBody)
      Remove a membership relationship between a validValue and a validValueSet that it belongs to.
      Parameters:
      serverName - name of the service to route the request to.
      userId - calling user
      validValueSetGUID - unique identifier of the valid value set
      validValueMemberGUID - unique identifier of the member
      requestBody - external source identifiers
      Returns:
      void or InvalidParameterException one of the parameters is invalid or UserNotAuthorizedException the user is not authorized to issue this request or PropertyServerException there is a problem reported in the open metadata server(s)

    • setupValidValues

      @PostMapping(path="/valid-values/{elementGUID}/valid-values/{validValueGUID}") public org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse setupValidValues(@PathVariable String serverName, @PathVariable String userId, @PathVariable String elementGUID, @PathVariable String validValueGUID, @RequestBody org.odpi.openmetadata.accessservices.datamanager.rest.RelationshipRequestBody requestBody)
      Create a valid value assignment relationship between an element and a valid value (typically, a valid value set) to show that the valid value defines the values that can be stored in the data item that the element represents.
      Parameters:
      serverName - name of the service to route the request to.
      userId - calling user
      elementGUID - unique identifier of the element
      validValueGUID - unique identifier of the valid value
      requestBody - relationship properties
      Returns:
      void or InvalidParameterException one of the parameters is invalid or UserNotAuthorizedException the user is not authorized to issue this request or PropertyServerException there is a problem reported in the open metadata server(s)

    • clearValidValues

      @PostMapping(path="/valid-values/{elementGUID}/valid-values/{validValueGUID}/delete") public org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse clearValidValues(@PathVariable String serverName, @PathVariable String userId, @PathVariable String elementGUID, @PathVariable String validValueGUID, @RequestBody org.odpi.openmetadata.accessservices.datamanager.rest.ExternalSourceRequestBody requestBody)
      Remove a valid value assignment relationship between an element and a valid value.
      Parameters:
      serverName - name of the service to route the request to.
      userId - calling user
      elementGUID - unique identifier of the element
      validValueGUID - unique identifier of the valid value
      requestBody - external source identifiers
      Returns:
      void or InvalidParameterException one of the parameters is invalid or UserNotAuthorizedException the user is not authorized to issue this request or PropertyServerException there is a problem reported in the open metadata server(s)

    • setupReferenceValueTag

      @PostMapping(path="/valid-values/{elementGUID}/reference-value-tags/{validValueGUID}") public org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse setupReferenceValueTag(@PathVariable String serverName, @PathVariable String userId, @PathVariable String elementGUID, @PathVariable String validValueGUID, @RequestBody org.odpi.openmetadata.accessservices.datamanager.rest.RelationshipRequestBody requestBody)
      Create a reference value assignment relationship between an element and a valid value to show that the valid value is a semiformal tag/classification.
      Parameters:
      serverName - name of the service to route the request to.
      userId - calling user
      elementGUID - unique identifier of the element
      validValueGUID - unique identifier of the valid value
      requestBody - relationship properties
      Returns:
      void or InvalidParameterException one of the parameters is invalid or UserNotAuthorizedException the user is not authorized to issue this request or PropertyServerException there is a problem reported in the open metadata server(s)

    • clearReferenceValueTag

      @PostMapping(path="/valid-values/{elementGUID}/reference-value-tags/{validValueGUID}/delete") public org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse clearReferenceValueTag(@PathVariable String serverName, @PathVariable String userId, @PathVariable String elementGUID, @PathVariable String validValueGUID, @RequestBody org.odpi.openmetadata.accessservices.datamanager.rest.ExternalSourceRequestBody requestBody)
      Remove a reference value assignment relationship between an element and a valid value.
      Parameters:
      serverName - name of the service to route the request to.
      userId - calling user
      elementGUID - unique identifier of the element
      validValueGUID - unique identifier of the valid value
      requestBody - external source identifiers
      Returns:
      void or InvalidParameterException one of the parameters is invalid or UserNotAuthorizedException the user is not authorized to issue this request or PropertyServerException there is a problem reported in the open metadata server(s)

    • removeValidValue

      @PostMapping(path="/valid-values/{validValueGUID}/delete") public org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse removeValidValue(@PathVariable String serverName, @PathVariable String userId, @PathVariable String validValueGUID, @RequestBody org.odpi.openmetadata.accessservices.datamanager.rest.ExternalSourceRequestBody requestBody)
      Remove the metadata element representing a validValue.
      Parameters:
      serverName - name of the service to route the request to.
      userId - calling user
      validValueGUID - unique identifier of the metadata element to remove
      requestBody - external source identifiers
      Returns:
      void or InvalidParameterException one of the parameters is invalid or UserNotAuthorizedException the user is not authorized to issue this request or PropertyServerException there is a problem reported in the open metadata server(s)

    • findValidValues

      @PostMapping(path="/valid-values/by-search-string") public org.odpi.openmetadata.accessservices.datamanager.rest.ValidValueListResponse findValidValues(@PathVariable String serverName, @PathVariable String userId, @RequestParam int startFrom, @RequestParam int pageSize, @RequestBody org.odpi.openmetadata.commonservices.ffdc.rest.SearchStringRequestBody requestBody)
      Retrieve the list of validValue metadata elements that contain the search string. The search string is treated as a regular expression.
      Parameters:
      serverName - name of the service to route the request to.
      userId - calling user
      requestBody - string to find in the properties
      startFrom - paging start point
      pageSize - maximum results that can be returned
      Returns:
      list of matching metadata elements or InvalidParameterException one of the parameters is invalid or UserNotAuthorizedException the user is not authorized to issue this request or PropertyServerException there is a problem reported in the open metadata server(s)

    • getValidValuesByName

      @PostMapping(path="/valid-values/by-name") public org.odpi.openmetadata.accessservices.datamanager.rest.ValidValueListResponse getValidValuesByName(@PathVariable String serverName, @PathVariable String userId, @RequestParam int startFrom, @RequestParam int pageSize, @RequestBody org.odpi.openmetadata.commonservices.ffdc.rest.NameRequestBody requestBody)
      Retrieve the list of validValue metadata elements with a matching qualified or display name. There are no wildcards supported on this request.
      Parameters:
      serverName - name of the service to route the request to.
      userId - calling user
      requestBody - name to search for
      startFrom - paging start point
      pageSize - maximum results that can be returned
      Returns:
      list of matching metadata elements or InvalidParameterException one of the parameters is invalid or UserNotAuthorizedException the user is not authorized to issue this request or PropertyServerException there is a problem reported in the open metadata server(s)

    • getValidValueSetMembers

      @GetMapping(path="/valid-values/members/{validValueSetGUID}") public org.odpi.openmetadata.accessservices.datamanager.rest.ValidValueListResponse getValidValueSetMembers(@PathVariable String serverName, @PathVariable String userId, @PathVariable String validValueSetGUID, @RequestParam int startFrom, @RequestParam int pageSize)
      Page through the members of a valid value set.
      Parameters:
      serverName - called server
      userId - calling user
      validValueSetGUID - unique identifier of the valid value set
      startFrom - index of the list to start from (0 for start)
      pageSize - maximum number of elements to return.
      Returns:
      list of valid value beans

      InvalidParameterException name or userId is null PropertyServerException problem accessing property server UserNotAuthorizedException security access problem

    • getSetsForValidValue

      @GetMapping(path="/valid-values/sets/{validValueGUID}") public org.odpi.openmetadata.accessservices.datamanager.rest.ValidValueListResponse getSetsForValidValue(@PathVariable String serverName, @PathVariable String userId, @PathVariable String validValueGUID, @RequestParam int startFrom, @RequestParam int pageSize)
      Page through the list of valid value sets that a valid value definition/set belongs to.
      Parameters:
      serverName - called server
      userId - calling user
      validValueGUID - unique identifier of the valid value
      startFrom - index of the list to start from (0 for start)
      pageSize - maximum number of elements to return.
      Returns:
      list of valid value beans

      InvalidParameterException name or userId is null PropertyServerException problem accessing property server UserNotAuthorizedException security access problem

    • getValidValuesForConsumer

      @GetMapping(path="/valid-values/by-consumer/{elementGUID}") public org.odpi.openmetadata.accessservices.datamanager.rest.ValidValueResponse getValidValuesForConsumer(@PathVariable String serverName, @PathVariable String userId, @PathVariable String elementGUID)
      Return information about the valid value set linked to an element as its set of valid values.
      Parameters:
      serverName - name of the service to route the request to.
      userId - calling user
      elementGUID - unique identifier for the element using the valid value set
      Returns:
      matching metadata element or InvalidParameterException one of the parameters is invalid or UserNotAuthorizedException the user is not authorized to issue this request or PropertyServerException there is a problem reported in the open metadata server(s)

    • getConsumersOfValidValue

      @GetMapping(path="/valid-values/{validValueGUID}/consumers") public org.odpi.openmetadata.accessservices.datamanager.rest.RelatedElementListResponse getConsumersOfValidValue(@PathVariable String serverName, @PathVariable String userId, @PathVariable String validValueGUID, @RequestParam int startFrom, @RequestParam int pageSize)
      Return information about the consumers linked to a valid value.
      Parameters:
      serverName - called server
      userId - calling user
      validValueGUID - unique identifier for the validValue
      startFrom - index of the list to start from (0 for start)
      pageSize - maximum number of elements to return.
      Returns:
      list of matching person roles

      InvalidParameterException name or userId is null PropertyServerException problem accessing property server UserNotAuthorizedException security access problem

    • getReferenceValues

      @GetMapping(path="/valid-values/by-reference-value-tags/{elementGUID}") public org.odpi.openmetadata.accessservices.datamanager.rest.ValidValueListResponse getReferenceValues(@PathVariable String serverName, @PathVariable String userId, @PathVariable String elementGUID, @RequestParam int startFrom, @RequestParam int pageSize)
      Return information about the valid values linked as reference value tags to an element.
      Parameters:
      serverName - name of the service to route the request to.
      userId - calling user
      elementGUID - unique identifier for the element using the valid value set
      startFrom - index of the list to start from (0 for start)
      pageSize - maximum number of elements to return.
      Returns:
      matching metadata elements or InvalidParameterException one of the parameters is invalid or UserNotAuthorizedException the user is not authorized to issue this request or PropertyServerException there is a problem reported in the open metadata server(s)

    • getAssigneesOfReferenceValue

      @GetMapping(path="/valid-values/{validValueGUID}/by-reference-value-tag-assignees") public org.odpi.openmetadata.accessservices.datamanager.rest.RelatedElementListResponse getAssigneesOfReferenceValue(@PathVariable String serverName, @PathVariable String userId, @PathVariable String validValueGUID, @RequestParam int startFrom, @RequestParam int pageSize)
      Return information about the consumers linked to a valid value.
      Parameters:
      serverName - called server
      userId - calling user
      validValueGUID - unique identifier for the validValue
      startFrom - index of the list to start from (0 for start)
      pageSize - maximum number of elements to return.
      Returns:
      list of matching person roles

      InvalidParameterException name or userId is null PropertyServerException problem accessing property server UserNotAuthorizedException security access problem

    • getAllValidValues

      @GetMapping(path="/valid-values") public org.odpi.openmetadata.accessservices.datamanager.rest.ValidValueListResponse getAllValidValues(@PathVariable String serverName, @PathVariable String userId, @RequestParam int startFrom, @RequestParam int pageSize)
      Retrieve the list of validValue metadata elements with a matching qualified or display name. There are no wildcards supported on this request.
      Parameters:
      serverName - name of the service to route the request to.
      userId - calling user
      startFrom - paging start point
      pageSize - maximum results that can be returned
      Returns:
      list of matching metadata elements or InvalidParameterException one of the parameters is invalid or UserNotAuthorizedException the user is not authorized to issue this request or PropertyServerException there is a problem reported in the open metadata server(s)

    • getValidValueByGUID

      @GetMapping(path="/valid-values/{guid}") public org.odpi.openmetadata.accessservices.datamanager.rest.ValidValueResponse getValidValueByGUID(@PathVariable String serverName, @PathVariable String userId, @PathVariable String guid)
      Retrieve the validValue metadata element with the supplied unique identifier.
      Parameters:
      serverName - name of the service to route the request to.
      userId - calling user
      guid - unique identifier of the requested metadata element
      Returns:
      matching metadata element or InvalidParameterException one of the parameters is invalid or UserNotAuthorizedException the user is not authorized to issue this request or PropertyServerException there is a problem reported in the open metadata server(s)