Module: GroupDocs::Signature::RecipientMethods

Included in:
Envelope, Template
Defined in:
lib/groupdocs/signature/shared/recipient_methods.rb

Overview

Envelope and template entities share the same set of recipient methods.

See Also:

Instance Method Summary collapse

Instance Method Details

#recipients!(access = {}) ⇒ Array<GroupDocs::Signature::Recipient>

Returns recipients array.

Parameters:

  • access (Hash) (defaults to: {}) —

    Access credentials

Options Hash (access):

  • :client_id (String)
  • :private_key (String)

Returns:



19
20
21
22
23
24
25
26
27
28
29
 
# File 'lib/groupdocs/signature/shared/recipient_methods.rb', line 19

def recipients!(access = {})
  json = Api::Request.new do |request|
    request[:access] = access
    request[:method] = :GET
    request[:path] = "/signature/{{client_id}}/#{pluralized_class_name}/#{id}/recipients"
  end.execute!

  json[:recipients].map do |recipient|
    Signature::Recipient.new(recipient)
  end
end

#remove_recipient!(recipient, access = {}) ⇒ Object

Removes recipient.

Examples:

template = GroupDocs::Signature::Template.get!("g94h5g84hj9g4gf23i40j")
recipient = template.recipients!.first
template.remove_recipient! recipient
envelope = GroupDocs::Signature::Envelope.get!("g94h5g84hj9g4gf23i40j")
recipient = envelope.recipients!.first
envelope.remove_recipient! recipient

Parameters:

Options Hash (access):

  • :client_id (String)
  • :private_key (String)

Raises:

  • (ArgumentError) —

    if recipient is not GroupDocs::Signature::Recipient



50
51
52
53
54
55
56
57
58
59
 
# File 'lib/groupdocs/signature/shared/recipient_methods.rb', line 50

def remove_recipient!(recipient, access = {})
  recipient.is_a?(GroupDocs::Signature::Recipient) or raise ArgumentError,
    "Recipient should be GroupDocs::Signature::Recipient object, received: #{recipient.inspect}"

  Api::Request.new do |request|
    request[:access] = access
    request[:method] = :DELETE
    request[:path] = "/signature/{{client_id}}/#{pluralized_class_name}/#{id}/recipients/#{recipient.id}"
  end.execute!
end