Class DisplayApplicationResource
java.lang.Object
org.odpi.openmetadata.accessservices.datamanager.server.spring.DisplayApplicationResource
@RestController
@RequestMapping("/servers/{serverName}/open-metadata/access-services/data-manager/users/{userId}")
public class DisplayApplicationResource
extends Object
DisplayApplicationResource is the server-side implementation of the Data Manager OMAS's
support for forms, reports and queries. It matches the DisplayApplicationClient.
-
Constructor Summary
-
Method Summary
Modifier and TypeMethodDescriptioncreateDataContainer
(String serverName, String userId, String parentGUID, boolean applicationIsHome, DataContainerRequestBody requestBody) Create a new metadata element to represent a data field.createDataContainerFromTemplate
(String serverName, String userId, String templateGUID, String parentGUID, boolean applicationIsHome, TemplateRequestBody requestBody) Create a new metadata element to represent a data field using an existing metadata element as a template.createForm
(String serverName, String userId, boolean applicationIsHome, FormRequestBody requestBody) Create a new metadata element to represent a form.createFormFromTemplate
(String serverName, String userId, String templateGUID, boolean applicationIsHome, TemplateRequestBody requestBody) Create a new metadata element to represent a form using an existing metadata element as a template.createQuery
(String serverName, String userId, boolean applicationIsHome, QueryRequestBody requestBody) Create a new metadata element to represent a query.createQueryFromTemplate
(String serverName, String userId, String templateGUID, boolean applicationIsHome, TemplateRequestBody requestBody) Create a new metadata element to represent a query using an existing metadata element as a template.createReport
(String serverName, String userId, boolean applicationIsHome, ReportRequestBody requestBody) Create a new metadata element to represent a report.createReportFromTemplate
(String serverName, String userId, String templateGUID, boolean applicationIsHome, TemplateRequestBody requestBody) Create a new metadata element to represent a report using an existing metadata element as a template.findDataContainers
(String serverName, String userId, SearchStringRequestBody requestBody, int startFrom, int pageSize) Retrieve the list of data field metadata elements that contain the search string.findForms
(String serverName, String userId, SearchStringRequestBody requestBody, int startFrom, int pageSize) Retrieve the list of form metadata elements that contain the search string.findQueries
(String serverName, String userId, SearchStringRequestBody requestBody, int startFrom, int pageSize) Retrieve the list of query metadata elements that contain the search string.findReports
(String serverName, String userId, SearchStringRequestBody requestBody, int startFrom, int pageSize) Retrieve the list of report metadata elements that contain the search string.getDataContainerByGUID
(String serverName, String userId, String dataContainerGUID) Retrieve the data field metadata element with the supplied unique identifier.getDataContainersByName
(String serverName, String userId, NameRequestBody requestBody, int startFrom, int pageSize) Retrieve the list of data field metadata elements with a matching qualified or display name.getDataContainersForParent
(String serverName, String userId, String parentGUID, int startFrom, int pageSize) Return the list of schemas associated with a parent element .getFormByGUID
(String serverName, String userId, String formGUID) Retrieve the form metadata element with the supplied unique identifier.getFormsByName
(String serverName, String userId, NameRequestBody requestBody, int startFrom, int pageSize) Retrieve the list of form metadata elements with a matching qualified or display name.getFormsForApplication
(String serverName, String userId, String applicationGUID, String applicationName, int startFrom, int pageSize) Retrieve the list of forms created by this caller.getQueriesByName
(String serverName, String userId, NameRequestBody requestBody, int startFrom, int pageSize) Retrieve the list of query metadata elements with a matching qualified or display name.getQueriesForApplication
(String serverName, String userId, String applicationGUID, String applicationName, int startFrom, int pageSize) Retrieve the list of queries created by this caller.getQueryByGUID
(String serverName, String userId, String queryGUID) Retrieve the query metadata element with the supplied unique identifier.getReportByGUID
(String serverName, String userId, String reportGUID) Retrieve the report metadata element with the supplied unique identifier.getReportsByName
(String serverName, String userId, NameRequestBody requestBody, int startFrom, int pageSize) Retrieve the list of report metadata elements with a matching qualified or display name.getReportsForApplication
(String serverName, String userId, String applicationGUID, String applicationName, int startFrom, int pageSize) Retrieve the list of reports created by this caller.publishForm
(String serverName, String userId, String formGUID, NullRequestBody nullRequestBody) Update the zones for the form asset so that it becomes visible to consumers.publishQuery
(String serverName, String userId, String queryGUID, NullRequestBody nullRequestBody) Update the zones for the query asset so that it becomes visible to consumers.publishReport
(String serverName, String userId, String reportGUID, NullRequestBody nullRequestBody) Update the zones for the report asset so that it becomes visible to consumers.removeDataContainer
(String serverName, String userId, String dataContainerGUID, String qualifiedName, MetadataSourceRequestBody requestBody) Remove the metadata element representing a data container.removeForm
(String serverName, String userId, String formGUID, String qualifiedName, MetadataSourceRequestBody requestBody) Remove the metadata element representing a form.removeQuery
(String serverName, String userId, String queryGUID, String qualifiedName, MetadataSourceRequestBody requestBody) Remove the metadata element representing a query.removeReport
(String serverName, String userId, String reportGUID, String qualifiedName, MetadataSourceRequestBody requestBody) Remove the metadata element representing a report.updateDataContainer
(String serverName, String userId, String dataContainerGUID, boolean isMergeUpdate, DataContainerRequestBody requestBody) Update the metadata element representing a data field.updateForm
(String serverName, String userId, String formGUID, boolean isMergeUpdate, FormRequestBody requestBody) Update the metadata element representing a form.updateQuery
(String serverName, String userId, String queryGUID, boolean isMergeUpdate, QueryRequestBody requestBody) Update the metadata element representing a query.updateReport
(String serverName, String userId, String reportGUID, boolean isMergeUpdate, ReportRequestBody requestBody) Update the metadata element representing a report.withdrawForm
(String serverName, String userId, String formGUID, NullRequestBody nullRequestBody) Update the zones for the form asset so that it is no longer visible to consumers.withdrawQuery
(String serverName, String userId, String queryGUID, NullRequestBody nullRequestBody) Update the zones for the query asset so that it is no longer visible to consumers.withdrawReport
(String serverName, String userId, String reportGUID, NullRequestBody nullRequestBody) Update the zones for the report asset so that it is no longer visible to consumers.
-
Constructor Details
-
DisplayApplicationResource
public DisplayApplicationResource()Default constructor
-
-
Method Details
-
createForm
@PostMapping(path="/forms") public GUIDResponse createForm(@PathVariable String serverName, @PathVariable String userId, @RequestParam boolean applicationIsHome, @RequestBody FormRequestBody requestBody) Create a new metadata element to represent a form.- Parameters:
serverName
- name of the service to route the request to.userId
- calling userapplicationIsHome
- should the form be marked as owned by the application so others can not update?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)
-
createFormFromTemplate
@PostMapping(path="/forms/by-template/{templateGUID}") public GUIDResponse createFormFromTemplate(@PathVariable String serverName, @PathVariable String userId, @PathVariable String templateGUID, @RequestParam boolean applicationIsHome, @RequestBody TemplateRequestBody requestBody) Create a new metadata element to represent a form using an existing metadata element as a template.- Parameters:
serverName
- name of the service to route the request to.userId
- calling usertemplateGUID
- unique identifier of the metadata element to copyapplicationIsHome
- should the form be marked as owned by the application so others can not update?requestBody
- properties that override the template- 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)
-
updateForm
@PostMapping(path="/forms/{formGUID}") public VoidResponse updateForm(@PathVariable String serverName, @PathVariable String userId, @PathVariable String formGUID, @RequestParam boolean isMergeUpdate, @RequestBody FormRequestBody requestBody) Update the metadata element representing a form.- Parameters:
serverName
- name of the service to route the request to.userId
- calling userformGUID
- unique identifier of the metadata element to updateisMergeUpdate
- 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)
-
publishForm
@PostMapping(path="/forms/{formGUID}/publish") public VoidResponse publishForm(@PathVariable String serverName, @PathVariable String userId, @PathVariable String formGUID, @RequestBody(required=false) NullRequestBody nullRequestBody) Update the zones for the form asset so that it becomes visible to consumers. (The zones are set to the list of zones in the publishedZones option configured for each instance of the Data Manager OMAS).- Parameters:
serverName
- name of the service to route the request to.userId
- calling userformGUID
- unique identifier of the metadata element to publishnullRequestBody
- empty request body- 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)
-
withdrawForm
@PostMapping(path="/forms/{formGUID}/withdraw") public VoidResponse withdrawForm(@PathVariable String serverName, @PathVariable String userId, @PathVariable String formGUID, @RequestBody(required=false) NullRequestBody nullRequestBody) Update the zones for the form asset so that it is no longer visible to consumers. (The zones are set to the list of zones in the defaultZones option configured for each instance of the Data Manager OMAS. This is the setting when the form is first created).- Parameters:
serverName
- name of the service to route the request to.userId
- calling userformGUID
- unique identifier of the metadata element to withdrawnullRequestBody
- empty request body- 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)
-
removeForm
@PostMapping(path="/forms/{formGUID}/{qualifiedName}/delete") public VoidResponse removeForm(@PathVariable String serverName, @PathVariable String userId, @PathVariable String formGUID, @PathVariable String qualifiedName, @RequestBody MetadataSourceRequestBody requestBody) Remove the metadata element representing a form.- Parameters:
serverName
- name of the service to route the request to.userId
- calling userformGUID
- unique identifier of the metadata element to removequalifiedName
- unique name of the metadata element to removerequestBody
- 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)
-
findForms
@PostMapping(path="/forms/by-search-string") public FormsResponse findForms(@PathVariable String serverName, @PathVariable String userId, @RequestBody SearchStringRequestBody requestBody, @RequestParam int startFrom, @RequestParam int pageSize) Retrieve the list of form 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 userrequestBody
- string to find in the propertiesstartFrom
- paging start pointpageSize
- 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)
-
getFormsByName
@PostMapping(path="/forms/by-name") public FormsResponse getFormsByName(@PathVariable String serverName, @PathVariable String userId, @RequestBody NameRequestBody requestBody, @RequestParam int startFrom, @RequestParam int pageSize) Retrieve the list of form 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 userrequestBody
- name to search forstartFrom
- paging start pointpageSize
- 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)
-
getFormsForApplication
@GetMapping(path="/forms/applications/{applicationGUID}/{applicationName}") public FormsResponse getFormsForApplication(@PathVariable String serverName, @PathVariable String userId, @PathVariable String applicationGUID, @PathVariable String applicationName, @RequestParam int startFrom, @RequestParam int pageSize) Retrieve the list of forms created by this caller.- Parameters:
serverName
- name of the service to route the request to.userId
- calling userapplicationGUID
- unique identifier of software server capability representing the applicationapplicationName
- unique name of software server capability representing the applicationstartFrom
- paging start pointpageSize
- 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)
-
getFormByGUID
@GetMapping(path="/forms/{formGUID}") public FormResponse getFormByGUID(@PathVariable String serverName, @PathVariable String userId, @PathVariable String formGUID) Retrieve the form metadata element with the supplied unique identifier.- Parameters:
serverName
- name of the service to route the request to.userId
- calling userformGUID
- 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)
-
createReport
@PostMapping(path="/reports") public GUIDResponse createReport(@PathVariable String serverName, @PathVariable String userId, @RequestParam boolean applicationIsHome, @RequestBody ReportRequestBody requestBody) Create a new metadata element to represent a report.- Parameters:
serverName
- name of the service to route the request to.userId
- calling userapplicationIsHome
- should the report be marked as owned by the application so others can not update?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)
-
createReportFromTemplate
@PostMapping(path="/reports/from-template/{templateGUID}") public GUIDResponse createReportFromTemplate(@PathVariable String serverName, @PathVariable String userId, @PathVariable String templateGUID, @RequestParam boolean applicationIsHome, @RequestBody TemplateRequestBody requestBody) Create a new metadata element to represent a report using an existing metadata element as a template.- Parameters:
serverName
- name of the service to route the request to.userId
- calling usertemplateGUID
- unique identifier of the metadata element to copyapplicationIsHome
- should the report be marked as owned by the application so others can not update?requestBody
- properties that override the template- 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)
-
updateReport
@PostMapping(path="/reports/{reportGUID}") public VoidResponse updateReport(@PathVariable String serverName, @PathVariable String userId, @PathVariable String reportGUID, @RequestParam boolean isMergeUpdate, @RequestBody ReportRequestBody requestBody) Update the metadata element representing a report.- Parameters:
serverName
- name of the service to route the request to.userId
- calling userreportGUID
- unique identifier of the metadata element to updateisMergeUpdate
- 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)
-
publishReport
@PostMapping(path="/reports/{reportGUID}/publish") public VoidResponse publishReport(@PathVariable String serverName, @PathVariable String userId, @PathVariable String reportGUID, @RequestBody(required=false) NullRequestBody nullRequestBody) Update the zones for the report asset so that it becomes visible to consumers. (The zones are set to the list of zones in the publishedZones option configured for each instance of the Data Manager OMAS).- Parameters:
serverName
- name of the service to route the request to.userId
- calling userreportGUID
- unique identifier of the metadata element to publishnullRequestBody
- empty request body- 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)
-
withdrawReport
@PostMapping(path="/reports/{reportGUID}/withdraw") public VoidResponse withdrawReport(@PathVariable String serverName, @PathVariable String userId, @PathVariable String reportGUID, @RequestBody(required=false) NullRequestBody nullRequestBody) Update the zones for the report asset so that it is no longer visible to consumers. (The zones are set to the list of zones in the defaultZones option configured for each instance of the Data Manager OMAS. This is the setting when the report is first created).- Parameters:
serverName
- name of the service to route the request to.userId
- calling userreportGUID
- unique identifier of the metadata element to withdrawnullRequestBody
- empty request body- 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)
-
removeReport
@PostMapping(path="/reports/{reportGUID}/{qualifiedName}/delete") public VoidResponse removeReport(@PathVariable String serverName, @PathVariable String userId, @PathVariable String reportGUID, @PathVariable String qualifiedName, @RequestBody MetadataSourceRequestBody requestBody) Remove the metadata element representing a report.- Parameters:
serverName
- name of the service to route the request to.userId
- calling userreportGUID
- unique identifier of the metadata element to removequalifiedName
- unique name of the metadata element to removerequestBody
- 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)
-
findReports
@PostMapping(path="/reports/by-search-string") public ReportsResponse findReports(@PathVariable String serverName, @PathVariable String userId, @RequestBody SearchStringRequestBody requestBody, @RequestParam int startFrom, @RequestParam int pageSize) Retrieve the list of report 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 userrequestBody
- string to find in the propertiesstartFrom
- paging start pointpageSize
- 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)
-
getReportsByName
@PostMapping(path="/reports/by-name") public ReportsResponse getReportsByName(@PathVariable String serverName, @PathVariable String userId, @RequestBody NameRequestBody requestBody, @RequestParam int startFrom, @RequestParam int pageSize) Retrieve the list of report 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 userrequestBody
- name to search forstartFrom
- paging start pointpageSize
- 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)
-
getReportsForApplication
@GetMapping(path="/reports/applications/{applicationGUID}/{applicationName}") public ReportsResponse getReportsForApplication(@PathVariable String serverName, @PathVariable String userId, @PathVariable String applicationGUID, @PathVariable String applicationName, @RequestParam int startFrom, @RequestParam int pageSize) Retrieve the list of reports created by this caller.- Parameters:
serverName
- name of the service to route the request to.userId
- calling userapplicationGUID
- unique identifier of software server capability representing the applicationapplicationName
- unique name of software server capability representing the applicationstartFrom
- paging start pointpageSize
- 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)
-
getReportByGUID
@GetMapping(path="/reports/{reportGUID}") public ReportResponse getReportByGUID(@PathVariable String serverName, @PathVariable String userId, @PathVariable String reportGUID) Retrieve the report metadata element with the supplied unique identifier.- Parameters:
serverName
- name of the service to route the request to.userId
- calling userreportGUID
- 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)
-
createQuery
@PostMapping(path="/queries") public GUIDResponse createQuery(@PathVariable String serverName, @PathVariable String userId, @RequestParam boolean applicationIsHome, @RequestBody QueryRequestBody requestBody) Create a new metadata element to represent a query.- Parameters:
serverName
- name of the service to route the request to.userId
- calling userapplicationIsHome
- should the query be marked as owned by the application so others can not update?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)
-
createQueryFromTemplate
@PostMapping(path="/queries/from-template/{templateGUID}") public GUIDResponse createQueryFromTemplate(@PathVariable String serverName, @PathVariable String userId, @PathVariable String templateGUID, @RequestParam boolean applicationIsHome, @RequestBody TemplateRequestBody requestBody) Create a new metadata element to represent a query using an existing metadata element as a template.- Parameters:
serverName
- name of the service to route the request to.userId
- calling usertemplateGUID
- unique identifier of the metadata element to copyapplicationIsHome
- should the query be marked as owned by the application so others can not update?requestBody
- properties that override the template- 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)
-
updateQuery
@PostMapping(path="/queries/{queryGUID}") public VoidResponse updateQuery(@PathVariable String serverName, @PathVariable String userId, @PathVariable String queryGUID, @RequestParam boolean isMergeUpdate, @RequestBody QueryRequestBody requestBody) Update the metadata element representing a query.- Parameters:
serverName
- name of the service to route the request to.userId
- calling userqueryGUID
- unique identifier of the metadata element to updateisMergeUpdate
- 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)
-
publishQuery
@PostMapping(path="/queries/{queryGUID}/publish") public VoidResponse publishQuery(@PathVariable String serverName, @PathVariable String userId, @PathVariable String queryGUID, @RequestBody(required=false) NullRequestBody nullRequestBody) Update the zones for the query asset so that it becomes visible to consumers. (The zones are set to the list of zones in the publishedZones option configured for each instance of the Data Manager OMAS).- Parameters:
serverName
- name of the service to route the request to.userId
- calling userqueryGUID
- unique identifier of the metadata element to publishnullRequestBody
- empty request body- 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)
-
withdrawQuery
@PostMapping(path="/queries/{queryGUID}/withdraw") public VoidResponse withdrawQuery(@PathVariable String serverName, @PathVariable String userId, @PathVariable String queryGUID, @RequestBody(required=false) NullRequestBody nullRequestBody) Update the zones for the query asset so that it is no longer visible to consumers. (The zones are set to the list of zones in the defaultZones option configured for each instance of the Data Manager OMAS. This is the setting when the query is first created).- Parameters:
serverName
- name of the service to route the request to.userId
- calling userqueryGUID
- unique identifier of the metadata element to withdrawnullRequestBody
- empty request body- 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)
-
removeQuery
@PostMapping(path="/queries/{queryGUID}/{qualifiedName}/delete") public VoidResponse removeQuery(@PathVariable String serverName, @PathVariable String userId, @PathVariable String queryGUID, @PathVariable String qualifiedName, @RequestBody MetadataSourceRequestBody requestBody) Remove the metadata element representing a query.- Parameters:
serverName
- name of the service to route the request to.userId
- calling userqueryGUID
- unique identifier of the metadata element to removequalifiedName
- unique name of the metadata element to removerequestBody
- 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)
-
findQueries
@PostMapping(path="/queries/by-search-string") public QueriesResponse findQueries(@PathVariable String serverName, @PathVariable String userId, @RequestBody SearchStringRequestBody requestBody, @RequestParam int startFrom, @RequestParam int pageSize) Retrieve the list of query 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 userrequestBody
- string to find in the propertiesstartFrom
- paging start pointpageSize
- 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)
-
getQueriesByName
@PostMapping(path="/queries/by-name") public QueriesResponse getQueriesByName(@PathVariable String serverName, @PathVariable String userId, @RequestBody NameRequestBody requestBody, @RequestParam int startFrom, @RequestParam int pageSize) Retrieve the list of query 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 userrequestBody
- name to search forstartFrom
- paging start pointpageSize
- 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)
-
getQueriesForApplication
@GetMapping(path="/queries/applications/{applicationGUID}/{applicationName}") public QueriesResponse getQueriesForApplication(@PathVariable String serverName, @PathVariable String userId, @PathVariable String applicationGUID, @PathVariable String applicationName, @RequestParam int startFrom, @RequestParam int pageSize) Retrieve the list of queries created by this caller.- Parameters:
serverName
- name of the service to route the request to.userId
- calling userapplicationGUID
- unique identifier of software server capability representing the applicationapplicationName
- unique name of software server capability representing the applicationstartFrom
- paging start pointpageSize
- 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)
-
getQueryByGUID
@GetMapping(path="/queries/{queryGUID}") public QueryResponse getQueryByGUID(@PathVariable String serverName, @PathVariable String userId, @PathVariable String queryGUID) Retrieve the query metadata element with the supplied unique identifier.- Parameters:
serverName
- name of the service to route the request to.userId
- calling userqueryGUID
- 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)
-
createDataContainer
@PostMapping(path="/schemas/elements/{parentGUID}/data-containers") public GUIDResponse createDataContainer(@PathVariable String serverName, @PathVariable String userId, @PathVariable String parentGUID, @RequestParam boolean applicationIsHome, @RequestBody DataContainerRequestBody requestBody) Create a new metadata element to represent a data field.- Parameters:
serverName
- name of the service to route the request to.userId
- calling userapplicationIsHome
- should the data field be marked as owned by the event broker so others can not update?parentGUID
- unique identifier of the parent element where the schema is locatedrequestBody
- properties about the data field- Returns:
- unique identifier of the new data field 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)
-
createDataContainerFromTemplate
@PostMapping(path="/schemas/elements/{parentGUID}/data-containers/from-template/{templateGUID}") public GUIDResponse createDataContainerFromTemplate(@PathVariable String serverName, @PathVariable String userId, @PathVariable String templateGUID, @PathVariable String parentGUID, @RequestParam boolean applicationIsHome, @RequestBody TemplateRequestBody requestBody) Create a new metadata element to represent a data field using an existing metadata element as a template.- Parameters:
serverName
- name of the service to route the request to.userId
- calling usertemplateGUID
- unique identifier of the metadata element to copyparentGUID
- unique identifier of the parent where the schema is locatedapplicationIsHome
- should the data field be marked as owned by the event broker so others can not update?requestBody
- properties that override the template- Returns:
- unique identifier of the new data field 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)
-
updateDataContainer
@PostMapping(path="/schemas/data-containers/{dataContainerGUID}") public VoidResponse updateDataContainer(@PathVariable String serverName, @PathVariable String userId, @PathVariable String dataContainerGUID, @RequestParam boolean isMergeUpdate, @RequestBody DataContainerRequestBody requestBody) Update the metadata element representing a data field.- Parameters:
serverName
- name of the service to route the request to.userId
- calling userdataContainerGUID
- unique identifier of the metadata element to updateisMergeUpdate
- are unspecified properties unchanged (true) or removed?requestBody
- new properties for the metadata 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)
-
removeDataContainer
@PostMapping(path="/schemas/data-containers/{dataContainerGUID}/delete") public VoidResponse removeDataContainer(@PathVariable String serverName, @PathVariable String userId, @PathVariable String dataContainerGUID, @PathVariable String qualifiedName, @RequestBody MetadataSourceRequestBody requestBody) Remove the metadata element representing a data container.- Parameters:
serverName
- name of the service to route the request to.userId
- calling userdataContainerGUID
- unique identifier of the metadata element to removequalifiedName
- unique name of the metadata element to removerequestBody
- 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)
-
findDataContainers
@PostMapping(path="/schemas/data-containers/by-search-string") public DataContainersResponse findDataContainers(@PathVariable String serverName, @PathVariable String userId, @RequestBody SearchStringRequestBody requestBody, @RequestParam int startFrom, @RequestParam int pageSize) Retrieve the list of data field 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 userrequestBody
- string to find in the propertiesstartFrom
- paging start pointpageSize
- 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)
-
getDataContainersForParent
@GetMapping(path="/schemas/data-containers/by-parent-element/{parentGUID}") public DataContainersResponse getDataContainersForParent(@PathVariable String serverName, @PathVariable String userId, @PathVariable String parentGUID, @RequestParam int startFrom, @RequestParam int pageSize) Return the list of schemas associated with a parent element .- Parameters:
serverName
- name of the service to route the request to.userId
- calling userparentGUID
- unique identifier of the parent element to querystartFrom
- paging start pointpageSize
- maximum results that can be returned- Returns:
- list of metadata elements describing the schemas associated with the requested parent 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)
-
getDataContainersByName
@PostMapping(path="/schemas/data-containers/by-name") public DataContainersResponse getDataContainersByName(@PathVariable String serverName, @PathVariable String userId, @RequestBody NameRequestBody requestBody, @RequestParam int startFrom, @RequestParam int pageSize) Retrieve the list of data field 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 userrequestBody
- name to search forstartFrom
- paging start pointpageSize
- 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)
-
getDataContainerByGUID
@GetMapping(path="/schemas/data-containers/{dataContainerGUID}") public DataContainerResponse getDataContainerByGUID(@PathVariable String serverName, @PathVariable String userId, @PathVariable String dataContainerGUID) Retrieve the data field metadata element with the supplied unique identifier.- Parameters:
serverName
- name of the service to route the request to.userId
- calling userdataContainerGUID
- unique identifier of the requested metadata element- Returns:
- requested 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)
-