Class FeedbackManagerRESTServices
java.lang.Object
org.odpi.openmetadata.tokencontroller.TokenController
org.odpi.openmetadata.viewservices.feedbackmanager.server.FeedbackManagerRESTServices
The FeedbackManagerRESTServices provides the implementation of the Feedback Manager Open Metadata View Service (OMVS).
This interface provides view interfaces for glossary UIs.
-
Constructor Summary
-
Method Summary
Modifier and TypeMethodDescriptionaddCommentReply
(String serverName, String elementGUID, String commentGUID, boolean isPublic, String viewServiceURLMarker, ReferenceableUpdateRequestBody requestBody) Adds a reply to a comment.addCommentToElement
(String serverName, String elementGUID, boolean isPublic, String viewServiceURLMarker, ReferenceableUpdateRequestBody requestBody) Adds a comment to the element.addLikeToElement
(String serverName, String guid, boolean isPublic, String viewServiceURLMarker, EffectiveTimeQueryRequestBody requestBody) Adds a "LikeProperties" to the element.addRatingToElement
(String serverName, String guid, boolean isPublic, String viewServiceURLMarker, RatingProperties requestBody) Adds a star rating and optional review text to the element.addTagToElement
(String serverName, String elementGUID, String tagGUID, boolean isPublic, String viewServiceURLMarker, EffectiveTimeQueryRequestBody requestBody) Adds a tag (either private of public) to an element.clearAcceptedAnswer
(String serverName, String questionCommentGUID, String answerCommentGUID, String viewServiceURLMarker, EffectiveTimeQueryRequestBody requestBody) Unlink a comment that contains an answer to a question posed in another comment.createInformalTag
(String serverName, String viewServiceURLMarker, TagProperties requestBody) Creates a new informal tag and returns the unique identifier for it.createNote
(String serverName, String noteLogGUID, String viewServiceURLMarker, NoteProperties requestBody) Creates a new note for a note log and returns the unique identifier for it.createNoteLog
(String serverName, String elementGUID, boolean isPublic, String viewServiceURLMarker, NoteLogProperties requestBody) Creates a new noteLog and returns the unique identifier for it.deleteNote
(String serverName, String noteGUID, String viewServiceURLMarker, EffectiveTimeQueryRequestBody requestBody) Removes a note from the repository.deleteNoteLog
(String serverName, String noteLogGUID, String viewServiceURLMarker, EffectiveTimeQueryRequestBody requestBody) Removes a note log from the repository.deleteTag
(String serverName, String tagGUID, String viewServiceURLMarker, EffectiveTimeQueryRequestBody requestBody) Removes a tag from the repository.findComments
(String serverName, int startFrom, int pageSize, boolean startsWith, boolean endsWith, boolean ignoreCase, String viewServiceURLMarker, FilterRequestBody requestBody) Retrieve the list of comment metadata elements that contain the search string.findMyTags
(String serverName, int startFrom, int pageSize, boolean startsWith, boolean endsWith, boolean ignoreCase, String viewServiceURLMarker, FilterRequestBody requestBody) Return the list of the calling user's private tags containing the supplied string in either the name or description.findNoteLogs
(String serverName, int startFrom, int pageSize, boolean startsWith, boolean endsWith, boolean ignoreCase, String viewServiceURLMarker, FilterRequestBody requestBody) Retrieve the list of note log metadata elements that contain the search string.findNotes
(String serverName, int startFrom, int pageSize, boolean startsWith, boolean endsWith, boolean ignoreCase, String viewServiceURLMarker, FilterRequestBody requestBody) Retrieve the list of note metadata elements that contain the search string.findTags
(String serverName, int startFrom, int pageSize, boolean startsWith, boolean endsWith, boolean ignoreCase, String viewServiceURLMarker, FilterRequestBody requestBody) Return the list of tags containing the supplied string in either the name or description.getAttachedComments
(String serverName, String elementGUID, int startFrom, int pageSize, String viewServiceURLMarker, EffectiveTimeQueryRequestBody requestBody) Return the comments attached to an element.getAttachedLikes
(String serverName, String elementGUID, int startFrom, int pageSize, String viewServiceURLMarker, EffectiveTimeQueryRequestBody requestBody) Return the likes attached to an element.getAttachedRatings
(String serverName, String elementGUID, int startFrom, int pageSize, String viewServiceURLMarker, EffectiveTimeQueryRequestBody requestBody) Return the comments attached to an element.getAttachedTags
(String serverName, String elementGUID, int startFrom, int pageSize, String viewServiceURLMarker, EffectiveTimeQueryRequestBody requestBody) Return the informal tags attached to an element.getCommentByGUID
(String serverName, String commentGUID, String viewServiceURLMarker, EffectiveTimeQueryRequestBody requestBody) Return the requested comment.getElementsByTag
(String serverName, String tagGUID, int startFrom, int pageSize, String viewServiceURLMarker, EffectiveTimeQueryRequestBody requestBody) Return the list of unique identifiers for elements that are linked to a specific tag either directly, or via one of its schema elements.getNoteByGUID
(String serverName, String noteGUID, String viewServiceURLMarker, EffectiveTimeQueryRequestBody requestBody) Retrieve the note metadata element with the supplied unique identifier.getNoteLogByGUID
(String serverName, String noteLogGUID, String viewServiceURLMarker, EffectiveTimeQueryRequestBody requestBody) Retrieve the note log metadata element with the supplied unique identifier.getNoteLogsByName
(String serverName, int startFrom, int pageSize, String viewServiceURLMarker, FilterRequestBody requestBody) Retrieve the list of note log metadata elements with a matching qualified or display name.getNoteLogsForElement
(String serverName, String elementGUID, int startFrom, int pageSize, String viewServiceURLMarker, EffectiveTimeQueryRequestBody requestBody) Retrieve the list of note log metadata elements attached to the element.getNotesForNoteLog
(String serverName, String noteLogGUID, int startFrom, int pageSize, String viewServiceURLMarker, EffectiveTimeQueryRequestBody requestBody) Retrieve the list of notes associated with a note log.getTag
(String serverName, String guid, String viewServiceURLMarker, EffectiveTimeQueryRequestBody requestBody) Return the tag for the supplied unique identifier (guid).getTagsByName
(String serverName, int startFrom, int pageSize, String viewServiceURLMarker, FilterRequestBody requestBody) Return the list of tags exactly matching the supplied name.removeCommentFromElement
(String serverName, String commentGUID, String viewServiceURLMarker, EffectiveTimeQueryRequestBody requestBody) Removes a comment added to the element by this user.removeLikeFromElement
(String serverName, String guid, String viewServiceURLMarker, EffectiveTimeQueryRequestBody requestBody) Removes a "LikeProperties" added to the element by this user.removeRatingFromElement
(String serverName, String guid, String viewServiceURLMarker, EffectiveTimeQueryRequestBody requestBody) Removes a star rating that was added to the element by this user.removeTagFromElement
(String serverName, String elementGUID, String tagGUID, String viewServiceURLMarker, EffectiveTimeQueryRequestBody requestBody) Removes a tag from the element that was added by this user.setupAcceptedAnswer
(String serverName, String questionCommentGUID, String answerCommentGUID, boolean isPublic, String viewServiceURLMarker, EffectiveTimeQueryRequestBody requestBody) Link a comment that contains the best answer to a question posed in another comment.updateComment
(String serverName, String commentGUID, boolean isMergeUpdate, String viewServiceURLMarker, ReferenceableUpdateRequestBody requestBody) Update an existing comment.updateCommentVisibility
(String serverName, String parentGUID, String commentGUID, boolean isPublic, String viewServiceURLMarker, EffectiveTimeQueryRequestBody requestBody) Update an existing comment's visibility.updateNote
(String serverName, String noteGUID, boolean isMergeUpdate, String viewServiceURLMarker, ReferenceableUpdateRequestBody requestBody) Update an existing note.updateNoteLog
(String serverName, String noteLogGUID, boolean isMergeUpdate, String viewServiceURLMarker, ReferenceableUpdateRequestBody requestBody) Update an existing note log.updateTagDescription
(String serverName, String tagGUID, String viewServiceURLMarker, InformalTagUpdateRequestBody requestBody) Updates the description of an existing tag (either private or public).Methods inherited from class org.odpi.openmetadata.tokencontroller.TokenController
getUser
-
Constructor Details
-
FeedbackManagerRESTServices
public FeedbackManagerRESTServices()Default constructor
-
-
Method Details
-
addRatingToElement
public VoidResponse addRatingToElement(String serverName, String guid, boolean isPublic, String viewServiceURLMarker, RatingProperties requestBody) Adds a star rating and optional review text to the element. If the user has already attached a rating then the original one is over-ridden.- Parameters:
serverName
- name of the server instances for this requestguid
- String - unique id for the element.isPublic
- is this visible to other peopleviewServiceURLMarker
- view service URL markerrequestBody
- containing the StarRating and user review of referenceable (probably element).- Returns:
- void or InvalidParameterException - one of the parameters is null or invalid or PropertyServerException - there is a problem adding the element properties to the metadata repository or UserNotAuthorizedException - the requesting user is not authorized to issue this request.
-
removeRatingFromElement
public VoidResponse removeRatingFromElement(String serverName, String guid, String viewServiceURLMarker, EffectiveTimeQueryRequestBody requestBody) Removes a star rating that was added to the element by this user.- Parameters:
serverName
- name of the server instances for this requestguid
- String - unique id for the rating objectviewServiceURLMarker
- view service URL markerrequestBody
- optional effective time- Returns:
- void or InvalidParameterException - one of the parameters is null or invalid or PropertyServerException - there is a problem updating the element properties in the metadata repository or UserNotAuthorizedException - the requesting user is not authorized to issue this request.
-
getAttachedRatings
public RatingElementsResponse getAttachedRatings(String serverName, String elementGUID, int startFrom, int pageSize, String viewServiceURLMarker, EffectiveTimeQueryRequestBody requestBody) Return the comments attached to an element.- Parameters:
serverName
- name of the server instances for this requestelementGUID
- unique identifier for the element that the comments are connected to (maybe a comment too).startFrom
- index of the list to start from (0 for start)pageSize
- maximum number of elements to return.viewServiceURLMarker
- view service URL markerrequestBody
- optional effective time- Returns:
- list of ratings or InvalidParameterException one of the parameters is null or invalid. PropertyServerException there is a problem updating the element properties in the property server. UserNotAuthorizedException the user does not have permission to perform this request.
-
addLikeToElement
public VoidResponse addLikeToElement(String serverName, String guid, boolean isPublic, String viewServiceURLMarker, EffectiveTimeQueryRequestBody requestBody) Adds a "LikeProperties" to the element.- Parameters:
serverName
- name of the server instances for this requestguid
- String - unique id for the element.isPublic
- is this visible to other peopleviewServiceURLMarker
- view service URL markerrequestBody
- optional effective time- Returns:
- void or InvalidParameterException - one of the parameters is null or invalid or PropertyServerException - there is a problem adding the element properties to the metadata repository or UserNotAuthorizedException - the requesting user is not authorized to issue this request.
-
removeLikeFromElement
public VoidResponse removeLikeFromElement(String serverName, String guid, String viewServiceURLMarker, EffectiveTimeQueryRequestBody requestBody) Removes a "LikeProperties" added to the element by this user.- Parameters:
serverName
- name of the server instances for this requestguid
- String - unique id for the like objectviewServiceURLMarker
- view service URL markerrequestBody
- optional effective time- Returns:
- void or InvalidParameterException - one of the parameters is null or invalid or PropertyServerException - there is a problem updating the element properties in the metadata repository or UserNotAuthorizedException - the requesting user is not authorized to issue this request.
-
getAttachedLikes
public LikeElementsResponse getAttachedLikes(String serverName, String elementGUID, int startFrom, int pageSize, String viewServiceURLMarker, EffectiveTimeQueryRequestBody requestBody) Return the likes attached to an element.- Parameters:
serverName
- name of the server instances for this requestelementGUID
- unique identifier for the element that the comments are connected to (maybe a comment too).startFrom
- index of the list to start from (0 for start)pageSize
- maximum number of elements to return.viewServiceURLMarker
- view service URL markerrequestBody
- optional effective time- Returns:
- list of likes or InvalidParameterException one of the parameters is null or invalid. PropertyServerException there is a problem updating the element properties in the property server. UserNotAuthorizedException the user does not have permission to perform this request.
-
addCommentToElement
public GUIDResponse addCommentToElement(String serverName, String elementGUID, boolean isPublic, String viewServiceURLMarker, ReferenceableUpdateRequestBody requestBody) Adds a comment to the element.- Parameters:
serverName
- name of the server instances for this requestelementGUID
- String - unique id for the element.isPublic
- is this visible to other peopleviewServiceURLMarker
- view service URL markerrequestBody
- containing type of comment enum and the text of the comment.- Returns:
- elementGUID for new comment object or InvalidParameterException - one of the parameters is null or invalid or PropertyServerException - there is a problem adding the element properties to the metadata repository or UserNotAuthorizedException - the requesting user is not authorized to issue this request.
-
addCommentReply
public GUIDResponse addCommentReply(String serverName, String elementGUID, String commentGUID, boolean isPublic, String viewServiceURLMarker, ReferenceableUpdateRequestBody requestBody) Adds a reply to a comment.- Parameters:
serverName
- name of the server instances for this requestelementGUID
- String - unique id for the anchor element.commentGUID
- String - unique id for an existing comment. Used to add a reply to a comment.isPublic
- is this visible to other peopleviewServiceURLMarker
- view service URL markerrequestBody
- containing type of comment enum and the text of the comment.- Returns:
- guid for new comment object or InvalidParameterException - one of the parameters is null or invalid or PropertyServerException - there is a problem adding the element properties to the metadata repository or UserNotAuthorizedException - the requesting user is not authorized to issue this request.
-
updateComment
public VoidResponse updateComment(String serverName, String commentGUID, boolean isMergeUpdate, String viewServiceURLMarker, ReferenceableUpdateRequestBody requestBody) Update an existing comment.- Parameters:
serverName
- name of the server instances for this request.commentGUID
- unique identifier for the comment to change.isMergeUpdate
- should the new properties be merged with existing properties (true) or completely replace them (false)?viewServiceURLMarker
- view service URL markerrequestBody
- containing type of comment enum and the text of the comment.- Returns:
- void or InvalidParameterException one of the parameters is null or invalid. PropertyServerException There is a problem updating the element properties in the metadata repository. UserNotAuthorizedException the requesting user is not authorized to issue this request.
-
updateCommentVisibility
public VoidResponse updateCommentVisibility(String serverName, String parentGUID, String commentGUID, boolean isPublic, String viewServiceURLMarker, EffectiveTimeQueryRequestBody requestBody) Update an existing comment's visibility.- Parameters:
serverName
- name of the server instances for this request.parentGUID
- String - unique id for the attached element.commentGUID
- unique identifier for the comment to change.isPublic
- is this visible to other peopleviewServiceURLMarker
- view service URL markerrequestBody
- optional effective time- Returns:
- void or InvalidParameterException one of the parameters is null or invalid. PropertyServerException There is a problem updating the element properties in the metadata repository. UserNotAuthorizedException the requesting user is not authorized to issue this request.
-
setupAcceptedAnswer
public VoidResponse setupAcceptedAnswer(String serverName, String questionCommentGUID, String answerCommentGUID, boolean isPublic, String viewServiceURLMarker, EffectiveTimeQueryRequestBody requestBody) Link a comment that contains the best answer to a question posed in another comment.- Parameters:
serverName
- name of the server to route the request toquestionCommentGUID
- unique identifier of the comment containing the questionanswerCommentGUID
- unique identifier of the comment containing the accepted answerisPublic
- is this visible to other peopleviewServiceURLMarker
- view service URL markerrequestBody
- optional effective time- 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)
-
clearAcceptedAnswer
public VoidResponse clearAcceptedAnswer(String serverName, String questionCommentGUID, String answerCommentGUID, String viewServiceURLMarker, EffectiveTimeQueryRequestBody requestBody) Unlink a comment that contains an answer to a question posed in another comment.- Parameters:
serverName
- name of the server to route the request toquestionCommentGUID
- unique identifier of the comment containing the questionanswerCommentGUID
- unique identifier of the comment containing the accepted answerviewServiceURLMarker
- view service URL markerrequestBody
- optional effective time- 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)
-
removeCommentFromElement
public VoidResponse removeCommentFromElement(String serverName, String commentGUID, String viewServiceURLMarker, EffectiveTimeQueryRequestBody requestBody) Removes a comment added to the element by this user.- Parameters:
serverName
- name of the server instances for this requestcommentGUID
- String - unique id for the comment objectviewServiceURLMarker
- view service URL markerrequestBody
- optional effective time- Returns:
- void or InvalidParameterException - one of the parameters is null or invalid or PropertyServerException - there is a problem updating the element properties in the metadata repository or UserNotAuthorizedException - the requesting user is not authorized to issue this request.
-
getCommentByGUID
public CommentResponse getCommentByGUID(String serverName, String commentGUID, String viewServiceURLMarker, EffectiveTimeQueryRequestBody requestBody) Return the requested comment.- Parameters:
serverName
- name of the server instances for this requestcommentGUID
- unique identifier for the comment object.viewServiceURLMarker
- view service URL markerrequestBody
- optional effective time- Returns:
- comment properties or InvalidParameterException one of the parameters is null or invalid. PropertyServerException there is a problem updating the element properties in the property server. UserNotAuthorizedException the user does not have permission to perform this request.
-
getAttachedComments
public CommentElementsResponse getAttachedComments(String serverName, String elementGUID, int startFrom, int pageSize, String viewServiceURLMarker, EffectiveTimeQueryRequestBody requestBody) Return the comments attached to an element.- Parameters:
serverName
- name of the server instances for this requestelementGUID
- unique identifier for the element that the comments are connected to (maybe a comment too).startFrom
- index of the list to start from (0 for start)pageSize
- maximum number of elements to return.viewServiceURLMarker
- view service URL markerrequestBody
- optional effective time- Returns:
- list of comments or InvalidParameterException one of the parameters is null or invalid. PropertyServerException there is a problem updating the element properties in the property server. UserNotAuthorizedException the user does not have permission to perform this request.
-
findComments
public CommentElementsResponse findComments(String serverName, int startFrom, int pageSize, boolean startsWith, boolean endsWith, boolean ignoreCase, String viewServiceURLMarker, FilterRequestBody requestBody) Retrieve the list of comment metadata elements that contain the search string. The search string is treated as a regular expression.- Parameters:
serverName
- name of the server to route the request tostartFrom
- paging start pointpageSize
- maximum results that can be returnedstartsWith
- does the value start with the supplied string?endsWith
- does the value end with the supplied string?ignoreCase
- should the search ignore case?viewServiceURLMarker
- view service URL markerrequestBody
- string to find in the properties- Returns:
- list of matching metadata elements or InvalidParameterException one of the parameters is invalid UserNotAuthorizedException the user is not authorized to issue this request PropertyServerException there is a problem reported in the open metadata server(s)
-
createInformalTag
public GUIDResponse createInformalTag(String serverName, String viewServiceURLMarker, TagProperties requestBody) Creates a new informal tag and returns the unique identifier for it.- Parameters:
serverName
- name of the server instances for this requestviewServiceURLMarker
- view service URL markerrequestBody
- contains the name of the tag and (optional) description of the tag- Returns:
- guid for new tag or InvalidParameterException - one of the parameters is invalid or PropertyServerException - there is a problem retrieving information from the property server(s) or UserNotAuthorizedException - the requesting user is not authorized to issue this request.
-
updateTagDescription
public VoidResponse updateTagDescription(String serverName, String tagGUID, String viewServiceURLMarker, InformalTagUpdateRequestBody requestBody) Updates the description of an existing tag (either private or public).- Parameters:
serverName
- name of the server instances for this requesttagGUID
- unique id for the tag.viewServiceURLMarker
- view service URL markerrequestBody
- contains the name of the tag and (optional) description of the tag.- Returns:
- void or InvalidParameterException - one of the parameters is invalid or PropertyServerException - there is a problem retrieving information from the property server(s) or UserNotAuthorizedException - the requesting user is not authorized to issue this request.
-
deleteTag
public VoidResponse deleteTag(String serverName, String tagGUID, String viewServiceURLMarker, EffectiveTimeQueryRequestBody requestBody) Removes a tag from the repository. All the relationships to referenceables are lost.- Parameters:
serverName
- name of the server instances for this requesttagGUID
- unique id for the tag.viewServiceURLMarker
- view service URL markerrequestBody
- optional effective time.- Returns:
- void or InvalidParameterException - one of the parameters is invalid or PropertyServerException - there is a problem retrieving information from the property server(s) or UserNotAuthorizedException - the requesting user is not authorized to issue this request.
-
getTag
public InformalTagResponse getTag(String serverName, String guid, String viewServiceURLMarker, EffectiveTimeQueryRequestBody requestBody) Return the tag for the supplied unique identifier (guid).- Parameters:
serverName
- name of the server instances for this requestguid
- unique identifier of the tag.viewServiceURLMarker
- view service URL markerrequestBody
- optional effective time- Returns:
- Tag object or InvalidParameterException - one of the parameters is invalid or PropertyServerException - there is a problem retrieving information from the property server(s) or UserNotAuthorizedException - the requesting user is not authorized to issue this request.
-
getTagsByName
public InformalTagsResponse getTagsByName(String serverName, int startFrom, int pageSize, String viewServiceURLMarker, FilterRequestBody requestBody) Return the list of tags exactly matching the supplied name.- Parameters:
serverName
- name of the server instances for this requeststartFrom
- index of the list to start from (0 for start)pageSize
- maximum number of elements to return.viewServiceURLMarker
- view service URL markerrequestBody
- name of tag.- Returns:
- tag list or InvalidParameterException - one of the parameters is invalid or PropertyServerException - there is a problem retrieving information from the property server(s) or UserNotAuthorizedException - the requesting user is not authorized to issue this request.
-
findTags
public InformalTagsResponse findTags(String serverName, int startFrom, int pageSize, boolean startsWith, boolean endsWith, boolean ignoreCase, String viewServiceURLMarker, FilterRequestBody requestBody) Return the list of tags containing the supplied string in either the name or description.- Parameters:
serverName
- name of the server to route the request tostartFrom
- paging start pointpageSize
- maximum results that can be returnedstartsWith
- does the value start with the supplied string?endsWith
- does the value end with the supplied string?ignoreCase
- should the search ignore case?viewServiceURLMarker
- view service URL markerrequestBody
- string to find in the properties- Returns:
- tag list or InvalidParameterException - one of the parameters is invalid or PropertyServerException - there is a problem retrieving information from the property server(s) or UserNotAuthorizedException - the requesting user is not authorized to issue this request.
-
findMyTags
public InformalTagsResponse findMyTags(String serverName, int startFrom, int pageSize, boolean startsWith, boolean endsWith, boolean ignoreCase, String viewServiceURLMarker, FilterRequestBody requestBody) Return the list of the calling user's private tags containing the supplied string in either the name or description.- Parameters:
serverName
- name of the server to route the request tostartFrom
- paging start pointpageSize
- maximum results that can be returnedstartsWith
- does the value start with the supplied string?endsWith
- does the value end with the supplied string?ignoreCase
- should the search ignore case?viewServiceURLMarker
- view service URL markerrequestBody
- string to find in the properties- Returns:
- tag list or InvalidParameterException - one of the parameters is invalid or PropertyServerException - there is a problem retrieving information from the property server(s) or UserNotAuthorizedException - the requesting user is not authorized to issue this request.
-
addTagToElement
public VoidResponse addTagToElement(String serverName, String elementGUID, String tagGUID, boolean isPublic, String viewServiceURLMarker, EffectiveTimeQueryRequestBody requestBody) Adds a tag (either private of public) to an element.- Parameters:
serverName
- name of the server instances for this requestelementGUID
- unique id for the element.tagGUID
- unique id of the tag.isPublic
- visibility of linkviewServiceURLMarker
- view service URL markerrequestBody
- feedback request body.- Returns:
- void or InvalidParameterException - one of the parameters is invalid or PropertyServerException - there is a problem retrieving information from the property server(s) or UserNotAuthorizedException - the requesting user is not authorized to issue this request.
-
removeTagFromElement
public VoidResponse removeTagFromElement(String serverName, String elementGUID, String tagGUID, String viewServiceURLMarker, EffectiveTimeQueryRequestBody requestBody) Removes a tag from the element that was added by this user.- Parameters:
serverName
- name of the server instances for this requestelementGUID
- unique id for the element.tagGUID
- unique id for the tag.viewServiceURLMarker
- view service URL markerrequestBody
- optional effective time- Returns:
- void or InvalidParameterException - one of the parameters is invalid or PropertyServerException - there is a problem retrieving information from the property server(s) or UserNotAuthorizedException - the requesting user is not authorized to issue this request.
-
getElementsByTag
public RelatedElementsResponse getElementsByTag(String serverName, String tagGUID, int startFrom, int pageSize, String viewServiceURLMarker, EffectiveTimeQueryRequestBody requestBody) Return the list of unique identifiers for elements that are linked to a specific tag either directly, or via one of its schema elements.- Parameters:
serverName
- name of the server instances for this requesttagGUID
- unique identifier of tag.startFrom
- index of the list to start from (0 for start)pageSize
- maximum number of elements to return.viewServiceURLMarker
- view service URL markerrequestBody
- optional effective time- Returns:
- element stubs list or InvalidParameterException the userId is null or invalid or PropertyServerException there is a problem retrieving information from the property server(s) or UserNotAuthorizedException the requesting user is not authorized to issue this request.
-
getAttachedTags
public InformalTagsResponse getAttachedTags(String serverName, String elementGUID, int startFrom, int pageSize, String viewServiceURLMarker, EffectiveTimeQueryRequestBody requestBody) Return the informal tags attached to an element.- Parameters:
serverName
- name of the server instances for this requestelementGUID
- unique identifier for the element that the comments are connected to (maybe a comment too).startFrom
- index of the list to start from (0 for start)pageSize
- maximum number of elements to return.viewServiceURLMarker
- view service URL markerrequestBody
- optional effective time- Returns:
- list of tags or InvalidParameterException one of the parameters is null or invalid. PropertyServerException there is a problem updating the element properties in the property server. UserNotAuthorizedException the user does not have permission to perform this request.
-
createNoteLog
public GUIDResponse createNoteLog(String serverName, String elementGUID, boolean isPublic, String viewServiceURLMarker, NoteLogProperties requestBody) Creates a new noteLog and returns the unique identifier for it.- Parameters:
serverName
- name of the server instances for this requestelementGUID
- unique identifier of the element where the note log is locatedisPublic
- is this element visible to other people.viewServiceURLMarker
- view service URL markerrequestBody
- contains the name of the tag and (optional) description of the tag- Returns:
- guid for new tag or InvalidParameterException - one of the parameters is invalid or PropertyServerException - there is a problem retrieving information from the property server(s) or UserNotAuthorizedException - the requesting user is not authorized to issue this request.
-
updateNoteLog
public VoidResponse updateNoteLog(String serverName, String noteLogGUID, boolean isMergeUpdate, String viewServiceURLMarker, ReferenceableUpdateRequestBody requestBody) Update an existing note log.- Parameters:
serverName
- name of the server instances for this request.noteLogGUID
- unique identifier for the note log to change.isMergeUpdate
- should the new properties be merged with existing properties (true) or completely replace them (false)?viewServiceURLMarker
- view service URL markerrequestBody
- containing type of comment enum and the text of the comment.- Returns:
- void or InvalidParameterException one of the parameters is null or invalid. PropertyServerException There is a problem updating the element properties in the metadata repository. UserNotAuthorizedException the requesting user is not authorized to issue this request.
-
deleteNoteLog
public VoidResponse deleteNoteLog(String serverName, String noteLogGUID, String viewServiceURLMarker, EffectiveTimeQueryRequestBody requestBody) Removes a note log from the repository. All the relationships to referenceables are lost.- Parameters:
serverName
- name of the server instances for this requestnoteLogGUID
- unique id for the note log.viewServiceURLMarker
- view service URL markerrequestBody
- optional effective time- Returns:
- void or InvalidParameterException - one of the parameters is invalid or PropertyServerException - there is a problem retrieving information from the property server(s) or UserNotAuthorizedException - the requesting user is not authorized to issue this request.
-
findNoteLogs
public NoteLogsResponse findNoteLogs(String serverName, int startFrom, int pageSize, boolean startsWith, boolean endsWith, boolean ignoreCase, String viewServiceURLMarker, FilterRequestBody requestBody) Retrieve the list of note log metadata elements that contain the search string. The search string is treated as a regular expression.- Parameters:
serverName
- name of the server to route the request tostartFrom
- paging start pointpageSize
- maximum results that can be returnedstartsWith
- does the value start with the supplied string?endsWith
- does the value end with the supplied string?ignoreCase
- should the search ignore case?viewServiceURLMarker
- view service URL markerrequestBody
- string to find in the properties- Returns:
- list of matching metadata elements or InvalidParameterException one of the parameters is invalid UserNotAuthorizedException the user is not authorized to issue this request PropertyServerException there is a problem reported in the open metadata server(s)
-
getNoteLogsByName
public NoteLogsResponse getNoteLogsByName(String serverName, int startFrom, int pageSize, String viewServiceURLMarker, FilterRequestBody requestBody) Retrieve the list of note log metadata elements with a matching qualified or display name. There are no wildcards supported on this request.- Parameters:
serverName
- name of the server instances for this requeststartFrom
- paging start pointpageSize
- maximum results that can be returnedviewServiceURLMarker
- view service URL markerrequestBody
- name to search for and correlators- Returns:
- list of matching metadata elements or InvalidParameterException one of the parameters is invalid UserNotAuthorizedException the user is not authorized to issue this request PropertyServerException there is a problem reported in the open metadata server(s)
-
getNoteLogsForElement
public NoteLogsResponse getNoteLogsForElement(String serverName, String elementGUID, int startFrom, int pageSize, String viewServiceURLMarker, EffectiveTimeQueryRequestBody requestBody) Retrieve the list of note log metadata elements attached to the element.- Parameters:
serverName
- name of the server instances for this requestelementGUID
- unique identifier of the note log of intereststartFrom
- paging start pointpageSize
- maximum results that can be returnedviewServiceURLMarker
- view service URL markerrequestBody
- optional effective time- Returns:
- list of associated metadata elements 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)
-
getNoteLogByGUID
public NoteLogResponse getNoteLogByGUID(String serverName, String noteLogGUID, String viewServiceURLMarker, EffectiveTimeQueryRequestBody requestBody) Retrieve the note log metadata element with the supplied unique identifier.- Parameters:
serverName
- name of the server instances for this requestnoteLogGUID
- unique identifier of the requested metadata elementviewServiceURLMarker
- view service URL markerrequestBody
- optional effective time- Returns:
- requested metadata element 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)
-
createNote
public GUIDResponse createNote(String serverName, String noteLogGUID, String viewServiceURLMarker, NoteProperties requestBody) Creates a new note for a note log and returns the unique identifier for it.- Parameters:
serverName
- name of the server instances for this requestnoteLogGUID
- unique identifier of the note logviewServiceURLMarker
- view service URL markerrequestBody
- contains the name of the tag and (optional) description of the tag- Returns:
- guid for new tag or InvalidParameterException - one of the parameters is invalid or PropertyServerException - there is a problem retrieving information from the property server(s) or UserNotAuthorizedException - the requesting user is not authorized to issue this request.
-
updateNote
public VoidResponse updateNote(String serverName, String noteGUID, boolean isMergeUpdate, String viewServiceURLMarker, ReferenceableUpdateRequestBody requestBody) Update an existing note.- Parameters:
serverName
- name of the server instances for this request.noteGUID
- unique identifier for the note to change.isMergeUpdate
- should the new properties be merged with existing properties (true) or completely replace them (false)?viewServiceURLMarker
- view service URL markerrequestBody
- containing type of comment enum and the text of the comment.- Returns:
- void or InvalidParameterException one of the parameters is null or invalid. PropertyServerException There is a problem updating the element properties in the metadata repository. UserNotAuthorizedException the requesting user is not authorized to issue this request.
-
deleteNote
public VoidResponse deleteNote(String serverName, String noteGUID, String viewServiceURLMarker, EffectiveTimeQueryRequestBody requestBody) Removes a note from the repository. All the relationships to referenceables are lost.- Parameters:
serverName
- name of the server instances for this requestnoteGUID
- unique id for the note .viewServiceURLMarker
- view service URL markerrequestBody
- optional effective time- Returns:
- void or InvalidParameterException - one of the parameters is invalid or PropertyServerException - there is a problem retrieving information from the property server(s) or UserNotAuthorizedException - the requesting user is not authorized to issue this request.
-
findNotes
public NotesResponse findNotes(String serverName, int startFrom, int pageSize, boolean startsWith, boolean endsWith, boolean ignoreCase, String viewServiceURLMarker, FilterRequestBody requestBody) Retrieve the list of note metadata elements that contain the search string. The search string is treated as a regular expression.- Parameters:
serverName
- name of the server to route the request tostartFrom
- paging start pointpageSize
- maximum results that can be returnedviewServiceURLMarker
- view service URL markerstartsWith
- does the value start with the supplied string?endsWith
- does the value end with the supplied string?ignoreCase
- should the search ignore case?requestBody
- string to find in the properties- Returns:
- list of matching metadata elements or InvalidParameterException one of the parameters is invalid UserNotAuthorizedException the user is not authorized to issue this request PropertyServerException there is a problem reported in the open metadata server(s)
-
getNotesForNoteLog
public NotesResponse getNotesForNoteLog(String serverName, String noteLogGUID, int startFrom, int pageSize, String viewServiceURLMarker, EffectiveTimeQueryRequestBody requestBody) Retrieve the list of notes associated with a note log.- Parameters:
serverName
- name of the server instances for this requestnoteLogGUID
- unique identifier of the note log of intereststartFrom
- paging start pointpageSize
- maximum results that can be returnedviewServiceURLMarker
- view service URL markerrequestBody
- optional effective time- Returns:
- list of associated metadata elements 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)
-
getNoteByGUID
public NoteResponse getNoteByGUID(String serverName, String noteGUID, String viewServiceURLMarker, EffectiveTimeQueryRequestBody requestBody) Retrieve the note metadata element with the supplied unique identifier.- Parameters:
serverName
- name of the server instances for this requestnoteGUID
- unique identifier of the requested metadata elementviewServiceURLMarker
- view service URL markerrequestBody
- optional effective time- Returns:
- matching metadata element 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)
-