Package org.odpi.openmetadata.viewservices.projectmanager.server.spring

Class ProjectManagerResource

java.lang.Object
org.odpi.openmetadata.viewservices.projectmanager.server.spring.ProjectManagerResource
@RestController @RequestMapping("/servers/{serverName}/api/open-metadata/project-manager") public class ProjectManagerResource extends Object
The ProjectManagerResource provides the Spring API endpoints of the Project Manager Open Metadata View Service (OMVS). =

  • Constructor Summary

    Constructors
    Constructor
    Description
    ProjectManagerResource()
    Default constructor

  • Method Summary

    Modifier and Type
    Method
    Description
    org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse
    addToProjectTeam(String serverName, String projectGUID, String actorGUID, org.odpi.openmetadata.frameworks.openmetadata.properties.projects.ProjectTeamProperties requestBody)
    Add an actor to a project.
    org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse
    clearProjectManagementRole(String serverName, String projectGUID, String projectRoleGUID, org.odpi.openmetadata.commonservices.ffdc.rest.NullRequestBody requestBody)
    Remove a ProjectManagement relationship between a project and a person role.
    org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse
    clearResource(String serverName, String elementGUID, String resourceGUID, org.odpi.openmetadata.commonservices.ffdc.rest.ExternalSourceRequestBody requestBody)
    Remove a "ResourceList" relationship between two referenceables.
    org.odpi.openmetadata.commonservices.ffdc.rest.GUIDResponse
    createProject(String serverName, String classificationName, org.odpi.openmetadata.commonservices.ffdc.rest.NewProjectRequestBody requestBody)
    Create a new generic project.
    org.odpi.openmetadata.commonservices.ffdc.rest.GUIDResponse
    createProjectFromTemplate(String serverName, org.odpi.openmetadata.commonservices.ffdc.rest.TemplateRequestBody requestBody)
    Create a new metadata element to represent a project using an existing metadata element as a template.
    org.odpi.openmetadata.commonservices.ffdc.rest.GUIDResponse
    createTaskProject(String serverName, String projectGUID, org.odpi.openmetadata.frameworks.openmetadata.properties.projects.ProjectProperties requestBody)
    Create a new task linked to the supplied project.
    org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse
    deleteProject(String serverName, String projectGUID, boolean cascadedDelete, org.odpi.openmetadata.commonservices.ffdc.rest.NullRequestBody requestBody)
    Delete a project.
    org.odpi.openmetadata.commonservices.ffdc.rest.ProjectsResponse
    findProjects(String serverName, boolean startsWith, boolean endsWith, boolean ignoreCase, int startFrom, int pageSize, org.odpi.openmetadata.commonservices.ffdc.rest.FilterRequestBody requestBody)
    Returns the list of projects matching the search string.
    org.odpi.openmetadata.commonservices.ffdc.rest.ProjectsResponse
    getClassifiedProjects(String serverName, int startFrom, int pageSize, org.odpi.openmetadata.commonservices.ffdc.rest.FilterRequestBody requestBody)
    Returns the list of projects with a particular classification.
    org.odpi.openmetadata.commonservices.ffdc.rest.ProjectsResponse
    getLinkedProjects(String serverName, String parentGUID, int startFrom, int pageSize, org.odpi.openmetadata.commonservices.ffdc.rest.FilterRequestBody requestBody)
    Returns the list of projects that are linked off of the supplied element.
    org.odpi.openmetadata.commonservices.ffdc.rest.ProjectResponse
    getProject(String serverName, String projectGUID)
    Return the properties of a specific project.
    org.odpi.openmetadata.commonservices.ffdc.rest.ProjectGraphResponse
    getProjectGraph(String serverName, String projectGUID)
    Returns the graph of related projects and resources starting with a supplied project guid..
    org.odpi.openmetadata.commonservices.ffdc.rest.ProjectsResponse
    getProjectsByName(String serverName, int startFrom, int pageSize, org.odpi.openmetadata.commonservices.ffdc.rest.FilterRequestBody requestBody)
    Returns the list of projects with a particular name.
    org.odpi.openmetadata.commonservices.ffdc.rest.ProjectMembersResponse
    getProjectTeam(String serverName, String projectGUID, int startFrom, int pageSize, org.odpi.openmetadata.commonservices.ffdc.rest.FilterRequestBody requestBody)
    Returns the list of actors that are linked off of the project.
    org.odpi.openmetadata.commonservices.ffdc.rest.RelatedElementsResponse
    getResourceList(String serverName, String elementGUID, int startFrom, int pageSize)
    Retrieve the list of resources assigned to an element via the "ResourceList" relationship between two referenceables.
    org.odpi.openmetadata.commonservices.ffdc.rest.RelatedElementsResponse
    getSupportedByResource(String serverName, String resourceGUID, int startFrom, int pageSize)
    Retrieve the list of elements assigned to a resource via the "ResourceList" relationship between two referenceables.
    org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse
    removeFromProjectTeam(String serverName, String projectGUID, String actorGUID, org.odpi.openmetadata.commonservices.ffdc.rest.NullRequestBody requestBody)
    Remove an actor from a project.
    org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse
    setupProjectManagementRole(String serverName, String projectGUID, String projectRoleGUID, org.odpi.openmetadata.commonservices.ffdc.rest.NullRequestBody requestBody)
    Create a ProjectManagement relationship between a project and a person role to show that anyone appointed to the role is a member of the project.
    org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse
    setupResource(String serverName, String elementGUID, String resourceGUID, org.odpi.openmetadata.commonservices.ffdc.rest.RelationshipRequestBody requestBody)
    Create a "ResourceList" relationship between a consuming element and an element that represents resources.
    org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse
    updateProject(String serverName, String projectGUID, boolean replaceAllProperties, org.odpi.openmetadata.frameworks.openmetadata.properties.projects.ProjectProperties requestBody)
    Update the properties of a project.

    Methods inherited from class java.lang.Object

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

  • Constructor Details

    • ProjectManagerResource

      public ProjectManagerResource()
      Default constructor

  • Method Details

    • getLinkedProjects

      @PostMapping(path="/metadata-elements/{parentGUID}/projects") public org.odpi.openmetadata.commonservices.ffdc.rest.ProjectsResponse getLinkedProjects(@PathVariable String serverName, @PathVariable String parentGUID, @RequestParam(required=false,defaultValue="0") int startFrom, @RequestParam(required=false,defaultValue="0") int pageSize, @RequestBody(required=false) org.odpi.openmetadata.commonservices.ffdc.rest.FilterRequestBody requestBody)
      Returns the list of projects that are linked off of the supplied element. Any relationship will do.
      Parameters:
      serverName - name of called server
      parentGUID - unique identifier of referenceable object (typically a personal profile, project or community) that the projects hang off of
      startFrom - index of the list to start from (0 for start)
      pageSize - maximum number of elements to return
      requestBody - filter response by project status - if null, any value will do
      Returns:
      a list of projects InvalidParameterException one of the parameters is null or invalid. PropertyServerException there is a problem retrieving information from the property server(s). UserNotAuthorizedException the requesting user is not authorized to issue this request.

    • getClassifiedProjects

      @PostMapping(path="/projects/by-classifications") public org.odpi.openmetadata.commonservices.ffdc.rest.ProjectsResponse getClassifiedProjects(@PathVariable String serverName, @RequestParam(required=false,defaultValue="0") int startFrom, @RequestParam(required=false,defaultValue="0") int pageSize, @RequestBody org.odpi.openmetadata.commonservices.ffdc.rest.FilterRequestBody requestBody)
      Returns the list of projects with a particular classification.
      Parameters:
      serverName - name of called server
      startFrom - index of the list to start from (0 for start)
      pageSize - maximum number of elements to return
      requestBody - name of the classification - if null, all projects are returned
      Returns:
      a list of projects InvalidParameterException one of the parameters is null or invalid. PropertyServerException there is a problem retrieving information from the property server(s). UserNotAuthorizedException the requesting user is not authorized to issue this request.

    • getProjectTeam

      @PostMapping(path="/projects/{projectGUID}/team") public org.odpi.openmetadata.commonservices.ffdc.rest.ProjectMembersResponse getProjectTeam(@PathVariable String serverName, @PathVariable String projectGUID, @RequestParam(required=false,defaultValue="0") int startFrom, @RequestParam(required=false,defaultValue="0") int pageSize, @RequestBody(required=false) org.odpi.openmetadata.commonservices.ffdc.rest.FilterRequestBody requestBody)
      Returns the list of actors that are linked off of the project.
      Parameters:
      serverName - name of called server
      projectGUID - unique identifier of the project
      startFrom - index of the list to start from (0 for start)
      pageSize - maximum number of elements to return
      requestBody - filter response by team role
      Returns:
      a list of projects InvalidParameterException one of the parameters is null or invalid. PropertyServerException there is a problem retrieving information from the property server(s). UserNotAuthorizedException the requesting user is not authorized to issue this request.

    • findProjects

      @PostMapping(path="/projects/by-search-string") public org.odpi.openmetadata.commonservices.ffdc.rest.ProjectsResponse findProjects(@PathVariable String serverName, @RequestParam(required=false,defaultValue="false") boolean startsWith, @RequestParam(required=false,defaultValue="false") boolean endsWith, @RequestParam(required=false,defaultValue="false") boolean ignoreCase, @RequestParam(required=false,defaultValue="0") int startFrom, @RequestParam(required=false,defaultValue="0") int pageSize, @RequestBody(required=false) org.odpi.openmetadata.commonservices.ffdc.rest.FilterRequestBody requestBody)
      Returns the list of projects matching the search string.
      Parameters:
      serverName - name of the service to route the request to
      startsWith - does the value start with the supplied string?
      endsWith - does the value end with the supplied string?
      ignoreCase - should the search ignore case?
      startFrom - paging start point
      pageSize - maximum results that can be returned
      requestBody - string to find in the properties
      Returns:
      a list of projects InvalidParameterException one of the parameters is null or invalid. PropertyServerException there is a problem retrieving information from the property server(s). UserNotAuthorizedException the requesting user is not authorized to issue this request.

    • getProjectsByName

      @PostMapping(path="/projects/by-name") public org.odpi.openmetadata.commonservices.ffdc.rest.ProjectsResponse getProjectsByName(@PathVariable String serverName, @RequestParam(required=false,defaultValue="0") int startFrom, @RequestParam(required=false,defaultValue="0") int pageSize, @RequestBody(required=false) org.odpi.openmetadata.commonservices.ffdc.rest.FilterRequestBody requestBody)
      Returns the list of projects with a particular name.
      Parameters:
      serverName - name of called server
      requestBody - name of the projects to return - match is full text match in qualifiedName or name
      startFrom - index of the list to start from (0 for start)
      pageSize - maximum number of elements to return
      Returns:
      a list of projects InvalidParameterException one of the parameters is null or invalid. PropertyServerException there is a problem retrieving information from the property server(s). UserNotAuthorizedException the requesting user is not authorized to issue this request.

    • getProject

      @GetMapping(path="/projects/{projectGUID}") public org.odpi.openmetadata.commonservices.ffdc.rest.ProjectResponse getProject(@PathVariable String serverName, @PathVariable String projectGUID)
      Return the properties of a specific project.
      Parameters:
      serverName - name of called server
      projectGUID - unique identifier of the required project
      Returns:
      project properties InvalidParameterException one of the parameters is null or invalid. PropertyServerException there is a problem retrieving information from the property server(s). UserNotAuthorizedException the requesting user is not authorized to issue this request.

    • getProjectGraph

      @GetMapping(path="/projects/{projectGUID}/graph") public org.odpi.openmetadata.commonservices.ffdc.rest.ProjectGraphResponse getProjectGraph(@PathVariable String serverName, @PathVariable String projectGUID)
      Returns the graph of related projects and resources starting with a supplied project guid..
      Parameters:
      serverName - name of called server
      projectGUID - unique identifier of the starting project
      Returns:
      a graph of projects or InvalidParameterException one of the parameters is null or invalid. PropertyServerException there is a problem retrieving information from the property server(s). UserNotAuthorizedException the requesting user is not authorized to issue this request.

    • createProject

      @PostMapping(path="/projects") public org.odpi.openmetadata.commonservices.ffdc.rest.GUIDResponse createProject(@PathVariable String serverName, @RequestParam(required=false) String classificationName, @RequestBody org.odpi.openmetadata.commonservices.ffdc.rest.NewProjectRequestBody requestBody)
      Create a new generic project.
      Parameters:
      serverName - name of called server.
      classificationName - name of project classification
      requestBody - properties for the project.
      Returns:
      unique identifier of the newly created Project InvalidParameterException one of the parameters is invalid. PropertyServerException there is a problem retrieving information from the property server(s). UserNotAuthorizedException the requesting user is not authorized to issue this request.

    • createTaskProject

      @PostMapping(path="/projects/{projectGUID}/task") public org.odpi.openmetadata.commonservices.ffdc.rest.GUIDResponse createTaskProject(@PathVariable String serverName, @PathVariable String projectGUID, @RequestBody org.odpi.openmetadata.frameworks.openmetadata.properties.projects.ProjectProperties requestBody)
      Create a new task linked to the supplied project. Used to identify a discrete piece of work within the project.
      Parameters:
      serverName - name of called server
      projectGUID - unique identifier of the project
      requestBody - properties for the project
      Returns:
      unique identifier of the newly created Project InvalidParameterException one of the parameters is invalid. PropertyServerException there is a problem retrieving information from the property server(s). UserNotAuthorizedException the requesting user is not authorized to issue this request.

    • createProjectFromTemplate

      @PostMapping(path="/projects/from-template") public org.odpi.openmetadata.commonservices.ffdc.rest.GUIDResponse createProjectFromTemplate(@PathVariable String serverName, @RequestBody org.odpi.openmetadata.commonservices.ffdc.rest.TemplateRequestBody requestBody)
      Create a new metadata element to represent a project using an existing metadata element as a template. The template defines additional classifications and relationships that should be added to the new project.
      Parameters:
      serverName - calling user
      requestBody - 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 there is a problem reported in the open metadata server(s)

    • updateProject

      @PostMapping(path="/projects/{projectGUID}/update") public org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse updateProject(@PathVariable String serverName, @PathVariable String projectGUID, @RequestParam boolean replaceAllProperties, @RequestBody org.odpi.openmetadata.frameworks.openmetadata.properties.projects.ProjectProperties requestBody)
      Update the properties of a project.
      Parameters:
      serverName - name of called server.
      projectGUID - unique identifier of the project (returned from create)
      replaceAllProperties - flag to indicate whether to completely replace the existing properties with the new properties, or just update the individual properties specified on the request.
      requestBody - properties for the project.
      Returns:
      void or InvalidParameterException one of the parameters is invalid. PropertyServerException there is a problem retrieving information from the property server(s). UserNotAuthorizedException the requesting user is not authorized to issue this request.

    • deleteProject

      @PostMapping(path="/projects/{projectGUID}/delete") public org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse deleteProject(@PathVariable String serverName, @PathVariable String projectGUID, @RequestParam(required=false,defaultValue="false") boolean cascadedDelete, @RequestBody(required=false) org.odpi.openmetadata.commonservices.ffdc.rest.NullRequestBody requestBody)
      Delete a project. It is detected from all parent elements. If members are anchored to the project then they are also deleted.
      Parameters:
      serverName - name of called server.
      projectGUID - unique identifier of the project.
      cascadedDelete - boolean indicating whether the delete request can cascade to dependent elements
      requestBody - null request body
      Returns:
      void or InvalidParameterException one of the parameters is null or invalid. PropertyServerException there is a problem retrieving information from the property server(s). UserNotAuthorizedException the requesting user is not authorized to issue this request.

    • addToProjectTeam

      @PostMapping(path="/projects/{projectGUID}/members/{actorGUID}/attach") public org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse addToProjectTeam(@PathVariable String serverName, @PathVariable String projectGUID, @PathVariable String actorGUID, @RequestBody(required=false) org.odpi.openmetadata.frameworks.openmetadata.properties.projects.ProjectTeamProperties requestBody)
      Add an actor to a project.
      Parameters:
      serverName - name of called server.
      projectGUID - unique identifier of the project.
      requestBody - properties describing the membership characteristics.
      actorGUID - unique identifier of the actor.
      Returns:
      void or InvalidParameterException one of the parameters is invalid. PropertyServerException there is a problem updating information in the property server(s). UserNotAuthorizedException the requesting user is not authorized to issue this request.

    • removeFromProjectTeam

      @PostMapping(path="/projects/{projectGUID}/members/{actorGUID}/detach") public org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse removeFromProjectTeam(@PathVariable String serverName, @PathVariable String projectGUID, @PathVariable String actorGUID, @RequestBody(required=false) org.odpi.openmetadata.commonservices.ffdc.rest.NullRequestBody requestBody)
      Remove an actor from a project.
      Parameters:
      serverName - name of called server.
      projectGUID - unique identifier of the project.
      actorGUID - unique identifier of the actor.
      requestBody - null request body
      Returns:
      void or InvalidParameterException one of the parameters is invalid. PropertyServerException there is a problem updating information in the property server(s). UserNotAuthorizedException the requesting user is not authorized to issue this request.

    • setupProjectManagementRole

      @PostMapping(path="/projects/{projectGUID}/project-management-roles/{projectRoleGUID}/attach") public org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse setupProjectManagementRole(@PathVariable String serverName, @PathVariable String projectGUID, @PathVariable String projectRoleGUID, @RequestBody(required=false) org.odpi.openmetadata.commonservices.ffdc.rest.NullRequestBody requestBody)
      Create a ProjectManagement relationship between a project and a person role to show that anyone appointed to the role is a member of the project.
      Parameters:
      serverName - name of the service to route the request to.
      projectGUID - unique identifier of the project
      projectRoleGUID - unique identifier of the person role
      requestBody - external 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)

    • clearProjectManagementRole

      @PostMapping(path="/projects/{projectGUID}/project-management-roles/{projectRoleGUID}/detach") public org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse clearProjectManagementRole(@PathVariable String serverName, @PathVariable String projectGUID, @PathVariable String projectRoleGUID, @RequestBody(required=false) org.odpi.openmetadata.commonservices.ffdc.rest.NullRequestBody requestBody)
      Remove a ProjectManagement relationship between a project and a person role.
      Parameters:
      serverName - name of the service to route the request to.
      projectGUID - unique identifier of the project
      projectRoleGUID - unique identifier of the person role
      requestBody - external 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)

    • setupResource

      @PostMapping(path="/related-elements/{elementGUID}/resource-list/{resourceGUID}") public org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse setupResource(@PathVariable String serverName, @PathVariable String elementGUID, @PathVariable String resourceGUID, @RequestBody(required=false) org.odpi.openmetadata.commonservices.ffdc.rest.RelationshipRequestBody requestBody)
      Create a "ResourceList" relationship between a consuming element and an element that represents resources.
      Parameters:
      serverName - name of the service to route the request to.
      elementGUID - unique identifier of the element
      resourceGUID - unique identifier of the resource
      requestBody - relationship properties
      Returns:
      void or InvalidParameterException one of the parameters is invalid UserNotAuthorizedException the user is not authorized to issue this request PropertyServerException there is a problem reported in the open metadata server(s)

    • clearResource

      @PostMapping(path="/related-elements/{elementGUID}/resource-list/{resourceGUID}/delete") public org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse clearResource(@PathVariable String serverName, @PathVariable String elementGUID, @PathVariable String resourceGUID, @RequestBody(required=false) org.odpi.openmetadata.commonservices.ffdc.rest.ExternalSourceRequestBody requestBody)
      Remove a "ResourceList" relationship between two referenceables.
      Parameters:
      serverName - name of the service to route the request to.
      elementGUID - unique identifier of the element
      resourceGUID - unique identifier of the resource
      requestBody - external source identifiers
      Returns:
      void or InvalidParameterException one of the parameters is invalid UserNotAuthorizedException the user is not authorized to issue this request PropertyServerException there is a problem reported in the open metadata server(s)

    • getResourceList

      @GetMapping(path="/related-elements/resource-list/by-assignee/{elementGUID}") public org.odpi.openmetadata.commonservices.ffdc.rest.RelatedElementsResponse getResourceList(@PathVariable String serverName, @PathVariable String elementGUID, @RequestParam int startFrom, @RequestParam int pageSize)
      Retrieve the list of resources assigned to an element via the "ResourceList" relationship between two referenceables.
      Parameters:
      serverName - name of the service to route the request to.
      elementGUID - unique identifier of the element
      startFrom - index of the list to start from (0 for start)
      pageSize - maximum number of elements to return.
      Returns:
      void or InvalidParameterException one of the parameters is invalid UserNotAuthorizedException the user is not authorized to issue this request PropertyServerException there is a problem reported in the open metadata server(s)

    • getSupportedByResource

      @GetMapping(path="/related-elements/resource-list/by-resource/{resourceGUID}") public org.odpi.openmetadata.commonservices.ffdc.rest.RelatedElementsResponse getSupportedByResource(@PathVariable String serverName, @PathVariable String resourceGUID, @RequestParam int startFrom, @RequestParam int pageSize)
      Retrieve the list of elements assigned to a resource via the "ResourceList" relationship between two referenceables.
      Parameters:
      serverName - name of the service to route the request to.
      resourceGUID - unique identifier of the resource
      startFrom - index of the list to start from (0 for start)
      pageSize - maximum number of elements to return.
      Returns:
      void or InvalidParameterException one of the parameters is invalid UserNotAuthorizedException the user is not authorized to issue this request PropertyServerException there is a problem reported in the open metadata server(s)