Package org.odpi.openmetadata.accessservices.assetmanager.client.exchange

Class CollaborationExchangeClient

java.lang.Object
org.odpi.openmetadata.accessservices.assetmanager.client.AssetManagerBaseClient
org.odpi.openmetadata.accessservices.assetmanager.client.exchange.CollaborationExchangeClient
All Implemented Interfaces:
org.odpi.openmetadata.accessservices.assetmanager.api.exchange.CollaborationExchangeInterface
public class CollaborationExchangeClient extends AssetManagerBaseClient implements org.odpi.openmetadata.accessservices.assetmanager.api.exchange.CollaborationExchangeInterface
CollaborationExchangeClient is the client for managing comments, ratings, likes and tags.

  • Constructor Summary

    Constructors
    Constructor
    Description
    CollaborationExchangeClient(String serverName, String serverPlatformURLRoot)
    Create a new client with no authentication embedded in the HTTP request.
    CollaborationExchangeClient(String serverName, String serverPlatformURLRoot, String userId, String password)
    Create a new client that passes userId and password in each HTTP request.
    CollaborationExchangeClient(String serverName, String serverPlatformURLRoot, String userId, String password, org.odpi.openmetadata.frameworks.auditlog.AuditLog auditLog)
    Create a new client that passes userId and password in each HTTP request.
    CollaborationExchangeClient(String serverName, String serverPlatformURLRoot, AssetManagerRESTClient restClient, int maxPageSize, org.odpi.openmetadata.frameworks.auditlog.AuditLog auditLog)
    Create a new client that is going to be used in an OMAG Server.
    CollaborationExchangeClient(String serverName, String serverPlatformURLRoot, org.odpi.openmetadata.frameworks.auditlog.AuditLog auditLog)
    Create a new client with no authentication embedded in the HTTP request.

  • Method Summary

    Modifier and Type
    Method
    Description
    String
    addCommentReply(String userId, String assetManagerGUID, String assetManagerName, boolean assetManagerIsHome, String commentGUID, org.odpi.openmetadata.accessservices.assetmanager.properties.ExternalIdentifierProperties externalIdentifierProperties, boolean isPublic, org.odpi.openmetadata.accessservices.assetmanager.properties.CommentProperties properties, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)
    Adds a comment to another comment.
    String
    addCommentToElement(String userId, String assetManagerGUID, String assetManagerName, boolean assetManagerIsHome, String elementGUID, org.odpi.openmetadata.accessservices.assetmanager.properties.ExternalIdentifierProperties externalIdentifierProperties, boolean isPublic, org.odpi.openmetadata.accessservices.assetmanager.properties.CommentProperties properties, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)
    Adds a comment to the element.
    void
    addLikeToElement(String userId, String elementGUID, boolean isPublic)
    Adds a "LikeProperties" to the element.
    String
    addRatingToElement(String userId, String elementGUID, boolean isPublic, org.odpi.openmetadata.accessservices.assetmanager.properties.RatingProperties properties)
    Adds a star rating and optional review text to the element.
    void
    addTagToElement(String userId, String elementGUID, String tagGUID, boolean isPublic)
    Adds a tag (either private of public) to an element.
    void
    clearAcceptedAnswer(String userId, String assetManagerGUID, String assetManagerName, String questionCommentGUID, String answerCommentGUID, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)
    Unlink a comment that contains an answer to a question posed in another comment.
    String
    createInformalTag(String userId, org.odpi.openmetadata.accessservices.assetmanager.properties.TagProperties properties)
    Creates a new informal tag and returns the unique identifier for it.
    String
    createNote(String userId, String assetManagerGUID, String assetManagerName, boolean assetManagerIsHome, String noteLogGUID, org.odpi.openmetadata.accessservices.assetmanager.properties.ExternalIdentifierProperties externalIdentifierProperties, org.odpi.openmetadata.accessservices.assetmanager.properties.NoteProperties noteProperties, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)
    Create a new metadata element to represent a note.
    String
    createNoteLog(String userId, String assetManagerGUID, String assetManagerName, boolean assetManagerIsHome, String elementGUID, org.odpi.openmetadata.accessservices.assetmanager.properties.ExternalIdentifierProperties externalIdentifierProperties, org.odpi.openmetadata.accessservices.assetmanager.properties.NoteLogProperties noteLogProperties, boolean isPublic, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)
    Create a new metadata element to represent a note log and attach it to an element (if supplied).
    void
    deleteTag(String userId, String tagGUID)
    Removes a tag from the repository.
    List<org.odpi.openmetadata.accessservices.assetmanager.metadataelements.CommentElement>
    findComments(String userId, String assetManagerGUID, String assetManagerName, String searchString, int startFrom, int pageSize, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)
    Retrieve the list of comment metadata elements that contain the search string.
    List<org.odpi.openmetadata.accessservices.assetmanager.metadataelements.InformalTagElement>
    findMyTags(String userId, String tag, int startFrom, int pageSize)
    Return the list of the calling user's private tags containing the supplied string in either the name or description.
    List<org.odpi.openmetadata.accessservices.assetmanager.metadataelements.NoteLogElement>
    findNoteLogs(String userId, String assetManagerGUID, String assetManagerName, String searchString, int startFrom, int pageSize, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)
    Retrieve the list of note log metadata elements that contain the search string.
    List<org.odpi.openmetadata.accessservices.assetmanager.metadataelements.NoteElement>
    findNotes(String userId, String assetManagerGUID, String assetManagerName, String searchString, int startFrom, int pageSize, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)
    Retrieve the list of note metadata elements that contain the search string.
    List<org.odpi.openmetadata.accessservices.assetmanager.metadataelements.InformalTagElement>
    findTags(String userId, String tag, int startFrom, int pageSize)
    Return the list of tags containing the supplied string in either the name or description.
    List<org.odpi.openmetadata.accessservices.assetmanager.metadataelements.CommentElement>
    getAttachedComments(String userId, String assetManagerGUID, String assetManagerName, String elementGUID, int startFrom, int pageSize, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)
    Return the comments attached to an element.
    org.odpi.openmetadata.accessservices.assetmanager.metadataelements.CommentElement
    getComment(String userId, String assetManagerGUID, String assetManagerName, String commentGUID, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)
    Return the requested comment.
    List<String>
    getElementsByTag(String userId, String tagGUID, int startFrom, int pageSize)
    Return the list of unique identifiers for elements that are linked to a specific tag either directly, or via one of its schema elements.
    List<org.odpi.openmetadata.accessservices.assetmanager.metadataelements.InformalTagElement>
    getMyTagsByName(String userId, String tag, int startFrom, int pageSize)
    Return the list of the calling user's private tags exactly matching the supplied name.
    org.odpi.openmetadata.accessservices.assetmanager.metadataelements.NoteElement
    getNoteByGUID(String userId, String assetManagerGUID, String assetManagerName, String noteGUID, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)
    Retrieve the note metadata element with the supplied unique identifier.
    org.odpi.openmetadata.accessservices.assetmanager.metadataelements.NoteLogElement
    getNoteLogByGUID(String userId, String assetManagerGUID, String assetManagerName, String noteLogGUID, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)
    Retrieve the note log metadata element with the supplied unique identifier.
    List<org.odpi.openmetadata.accessservices.assetmanager.metadataelements.NoteLogElement>
    getNoteLogsByName(String userId, String assetManagerGUID, String assetManagerName, String name, int startFrom, int pageSize, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)
    Retrieve the list of note log metadata elements with a matching qualified or display name.
    List<org.odpi.openmetadata.accessservices.assetmanager.metadataelements.NoteLogElement>
    getNoteLogsForElement(String userId, String assetManagerGUID, String assetManagerName, String elementGUID, int startFrom, int pageSize, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)
    Retrieve the list of note log metadata elements attached to the element.
    List<org.odpi.openmetadata.accessservices.assetmanager.metadataelements.NoteElement>
    getNotesForNoteLog(String userId, String assetManagerGUID, String assetManagerName, String noteLogGUID, int startFrom, int pageSize, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)
    Retrieve the list of notes associated with a note log.
    org.odpi.openmetadata.accessservices.assetmanager.metadataelements.InformalTagElement
    getTag(String userId, String tagGUID)
    Return the tag for the supplied unique identifier (guid).
    List<org.odpi.openmetadata.accessservices.assetmanager.metadataelements.InformalTagElement>
    getTagsByName(String userId, String tag, int startFrom, int pageSize)
    Return the list of tags exactly matching the supplied name.
    void
    removeComment(String userId, String assetManagerGUID, String assetManagerName, String commentGUID, String externalIdentifier, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)
    Removes a comment added to the element.
    void
    removeLikeFromElement(String userId, String elementGUID)
    Removes a "LikeProperties" added to the element by this user.
    void
    removeNote(String userId, String assetManagerGUID, String assetManagerName, String noteGUID, String noteExternalIdentifier, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)
    Remove the metadata element representing a note.
    void
    removeNoteLog(String userId, String assetManagerGUID, String assetManagerName, String noteLogGUID, String noteLogExternalIdentifier, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)
    Remove the metadata element representing a note log.
    void
    removeRatingFromElement(String userId, String elementGUID)
    Removes of a review that was added to the element by this user.
    void
    removeTagFromElement(String userId, String elementGUID, String tagGUID)
    Removes a tag from the element that was added by this user.
    void
    setupAcceptedAnswer(String userId, String assetManagerGUID, String assetManagerName, String questionCommentGUID, String answerCommentGUID, org.odpi.openmetadata.accessservices.assetmanager.properties.FeedbackProperties properties, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)
    Link a comment that contains the best answer to a question posed in another comment.
    void
    updateComment(String userId, String assetManagerGUID, String assetManagerName, String commentGUID, String externalIdentifier, boolean isMergeUpdate, boolean isPublic, org.odpi.openmetadata.accessservices.assetmanager.properties.CommentProperties properties, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)
    Update an existing comment.
    void
    updateNote(String userId, String assetManagerGUID, String assetManagerName, String noteGUID, String noteExternalIdentifier, boolean isMergeUpdate, org.odpi.openmetadata.accessservices.assetmanager.properties.NoteProperties noteProperties, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)
    Update the properties of the metadata element representing a note.
    void
    updateNoteLog(String userId, String assetManagerGUID, String assetManagerName, String noteLogGUID, String noteLogExternalIdentifier, boolean isMergeUpdate, boolean isPublic, org.odpi.openmetadata.accessservices.assetmanager.properties.NoteLogProperties noteLogProperties, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing)
    Update the metadata element representing a note log.
    void
    updateTagDescription(String userId, String tagGUID, String tagDescription)
    Updates the description of an existing tag (either private or public).

    Methods inherited from class java.lang.Object

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

  • Constructor Details

    • CollaborationExchangeClient

      public CollaborationExchangeClient(String serverName, String serverPlatformURLRoot, org.odpi.openmetadata.frameworks.auditlog.AuditLog auditLog) throws org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException
      Create a new client with no authentication embedded in the HTTP request.
      Parameters:
      serverName - name of the server to connect to
      serverPlatformURLRoot - the network address of the server running the OMAS REST services
      auditLog - logging destination
      Throws:
      org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException - there is a problem creating the client-side components to issue any REST API calls.

    • CollaborationExchangeClient

      public CollaborationExchangeClient(String serverName, String serverPlatformURLRoot) throws org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException
      Create a new client with no authentication embedded in the HTTP request.
      Parameters:
      serverName - name of the server to connect to
      serverPlatformURLRoot - the network address of the server running the OMAS REST services
      Throws:
      org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException - there is a problem creating the client-side components to issue any REST API calls.

    • CollaborationExchangeClient

      public CollaborationExchangeClient(String serverName, String serverPlatformURLRoot, String userId, String password, org.odpi.openmetadata.frameworks.auditlog.AuditLog auditLog) throws org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException
      Create a new client that passes userId and password in each HTTP request. This is the userId/password of the calling server. The end user's userId is sent on each request.
      Parameters:
      serverName - name of the server to connect to
      serverPlatformURLRoot - the network address of the server running the OMAS REST services
      userId - caller's userId embedded in all HTTP requests
      password - caller's userId embedded in all HTTP requests
      auditLog - logging destination
      Throws:
      org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException - there is a problem creating the client-side components to issue any REST API calls.

    • CollaborationExchangeClient

      public CollaborationExchangeClient(String serverName, String serverPlatformURLRoot, AssetManagerRESTClient restClient, int maxPageSize, org.odpi.openmetadata.frameworks.auditlog.AuditLog auditLog) throws org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException
      Create a new client that is going to be used in an OMAG Server.
      Parameters:
      serverName - name of the server to connect to
      serverPlatformURLRoot - the network address of the server running the OMAS REST services
      restClient - client that issues the REST API calls
      maxPageSize - maximum number of results supported by this server
      auditLog - logging destination
      Throws:
      org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException - there is a problem creating the client-side components to issue any REST API calls.

    • CollaborationExchangeClient

      public CollaborationExchangeClient(String serverName, String serverPlatformURLRoot, String userId, String password) throws org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException
      Create a new client that passes userId and password in each HTTP request. This is the userId/password of the calling server. The end user's userId is sent on each request.
      Parameters:
      serverName - name of the server to connect to
      serverPlatformURLRoot - the network address of the server running the OMAS REST services
      userId - caller's userId embedded in all HTTP requests
      password - caller's userId embedded in all HTTP requests
      Throws:
      org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException - there is a problem creating the client-side components to issue any REST API calls.

  • Method Details

    • addRatingToElement

      public String addRatingToElement(String userId, String elementGUID, boolean isPublic, org.odpi.openmetadata.accessservices.assetmanager.properties.RatingProperties properties) throws org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException, org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException, org.odpi.openmetadata.frameworks.connectors.ffdc.UserNotAuthorizedException
      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.
      Specified by:
      addRatingToElement in interface org.odpi.openmetadata.accessservices.assetmanager.api.exchange.CollaborationExchangeInterface
      Parameters:
      userId - userId of user making request.
      elementGUID - unique identifier for the element.
      isPublic - is this visible to other people
      properties - properties of the rating
      Returns:
      unique identifier of the rating
      Throws:
      org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException - one of the parameters is null or invalid.
      org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException - there is a problem adding the element properties to the property server.
      org.odpi.openmetadata.frameworks.connectors.ffdc.UserNotAuthorizedException - the requesting user is not authorized to issue this request.

    • removeRatingFromElement

      public void removeRatingFromElement(String userId, String elementGUID) throws org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException, org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException, org.odpi.openmetadata.frameworks.connectors.ffdc.UserNotAuthorizedException
      Removes of a review that was added to the element by this user.
      Specified by:
      removeRatingFromElement in interface org.odpi.openmetadata.accessservices.assetmanager.api.exchange.CollaborationExchangeInterface
      Parameters:
      userId - userId of user making request.
      elementGUID - unique identifier for the attached element.
      Throws:
      org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException - one of the parameters is null or invalid.
      org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException - there is a problem updating the element properties in the property server.
      org.odpi.openmetadata.frameworks.connectors.ffdc.UserNotAuthorizedException - the requesting user is not authorized to issue this request.

    • addLikeToElement

      public void addLikeToElement(String userId, String elementGUID, boolean isPublic) throws org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException, org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException, org.odpi.openmetadata.frameworks.connectors.ffdc.UserNotAuthorizedException
      Adds a "LikeProperties" to the element.
      Specified by:
      addLikeToElement in interface org.odpi.openmetadata.accessservices.assetmanager.api.exchange.CollaborationExchangeInterface
      Parameters:
      userId - userId of user making request
      elementGUID - unique identifier for the element
      isPublic - is this visible to other people
      Throws:
      org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException - one of the parameters is null or invalid.
      org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException - there is a problem adding the element properties to the property server.
      org.odpi.openmetadata.frameworks.connectors.ffdc.UserNotAuthorizedException - the requesting user is not authorized to issue this request.

    • removeLikeFromElement

      public void removeLikeFromElement(String userId, String elementGUID) throws org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException, org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException, org.odpi.openmetadata.frameworks.connectors.ffdc.UserNotAuthorizedException
      Removes a "LikeProperties" added to the element by this user.
      Specified by:
      removeLikeFromElement in interface org.odpi.openmetadata.accessservices.assetmanager.api.exchange.CollaborationExchangeInterface
      Parameters:
      userId - userId of user making request.
      elementGUID - unique identifier for the like object.
      Throws:
      org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException - one of the parameters is null or invalid.
      org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException - there is a problem updating the element properties in the property server.
      org.odpi.openmetadata.frameworks.connectors.ffdc.UserNotAuthorizedException - the requesting user is not authorized to issue this request.

    • addCommentToElement

      public String addCommentToElement(String userId, String assetManagerGUID, String assetManagerName, boolean assetManagerIsHome, String elementGUID, org.odpi.openmetadata.accessservices.assetmanager.properties.ExternalIdentifierProperties externalIdentifierProperties, boolean isPublic, org.odpi.openmetadata.accessservices.assetmanager.properties.CommentProperties properties, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing) throws org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException, org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException, org.odpi.openmetadata.frameworks.connectors.ffdc.UserNotAuthorizedException
      Adds a comment to the element.
      Specified by:
      addCommentToElement in interface org.odpi.openmetadata.accessservices.assetmanager.api.exchange.CollaborationExchangeInterface
      Parameters:
      userId - userId of user making request.
      assetManagerGUID - unique identifier of software capability representing the caller
      assetManagerName - unique name of software capability representing the caller
      assetManagerIsHome - ensure that only the asset manager can update this element
      elementGUID - unique identifier for the element.
      externalIdentifierProperties - optional properties used to define an external identifier for the comment.
      isPublic - is this comment visible to other people.
      properties - properties of the comment
      effectiveTime - the time that the retrieved elements must be effective for
      forLineage - return elements marked with the Memento classification?
      forDuplicateProcessing - do not merge elements marked as duplicates?
      Returns:
      guid of new comment.
      Throws:
      org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException - one of the parameters is null or invalid.
      org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException - there is a problem adding the element properties to the property server.
      org.odpi.openmetadata.frameworks.connectors.ffdc.UserNotAuthorizedException - the requesting user is not authorized to issue this request.

    • addCommentReply

      public String addCommentReply(String userId, String assetManagerGUID, String assetManagerName, boolean assetManagerIsHome, String commentGUID, org.odpi.openmetadata.accessservices.assetmanager.properties.ExternalIdentifierProperties externalIdentifierProperties, boolean isPublic, org.odpi.openmetadata.accessservices.assetmanager.properties.CommentProperties properties, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing) throws org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException, org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException, org.odpi.openmetadata.frameworks.connectors.ffdc.UserNotAuthorizedException
      Adds a comment to another comment.
      Specified by:
      addCommentReply in interface org.odpi.openmetadata.accessservices.assetmanager.api.exchange.CollaborationExchangeInterface
      Parameters:
      userId - userId of user making request.
      assetManagerGUID - unique identifier of software capability representing the caller
      assetManagerName - unique name of software capability representing the caller
      assetManagerIsHome - ensure that only the asset manager can update this element
      commentGUID - unique identifier for an existing comment. Used to add a reply to a comment.
      externalIdentifierProperties - optional properties used to define an external identifier for the comment.
      properties - properties of the comment
      effectiveTime - the time that the retrieved elements must be effective for
      forLineage - return elements marked with the Memento classification?
      forDuplicateProcessing - do not merge elements marked as duplicates?
      Returns:
      guid of new comment.
      Throws:
      org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException - one of the parameters is null or invalid.
      org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException - there is a problem adding the element properties to the property server.
      org.odpi.openmetadata.frameworks.connectors.ffdc.UserNotAuthorizedException - the requesting user is not authorized to issue this request.

    • updateComment

      public void updateComment(String userId, String assetManagerGUID, String assetManagerName, String commentGUID, String externalIdentifier, boolean isMergeUpdate, boolean isPublic, org.odpi.openmetadata.accessservices.assetmanager.properties.CommentProperties properties, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing) throws org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException, org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException, org.odpi.openmetadata.frameworks.connectors.ffdc.UserNotAuthorizedException
      Update an existing comment.
      Specified by:
      updateComment in interface org.odpi.openmetadata.accessservices.assetmanager.api.exchange.CollaborationExchangeInterface
      Parameters:
      userId - userId of user making request.
      assetManagerGUID - unique identifier of software capability representing the caller
      assetManagerName - unique name of software capability representing the caller
      commentGUID - unique identifier for the comment to change.
      externalIdentifier - unique identifier of the comment in the external asset manager
      isMergeUpdate - should the new properties be merged with existing properties (true) or completely replace them (false)?
      isPublic - is this visible to other people
      properties - properties of the comment
      effectiveTime - the time that the retrieved elements must be effective for
      forLineage - return elements marked with the Memento classification?
      forDuplicateProcessing - do not merge elements marked as duplicates?
      Throws:
      org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException - one of the parameters is null or invalid.
      org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException - there is a problem adding the element properties to the property server.
      org.odpi.openmetadata.frameworks.connectors.ffdc.UserNotAuthorizedException - the requesting user is not authorized to issue this request.

    • setupAcceptedAnswer

      public void setupAcceptedAnswer(String userId, String assetManagerGUID, String assetManagerName, String questionCommentGUID, String answerCommentGUID, org.odpi.openmetadata.accessservices.assetmanager.properties.FeedbackProperties properties, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing) throws org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException, org.odpi.openmetadata.frameworks.connectors.ffdc.UserNotAuthorizedException, org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException
      Link a comment that contains the best answer to a question posed in another comment.
      Specified by:
      setupAcceptedAnswer in interface org.odpi.openmetadata.accessservices.assetmanager.api.exchange.CollaborationExchangeInterface
      Parameters:
      userId - calling user
      assetManagerGUID - unique identifier of software capability representing the caller
      assetManagerName - unique name of software capability representing the caller
      questionCommentGUID - unique identifier of the comment containing the question
      answerCommentGUID - unique identifier of the comment containing the accepted answer
      properties - is this visible to other people
      effectiveTime - the time that the retrieved elements must be effective for
      forLineage - return elements marked with the Memento classification?
      forDuplicateProcessing - do not merge elements marked as duplicates?
      Throws:
      org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException - one of the parameters is invalid
      org.odpi.openmetadata.frameworks.connectors.ffdc.UserNotAuthorizedException - the user is not authorized to issue this request
      org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException - there is a problem reported in the open metadata server(s)

    • clearAcceptedAnswer

      public void clearAcceptedAnswer(String userId, String assetManagerGUID, String assetManagerName, String questionCommentGUID, String answerCommentGUID, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing) throws org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException, org.odpi.openmetadata.frameworks.connectors.ffdc.UserNotAuthorizedException, org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException
      Unlink a comment that contains an answer to a question posed in another comment.
      Specified by:
      clearAcceptedAnswer in interface org.odpi.openmetadata.accessservices.assetmanager.api.exchange.CollaborationExchangeInterface
      Parameters:
      userId - calling user
      assetManagerGUID - unique identifier of software capability representing the caller
      assetManagerName - unique name of software capability representing the caller
      questionCommentGUID - unique identifier of the comment containing the question
      answerCommentGUID - unique identifier of the comment containing the accepted answer
      effectiveTime - the time that the retrieved elements must be effective for
      forLineage - return elements marked with the Memento classification?
      forDuplicateProcessing - do not merge elements marked as duplicates?
      Throws:
      org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException - one of the parameters is invalid
      org.odpi.openmetadata.frameworks.connectors.ffdc.UserNotAuthorizedException - the user is not authorized to issue this request
      org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException - there is a problem reported in the open metadata server(s)

    • removeComment

      public void removeComment(String userId, String assetManagerGUID, String assetManagerName, String commentGUID, String externalIdentifier, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing) throws org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException, org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException, org.odpi.openmetadata.frameworks.connectors.ffdc.UserNotAuthorizedException
      Removes a comment added to the element.
      Specified by:
      removeComment in interface org.odpi.openmetadata.accessservices.assetmanager.api.exchange.CollaborationExchangeInterface
      Parameters:
      userId - userId of user making request.
      assetManagerGUID - unique identifier of software capability representing the caller
      assetManagerName - unique name of software capability representing the caller
      commentGUID - unique identifier for the comment object.
      externalIdentifier - unique identifier of the comment in the external asset manager
      effectiveTime - the time that the retrieved elements must be effective for
      forLineage - return elements marked with the Memento classification?
      forDuplicateProcessing - do not merge elements marked as duplicates?
      Throws:
      org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException - one of the parameters is null or invalid.
      org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException - there is a problem updating the element properties in the property server.
      org.odpi.openmetadata.frameworks.connectors.ffdc.UserNotAuthorizedException - the user does not have permission to perform this request.

    • getComment

      public org.odpi.openmetadata.accessservices.assetmanager.metadataelements.CommentElement getComment(String userId, String assetManagerGUID, String assetManagerName, String commentGUID, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing) throws org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException, org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException, org.odpi.openmetadata.frameworks.connectors.ffdc.UserNotAuthorizedException
      Return the requested comment.
      Specified by:
      getComment in interface org.odpi.openmetadata.accessservices.assetmanager.api.exchange.CollaborationExchangeInterface
      Parameters:
      userId - userId of user making request.
      assetManagerGUID - unique identifier of software capability representing the caller
      assetManagerName - unique name of software capability representing the caller
      commentGUID - unique identifier for the comment object.
      effectiveTime - the time that the retrieved elements must be effective for
      forLineage - return elements marked with the Memento classification?
      forDuplicateProcessing - do not merge elements marked as duplicates?
      Returns:
      comment properties
      Throws:
      org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException - one of the parameters is null or invalid.
      org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException - there is a problem updating the element properties in the property server.
      org.odpi.openmetadata.frameworks.connectors.ffdc.UserNotAuthorizedException - the user does not have permission to perform this request.

    • getAttachedComments

      public List<org.odpi.openmetadata.accessservices.assetmanager.metadataelements.CommentElement> getAttachedComments(String userId, String assetManagerGUID, String assetManagerName, String elementGUID, int startFrom, int pageSize, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing) throws org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException, org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException, org.odpi.openmetadata.frameworks.connectors.ffdc.UserNotAuthorizedException
      Return the comments attached to an element.
      Specified by:
      getAttachedComments in interface org.odpi.openmetadata.accessservices.assetmanager.api.exchange.CollaborationExchangeInterface
      Parameters:
      userId - userId of user making request.
      assetManagerGUID - unique identifier of software capability representing the caller
      assetManagerName - unique name of software capability representing the caller
      elementGUID - 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.
      effectiveTime - the time that the retrieved elements must be effective for
      forLineage - return elements marked with the Memento classification?
      forDuplicateProcessing - do not merge elements marked as duplicates?
      Returns:
      list of comments
      Throws:
      org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException - one of the parameters is null or invalid.
      org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException - there is a problem updating the element properties in the property server.
      org.odpi.openmetadata.frameworks.connectors.ffdc.UserNotAuthorizedException - the user does not have permission to perform this request.

    • findComments

      public List<org.odpi.openmetadata.accessservices.assetmanager.metadataelements.CommentElement> findComments(String userId, String assetManagerGUID, String assetManagerName, String searchString, int startFrom, int pageSize, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing) throws org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException, org.odpi.openmetadata.frameworks.connectors.ffdc.UserNotAuthorizedException, org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException
      Retrieve the list of comment metadata elements that contain the search string. The search string is treated as a regular expression.
      Specified by:
      findComments in interface org.odpi.openmetadata.accessservices.assetmanager.api.exchange.CollaborationExchangeInterface
      Parameters:
      userId - calling user
      assetManagerGUID - unique identifier of software capability representing the caller
      assetManagerName - unique name of software capability representing the caller
      searchString - string to find in the properties
      startFrom - paging start point
      pageSize - maximum results that can be returned
      effectiveTime - the time that the retrieved elements must be effective for
      forLineage - return elements marked with the Memento classification?
      forDuplicateProcessing - do not merge elements marked as duplicates?
      Returns:
      list of matching metadata elements
      Throws:
      org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException - one of the parameters is invalid
      org.odpi.openmetadata.frameworks.connectors.ffdc.UserNotAuthorizedException - the user is not authorized to issue this request
      org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException - there is a problem reported in the open metadata server(s)

    • createInformalTag

      public String createInformalTag(String userId, org.odpi.openmetadata.accessservices.assetmanager.properties.TagProperties properties) throws org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException, org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException, org.odpi.openmetadata.frameworks.connectors.ffdc.UserNotAuthorizedException
      Creates a new informal tag and returns the unique identifier for it.
      Specified by:
      createInformalTag in interface org.odpi.openmetadata.accessservices.assetmanager.api.exchange.CollaborationExchangeInterface
      Parameters:
      userId - userId of user making request.
      properties - name of the tag and (optional) description. Setting a description, particularly in a public tag makes the tag more valuable to other users and can act as an embryonic note.
      Returns:
      GUID for new tag.
      Throws:
      org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException - one of the parameters is null or invalid.
      org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException - there is a problem adding the element properties to the property server.
      org.odpi.openmetadata.frameworks.connectors.ffdc.UserNotAuthorizedException - the requesting user is not authorized to issue this request.

    • updateTagDescription

      public void updateTagDescription(String userId, String tagGUID, String tagDescription) throws org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException, org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException, org.odpi.openmetadata.frameworks.connectors.ffdc.UserNotAuthorizedException
      Updates the description of an existing tag (either private or public).
      Specified by:
      updateTagDescription in interface org.odpi.openmetadata.accessservices.assetmanager.api.exchange.CollaborationExchangeInterface
      Parameters:
      userId - userId of user making request.
      tagGUID - unique identifier for the tag.
      tagDescription - description of the tag. Setting a description, particularly in a public tag makes the tag more valuable to other users and can act as an embryonic glossary term.
      Throws:
      org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException - one of the parameters is null or invalid.
      org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException - there is a problem adding the element properties to the property server.
      org.odpi.openmetadata.frameworks.connectors.ffdc.UserNotAuthorizedException - the requesting user is not authorized to issue this request.

    • deleteTag

      public void deleteTag(String userId, String tagGUID) throws org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException, org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException, org.odpi.openmetadata.frameworks.connectors.ffdc.UserNotAuthorizedException
      Removes a tag from the repository. A private tag can be deleted by its creator and all the references are lost; a public tag can be deleted by anyone, but only if it is not attached to any referenceable.
      Specified by:
      deleteTag in interface org.odpi.openmetadata.accessservices.assetmanager.api.exchange.CollaborationExchangeInterface
      Parameters:
      userId - userId of user making request.
      tagGUID - unique id for the tag.
      Throws:
      org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException - one of the parameters is null or invalid.
      org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException - there is a problem updating the element properties in the property server.
      org.odpi.openmetadata.frameworks.connectors.ffdc.UserNotAuthorizedException - the requesting user is not authorized to issue this request.

    • getTag

      public org.odpi.openmetadata.accessservices.assetmanager.metadataelements.InformalTagElement getTag(String userId, String tagGUID) throws org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException, org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException, org.odpi.openmetadata.frameworks.connectors.ffdc.UserNotAuthorizedException
      Return the tag for the supplied unique identifier (guid).
      Specified by:
      getTag in interface org.odpi.openmetadata.accessservices.assetmanager.api.exchange.CollaborationExchangeInterface
      Parameters:
      userId - userId of the user making the request.
      tagGUID - unique identifier of the tag.
      Returns:
      tag
      Throws:
      org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException - the userId is null or invalid.
      org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException - there is a problem retrieving information from the property server(s).
      org.odpi.openmetadata.frameworks.connectors.ffdc.UserNotAuthorizedException - the requesting user is not authorized to issue this request.

    • getTagsByName

      public List<org.odpi.openmetadata.accessservices.assetmanager.metadataelements.InformalTagElement> getTagsByName(String userId, String tag, int startFrom, int pageSize) throws org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException, org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException, org.odpi.openmetadata.frameworks.connectors.ffdc.UserNotAuthorizedException
      Return the list of tags exactly matching the supplied name.
      Specified by:
      getTagsByName in interface org.odpi.openmetadata.accessservices.assetmanager.api.exchange.CollaborationExchangeInterface
      Parameters:
      userId - the name of the calling user.
      tag - name of tag.
      startFrom - index of the list to start from (0 for start)
      pageSize - maximum number of elements to return.
      Returns:
      tag list
      Throws:
      org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException - the userId is null or invalid.
      org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException - there is a problem retrieving information from the property server(s).
      org.odpi.openmetadata.frameworks.connectors.ffdc.UserNotAuthorizedException - the requesting user is not authorized to issue this request.

    • getMyTagsByName

      public List<org.odpi.openmetadata.accessservices.assetmanager.metadataelements.InformalTagElement> getMyTagsByName(String userId, String tag, int startFrom, int pageSize) throws org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException, org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException, org.odpi.openmetadata.frameworks.connectors.ffdc.UserNotAuthorizedException
      Return the list of the calling user's private tags exactly matching the supplied name.
      Specified by:
      getMyTagsByName in interface org.odpi.openmetadata.accessservices.assetmanager.api.exchange.CollaborationExchangeInterface
      Parameters:
      userId - the name of the calling user.
      tag - name of tag.
      startFrom - index of the list to start from (0 for start)
      pageSize - maximum number of elements to return.
      Returns:
      tag list
      Throws:
      org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException - the userId is null or invalid.
      org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException - there is a problem retrieving information from the property server(s).
      org.odpi.openmetadata.frameworks.connectors.ffdc.UserNotAuthorizedException - the requesting user is not authorized to issue this request.

    • findTags

      public List<org.odpi.openmetadata.accessservices.assetmanager.metadataelements.InformalTagElement> findTags(String userId, String tag, int startFrom, int pageSize) throws org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException, org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException, org.odpi.openmetadata.frameworks.connectors.ffdc.UserNotAuthorizedException
      Return the list of tags containing the supplied string in either the name or description.
      Specified by:
      findTags in interface org.odpi.openmetadata.accessservices.assetmanager.api.exchange.CollaborationExchangeInterface
      Parameters:
      userId - the name of the calling user.
      tag - name of tag. This may include wild card characters.
      startFrom - index of the list to start from (0 for start)
      pageSize - maximum number of elements to return.
      Returns:
      tag list
      Throws:
      org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException - the userId is null or invalid.
      org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException - there is a problem retrieving information from the property server(s).
      org.odpi.openmetadata.frameworks.connectors.ffdc.UserNotAuthorizedException - the requesting user is not authorized to issue this request.

    • findMyTags

      public List<org.odpi.openmetadata.accessservices.assetmanager.metadataelements.InformalTagElement> findMyTags(String userId, String tag, int startFrom, int pageSize) throws org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException, org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException, org.odpi.openmetadata.frameworks.connectors.ffdc.UserNotAuthorizedException
      Return the list of the calling user's private tags containing the supplied string in either the name or description.
      Specified by:
      findMyTags in interface org.odpi.openmetadata.accessservices.assetmanager.api.exchange.CollaborationExchangeInterface
      Parameters:
      userId - the name of the calling user.
      tag - name of tag. This may include wild card characters.
      startFrom - index of the list to start from (0 for start)
      pageSize - maximum number of elements to return.
      Returns:
      tag list
      Throws:
      org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException - the userId is null or invalid.
      org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException - there is a problem retrieving information from the property server(s).
      org.odpi.openmetadata.frameworks.connectors.ffdc.UserNotAuthorizedException - the requesting user is not authorized to issue this request.

    • addTagToElement

      public void addTagToElement(String userId, String elementGUID, String tagGUID, boolean isPublic) throws org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException, org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException, org.odpi.openmetadata.frameworks.connectors.ffdc.UserNotAuthorizedException
      Adds a tag (either private of public) to an element.
      Specified by:
      addTagToElement in interface org.odpi.openmetadata.accessservices.assetmanager.api.exchange.CollaborationExchangeInterface
      Parameters:
      userId - userId of user making request.
      elementGUID - unique id for the element.
      tagGUID - unique id of the tag.
      isPublic - flag indicating whether the attachment of the tag is public or not
      Throws:
      org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException - one of the parameters is null or invalid.
      org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException - there is a problem adding the element properties to the property server.
      org.odpi.openmetadata.frameworks.connectors.ffdc.UserNotAuthorizedException - the requesting user is not authorized to issue this request.

    • removeTagFromElement

      public void removeTagFromElement(String userId, String elementGUID, String tagGUID) throws org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException, org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException, org.odpi.openmetadata.frameworks.connectors.ffdc.UserNotAuthorizedException
      Removes a tag from the element that was added by this user.
      Specified by:
      removeTagFromElement in interface org.odpi.openmetadata.accessservices.assetmanager.api.exchange.CollaborationExchangeInterface
      Parameters:
      userId - userId of user making request.
      elementGUID - unique id for the element.
      tagGUID - unique id for the tag.
      Throws:
      org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException - one of the parameters is null or invalid.
      org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException - there is a problem updating the element properties in the property server.
      org.odpi.openmetadata.frameworks.connectors.ffdc.UserNotAuthorizedException - the requesting user is not authorized to issue this request.

    • getElementsByTag

      public List<String> getElementsByTag(String userId, String tagGUID, int startFrom, int pageSize) throws org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException, org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException, org.odpi.openmetadata.frameworks.connectors.ffdc.UserNotAuthorizedException
      Return the list of unique identifiers for elements that are linked to a specific tag either directly, or via one of its schema elements. An Element's GUID may appear multiple times in the results if it is tagged multiple times with the requested tag.
      Specified by:
      getElementsByTag in interface org.odpi.openmetadata.accessservices.assetmanager.api.exchange.CollaborationExchangeInterface
      Parameters:
      userId - the name of the calling user.
      tagGUID - unique identifier of tag.
      startFrom - index of the list to start from (0 for start)
      pageSize - maximum number of elements to return.
      Returns:
      element guid list
      Throws:
      org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException - the userId is null or invalid.
      org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException - there is a problem retrieving information from the property server(s).
      org.odpi.openmetadata.frameworks.connectors.ffdc.UserNotAuthorizedException - the requesting user is not authorized to issue this request.

    • createNoteLog

      public String createNoteLog(String userId, String assetManagerGUID, String assetManagerName, boolean assetManagerIsHome, String elementGUID, org.odpi.openmetadata.accessservices.assetmanager.properties.ExternalIdentifierProperties externalIdentifierProperties, org.odpi.openmetadata.accessservices.assetmanager.properties.NoteLogProperties noteLogProperties, boolean isPublic, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing) throws org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException, org.odpi.openmetadata.frameworks.connectors.ffdc.UserNotAuthorizedException, org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException
      Create a new metadata element to represent a note log and attach it to an element (if supplied). Any supplied element becomes the note log's anchor, causing the note log to be deleted if/when the element is deleted.
      Specified by:
      createNoteLog in interface org.odpi.openmetadata.accessservices.assetmanager.api.exchange.CollaborationExchangeInterface
      Parameters:
      userId - calling user
      assetManagerGUID - unique identifier of software capability representing the caller
      assetManagerName - unique name of software capability representing the caller
      assetManagerIsHome - ensure that only the asset manager can update this element
      elementGUID - unique identifier of the element where the note log is located
      externalIdentifierProperties - optional properties used to define an external identifier for the note log
      noteLogProperties - properties about the note log to store
      isPublic - is this element visible to other people.
      effectiveTime - the time that the retrieved elements must be effective for
      forLineage - return elements marked with the Memento classification?
      forDuplicateProcessing - do not merge elements marked as duplicates?
      Returns:
      unique identifier of the new note log
      Throws:
      org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException - one of the parameters is invalid
      org.odpi.openmetadata.frameworks.connectors.ffdc.UserNotAuthorizedException - the user is not authorized to issue this request
      org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException - there is a problem reported in the open metadata server(s)

    • updateNoteLog

      public void updateNoteLog(String userId, String assetManagerGUID, String assetManagerName, String noteLogGUID, String noteLogExternalIdentifier, boolean isMergeUpdate, boolean isPublic, org.odpi.openmetadata.accessservices.assetmanager.properties.NoteLogProperties noteLogProperties, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing) throws org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException, org.odpi.openmetadata.frameworks.connectors.ffdc.UserNotAuthorizedException, org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException
      Update the metadata element representing a note log.
      Specified by:
      updateNoteLog in interface org.odpi.openmetadata.accessservices.assetmanager.api.exchange.CollaborationExchangeInterface
      Parameters:
      userId - calling user
      assetManagerGUID - unique identifier of software capability representing the caller
      assetManagerName - unique name of software capability representing the caller
      noteLogGUID - unique identifier of the metadata element to update
      noteLogExternalIdentifier - unique identifier of the note log in the external asset manager
      isMergeUpdate - should the new properties be merged with existing properties (true) or completely replace them (false)?
      isPublic - is this element visible to other people.
      noteLogProperties - new properties for the metadata element
      effectiveTime - the time that the retrieved elements must be effective for
      forLineage - return elements marked with the Memento classification?
      forDuplicateProcessing - do not merge elements marked as duplicates?
      Throws:
      org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException - one of the parameters is invalid
      org.odpi.openmetadata.frameworks.connectors.ffdc.UserNotAuthorizedException - the user is not authorized to issue this request
      org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException - there is a problem reported in the open metadata server(s)

    • removeNoteLog

      public void removeNoteLog(String userId, String assetManagerGUID, String assetManagerName, String noteLogGUID, String noteLogExternalIdentifier, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing) throws org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException, org.odpi.openmetadata.frameworks.connectors.ffdc.UserNotAuthorizedException, org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException
      Remove the metadata element representing a note log.
      Specified by:
      removeNoteLog in interface org.odpi.openmetadata.accessservices.assetmanager.api.exchange.CollaborationExchangeInterface
      Parameters:
      userId - calling user
      assetManagerGUID - unique identifier of software capability representing the caller
      assetManagerName - unique name of software capability representing the caller
      noteLogGUID - unique identifier of the metadata element to remove
      noteLogExternalIdentifier - unique identifier of the note log in the external asset manager
      effectiveTime - the time that the retrieved elements must be effective for
      forLineage - return elements marked with the Memento classification?
      forDuplicateProcessing - do not merge elements marked as duplicates?
      Throws:
      org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException - one of the parameters is invalid
      org.odpi.openmetadata.frameworks.connectors.ffdc.UserNotAuthorizedException - the user is not authorized to issue this request
      org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException - there is a problem reported in the open metadata server(s)

    • findNoteLogs

      public List<org.odpi.openmetadata.accessservices.assetmanager.metadataelements.NoteLogElement> findNoteLogs(String userId, String assetManagerGUID, String assetManagerName, String searchString, int startFrom, int pageSize, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing) throws org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException, org.odpi.openmetadata.frameworks.connectors.ffdc.UserNotAuthorizedException, org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException
      Retrieve the list of note log metadata elements that contain the search string. The search string is treated as a regular expression.
      Specified by:
      findNoteLogs in interface org.odpi.openmetadata.accessservices.assetmanager.api.exchange.CollaborationExchangeInterface
      Parameters:
      userId - calling user
      assetManagerGUID - unique identifier of software capability representing the caller
      assetManagerName - unique name of software capability representing the caller
      searchString - string to find in the properties
      startFrom - paging start point
      pageSize - maximum results that can be returned
      effectiveTime - the time that the retrieved elements must be effective for
      forLineage - return elements marked with the Memento classification?
      forDuplicateProcessing - do not merge elements marked as duplicates?
      Returns:
      list of matching metadata elements
      Throws:
      org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException - one of the parameters is invalid
      org.odpi.openmetadata.frameworks.connectors.ffdc.UserNotAuthorizedException - the user is not authorized to issue this request
      org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException - there is a problem reported in the open metadata server(s)

    • getNoteLogsByName

      public List<org.odpi.openmetadata.accessservices.assetmanager.metadataelements.NoteLogElement> getNoteLogsByName(String userId, String assetManagerGUID, String assetManagerName, String name, int startFrom, int pageSize, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing) throws org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException, org.odpi.openmetadata.frameworks.connectors.ffdc.UserNotAuthorizedException, org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException
      Retrieve the list of note log metadata elements with a matching qualified or display name. There are no wildcards supported on this request.
      Specified by:
      getNoteLogsByName in interface org.odpi.openmetadata.accessservices.assetmanager.api.exchange.CollaborationExchangeInterface
      Parameters:
      userId - calling user
      assetManagerGUID - unique identifier of software capability representing the caller
      assetManagerName - unique name of software capability representing the caller
      name - name to search for
      startFrom - paging start point
      pageSize - maximum results that can be returned
      effectiveTime - the time that the retrieved elements must be effective for
      forLineage - return elements marked with the Memento classification?
      forDuplicateProcessing - do not merge elements marked as duplicates?
      Returns:
      list of matching metadata elements
      Throws:
      org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException - one of the parameters is invalid
      org.odpi.openmetadata.frameworks.connectors.ffdc.UserNotAuthorizedException - the user is not authorized to issue this request
      org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException - there is a problem reported in the open metadata server(s)

    • getNoteLogsForElement

      public List<org.odpi.openmetadata.accessservices.assetmanager.metadataelements.NoteLogElement> getNoteLogsForElement(String userId, String assetManagerGUID, String assetManagerName, String elementGUID, int startFrom, int pageSize, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing) throws org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException, org.odpi.openmetadata.frameworks.connectors.ffdc.UserNotAuthorizedException, org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException
      Retrieve the list of note log metadata elements attached to the element.
      Specified by:
      getNoteLogsForElement in interface org.odpi.openmetadata.accessservices.assetmanager.api.exchange.CollaborationExchangeInterface
      Parameters:
      userId - calling user
      assetManagerGUID - unique identifier of software capability representing the caller
      assetManagerName - unique elementGUID of software capability representing the caller
      elementGUID - element to start from
      startFrom - paging start point
      pageSize - maximum results that can be returned
      effectiveTime - the time that the retrieved elements must be effective for
      forLineage - return elements marked with the Memento classification?
      forDuplicateProcessing - do not merge elements marked as duplicates?
      Returns:
      list of matching metadata elements
      Throws:
      org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException - one of the parameters is invalid
      org.odpi.openmetadata.frameworks.connectors.ffdc.UserNotAuthorizedException - the user is not authorized to issue this request
      org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException - there is a problem reported in the open metadata server(s)

    • getNoteLogByGUID

      public org.odpi.openmetadata.accessservices.assetmanager.metadataelements.NoteLogElement getNoteLogByGUID(String userId, String assetManagerGUID, String assetManagerName, String noteLogGUID, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing) throws org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException, org.odpi.openmetadata.frameworks.connectors.ffdc.UserNotAuthorizedException, org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException
      Retrieve the note log metadata element with the supplied unique identifier.
      Specified by:
      getNoteLogByGUID in interface org.odpi.openmetadata.accessservices.assetmanager.api.exchange.CollaborationExchangeInterface
      Parameters:
      userId - calling user
      assetManagerGUID - unique identifier of software capability representing the caller
      assetManagerName - unique name of software capability representing the caller
      noteLogGUID - unique identifier of the requested metadata element
      effectiveTime - the time that the retrieved elements must be effective for
      forLineage - return elements marked with the Memento classification?
      forDuplicateProcessing - do not merge elements marked as duplicates?
      Returns:
      requested metadata element
      Throws:
      org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException - one of the parameters is invalid
      org.odpi.openmetadata.frameworks.connectors.ffdc.UserNotAuthorizedException - the user is not authorized to issue this request
      org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException - there is a problem reported in the open metadata server(s)

    • createNote

      public String createNote(String userId, String assetManagerGUID, String assetManagerName, boolean assetManagerIsHome, String noteLogGUID, org.odpi.openmetadata.accessservices.assetmanager.properties.ExternalIdentifierProperties externalIdentifierProperties, org.odpi.openmetadata.accessservices.assetmanager.properties.NoteProperties noteProperties, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing) throws org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException, org.odpi.openmetadata.frameworks.connectors.ffdc.UserNotAuthorizedException, org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException
      Create a new metadata element to represent a note.
      Specified by:
      createNote in interface org.odpi.openmetadata.accessservices.assetmanager.api.exchange.CollaborationExchangeInterface
      Parameters:
      userId - calling user
      assetManagerGUID - unique identifier of software capability representing the caller
      assetManagerName - unique name of software capability representing the caller
      assetManagerIsHome - ensure that only the asset manager can update this element
      noteLogGUID - unique identifier of the element where the note is located
      externalIdentifierProperties - optional properties used to define an external identifier for the note
      noteProperties - properties for the note
      effectiveTime - the time that the retrieved elements must be effective for
      forLineage - return elements marked with the Memento classification?
      forDuplicateProcessing - do not merge elements marked as duplicates?
      Returns:
      unique identifier of the new metadata element for the note
      Throws:
      org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException - one of the parameters is invalid
      org.odpi.openmetadata.frameworks.connectors.ffdc.UserNotAuthorizedException - the user is not authorized to issue this request
      org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException - there is a problem reported in the open metadata server(s)

    • updateNote

      public void updateNote(String userId, String assetManagerGUID, String assetManagerName, String noteGUID, String noteExternalIdentifier, boolean isMergeUpdate, org.odpi.openmetadata.accessservices.assetmanager.properties.NoteProperties noteProperties, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing) throws org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException, org.odpi.openmetadata.frameworks.connectors.ffdc.UserNotAuthorizedException, org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException
      Update the properties of the metadata element representing a note.
      Specified by:
      updateNote in interface org.odpi.openmetadata.accessservices.assetmanager.api.exchange.CollaborationExchangeInterface
      Parameters:
      userId - calling user
      assetManagerGUID - unique identifier of software capability representing the caller
      assetManagerName - unique name of software capability representing the caller
      noteGUID - unique identifier of the note to update
      isMergeUpdate - should the new properties be merged with existing properties (true) or completely replace them (false)?
      noteProperties - new properties for the note
      noteExternalIdentifier - unique identifier of the note in the external asset manager
      effectiveTime - the time that the retrieved elements must be effective for
      forLineage - return elements marked with the Memento classification?
      forDuplicateProcessing - do not merge elements marked as duplicates?
      Throws:
      org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException - one of the parameters is invalid
      org.odpi.openmetadata.frameworks.connectors.ffdc.UserNotAuthorizedException - the user is not authorized to issue this request
      org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException - there is a problem reported in the open metadata server(s)

    • removeNote

      public void removeNote(String userId, String assetManagerGUID, String assetManagerName, String noteGUID, String noteExternalIdentifier, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing) throws org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException, org.odpi.openmetadata.frameworks.connectors.ffdc.UserNotAuthorizedException, org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException
      Remove the metadata element representing a note.
      Specified by:
      removeNote in interface org.odpi.openmetadata.accessservices.assetmanager.api.exchange.CollaborationExchangeInterface
      Parameters:
      userId - calling user
      assetManagerGUID - unique identifier of software capability representing the caller
      assetManagerName - unique name of software capability representing the caller
      noteGUID - unique identifier of the metadata element to remove
      noteExternalIdentifier - unique identifier of the note in the external asset manager
      effectiveTime - the time that the retrieved elements must be effective for
      forLineage - return elements marked with the Memento classification?
      forDuplicateProcessing - do not merge elements marked as duplicates?
      Throws:
      org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException - one of the parameters is invalid
      org.odpi.openmetadata.frameworks.connectors.ffdc.UserNotAuthorizedException - the user is not authorized to issue this request
      org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException - there is a problem reported in the open metadata server(s)

    • findNotes

      public List<org.odpi.openmetadata.accessservices.assetmanager.metadataelements.NoteElement> findNotes(String userId, String assetManagerGUID, String assetManagerName, String searchString, int startFrom, int pageSize, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing) throws org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException, org.odpi.openmetadata.frameworks.connectors.ffdc.UserNotAuthorizedException, org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException
      Retrieve the list of note metadata elements that contain the search string. The search string is treated as a regular expression.
      Specified by:
      findNotes in interface org.odpi.openmetadata.accessservices.assetmanager.api.exchange.CollaborationExchangeInterface
      Parameters:
      userId - calling user
      assetManagerGUID - unique identifier of software capability representing the caller
      assetManagerName - unique name of software capability representing the caller
      searchString - string to find in the properties
      startFrom - paging start point
      pageSize - maximum results that can be returned
      effectiveTime - the time that the retrieved elements must be effective for
      forLineage - return elements marked with the Memento classification?
      forDuplicateProcessing - do not merge elements marked as duplicates?
      Returns:
      list of matching metadata elements
      Throws:
      org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException - one of the parameters is invalid
      org.odpi.openmetadata.frameworks.connectors.ffdc.UserNotAuthorizedException - the user is not authorized to issue this request
      org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException - there is a problem reported in the open metadata server(s)

    • getNotesForNoteLog

      public List<org.odpi.openmetadata.accessservices.assetmanager.metadataelements.NoteElement> getNotesForNoteLog(String userId, String assetManagerGUID, String assetManagerName, String noteLogGUID, int startFrom, int pageSize, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing) throws org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException, org.odpi.openmetadata.frameworks.connectors.ffdc.UserNotAuthorizedException, org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException
      Retrieve the list of notes associated with a note log.
      Specified by:
      getNotesForNoteLog in interface org.odpi.openmetadata.accessservices.assetmanager.api.exchange.CollaborationExchangeInterface
      Parameters:
      userId - calling user
      assetManagerGUID - unique identifier of software capability representing the caller
      assetManagerName - unique name of software capability representing the caller
      noteLogGUID - unique identifier of the note log of interest
      startFrom - paging start point
      pageSize - maximum results that can be returned
      effectiveTime - the time that the retrieved elements must be effective for
      forLineage - return elements marked with the Memento classification?
      forDuplicateProcessing - do not merge elements marked as duplicates?
      Returns:
      list of associated metadata elements
      Throws:
      org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException - one of the parameters is invalid
      org.odpi.openmetadata.frameworks.connectors.ffdc.UserNotAuthorizedException - the user is not authorized to issue this request
      org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException - there is a problem reported in the open metadata server(s)

    • getNoteByGUID

      public org.odpi.openmetadata.accessservices.assetmanager.metadataelements.NoteElement getNoteByGUID(String userId, String assetManagerGUID, String assetManagerName, String noteGUID, Date effectiveTime, boolean forLineage, boolean forDuplicateProcessing) throws org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException, org.odpi.openmetadata.frameworks.connectors.ffdc.UserNotAuthorizedException, org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException
      Retrieve the note metadata element with the supplied unique identifier.
      Specified by:
      getNoteByGUID in interface org.odpi.openmetadata.accessservices.assetmanager.api.exchange.CollaborationExchangeInterface
      Parameters:
      userId - calling user
      assetManagerGUID - unique identifier of software capability representing the caller
      assetManagerName - unique name of software capability representing the caller
      noteGUID - unique identifier of the requested metadata element
      effectiveTime - the time that the retrieved elements must be effective for
      forLineage - return elements marked with the Memento classification?
      forDuplicateProcessing - do not merge elements marked as duplicates?
      Returns:
      matching metadata element
      Throws:
      org.odpi.openmetadata.frameworks.connectors.ffdc.InvalidParameterException - one of the parameters is invalid
      org.odpi.openmetadata.frameworks.connectors.ffdc.UserNotAuthorizedException - the user is not authorized to issue this request
      org.odpi.openmetadata.frameworks.connectors.ffdc.PropertyServerException - there is a problem reported in the open metadata server(s)