Class RecipientViewRequest

  • All Implemented Interfaces:
    Serializable

    public class RecipientViewRequest
    extends Object
    implements Serializable
    The request body for the [EnvelopeViews: createRecipient](/docs/esign-rest-api/reference/envelopes/envelopeviews/createrecipient/) and [EnvelopeViews: createSharedRecipient](/docs/esign-rest-api/reference/envelopes/envelopeviews/createsharedrecipient/) methods..
    See Also:
    Serialized Form
    • Constructor Detail

      • RecipientViewRequest

        public RecipientViewRequest()
    • Method Detail

      • getAssertionId

        public String getAssertionId()
        A unique identifier of the authentication event executed by the client application..
        Returns:
        assertionId
      • setAssertionId

        public void setAssertionId​(String assertionId)
        setAssertionId.
      • authenticationInstant

        public RecipientViewRequest authenticationInstant​(String authenticationInstant)
        authenticationInstant.
        Returns:
        RecipientViewRequest
      • getAuthenticationInstant

        public String getAuthenticationInstant()
        A sender generated value that indicates the date/time that the signer was authenticated..
        Returns:
        authenticationInstant
      • setAuthenticationInstant

        public void setAuthenticationInstant​(String authenticationInstant)
        setAuthenticationInstant.
      • authenticationMethod

        public RecipientViewRequest authenticationMethod​(String authenticationMethod)
        authenticationMethod.
        Returns:
        RecipientViewRequest
      • getAuthenticationMethod

        public String getAuthenticationMethod()
        A sender created value that indicates the convention used to authenticate the signer. This information is included in the Certificate of Completion..
        Returns:
        authenticationMethod
      • setAuthenticationMethod

        public void setAuthenticationMethod​(String authenticationMethod)
        setAuthenticationMethod.
      • getClientUserId

        public String getClientUserId()
        A sender created value that shows the recipient is embedded (captive). Maximum length: 100 characters..
        Returns:
        clientUserId
      • setClientUserId

        public void setClientUserId​(String clientUserId)
        setClientUserId.
      • displayFormat

        public RecipientViewRequest displayFormat​(String displayFormat)
        displayFormat.
        Returns:
        RecipientViewRequest
      • getDisplayFormat

        public String getDisplayFormat()
        .
        Returns:
        displayFormat
      • setDisplayFormat

        public void setDisplayFormat​(String displayFormat)
        setDisplayFormat.
      • getEmail

        public String getEmail()
        Specifies the email of the recipient. You can use either email and userName or userId to identify the recipient..
        Returns:
        email
      • setEmail

        public void setEmail​(String email)
        setEmail.
      • addFrameAncestorsItem

        public RecipientViewRequest addFrameAncestorsItem​(String frameAncestorsItem)
        addFrameAncestorsItem.
        Returns:
        RecipientViewRequest
      • getFrameAncestors

        public List<String> getFrameAncestors()
        .
        Returns:
        frameAncestors
      • setFrameAncestors

        public void setFrameAncestors​(List<String> frameAncestors)
        setFrameAncestors.
      • addMessageOriginsItem

        public RecipientViewRequest addMessageOriginsItem​(String messageOriginsItem)
        addMessageOriginsItem.
        Returns:
        RecipientViewRequest
      • getMessageOrigins

        public List<String> getMessageOrigins()
        .
        Returns:
        messageOrigins
      • setMessageOrigins

        public void setMessageOrigins​(List<String> messageOrigins)
        setMessageOrigins.
      • pingFrequency

        public RecipientViewRequest pingFrequency​(String pingFrequency)
        pingFrequency.
        Returns:
        RecipientViewRequest
      • getPingFrequency

        public String getPingFrequency()
        Only used if pingUrl is specified. This is the interval, in seconds, between pings on the pingUrl. The default is 300 seconds. Valid values are 60-1200 seconds..
        Returns:
        pingFrequency
      • setPingFrequency

        public void setPingFrequency​(String pingFrequency)
        setPingFrequency.
      • getPingUrl

        public String getPingUrl()
        A client Url to be pinged by the DocuSign Signing experience to indicate to the client that Signing is active. An HTTP Get is executed against the client. The response from the client is ignored. The intent is for the client to reset it's session timer when the request is received..
        Returns:
        pingUrl
      • setPingUrl

        public void setPingUrl​(String pingUrl)
        setPingUrl.
      • getRecipientId

        public String getRecipientId()
        Unique for the recipient. It is used by the tab element to indicate which recipient is to sign the Document..
        Returns:
        recipientId
      • setRecipientId

        public void setRecipientId​(String recipientId)
        setRecipientId.
      • getReturnUrl

        public String getReturnUrl()
        The url the recipient is redirected to after the signing session has ended. DocuSign redirects to the url and includes an event parameter that can be used by your application. Possible event parameter values: * cancel (recipient canceled the signing operation) * decline (recipient declined to sign) * exception (an exception occurred) * fax_pending (recipient has a fax pending) * session_timeout (session timed out) * signing_complete (signer completed the signing ceremony) * ttl_expired (the TTL, time to live, timer expired) * viewing_complete (recipient completed viewing the envelope) ###### Note: Include https:// in the URL or the redirect might not succeed on some browsers. .
        Returns:
        returnUrl
      • setReturnUrl

        public void setReturnUrl​(String returnUrl)
        setReturnUrl.
      • securityDomain

        public RecipientViewRequest securityDomain​(String securityDomain)
        securityDomain.
        Returns:
        RecipientViewRequest
      • getSecurityDomain

        public String getSecurityDomain()
        The domain in which the user authenticated..
        Returns:
        securityDomain
      • setSecurityDomain

        public void setSecurityDomain​(String securityDomain)
        setSecurityDomain.
      • getUserId

        public String getUserId()
        Specifies the user ID of the recipient. You can use with user ID or email and user name to identify the recipient. If user ID is used and a client user ID is provided, the value in the `userId` property must match a recipient ID (which can be retrieved with a GET recipients call) for the envelope. If a user ID is used and a clientUser ID is not provided, the user ID match the user ID of the authenticating user..
        Returns:
        userId
      • setUserId

        public void setUserId​(String userId)
        setUserId.
      • getUserName

        public String getUserName()
        Specifies the username of the recipient. You can use either email and userName or userId to identify the recipient..
        Returns:
        userName
      • setUserName

        public void setUserName​(String userName)
        setUserName.
      • xFrameOptions

        public RecipientViewRequest xFrameOptions​(String xFrameOptions)
        xFrameOptions.
        Returns:
        RecipientViewRequest
      • getXFrameOptions

        public String getXFrameOptions()
        .
        Returns:
        xFrameOptions
      • setXFrameOptions

        public void setXFrameOptions​(String xFrameOptions)
        setXFrameOptions.
      • xFrameOptionsAllowFromUrl

        public RecipientViewRequest xFrameOptionsAllowFromUrl​(String xFrameOptionsAllowFromUrl)
        xFrameOptionsAllowFromUrl.
        Returns:
        RecipientViewRequest
      • getXFrameOptionsAllowFromUrl

        public String getXFrameOptionsAllowFromUrl()
        .
        Returns:
        xFrameOptionsAllowFromUrl
      • setXFrameOptionsAllowFromUrl

        public void setXFrameOptionsAllowFromUrl​(String xFrameOptionsAllowFromUrl)
        setXFrameOptionsAllowFromUrl.
      • equals

        public boolean equals​(Object o)
        Compares objects.
        Overrides:
        equals in class Object
        Returns:
        true or false depending on comparison result.
      • hashCode

        public int hashCode()
        Returns the HashCode.
        Overrides:
        hashCode in class Object
      • toString

        public String toString()
        Converts the given object to string.
        Overrides:
        toString in class Object