Package org.odpi.openmetadata.accessservices.governanceprogram.server

Class SubjectAreaRESTServices

java.lang.Object
org.odpi.openmetadata.accessservices.governanceprogram.server.SubjectAreaRESTServices
public class SubjectAreaRESTServices extends Object
SubjectAreaRESTServices provides the server side logic for the Governance SubjectArea Manager. It manages the definitions of subject areas and their linkage to the rest of the governance program.

  • Constructor Summary

    Constructors
    Constructor
    Description
    SubjectAreaRESTServices()
    Default constructor

  • Method Summary

    Modifier and Type
    Method
    Description
    org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse
    addSubjectAreaMemberClassification(String serverName, String userId, String elementGUID, org.odpi.openmetadata.accessservices.governanceprogram.rest.ClassificationRequestBody requestBody)
    Add a subject area classification to a referenceable element.
    org.odpi.openmetadata.commonservices.ffdc.rest.GUIDResponse
    createSubjectArea(String serverName, String userId, org.odpi.openmetadata.accessservices.governanceprogram.rest.ReferenceableRequestBody requestBody)
    Create a definition of a subject area.
    org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse
    deleteSubjectArea(String serverName, String userId, String subjectAreaGUID, org.odpi.openmetadata.accessservices.governanceprogram.rest.ExternalSourceRequestBody requestBody)
    Remove the definition of a subjectArea.
    org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse
    deleteSubjectAreaMemberClassification(String serverName, String userId, String elementGUID, org.odpi.openmetadata.accessservices.governanceprogram.rest.ExternalSourceRequestBody requestBody)
    Remove a subject area classification from a referenceable.
    org.odpi.openmetadata.accessservices.governanceprogram.rest.ElementStubListResponse
    getMembersOfSubjectArea(String serverName, String userId, String subjectAreaName, int startFrom, int pageSize)
    Return information about the contents of a subject area such as the glossaries, reference data sets and quality definitions.
    org.odpi.openmetadata.accessservices.governanceprogram.rest.SubjectAreaResponse
    getSubjectAreaByGUID(String serverName, String userId, String subjectAreaGUID)
    Return information about a specific subject area.
    org.odpi.openmetadata.accessservices.governanceprogram.rest.SubjectAreaResponse
    getSubjectAreaByName(String serverName, String userId, String qualifiedName)
    Return information about a specific subject area.
    org.odpi.openmetadata.accessservices.governanceprogram.rest.SubjectAreaDefinitionResponse
    getSubjectAreaDefinitionByGUID(String serverName, String userId, String subjectAreaGUID)
    Return information about a specific subject area and its linked governance definitions.
    org.odpi.openmetadata.accessservices.governanceprogram.rest.SubjectAreaListResponse
    getSubjectAreasForDomain(String serverName, String userId, int domainIdentifier, int startFrom, int pageSize)
    Return information about the defined subject areas.
    org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse
    linkSubjectAreasInHierarchy(String serverName, String userId, String parentSubjectAreaGUID, String childSubjectAreaGUID, org.odpi.openmetadata.accessservices.governanceprogram.rest.RelationshipRequestBody requestBody)
    Link two related subject areas together as part of a hierarchy.
    org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse
    linkSubjectAreaToGovernanceDefinition(String serverName, String userId, String subjectAreaGUID, String definitionGUID, org.odpi.openmetadata.accessservices.governanceprogram.rest.RelationshipRequestBody requestBody)
    Link a subject area to a governance definition that controls how the assets in the subjectArea should be governed.
    org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse
    unlinkSubjectAreaFromGovernanceDefinition(String serverName, String userId, String subjectAreaGUID, String definitionGUID, org.odpi.openmetadata.accessservices.governanceprogram.rest.RelationshipRequestBody requestBody)
    Remove the link between a subjectArea and a governance definition.
    org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse
    unlinkSubjectAreasInHierarchy(String serverName, String userId, String parentSubjectAreaGUID, String childSubjectAreaGUID, org.odpi.openmetadata.accessservices.governanceprogram.rest.RelationshipRequestBody requestBody)
    Remove the link between two subjectAreas in the subjectArea hierarchy.
    org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse
    updateSubjectArea(String serverName, String userId, String subjectAreaGUID, boolean isMergeUpdate, org.odpi.openmetadata.accessservices.governanceprogram.rest.ReferenceableRequestBody requestBody)
    Update the definition of a subjectArea.

    Methods inherited from class java.lang.Object

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

  • Constructor Details

    • SubjectAreaRESTServices

      public SubjectAreaRESTServices()
      Default constructor

  • Method Details

    • createSubjectArea

      public org.odpi.openmetadata.commonservices.ffdc.rest.GUIDResponse createSubjectArea(String serverName, String userId, org.odpi.openmetadata.accessservices.governanceprogram.rest.ReferenceableRequestBody requestBody)
      Create a definition of a subject area.
      Parameters:
      serverName - name of the server instance to connect to
      userId - calling user
      requestBody - properties to store
      Returns:
      unique identifier of the new subjectArea or InvalidParameterException full path or userId is null or PropertyServerException problem accessing property server or UserNotAuthorizedException security access problem

    • updateSubjectArea

      public org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse updateSubjectArea(String serverName, String userId, String subjectAreaGUID, boolean isMergeUpdate, org.odpi.openmetadata.accessservices.governanceprogram.rest.ReferenceableRequestBody requestBody)
      Update the definition of a subjectArea.
      Parameters:
      serverName - name of the server instance to connect to
      userId - calling user
      subjectAreaGUID - unique identifier of subjectArea
      isMergeUpdate - are unspecified properties unchanged (true) or replaced with null?
      requestBody - properties to change
      Returns:
      void or InvalidParameterException guid, qualifiedName or userId is null; qualifiedName is not unique; guid is not known PropertyServerException problem accessing property server UserNotAuthorizedException security access problem

    • deleteSubjectArea

      public org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse deleteSubjectArea(String serverName, String userId, String subjectAreaGUID, org.odpi.openmetadata.accessservices.governanceprogram.rest.ExternalSourceRequestBody requestBody)
      Remove the definition of a subjectArea.
      Parameters:
      serverName - name of the server instance to connect to
      userId - calling user
      subjectAreaGUID - unique identifier of subjectArea
      requestBody - external source request body
      Returns:
      void or InvalidParameterException guid or userId is null; guid is not known PropertyServerException problem accessing property server UserNotAuthorizedException security access problem

    • linkSubjectAreasInHierarchy

      public org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse linkSubjectAreasInHierarchy(String serverName, String userId, String parentSubjectAreaGUID, String childSubjectAreaGUID, org.odpi.openmetadata.accessservices.governanceprogram.rest.RelationshipRequestBody requestBody)
      Link two related subject areas together as part of a hierarchy. A subjectArea can only have one parent but many child subjectAreas.
      Parameters:
      serverName - name of the server instance to connect to
      userId - calling user
      parentSubjectAreaGUID - unique identifier of the parent subjectArea
      childSubjectAreaGUID - unique identifier of the child subjectArea
      requestBody - relationship requestBody
      Returns:
      void or InvalidParameterException one of the guids is null or not known PropertyServerException problem accessing property server UserNotAuthorizedException security access problem

    • unlinkSubjectAreasInHierarchy

      public org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse unlinkSubjectAreasInHierarchy(String serverName, String userId, String parentSubjectAreaGUID, String childSubjectAreaGUID, org.odpi.openmetadata.accessservices.governanceprogram.rest.RelationshipRequestBody requestBody)
      Remove the link between two subjectAreas in the subjectArea hierarchy.
      Parameters:
      serverName - name of the server instance to connect to
      userId - calling user
      parentSubjectAreaGUID - unique identifier of the parent subjectArea
      childSubjectAreaGUID - unique identifier of the child subjectArea
      requestBody - relationship requestBody
      Returns:
      void or InvalidParameterException one of the guids is null or not known PropertyServerException problem accessing property server UserNotAuthorizedException security access problem

    • linkSubjectAreaToGovernanceDefinition

      public org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse linkSubjectAreaToGovernanceDefinition(String serverName, String userId, String subjectAreaGUID, String definitionGUID, org.odpi.openmetadata.accessservices.governanceprogram.rest.RelationshipRequestBody requestBody)
      Link a subject area to a governance definition that controls how the assets in the subjectArea should be governed.
      Parameters:
      serverName - name of the server instance to connect to
      userId - calling user
      subjectAreaGUID - unique identifier of the subjectArea
      definitionGUID - unique identifier of the governance definition
      requestBody - relationship requestBody
      Returns:
      void or InvalidParameterException one of the guids is null or not known PropertyServerException problem accessing property server UserNotAuthorizedException security access problem

    • unlinkSubjectAreaFromGovernanceDefinition

      public org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse unlinkSubjectAreaFromGovernanceDefinition(String serverName, String userId, String subjectAreaGUID, String definitionGUID, org.odpi.openmetadata.accessservices.governanceprogram.rest.RelationshipRequestBody requestBody)
      Remove the link between a subjectArea and a governance definition.
      Parameters:
      serverName - name of the server instance to connect to
      userId - calling user
      subjectAreaGUID - unique identifier of the subjectArea
      definitionGUID - unique identifier of the governance definition
      requestBody - relationship requestBody
      Returns:
      void or InvalidParameterException one of the guids is null or not known PropertyServerException problem accessing property server UserNotAuthorizedException security access problem

    • getSubjectAreaByGUID

      public org.odpi.openmetadata.accessservices.governanceprogram.rest.SubjectAreaResponse getSubjectAreaByGUID(String serverName, String userId, String subjectAreaGUID)
      Return information about a specific subject area.
      Parameters:
      serverName - name of the server instance to connect to
      userId - calling user
      subjectAreaGUID - unique identifier for the subjectArea
      Returns:
      properties of the subject area or InvalidParameterException subjectAreaGUID or userId is null PropertyServerException problem accessing property server UserNotAuthorizedException security access problem

    • getSubjectAreaByName

      public org.odpi.openmetadata.accessservices.governanceprogram.rest.SubjectAreaResponse getSubjectAreaByName(String serverName, String userId, String qualifiedName)
      Return information about a specific subject area.
      Parameters:
      serverName - name of the server instance to connect to
      userId - calling user
      qualifiedName - unique name for the subjectArea
      Returns:
      properties of the subject area or InvalidParameterException qualifiedName or userId is null PropertyServerException problem accessing property server UserNotAuthorizedException security access problem

    • getSubjectAreasForDomain

      public org.odpi.openmetadata.accessservices.governanceprogram.rest.SubjectAreaListResponse getSubjectAreasForDomain(String serverName, String userId, int domainIdentifier, int startFrom, int pageSize)
      Return information about the defined subject areas.
      Parameters:
      serverName - name of the server instance to connect to
      userId - calling user
      domainIdentifier - identifier for the desired governance domain - 0 for all domains
      startFrom - paging start point
      pageSize - maximum results that can be returned
      Returns:
      properties of the subject area or InvalidParameterException qualifiedName or userId is null PropertyServerException problem accessing property server UserNotAuthorizedException security access problem

    • getSubjectAreaDefinitionByGUID

      public org.odpi.openmetadata.accessservices.governanceprogram.rest.SubjectAreaDefinitionResponse getSubjectAreaDefinitionByGUID(String serverName, String userId, String subjectAreaGUID)
      Return information about a specific subject area and its linked governance definitions.
      Parameters:
      serverName - name of the server instance to connect to
      userId - calling user
      subjectAreaGUID - unique identifier for the subjectArea
      Returns:
      properties of the subject area linked to the associated governance definitions or InvalidParameterException subjectAreaGUID or userId is null PropertyServerException problem accessing property server UserNotAuthorizedException security access problem

    • addSubjectAreaMemberClassification

      public org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse addSubjectAreaMemberClassification(String serverName, String userId, String elementGUID, org.odpi.openmetadata.accessservices.governanceprogram.rest.ClassificationRequestBody requestBody)
      Add a subject area classification to a referenceable element.
      Parameters:
      serverName - name of the server instance to connect to
      userId - calling user
      elementGUID - unique identifier for the element
      requestBody - identifier for a subject area
      Returns:
      void or InvalidParameterException qualifiedName or userId is null; qualifiedName is not unique PropertyServerException problem accessing property server UserNotAuthorizedException security access problem

    • deleteSubjectAreaMemberClassification

      public org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse deleteSubjectAreaMemberClassification(String serverName, String userId, String elementGUID, org.odpi.openmetadata.accessservices.governanceprogram.rest.ExternalSourceRequestBody requestBody)
      Remove a subject area classification from a referenceable.
      Parameters:
      serverName - name of the server instance to connect to
      userId - calling user
      elementGUID - unique identifier for the element
      requestBody - external source request body
      Returns:
      void or InvalidParameterException guid or userId is null; guid is not known PropertyServerException problem accessing property server UserNotAuthorizedException security access problem

    • getMembersOfSubjectArea

      public org.odpi.openmetadata.accessservices.governanceprogram.rest.ElementStubListResponse getMembersOfSubjectArea(String serverName, String userId, String subjectAreaName, int startFrom, int pageSize)
      Return information about the contents of a subject area such as the glossaries, reference data sets and quality definitions.
      Parameters:
      serverName - name of the server instance to connect to
      userId - calling user
      subjectAreaName - unique identifier for the subject area
      startFrom - paging start point
      pageSize - maximum results that can be returned
      Returns:
      list of subject area members or InvalidParameterException qualifiedName or userId is null PropertyServerException problem accessing property server UserNotAuthorizedException security access problem