groupdocs 2.2.0 → 2.3.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (324) hide show
  1. checksums.yaml +7 -0
  2. data/.travis.yml +9 -9
  3. data/CHANGELOG.md +482 -477
  4. data/Gemfile +3 -3
  5. data/LICENSE.txt +21 -21
  6. data/README.md +94 -94
  7. data/Rakefile +9 -9
  8. data/examples/README.md +12 -12
  9. data/examples/api-samples/Gemfile +5 -5
  10. data/examples/api-samples/Gemfile.lock +49 -49
  11. data/examples/api-samples/README.md +23 -23
  12. data/examples/api-samples/public/css/style.css +229 -229
  13. data/examples/api-samples/public/docs/annotation-sample.html +167 -167
  14. data/examples/api-samples/public/docs/docco.css +500 -500
  15. data/examples/api-samples/public/docs/envelope-sample.html +374 -374
  16. data/examples/api-samples/public/docs/sample01.html +181 -181
  17. data/examples/api-samples/public/docs/sample02.html +199 -199
  18. data/examples/api-samples/public/docs/sample03.html +318 -318
  19. data/examples/api-samples/public/docs/sample04.html +217 -217
  20. data/examples/api-samples/public/docs/sample05.html +296 -296
  21. data/examples/api-samples/public/docs/sample06.html +347 -347
  22. data/examples/api-samples/public/docs/sample07.html +209 -209
  23. data/examples/api-samples/public/docs/sample08.html +277 -277
  24. data/examples/api-samples/public/docs/sample09.html +314 -314
  25. data/examples/api-samples/public/docs/sample10.html +270 -270
  26. data/examples/api-samples/public/docs/sample11.html +462 -462
  27. data/examples/api-samples/public/docs/sample12.html +199 -199
  28. data/examples/api-samples/public/docs/sample13.html +201 -201
  29. data/examples/api-samples/public/docs/sample14.html +204 -204
  30. data/examples/api-samples/public/docs/sample15.html +182 -182
  31. data/examples/api-samples/public/docs/sample16.html +234 -234
  32. data/examples/api-samples/public/docs/sample17.html +309 -309
  33. data/examples/api-samples/public/docs/sample18.html +721 -721
  34. data/examples/api-samples/public/docs/sample19.html +631 -631
  35. data/examples/api-samples/public/docs/sample20.html +230 -230
  36. data/examples/api-samples/public/docs/sample21.html +790 -790
  37. data/examples/api-samples/public/docs/sample22.html +408 -408
  38. data/examples/api-samples/public/docs/sample25.html +550 -550
  39. data/examples/api-samples/public/templates/base-simple_source.html +191 -191
  40. data/examples/api-samples/public/templates/testdocument.html +100 -100
  41. data/examples/api-samples/public/templates/welcome.htm +137 -137
  42. data/examples/api-samples/samples/annotation-sample.rb +56 -56
  43. data/examples/api-samples/samples/envelope-sample.rb +133 -133
  44. data/examples/api-samples/samples/sample01.rb +44 -44
  45. data/examples/api-samples/samples/sample02.rb +50 -50
  46. data/examples/api-samples/samples/sample03.rb +79 -79
  47. data/examples/api-samples/samples/sample04.rb +54 -54
  48. data/examples/api-samples/samples/sample05.rb +83 -83
  49. data/examples/api-samples/samples/sample06.rb +86 -86
  50. data/examples/api-samples/samples/sample07.rb +59 -59
  51. data/examples/api-samples/samples/sample08.rb +76 -76
  52. data/examples/api-samples/samples/sample09.rb +85 -85
  53. data/examples/api-samples/samples/sample10.rb +70 -70
  54. data/examples/api-samples/samples/sample11.rb +132 -132
  55. data/examples/api-samples/samples/sample12.rb +48 -48
  56. data/examples/api-samples/samples/sample13.rb +49 -49
  57. data/examples/api-samples/samples/sample14.rb +54 -54
  58. data/examples/api-samples/samples/sample15.rb +43 -43
  59. data/examples/api-samples/samples/sample16.rb +57 -57
  60. data/examples/api-samples/samples/sample17.rb +70 -70
  61. data/examples/api-samples/samples/sample18.rb +190 -190
  62. data/examples/api-samples/samples/sample19.rb +188 -188
  63. data/examples/api-samples/samples/sample20.rb +68 -68
  64. data/examples/api-samples/samples/sample21.rb +212 -212
  65. data/examples/api-samples/samples/sample22.rb +109 -109
  66. data/examples/api-samples/samples/sample25.rb +127 -127
  67. data/examples/api-samples/views/_others_samples.haml +233 -233
  68. data/examples/api-samples/views/annotation_sample.haml +63 -63
  69. data/examples/api-samples/views/envelope_sample.haml +72 -72
  70. data/examples/api-samples/views/index.haml +235 -235
  71. data/examples/api-samples/views/layout.haml +3 -3
  72. data/examples/api-samples/views/sample01.haml +63 -63
  73. data/examples/api-samples/views/sample02.haml +52 -52
  74. data/examples/api-samples/views/sample03.haml +87 -87
  75. data/examples/api-samples/views/sample04.haml +55 -55
  76. data/examples/api-samples/views/sample05.haml +86 -86
  77. data/examples/api-samples/views/sample06.haml +58 -58
  78. data/examples/api-samples/views/sample07.haml +52 -52
  79. data/examples/api-samples/views/sample08.haml +100 -100
  80. data/examples/api-samples/views/sample09.haml +95 -95
  81. data/examples/api-samples/views/sample10.haml +93 -93
  82. data/examples/api-samples/views/sample11.haml +140 -140
  83. data/examples/api-samples/views/sample12.haml +68 -68
  84. data/examples/api-samples/views/sample13.haml +64 -64
  85. data/examples/api-samples/views/sample14.haml +60 -60
  86. data/examples/api-samples/views/sample15.haml +51 -51
  87. data/examples/api-samples/views/sample16.haml +50 -50
  88. data/examples/api-samples/views/sample17.haml +54 -54
  89. data/examples/api-samples/views/sample18.haml +143 -143
  90. data/examples/api-samples/views/sample19.haml +92 -92
  91. data/examples/api-samples/views/sample20.haml +54 -54
  92. data/examples/api-samples/views/sample21.haml +123 -123
  93. data/examples/api-samples/views/sample22.haml +106 -106
  94. data/examples/api-samples/views/sample25.haml +101 -101
  95. data/examples/api-samples/views/sample31.haml +2 -2
  96. data/examples/api-samples/web.rb +20 -20
  97. data/examples/viewer/Gemfile +5 -5
  98. data/examples/viewer/app.rb +52 -52
  99. data/groupdocs.gemspec +31 -31
  100. data/lib/groupdocs.rb +62 -62
  101. data/lib/groupdocs/api.rb +6 -6
  102. data/lib/groupdocs/api/entity.rb +112 -112
  103. data/lib/groupdocs/api/helpers.rb +11 -11
  104. data/lib/groupdocs/api/helpers/access_mode_helper.rb +27 -27
  105. data/lib/groupdocs/api/helpers/access_rights_helper.rb +55 -55
  106. data/lib/groupdocs/api/helpers/accessor_helper.rb +30 -30
  107. data/lib/groupdocs/api/helpers/byte_flag_helper.rb +49 -49
  108. data/lib/groupdocs/api/helpers/credentials_helper.rb +35 -35
  109. data/lib/groupdocs/api/helpers/mime_helper.rb +21 -21
  110. data/lib/groupdocs/api/helpers/path_helper.rb +28 -28
  111. data/lib/groupdocs/api/helpers/rest_helper.rb +99 -99
  112. data/lib/groupdocs/api/helpers/signature_public_helper.rb +22 -22
  113. data/lib/groupdocs/api/helpers/status_helper.rb +27 -27
  114. data/lib/groupdocs/api/helpers/url_helper.rb +101 -101
  115. data/lib/groupdocs/api/request.rb +91 -91
  116. data/lib/groupdocs/datasource.rb +249 -249
  117. data/lib/groupdocs/datasource/field.rb +39 -39
  118. data/lib/groupdocs/document.rb +1550 -1550
  119. data/lib/groupdocs/document/annotation.rb +421 -421
  120. data/lib/groupdocs/document/annotation/reply.rb +173 -173
  121. data/lib/groupdocs/document/annotation/reviewer.rb +66 -66
  122. data/lib/groupdocs/document/change.rb +56 -56
  123. data/lib/groupdocs/document/field.rb +53 -53
  124. data/lib/groupdocs/document/metadata.rb +32 -32
  125. data/lib/groupdocs/document/rectangle.rb +18 -18
  126. data/lib/groupdocs/document/view.rb +36 -36
  127. data/lib/groupdocs/errors.rb +8 -8
  128. data/lib/groupdocs/job.rb +468 -468
  129. data/lib/groupdocs/questionnaire.rb +530 -530
  130. data/lib/groupdocs/questionnaire/collector.rb +335 -335
  131. data/lib/groupdocs/questionnaire/execution.rb +181 -181
  132. data/lib/groupdocs/questionnaire/page.rb +43 -43
  133. data/lib/groupdocs/questionnaire/question.rb +108 -108
  134. data/lib/groupdocs/questionnaire/question/answer.rb +15 -15
  135. data/lib/groupdocs/signature.rb +380 -380
  136. data/lib/groupdocs/signature/contact.rb +181 -181
  137. data/lib/groupdocs/signature/envelope.rb +747 -747
  138. data/lib/groupdocs/signature/envelope/log.rb +20 -20
  139. data/lib/groupdocs/signature/field.rb +286 -286
  140. data/lib/groupdocs/signature/field/location.rb +71 -71
  141. data/lib/groupdocs/signature/form.rb +804 -804
  142. data/lib/groupdocs/signature/list.rb +92 -92
  143. data/lib/groupdocs/signature/recipient.rb +79 -79
  144. data/lib/groupdocs/signature/role.rb +54 -54
  145. data/lib/groupdocs/signature/shared.rb +6 -6
  146. data/lib/groupdocs/signature/shared/document_methods.rb +158 -158
  147. data/lib/groupdocs/signature/shared/entity_fields.rb +76 -76
  148. data/lib/groupdocs/signature/shared/entity_methods.rb +144 -144
  149. data/lib/groupdocs/signature/shared/field_methods.rb +354 -354
  150. data/lib/groupdocs/signature/shared/recipient_methods.rb +75 -75
  151. data/lib/groupdocs/signature/shared/resource_methods.rb +65 -65
  152. data/lib/groupdocs/signature/template.rb +124 -124
  153. data/lib/groupdocs/storage.rb +44 -44
  154. data/lib/groupdocs/storage/file.rb +432 -432
  155. data/lib/groupdocs/storage/folder.rb +288 -288
  156. data/lib/groupdocs/storage/package.rb +48 -48
  157. data/lib/groupdocs/storage/provider.rb +32 -32
  158. data/lib/groupdocs/subscription.rb +323 -323
  159. data/lib/groupdocs/subscription/limit.rb +20 -20
  160. data/lib/groupdocs/user.rb +955 -930
  161. data/lib/groupdocs/version.rb +3 -3
  162. data/spec/groupdocs/api/entity_spec.rb +55 -55
  163. data/spec/groupdocs/api/helpers/access_mode_helper_spec.rb +21 -21
  164. data/spec/groupdocs/api/helpers/access_rights_helper_spec.rb +43 -43
  165. data/spec/groupdocs/api/helpers/accessor_helper_spec.rb +16 -16
  166. data/spec/groupdocs/api/helpers/byte_flag_helper_spec.rb +23 -23
  167. data/spec/groupdocs/api/helpers/credentials_helpers_spec.rb +48 -48
  168. data/spec/groupdocs/api/helpers/mime_helper_spec.rb +16 -16
  169. data/spec/groupdocs/api/helpers/path_helper_spec.rb +15 -15
  170. data/spec/groupdocs/api/helpers/rest_helper_spec.rb +161 -161
  171. data/spec/groupdocs/api/helpers/signature_public_helper_spec.rb +21 -21
  172. data/spec/groupdocs/api/helpers/status_helper_spec.rb +22 -22
  173. data/spec/groupdocs/api/helpers/url_helper_spec.rb +112 -112
  174. data/spec/groupdocs/api/request_spec.rb +112 -112
  175. data/spec/groupdocs/datasource/field_spec.rb +29 -29
  176. data/spec/groupdocs/datasource_spec.rb +145 -145
  177. data/spec/groupdocs/document/annotation/reply_spec.rb +154 -154
  178. data/spec/groupdocs/document/annotation/reviewer_spec.rb +51 -51
  179. data/spec/groupdocs/document/annotation_spec.rb +234 -234
  180. data/spec/groupdocs/document/change_spec.rb +39 -39
  181. data/spec/groupdocs/document/field_spec.rb +28 -28
  182. data/spec/groupdocs/document/metadata_spec.rb +21 -21
  183. data/spec/groupdocs/document/rectangle_spec.rb +14 -14
  184. data/spec/groupdocs/document/view_spec.rb +33 -33
  185. data/spec/groupdocs/document_spec.rb +859 -859
  186. data/spec/groupdocs/errors_spec.rb +7 -7
  187. data/spec/groupdocs/job_spec.rb +323 -323
  188. data/spec/groupdocs/questionnaire/collector_spec.rb +197 -197
  189. data/spec/groupdocs/questionnaire/execution_spec.rb +162 -162
  190. data/spec/groupdocs/questionnaire/page_spec.rb +47 -47
  191. data/spec/groupdocs/questionnaire/question/answer_spec.rb +9 -9
  192. data/spec/groupdocs/questionnaire/question_spec.rb +75 -75
  193. data/spec/groupdocs/questionnaire_spec.rb +295 -295
  194. data/spec/groupdocs/signature/contact_spec.rb +142 -142
  195. data/spec/groupdocs/signature/envelope/log_spec.rb +15 -15
  196. data/spec/groupdocs/signature/envelope_spec.rb +384 -384
  197. data/spec/groupdocs/signature/field/location_spec.rb +40 -40
  198. data/spec/groupdocs/signature/field_spec.rb +235 -235
  199. data/spec/groupdocs/signature/form_spec.rb +205 -205
  200. data/spec/groupdocs/signature/list_spec.rb +87 -87
  201. data/spec/groupdocs/signature/recipient_spec.rb +26 -26
  202. data/spec/groupdocs/signature/role_spec.rb +47 -47
  203. data/spec/groupdocs/signature/template_spec.rb +80 -80
  204. data/spec/groupdocs/signature_spec.rb +194 -194
  205. data/spec/groupdocs/storage/file_spec.rb +303 -303
  206. data/spec/groupdocs/storage/folder_spec.rb +270 -270
  207. data/spec/groupdocs/storage/package_spec.rb +38 -38
  208. data/spec/groupdocs/storage/provider_spec.rb +21 -21
  209. data/spec/groupdocs/storage_spec.rb +27 -27
  210. data/spec/groupdocs/subscription/limit_spec.rb +16 -16
  211. data/spec/groupdocs/subscription_spec.rb +74 -74
  212. data/spec/groupdocs/user_spec.rb +257 -257
  213. data/spec/groupdocs_spec.rb +63 -63
  214. data/spec/spec_helper.rb +73 -73
  215. data/spec/support/json/annotation_access_set.json +11 -11
  216. data/spec/support/json/annotation_collaborators_get.json +16 -16
  217. data/spec/support/json/annotation_collaborators_set.json +16 -16
  218. data/spec/support/json/annotation_create.json +12 -12
  219. data/spec/support/json/annotation_list.json +32 -32
  220. data/spec/support/json/annotation_marker_move.json +10 -10
  221. data/spec/support/json/annotation_move.json +8 -8
  222. data/spec/support/json/annotation_remove.json +9 -9
  223. data/spec/support/json/annotation_replies_create.json +9 -9
  224. data/spec/support/json/annotation_replies_get.json +25 -25
  225. data/spec/support/json/annotation_reviewers_get.json +18 -18
  226. data/spec/support/json/comparison_changes.json +46 -46
  227. data/spec/support/json/comparison_compare.json +8 -8
  228. data/spec/support/json/comparison_document.json +10 -10
  229. data/spec/support/json/contact_add.json +12 -12
  230. data/spec/support/json/contacts_get.json +19 -19
  231. data/spec/support/json/contacts_import.json +8 -8
  232. data/spec/support/json/datasource_add.json +8 -8
  233. data/spec/support/json/datasource_get.json +22 -22
  234. data/spec/support/json/datasource_remove.json +8 -8
  235. data/spec/support/json/datasource_update.json +8 -8
  236. data/spec/support/json/delete_account.json +9 -9
  237. data/spec/support/json/document_access_info_get.json +14 -14
  238. data/spec/support/json/document_convert.json +8 -8
  239. data/spec/support/json/document_datasource.json +10 -10
  240. data/spec/support/json/document_fields.json +34 -34
  241. data/spec/support/json/document_formats.json +8 -8
  242. data/spec/support/json/document_metadata.json +15 -15
  243. data/spec/support/json/document_page_images_get.json +20 -20
  244. data/spec/support/json/document_questionnaire_create.json +9 -9
  245. data/spec/support/json/document_questionnaires.json +23 -23
  246. data/spec/support/json/document_sharers_remove.json +8 -8
  247. data/spec/support/json/document_sharers_set.json +16 -16
  248. data/spec/support/json/document_thumbnails.json +24 -24
  249. data/spec/support/json/document_views.json +32 -32
  250. data/spec/support/json/envelope_get.json +46 -46
  251. data/spec/support/json/envelope_logs.json +16 -16
  252. data/spec/support/json/envelope_recipient_add.json +26 -26
  253. data/spec/support/json/envelopes_all.json +48 -48
  254. data/spec/support/json/envelopes_resources.json +31 -31
  255. data/spec/support/json/file_compress.json +8 -8
  256. data/spec/support/json/file_copy.json +14 -14
  257. data/spec/support/json/file_delete.json +5 -5
  258. data/spec/support/json/file_move.json +14 -14
  259. data/spec/support/json/file_upload.json +8 -8
  260. data/spec/support/json/folder_create.json +8 -8
  261. data/spec/support/json/folder_delete.json +5 -5
  262. data/spec/support/json/folder_list.json +22 -22
  263. data/spec/support/json/folder_move.json +8 -8
  264. data/spec/support/json/folder_sharers_get.json +16 -16
  265. data/spec/support/json/folder_sharers_remove.json +8 -8
  266. data/spec/support/json/folder_sharers_set.json +16 -16
  267. data/spec/support/json/form_get.json +21 -21
  268. data/spec/support/json/forms_all.json +23 -23
  269. data/spec/support/json/job_add_url.json +8 -8
  270. data/spec/support/json/job_create.json +8 -8
  271. data/spec/support/json/job_documents.json +40 -40
  272. data/spec/support/json/job_file_add.json +8 -8
  273. data/spec/support/json/job_get.json +30 -30
  274. data/spec/support/json/job_update.json +7 -7
  275. data/spec/support/json/jobs_get.json +58 -58
  276. data/spec/support/json/list_add.json +12 -12
  277. data/spec/support/json/lists_get.json +19 -19
  278. data/spec/support/json/package_create.json +7 -7
  279. data/spec/support/json/questionnaire_collector.json +17 -17
  280. data/spec/support/json/questionnaire_collectors.json +38 -38
  281. data/spec/support/json/questionnaire_collectors_add.json +10 -10
  282. data/spec/support/json/questionnaire_create.json +10 -10
  283. data/spec/support/json/questionnaire_datasources.json +26 -26
  284. data/spec/support/json/questionnaire_execution_add.json +9 -9
  285. data/spec/support/json/questionnaire_execution_status_set.json +8 -8
  286. data/spec/support/json/questionnaire_execution_update.json +8 -8
  287. data/spec/support/json/questionnaire_executions.json +28 -28
  288. data/spec/support/json/questionnaire_get.json +17 -17
  289. data/spec/support/json/questionnaire_remove.json +8 -8
  290. data/spec/support/json/questionnaire_update.json +8 -8
  291. data/spec/support/json/questionnaires_get.json +40 -40
  292. data/spec/support/json/sign_documents.json +16 -16
  293. data/spec/support/json/signature_create.json +12 -12
  294. data/spec/support/json/signature_field_add.json +25 -25
  295. data/spec/support/json/signature_fields_get.json +27 -27
  296. data/spec/support/json/signature_roles_get.json +17 -17
  297. data/spec/support/json/signatures_get.json +19 -19
  298. data/spec/support/json/storage_info.json +10 -10
  299. data/spec/support/json/subscription_plan_get.json +9 -9
  300. data/spec/support/json/subscription_plans_get.json +17 -17
  301. data/spec/support/json/template_get.json +35 -35
  302. data/spec/support/json/template_get_documents.json +15 -15
  303. data/spec/support/json/template_get_recipients.json +20 -20
  304. data/spec/support/json/templates_all.json +37 -37
  305. data/spec/support/json/templates_get.json +21 -21
  306. data/spec/support/json/update_account.json +10 -10
  307. data/spec/support/json/user_area.json +67 -67
  308. data/spec/support/json/user_embed_key.json +38 -38
  309. data/spec/support/json/user_get_embed_key.json +67 -67
  310. data/spec/support/json/user_login.json +67 -67
  311. data/spec/support/json/user_profile_get.json +24 -24
  312. data/spec/support/json/user_providers.json +31 -31
  313. data/spec/support/json/user_roles.json +25 -25
  314. data/spec/support/json/user_users_get.json +27 -27
  315. data/spec/support/shared_examples/api/entity.rb +39 -39
  316. data/spec/support/shared_examples/api/helpers/access_mode_helper.rb +11 -11
  317. data/spec/support/shared_examples/api/helpers/status_helper.rb +11 -11
  318. data/spec/support/shared_examples/signature/shared/document_methods.rb +68 -68
  319. data/spec/support/shared_examples/signature/shared/entity_fields.rb +56 -56
  320. data/spec/support/shared_examples/signature/shared/entity_methods.rb +116 -116
  321. data/spec/support/shared_examples/signature/shared/field_methods.rb +220 -220
  322. data/spec/support/shared_examples/signature/shared/recipient_methods.rb +46 -46
  323. data/spec/support/shared_examples/signature/shared/resource_methods.rb +46 -46
  324. metadata +35 -55
@@ -1,790 +1,790 @@
1
- <!DOCTYPE html>
2
-
3
- <html>
4
- <head>
5
- <title>sample21.rb</title>
6
- <meta http-equiv="content-type" content="text/html; charset=UTF-8">
7
- <meta name="viewport" content="width=device-width, target-densitydpi=160dpi, initial-scale=1.0; maximum-scale=1.0; user-scalable=0;">
8
- <link rel="stylesheet" media="all" href="docco.css" />
9
- </head>
10
- <body>
11
- <div id="container">
12
- <div id="background"></div>
13
-
14
- <ul class="sections">
15
-
16
- <li id="title">
17
- <div class="annotation">
18
- <h1>sample21.rb</h1>
19
- </div>
20
- </li>
21
-
22
-
23
-
24
- <li id="section-1">
25
- <div class="annotation">
26
-
27
- <div class="pilwrap ">
28
- <a class="pilcrow" href="#section-1">&#182;</a>
29
- </div>
30
- <p>GET request</p>
31
-
32
- </div>
33
-
34
- <div class="content"><div class='highlight'><pre>get <span class="hljs-string">'/sample-21-how-to-create-and-upload-envelop-to-groupdocs-account'</span> <span class="hljs-keyword">do</span>
35
- haml <span class="hljs-symbol">:sample21</span>
36
- <span class="hljs-keyword">end</span></pre></div></div>
37
-
38
- </li>
39
-
40
-
41
- <li id="section-2">
42
- <div class="annotation">
43
-
44
- <div class="pilwrap ">
45
- <a class="pilcrow" href="#section-2">&#182;</a>
46
- </div>
47
- <p>POST request</p>
48
-
49
- </div>
50
-
51
- <div class="content"><div class='highlight'><pre>post <span class="hljs-string">'/sample21/signature_callback'</span> <span class="hljs-keyword">do</span></pre></div></div>
52
-
53
- </li>
54
-
55
-
56
- <li id="section-3">
57
- <div class="annotation">
58
-
59
- <div class="pilwrap ">
60
- <a class="pilcrow" href="#section-3">&#182;</a>
61
- </div>
62
- <p>Set download path</p>
63
-
64
- </div>
65
-
66
- <div class="content"><div class='highlight'><pre> downloads_path = <span class="hljs-string">"<span class="hljs-subst">#{<span class="hljs-constant">File</span>.dirname(__FILE_<span class="hljs-number">_</span>)}</span>/../public/downloads"</span></pre></div></div>
67
-
68
- </li>
69
-
70
-
71
- <li id="section-4">
72
- <div class="annotation">
73
-
74
- <div class="pilwrap ">
75
- <a class="pilcrow" href="#section-4">&#182;</a>
76
- </div>
77
- <p>Get callback request</p>
78
-
79
- </div>
80
-
81
- <div class="content"><div class='highlight'><pre> data = <span class="hljs-constant">JSON</span>.parse(request.body.read)
82
- <span class="hljs-keyword">begin</span>
83
- raise <span class="hljs-string">'Empty params!'</span> <span class="hljs-keyword">if</span> data.empty?
84
- source_id = <span class="hljs-keyword">nil</span>
85
- client_id = <span class="hljs-keyword">nil</span>
86
- private_key = <span class="hljs-keyword">nil</span></pre></div></div>
87
-
88
- </li>
89
-
90
-
91
- <li id="section-5">
92
- <div class="annotation">
93
-
94
- <div class="pilwrap ">
95
- <a class="pilcrow" href="#section-5">&#182;</a>
96
- </div>
97
- <p>Get value of SourceId</p>
98
-
99
- </div>
100
-
101
- <div class="content"><div class='highlight'><pre> data.each <span class="hljs-keyword">do</span> |key, value|
102
- <span class="hljs-keyword">if</span> key == <span class="hljs-string">'SourceId'</span>
103
- source_id = value
104
- <span class="hljs-keyword">end</span>
105
- <span class="hljs-keyword">end</span></pre></div></div>
106
-
107
- </li>
108
-
109
-
110
- <li id="section-6">
111
- <div class="annotation">
112
-
113
- <div class="pilwrap ">
114
- <a class="pilcrow" href="#section-6">&#182;</a>
115
- </div>
116
- <p>Get private key and client_id from file user_info.txt</p>
117
-
118
- </div>
119
-
120
- <div class="content"><div class='highlight'><pre> <span class="hljs-keyword">if</span> <span class="hljs-constant">File</span>.exist?(<span class="hljs-string">"<span class="hljs-subst">#{<span class="hljs-constant">File</span>.dirname(__FILE_<span class="hljs-number">_</span>)}</span>/../public/user_info.txt"</span>)
121
- contents = <span class="hljs-constant">File</span>.read(<span class="hljs-string">"<span class="hljs-subst">#{<span class="hljs-constant">File</span>.dirname(__FILE_<span class="hljs-number">_</span>)}</span>/../public/user_info.txt"</span>)
122
- contents = contents.split(<span class="hljs-string">' '</span>)
123
- client_id = contents.first
124
- private_key = contents.last
125
- <span class="hljs-keyword">end</span></pre></div></div>
126
-
127
- </li>
128
-
129
-
130
- <li id="section-7">
131
- <div class="annotation">
132
-
133
- <div class="pilwrap ">
134
- <a class="pilcrow" href="#section-7">&#182;</a>
135
- </div>
136
- <p>Create Job instance</p>
137
-
138
- </div>
139
-
140
- <div class="content"><div class='highlight'><pre> job = <span class="hljs-constant">GroupDocs::Signature::Envelope</span>.new({<span class="hljs-symbol">:id</span> =&gt; source_id})</pre></div></div>
141
-
142
- </li>
143
-
144
-
145
- <li id="section-8">
146
- <div class="annotation">
147
-
148
- <div class="pilwrap ">
149
- <a class="pilcrow" href="#section-8">&#182;</a>
150
- </div>
151
- <p>Get document by job id</p>
152
-
153
- </div>
154
-
155
- <div class="content"><div class='highlight'><pre> documents = job.documents!({}, {<span class="hljs-symbol">:client_id</span> =&gt; client_id, <span class="hljs-symbol">:private_key</span> =&gt; private_key})</pre></div></div>
156
-
157
- </li>
158
-
159
-
160
- <li id="section-9">
161
- <div class="annotation">
162
-
163
- <div class="pilwrap ">
164
- <a class="pilcrow" href="#section-9">&#182;</a>
165
- </div>
166
- <p>Download converted file</p>
167
-
168
- </div>
169
-
170
- <div class="content"><div class='highlight'><pre> documents[<span class="hljs-number">0</span>].file.download!(downloads_path, {<span class="hljs-symbol">:client_id</span> =&gt; client_id, <span class="hljs-symbol">:private_key</span> =&gt; private_key})
171
-
172
- <span class="hljs-keyword">rescue</span> <span class="hljs-constant">Exception</span> =&gt; e
173
- err = e.message
174
- <span class="hljs-keyword">end</span>
175
- <span class="hljs-keyword">end</span></pre></div></div>
176
-
177
- </li>
178
-
179
-
180
- <li id="section-10">
181
- <div class="annotation">
182
-
183
- <div class="pilwrap ">
184
- <a class="pilcrow" href="#section-10">&#182;</a>
185
- </div>
186
- <p>GET request</p>
187
-
188
- </div>
189
-
190
- <div class="content"><div class='highlight'><pre>get <span class="hljs-string">'/sample21/check'</span> <span class="hljs-keyword">do</span></pre></div></div>
191
-
192
- </li>
193
-
194
-
195
- <li id="section-11">
196
- <div class="annotation">
197
-
198
- <div class="pilwrap ">
199
- <a class="pilcrow" href="#section-11">&#182;</a>
200
- </div>
201
- <p>Check is there download directory</p>
202
-
203
- </div>
204
-
205
- <div class="content"><div class='highlight'><pre> <span class="hljs-keyword">unless</span> <span class="hljs-constant">File</span>.directory?(<span class="hljs-string">"<span class="hljs-subst">#{<span class="hljs-constant">File</span>.dirname(__FILE_<span class="hljs-number">_</span>)}</span>/../public/downloads"</span>)
206
- <span class="hljs-keyword">return</span> <span class="hljs-string">'Directory was not found.'</span>
207
- <span class="hljs-keyword">end</span></pre></div></div>
208
-
209
- </li>
210
-
211
-
212
- <li id="section-12">
213
- <div class="annotation">
214
-
215
- <div class="pilwrap ">
216
- <a class="pilcrow" href="#section-12">&#182;</a>
217
- </div>
218
- <p>Get file name from download directory</p>
219
-
220
- </div>
221
-
222
- <div class="content"><div class='highlight'><pre> name = <span class="hljs-keyword">nil</span>
223
- <span class="hljs-constant">Dir</span>.entries(<span class="hljs-string">"<span class="hljs-subst">#{<span class="hljs-constant">File</span>.dirname(__FILE_<span class="hljs-number">_</span>)}</span>/../public/downloads"</span>).each <span class="hljs-keyword">do</span> |file|
224
- name = file <span class="hljs-keyword">if</span> file != <span class="hljs-string">'.'</span> &amp;&amp; file != <span class="hljs-string">'..'</span>
225
- <span class="hljs-keyword">end</span>
226
-
227
- name
228
- <span class="hljs-keyword">end</span></pre></div></div>
229
-
230
- </li>
231
-
232
-
233
- <li id="section-13">
234
- <div class="annotation">
235
-
236
- <div class="pilwrap ">
237
- <a class="pilcrow" href="#section-13">&#182;</a>
238
- </div>
239
- <p>GET request</p>
240
-
241
- </div>
242
-
243
- <div class="content"><div class='highlight'><pre>get <span class="hljs-string">'/sample21/downloads/:filename'</span> <span class="hljs-keyword">do</span> |filename|</pre></div></div>
244
-
245
- </li>
246
-
247
-
248
- <li id="section-14">
249
- <div class="annotation">
250
-
251
- <div class="pilwrap ">
252
- <a class="pilcrow" href="#section-14">&#182;</a>
253
- </div>
254
- <p>Send file with header to download it</p>
255
-
256
- </div>
257
-
258
- <div class="content"><div class='highlight'><pre> send_file <span class="hljs-string">"<span class="hljs-subst">#{<span class="hljs-constant">File</span>.dirname(__FILE_<span class="hljs-number">_</span>)}</span>/../public/downloads/<span class="hljs-subst">#{filename}</span>"</span>, <span class="hljs-symbol">:filename</span> =&gt; filename, <span class="hljs-symbol">:type</span> =&gt; <span class="hljs-string">'Application/octet-stream'</span>
259
- <span class="hljs-keyword">end</span></pre></div></div>
260
-
261
- </li>
262
-
263
-
264
- <li id="section-15">
265
- <div class="annotation">
266
-
267
- <div class="pilwrap ">
268
- <a class="pilcrow" href="#section-15">&#182;</a>
269
- </div>
270
- <p>POST request</p>
271
-
272
- </div>
273
-
274
- <div class="content"><div class='highlight'><pre>post <span class="hljs-string">'/sample-21-how-to-create-and-upload-envelop-to-groupdocs-account'</span> <span class="hljs-keyword">do</span></pre></div></div>
275
-
276
- </li>
277
-
278
-
279
- <li id="section-16">
280
- <div class="annotation">
281
-
282
- <div class="pilwrap ">
283
- <a class="pilcrow" href="#section-16">&#182;</a>
284
- </div>
285
- <p>Set variables</p>
286
-
287
- </div>
288
-
289
- <div class="content"><div class='highlight'><pre> set <span class="hljs-symbol">:client_id</span>, params[<span class="hljs-symbol">:clientId</span>]
290
- set <span class="hljs-symbol">:private_key</span>, params[<span class="hljs-symbol">:privateKey</span>]
291
- set <span class="hljs-symbol">:email</span>, params[<span class="hljs-symbol">:email</span>]
292
- set <span class="hljs-symbol">:name</span>, params[<span class="hljs-symbol">:name</span>]
293
- set <span class="hljs-symbol">:lastName</span>, params[<span class="hljs-symbol">:lastName</span>]
294
- set <span class="hljs-symbol">:fileId</span>, params[<span class="hljs-symbol">:fileId</span>]
295
- set <span class="hljs-symbol">:callback</span>, params[<span class="hljs-symbol">:callback</span>]
296
- set <span class="hljs-symbol">:base_path</span>, params[<span class="hljs-symbol">:basePath</span>]
297
- set <span class="hljs-symbol">:url</span>, params[<span class="hljs-symbol">:url</span>]
298
- set <span class="hljs-symbol">:source</span>, params[<span class="hljs-symbol">:source</span>]</pre></div></div>
299
-
300
- </li>
301
-
302
-
303
- <li id="section-17">
304
- <div class="annotation">
305
-
306
- <div class="pilwrap ">
307
- <a class="pilcrow" href="#section-17">&#182;</a>
308
- </div>
309
- <p>Set download path</p>
310
-
311
- </div>
312
-
313
- <div class="content"><div class='highlight'><pre> downloads_path = <span class="hljs-string">"<span class="hljs-subst">#{<span class="hljs-constant">File</span>.dirname(__FILE_<span class="hljs-number">_</span>)}</span>/../public/downloads"</span></pre></div></div>
314
-
315
- </li>
316
-
317
-
318
- <li id="section-18">
319
- <div class="annotation">
320
-
321
- <div class="pilwrap ">
322
- <a class="pilcrow" href="#section-18">&#182;</a>
323
- </div>
324
- <p>Remove all files from download directory or create folder if it not there</p>
325
-
326
- </div>
327
-
328
- <div class="content"><div class='highlight'><pre> <span class="hljs-keyword">if</span> <span class="hljs-constant">File</span>.directory?(downloads_path)
329
- <span class="hljs-constant">Dir</span>.foreach(downloads_path) { |f| fn = <span class="hljs-constant">File</span>.join(downloads_path, f); <span class="hljs-constant">File</span>.delete(fn) <span class="hljs-keyword">if</span> f != <span class="hljs-string">'.'</span> &amp;&amp; f != <span class="hljs-string">'..'</span> }
330
- <span class="hljs-keyword">else</span>
331
- <span class="hljs-constant">Dir::</span>mkdir(downloads_path)
332
- <span class="hljs-keyword">end</span>
333
-
334
- <span class="hljs-keyword">begin</span></pre></div></div>
335
-
336
- </li>
337
-
338
-
339
- <li id="section-19">
340
- <div class="annotation">
341
-
342
- <div class="pilwrap ">
343
- <a class="pilcrow" href="#section-19">&#182;</a>
344
- </div>
345
- <p>Check required variables</p>
346
-
347
- </div>
348
-
349
- <div class="content"><div class='highlight'><pre> raise <span class="hljs-string">'Please enter all required parameters'</span> <span class="hljs-keyword">if</span> settings.client_id.empty? <span class="hljs-keyword">or</span> settings.private_key.empty? <span class="hljs-keyword">or</span> settings.email.empty? <span class="hljs-keyword">or</span> settings.name.empty? <span class="hljs-keyword">or</span> settings.lastName.empty?</pre></div></div>
350
-
351
- </li>
352
-
353
-
354
- <li id="section-20">
355
- <div class="annotation">
356
-
357
- <div class="pilwrap ">
358
- <a class="pilcrow" href="#section-20">&#182;</a>
359
- </div>
360
- <p>Prepare base path</p>
361
-
362
- </div>
363
-
364
- <div class="content"><div class='highlight'><pre> <span class="hljs-keyword">if</span> settings.base_path.empty?
365
- base_path = <span class="hljs-string">'https://api.groupdocs.com'</span>
366
- <span class="hljs-keyword">elsif</span> settings.base_path.match(<span class="hljs-string">'/v2.0'</span>)
367
- base_path = settings.base_path.split(<span class="hljs-string">'/v2.0'</span>)[<span class="hljs-number">0</span>]
368
- <span class="hljs-keyword">else</span>
369
- base_path = settings.base_path
370
- <span class="hljs-keyword">end</span></pre></div></div>
371
-
372
- </li>
373
-
374
-
375
- <li id="section-21">
376
- <div class="annotation">
377
-
378
- <div class="pilwrap ">
379
- <a class="pilcrow" href="#section-21">&#182;</a>
380
- </div>
381
- <p>Configure your access to API server</p>
382
-
383
- </div>
384
-
385
- <div class="content"><div class='highlight'><pre> <span class="hljs-constant">GroupDocs</span>.configure <span class="hljs-keyword">do</span> |groupdocs|
386
- groupdocs.client_id = settings.client_id
387
- groupdocs.private_key = settings.private_key</pre></div></div>
388
-
389
- </li>
390
-
391
-
392
- <li id="section-22">
393
- <div class="annotation">
394
-
395
- <div class="pilwrap ">
396
- <a class="pilcrow" href="#section-22">&#182;</a>
397
- </div>
398
- <p>Optionally specify API server and version</p>
399
-
400
- </div>
401
-
402
- <div class="content"><div class='highlight'><pre> groupdocs.api_server = base_path <span class="hljs-comment"># default is 'https://api.groupdocs.com'</span>
403
- <span class="hljs-keyword">end</span></pre></div></div>
404
-
405
- </li>
406
-
407
-
408
- <li id="section-23">
409
- <div class="annotation">
410
-
411
- <div class="pilwrap ">
412
- <a class="pilcrow" href="#section-23">&#182;</a>
413
- </div>
414
- <p>Write client and private key to the file for callback job</p>
415
-
416
- </div>
417
-
418
- <div class="content"><div class='highlight'><pre> <span class="hljs-keyword">if</span> settings.callback
419
- out_file = <span class="hljs-constant">File</span>.new(<span class="hljs-string">"<span class="hljs-subst">#{<span class="hljs-constant">File</span>.dirname(__FILE_<span class="hljs-number">_</span>)}</span>/../public/user_info.txt"</span>, <span class="hljs-string">'w'</span>)</pre></div></div>
420
-
421
- </li>
422
-
423
-
424
- <li id="section-24">
425
- <div class="annotation">
426
-
427
- <div class="pilwrap ">
428
- <a class="pilcrow" href="#section-24">&#182;</a>
429
- </div>
430
- <p>White space is required</p>
431
-
432
- </div>
433
-
434
- <div class="content"><div class='highlight'><pre> out_file.write(<span class="hljs-string">"<span class="hljs-subst">#{settings.client_id}</span> "</span>)
435
- out_file.write(<span class="hljs-string">"<span class="hljs-subst">#{settings.private_key}</span>"</span>)
436
- out_file.close
437
- <span class="hljs-keyword">end</span>
438
-
439
- file = <span class="hljs-keyword">nil</span></pre></div></div>
440
-
441
- </li>
442
-
443
-
444
- <li id="section-25">
445
- <div class="annotation">
446
-
447
- <div class="pilwrap ">
448
- <a class="pilcrow" href="#section-25">&#182;</a>
449
- </div>
450
- <p>Get document by file GUID</p>
451
-
452
- </div>
453
-
454
- <div class="content"><div class='highlight'><pre> <span class="hljs-keyword">case</span> settings.source
455
- <span class="hljs-keyword">when</span> <span class="hljs-string">'guid'</span></pre></div></div>
456
-
457
- </li>
458
-
459
-
460
- <li id="section-26">
461
- <div class="annotation">
462
-
463
- <div class="pilwrap ">
464
- <a class="pilcrow" href="#section-26">&#182;</a>
465
- </div>
466
- <p>Create instance of File</p>
467
-
468
- </div>
469
-
470
- <div class="content"><div class='highlight'><pre> file = <span class="hljs-constant">GroupDocs::Storage::File</span>.new({<span class="hljs-symbol">:guid</span> =&gt; settings.fileId}).to_document.metadata!()
471
- file = file.last_view.document.file.to_document
472
- <span class="hljs-keyword">when</span> <span class="hljs-string">'local'</span></pre></div></div>
473
-
474
- </li>
475
-
476
-
477
- <li id="section-27">
478
- <div class="annotation">
479
-
480
- <div class="pilwrap ">
481
- <a class="pilcrow" href="#section-27">&#182;</a>
482
- </div>
483
- <p>Construct path</p>
484
-
485
- </div>
486
-
487
- <div class="content"><div class='highlight'><pre> file_path = <span class="hljs-string">"<span class="hljs-subst">#{<span class="hljs-constant">Dir</span>.tmpdir}</span>/<span class="hljs-subst">#{params[<span class="hljs-symbol">:file</span>][<span class="hljs-symbol">:filename</span>]}</span>"</span></pre></div></div>
488
-
489
- </li>
490
-
491
-
492
- <li id="section-28">
493
- <div class="annotation">
494
-
495
- <div class="pilwrap ">
496
- <a class="pilcrow" href="#section-28">&#182;</a>
497
- </div>
498
- <p>Open file</p>
499
-
500
- </div>
501
-
502
- <div class="content"><div class='highlight'><pre> <span class="hljs-constant">File</span>.open(file_path, <span class="hljs-string">'wb'</span>) { |f| f.write(params[<span class="hljs-symbol">:file</span>][<span class="hljs-symbol">:tempfile</span>].read) }</pre></div></div>
503
-
504
- </li>
505
-
506
-
507
- <li id="section-29">
508
- <div class="annotation">
509
-
510
- <div class="pilwrap ">
511
- <a class="pilcrow" href="#section-29">&#182;</a>
512
- </div>
513
- <p>Make a request to API using client_id and private_key</p>
514
-
515
- </div>
516
-
517
- <div class="content"><div class='highlight'><pre> file = <span class="hljs-constant">GroupDocs::Storage::File</span>.upload!(file_path, {}).to_document
518
- <span class="hljs-keyword">when</span> <span class="hljs-string">'url'</span></pre></div></div>
519
-
520
- </li>
521
-
522
-
523
- <li id="section-30">
524
- <div class="annotation">
525
-
526
- <div class="pilwrap ">
527
- <a class="pilcrow" href="#section-30">&#182;</a>
528
- </div>
529
- <p>Upload file from defined url</p>
530
-
531
- </div>
532
-
533
- <div class="content"><div class='highlight'><pre> file = <span class="hljs-constant">GroupDocs::Storage::File</span>.upload_web!(settings.url).to_document
534
- <span class="hljs-keyword">else</span>
535
- raise <span class="hljs-string">'Wrong GUID source.'</span>
536
- <span class="hljs-keyword">end</span>
537
-
538
- name = file.name</pre></div></div>
539
-
540
- </li>
541
-
542
-
543
- <li id="section-31">
544
- <div class="annotation">
545
-
546
- <div class="pilwrap ">
547
- <a class="pilcrow" href="#section-31">&#182;</a>
548
- </div>
549
- <p>Create envelope using user id and entered by user name</p>
550
-
551
- </div>
552
-
553
- <div class="content"><div class='highlight'><pre> envelope = <span class="hljs-constant">GroupDocs::Signature::Envelope</span>.new
554
- envelope.name = file.name
555
- envelope.email_subject = <span class="hljs-string">'Sing this!'</span>
556
- envelope.create!({})</pre></div></div>
557
-
558
- </li>
559
-
560
-
561
- <li id="section-32">
562
- <div class="annotation">
563
-
564
- <div class="pilwrap ">
565
- <a class="pilcrow" href="#section-32">&#182;</a>
566
- </div>
567
- <p>Add uploaded document to envelope</p>
568
-
569
- </div>
570
-
571
- <div class="content"><div class='highlight'><pre> envelope.add_document!(file, {})</pre></div></div>
572
-
573
- </li>
574
-
575
-
576
- <li id="section-33">
577
- <div class="annotation">
578
-
579
- <div class="pilwrap ">
580
- <a class="pilcrow" href="#section-33">&#182;</a>
581
- </div>
582
- <p>Get role list for current user</p>
583
-
584
- </div>
585
-
586
- <div class="content"><div class='highlight'><pre> roles = <span class="hljs-constant">GroupDocs::Signature::Role</span>.get!({})</pre></div></div>
587
-
588
- </li>
589
-
590
-
591
- <li id="section-34">
592
- <div class="annotation">
593
-
594
- <div class="pilwrap ">
595
- <a class="pilcrow" href="#section-34">&#182;</a>
596
- </div>
597
- <p>Create new recipient</p>
598
-
599
- </div>
600
-
601
- <div class="content"><div class='highlight'><pre> recipient = <span class="hljs-constant">GroupDocs::Signature::Recipient</span>.new
602
- recipient.email = settings.email
603
- recipient.first_name = settings.name
604
- recipient.last_name = settings.lastName
605
- recipient.role_id = roles.detect { |role| role.name == <span class="hljs-string">'Signer'</span> }.id</pre></div></div>
606
-
607
- </li>
608
-
609
-
610
- <li id="section-35">
611
- <div class="annotation">
612
-
613
- <div class="pilwrap ">
614
- <a class="pilcrow" href="#section-35">&#182;</a>
615
- </div>
616
- <p>Add recipient to envelope</p>
617
-
618
- </div>
619
-
620
- <div class="content"><div class='highlight'><pre> recipient = envelope.add_recipient!(recipient)</pre></div></div>
621
-
622
- </li>
623
-
624
-
625
- <li id="section-36">
626
- <div class="annotation">
627
-
628
- <div class="pilwrap ">
629
- <a class="pilcrow" href="#section-36">&#182;</a>
630
- </div>
631
- <p>Get document id</p>
632
-
633
- </div>
634
-
635
- <div class="content"><div class='highlight'><pre> document = envelope.documents!({})</pre></div></div>
636
-
637
- </li>
638
-
639
-
640
- <li id="section-37">
641
- <div class="annotation">
642
-
643
- <div class="pilwrap ">
644
- <a class="pilcrow" href="#section-37">&#182;</a>
645
- </div>
646
- <p>Get field and add the location to field</p>
647
-
648
- </div>
649
-
650
- <div class="content"><div class='highlight'><pre> field = <span class="hljs-constant">GroupDocs::Signature::Field</span>.get!({}).detect { |f| f.type == <span class="hljs-symbol">:signature</span> }
651
- field.location = {<span class="hljs-symbol">:location_x</span> =&gt; <span class="hljs-number">0</span>.<span class="hljs-number">15</span>, <span class="hljs-symbol">:location_y</span> =&gt; <span class="hljs-number">0</span>.<span class="hljs-number">73</span>, <span class="hljs-symbol">:location_w</span> =&gt; <span class="hljs-number">150</span>, <span class="hljs-symbol">:location_h</span> =&gt; <span class="hljs-number">50</span>, <span class="hljs-symbol">:page</span> =&gt; <span class="hljs-number">1</span>}
652
- field.name = <span class="hljs-string">'EMPLOYEE SIGNATURE'</span></pre></div></div>
653
-
654
- </li>
655
-
656
-
657
- <li id="section-38">
658
- <div class="annotation">
659
-
660
- <div class="pilwrap ">
661
- <a class="pilcrow" href="#section-38">&#182;</a>
662
- </div>
663
- <p>Add field to envelope</p>
664
-
665
- </div>
666
-
667
- <div class="content"><div class='highlight'><pre> envelope.add_field!(field, document[<span class="hljs-number">0</span>], recipient, {})</pre></div></div>
668
-
669
- </li>
670
-
671
-
672
- <li id="section-39">
673
- <div class="annotation">
674
-
675
- <div class="pilwrap ">
676
- <a class="pilcrow" href="#section-39">&#182;</a>
677
- </div>
678
- <p>Send envelop</p>
679
-
680
- </div>
681
-
682
- <div class="content"><div class='highlight'><pre> envelope.send!({<span class="hljs-symbol">:callbackUrl</span> =&gt; settings.callback})</pre></div></div>
683
-
684
- </li>
685
-
686
-
687
- <li id="section-40">
688
- <div class="annotation">
689
-
690
- <div class="pilwrap ">
691
- <a class="pilcrow" href="#section-40">&#182;</a>
692
- </div>
693
- <p>Prepare to sign url</p>
694
-
695
- </div>
696
-
697
- <div class="content"><div class='highlight'><pre> iframe = <span class="hljs-string">"/signature2/signembed/<span class="hljs-subst">#{envelope.id}</span>/<span class="hljs-subst">#{recipient.id}</span>"</span></pre></div></div>
698
-
699
- </li>
700
-
701
-
702
- <li id="section-41">
703
- <div class="annotation">
704
-
705
- <div class="pilwrap ">
706
- <a class="pilcrow" href="#section-41">&#182;</a>
707
- </div>
708
- <p>Construct result string</p>
709
-
710
- </div>
711
-
712
- <div class="content"><div class='highlight'><pre> url = <span class="hljs-constant">GroupDocs::Api::Request</span>.new(<span class="hljs-symbol">:path</span> =&gt; iframe).prepare_and_sign_url</pre></div></div>
713
-
714
- </li>
715
-
716
-
717
- <li id="section-42">
718
- <div class="annotation">
719
-
720
- <div class="pilwrap ">
721
- <a class="pilcrow" href="#section-42">&#182;</a>
722
- </div>
723
- <p>Generate iframe URL</p>
724
-
725
- </div>
726
-
727
- <div class="content"><div class='highlight'><pre> <span class="hljs-keyword">case</span> base_path
728
- <span class="hljs-keyword">when</span> <span class="hljs-string">'https://stage-api-groupdocs.dynabic.com'</span>
729
- iframe = <span class="hljs-string">"https://stage-api-groupdocs.dynabic.com<span class="hljs-subst">#{url}</span>"</span>
730
- <span class="hljs-keyword">when</span> <span class="hljs-string">'https://dev-api-groupdocs.dynabic.com'</span>
731
- iframe = <span class="hljs-string">"https://dev-apps.groupdocs.com<span class="hljs-subst">#{url}</span>"</span>
732
- <span class="hljs-keyword">else</span>
733
- iframe = <span class="hljs-string">"https://apps.groupdocs.com<span class="hljs-subst">#{url}</span>"</span>
734
- <span class="hljs-keyword">end</span></pre></div></div>
735
-
736
- </li>
737
-
738
-
739
- <li id="section-43">
740
- <div class="annotation">
741
-
742
- <div class="pilwrap ">
743
- <a class="pilcrow" href="#section-43">&#182;</a>
744
- </div>
745
- <p>Make iframe</p>
746
-
747
- </div>
748
-
749
- <div class="content"><div class='highlight'><pre> iframe = <span class="hljs-string">"&lt;iframe id='downloadframe' src='<span class="hljs-subst">#{iframe}</span>' width='800' height='1000'&gt;&lt;/iframe&gt;"</span></pre></div></div>
750
-
751
- </li>
752
-
753
-
754
- <li id="section-44">
755
- <div class="annotation">
756
-
757
- <div class="pilwrap ">
758
- <a class="pilcrow" href="#section-44">&#182;</a>
759
- </div>
760
- <p>Create message</p>
761
-
762
- </div>
763
-
764
- <div class="content"><div class='highlight'><pre> message = <span class="hljs-string">"&lt;p&gt;File was uploaded to GroupDocs. Here you can see your &lt;strong&gt;<span class="hljs-subst">#{name}</span>&lt;/strong&gt; file in the GroupDocs Embedded Viewer.&lt;/p&gt;"</span>
765
- <span class="hljs-keyword">rescue</span> <span class="hljs-constant">Exception</span> =&gt; e
766
- err = e.message
767
- <span class="hljs-keyword">end</span></pre></div></div>
768
-
769
- </li>
770
-
771
-
772
- <li id="section-45">
773
- <div class="annotation">
774
-
775
- <div class="pilwrap ">
776
- <a class="pilcrow" href="#section-45">&#182;</a>
777
- </div>
778
- <p>Set variables for template</p>
779
-
780
- </div>
781
-
782
- <div class="content"><div class='highlight'><pre> haml <span class="hljs-symbol">:sample21</span>, <span class="hljs-symbol">:locals</span> =&gt; {<span class="hljs-symbol">:userId</span> =&gt; settings.client_id, <span class="hljs-symbol">:privateKey</span> =&gt; settings.private_key, <span class="hljs-symbol">:email</span> =&gt; settings.email, <span class="hljs-symbol">:name</span> =&gt; settings.name, <span class="hljs-symbol">:lastName</span> =&gt; settings.lastName, <span class="hljs-symbol">:iframe</span> =&gt; iframe, <span class="hljs-symbol">:massage</span> =&gt; message, <span class="hljs-symbol">:err</span> =&gt; err, <span class="hljs-symbol">:callback</span> =&gt; settings.callback,}
783
- <span class="hljs-keyword">end</span></pre></div></div>
784
-
785
- </li>
786
-
787
- </ul>
788
- </div>
789
- </body>
790
- </html>
1
+ <!DOCTYPE html>
2
+
3
+ <html>
4
+ <head>
5
+ <title>sample21.rb</title>
6
+ <meta http-equiv="content-type" content="text/html; charset=UTF-8">
7
+ <meta name="viewport" content="width=device-width, target-densitydpi=160dpi, initial-scale=1.0; maximum-scale=1.0; user-scalable=0;">
8
+ <link rel="stylesheet" media="all" href="docco.css" />
9
+ </head>
10
+ <body>
11
+ <div id="container">
12
+ <div id="background"></div>
13
+
14
+ <ul class="sections">
15
+
16
+ <li id="title">
17
+ <div class="annotation">
18
+ <h1>sample21.rb</h1>
19
+ </div>
20
+ </li>
21
+
22
+
23
+
24
+ <li id="section-1">
25
+ <div class="annotation">
26
+
27
+ <div class="pilwrap ">
28
+ <a class="pilcrow" href="#section-1">&#182;</a>
29
+ </div>
30
+ <p>GET request</p>
31
+
32
+ </div>
33
+
34
+ <div class="content"><div class='highlight'><pre>get <span class="hljs-string">'/sample-21-how-to-create-and-upload-envelop-to-groupdocs-account'</span> <span class="hljs-keyword">do</span>
35
+ haml <span class="hljs-symbol">:sample21</span>
36
+ <span class="hljs-keyword">end</span></pre></div></div>
37
+
38
+ </li>
39
+
40
+
41
+ <li id="section-2">
42
+ <div class="annotation">
43
+
44
+ <div class="pilwrap ">
45
+ <a class="pilcrow" href="#section-2">&#182;</a>
46
+ </div>
47
+ <p>POST request</p>
48
+
49
+ </div>
50
+
51
+ <div class="content"><div class='highlight'><pre>post <span class="hljs-string">'/sample21/signature_callback'</span> <span class="hljs-keyword">do</span></pre></div></div>
52
+
53
+ </li>
54
+
55
+
56
+ <li id="section-3">
57
+ <div class="annotation">
58
+
59
+ <div class="pilwrap ">
60
+ <a class="pilcrow" href="#section-3">&#182;</a>
61
+ </div>
62
+ <p>Set download path</p>
63
+
64
+ </div>
65
+
66
+ <div class="content"><div class='highlight'><pre> downloads_path = <span class="hljs-string">"<span class="hljs-subst">#{<span class="hljs-constant">File</span>.dirname(__FILE_<span class="hljs-number">_</span>)}</span>/../public/downloads"</span></pre></div></div>
67
+
68
+ </li>
69
+
70
+
71
+ <li id="section-4">
72
+ <div class="annotation">
73
+
74
+ <div class="pilwrap ">
75
+ <a class="pilcrow" href="#section-4">&#182;</a>
76
+ </div>
77
+ <p>Get callback request</p>
78
+
79
+ </div>
80
+
81
+ <div class="content"><div class='highlight'><pre> data = <span class="hljs-constant">JSON</span>.parse(request.body.read)
82
+ <span class="hljs-keyword">begin</span>
83
+ raise <span class="hljs-string">'Empty params!'</span> <span class="hljs-keyword">if</span> data.empty?
84
+ source_id = <span class="hljs-keyword">nil</span>
85
+ client_id = <span class="hljs-keyword">nil</span>
86
+ private_key = <span class="hljs-keyword">nil</span></pre></div></div>
87
+
88
+ </li>
89
+
90
+
91
+ <li id="section-5">
92
+ <div class="annotation">
93
+
94
+ <div class="pilwrap ">
95
+ <a class="pilcrow" href="#section-5">&#182;</a>
96
+ </div>
97
+ <p>Get value of SourceId</p>
98
+
99
+ </div>
100
+
101
+ <div class="content"><div class='highlight'><pre> data.each <span class="hljs-keyword">do</span> |key, value|
102
+ <span class="hljs-keyword">if</span> key == <span class="hljs-string">'SourceId'</span>
103
+ source_id = value
104
+ <span class="hljs-keyword">end</span>
105
+ <span class="hljs-keyword">end</span></pre></div></div>
106
+
107
+ </li>
108
+
109
+
110
+ <li id="section-6">
111
+ <div class="annotation">
112
+
113
+ <div class="pilwrap ">
114
+ <a class="pilcrow" href="#section-6">&#182;</a>
115
+ </div>
116
+ <p>Get private key and client_id from file user_info.txt</p>
117
+
118
+ </div>
119
+
120
+ <div class="content"><div class='highlight'><pre> <span class="hljs-keyword">if</span> <span class="hljs-constant">File</span>.exist?(<span class="hljs-string">"<span class="hljs-subst">#{<span class="hljs-constant">File</span>.dirname(__FILE_<span class="hljs-number">_</span>)}</span>/../public/user_info.txt"</span>)
121
+ contents = <span class="hljs-constant">File</span>.read(<span class="hljs-string">"<span class="hljs-subst">#{<span class="hljs-constant">File</span>.dirname(__FILE_<span class="hljs-number">_</span>)}</span>/../public/user_info.txt"</span>)
122
+ contents = contents.split(<span class="hljs-string">' '</span>)
123
+ client_id = contents.first
124
+ private_key = contents.last
125
+ <span class="hljs-keyword">end</span></pre></div></div>
126
+
127
+ </li>
128
+
129
+
130
+ <li id="section-7">
131
+ <div class="annotation">
132
+
133
+ <div class="pilwrap ">
134
+ <a class="pilcrow" href="#section-7">&#182;</a>
135
+ </div>
136
+ <p>Create Job instance</p>
137
+
138
+ </div>
139
+
140
+ <div class="content"><div class='highlight'><pre> job = <span class="hljs-constant">GroupDocs::Signature::Envelope</span>.new({<span class="hljs-symbol">:id</span> =&gt; source_id})</pre></div></div>
141
+
142
+ </li>
143
+
144
+
145
+ <li id="section-8">
146
+ <div class="annotation">
147
+
148
+ <div class="pilwrap ">
149
+ <a class="pilcrow" href="#section-8">&#182;</a>
150
+ </div>
151
+ <p>Get document by job id</p>
152
+
153
+ </div>
154
+
155
+ <div class="content"><div class='highlight'><pre> documents = job.documents!({}, {<span class="hljs-symbol">:client_id</span> =&gt; client_id, <span class="hljs-symbol">:private_key</span> =&gt; private_key})</pre></div></div>
156
+
157
+ </li>
158
+
159
+
160
+ <li id="section-9">
161
+ <div class="annotation">
162
+
163
+ <div class="pilwrap ">
164
+ <a class="pilcrow" href="#section-9">&#182;</a>
165
+ </div>
166
+ <p>Download converted file</p>
167
+
168
+ </div>
169
+
170
+ <div class="content"><div class='highlight'><pre> documents[<span class="hljs-number">0</span>].file.download!(downloads_path, {<span class="hljs-symbol">:client_id</span> =&gt; client_id, <span class="hljs-symbol">:private_key</span> =&gt; private_key})
171
+
172
+ <span class="hljs-keyword">rescue</span> <span class="hljs-constant">Exception</span> =&gt; e
173
+ err = e.message
174
+ <span class="hljs-keyword">end</span>
175
+ <span class="hljs-keyword">end</span></pre></div></div>
176
+
177
+ </li>
178
+
179
+
180
+ <li id="section-10">
181
+ <div class="annotation">
182
+
183
+ <div class="pilwrap ">
184
+ <a class="pilcrow" href="#section-10">&#182;</a>
185
+ </div>
186
+ <p>GET request</p>
187
+
188
+ </div>
189
+
190
+ <div class="content"><div class='highlight'><pre>get <span class="hljs-string">'/sample21/check'</span> <span class="hljs-keyword">do</span></pre></div></div>
191
+
192
+ </li>
193
+
194
+
195
+ <li id="section-11">
196
+ <div class="annotation">
197
+
198
+ <div class="pilwrap ">
199
+ <a class="pilcrow" href="#section-11">&#182;</a>
200
+ </div>
201
+ <p>Check is there download directory</p>
202
+
203
+ </div>
204
+
205
+ <div class="content"><div class='highlight'><pre> <span class="hljs-keyword">unless</span> <span class="hljs-constant">File</span>.directory?(<span class="hljs-string">"<span class="hljs-subst">#{<span class="hljs-constant">File</span>.dirname(__FILE_<span class="hljs-number">_</span>)}</span>/../public/downloads"</span>)
206
+ <span class="hljs-keyword">return</span> <span class="hljs-string">'Directory was not found.'</span>
207
+ <span class="hljs-keyword">end</span></pre></div></div>
208
+
209
+ </li>
210
+
211
+
212
+ <li id="section-12">
213
+ <div class="annotation">
214
+
215
+ <div class="pilwrap ">
216
+ <a class="pilcrow" href="#section-12">&#182;</a>
217
+ </div>
218
+ <p>Get file name from download directory</p>
219
+
220
+ </div>
221
+
222
+ <div class="content"><div class='highlight'><pre> name = <span class="hljs-keyword">nil</span>
223
+ <span class="hljs-constant">Dir</span>.entries(<span class="hljs-string">"<span class="hljs-subst">#{<span class="hljs-constant">File</span>.dirname(__FILE_<span class="hljs-number">_</span>)}</span>/../public/downloads"</span>).each <span class="hljs-keyword">do</span> |file|
224
+ name = file <span class="hljs-keyword">if</span> file != <span class="hljs-string">'.'</span> &amp;&amp; file != <span class="hljs-string">'..'</span>
225
+ <span class="hljs-keyword">end</span>
226
+
227
+ name
228
+ <span class="hljs-keyword">end</span></pre></div></div>
229
+
230
+ </li>
231
+
232
+
233
+ <li id="section-13">
234
+ <div class="annotation">
235
+
236
+ <div class="pilwrap ">
237
+ <a class="pilcrow" href="#section-13">&#182;</a>
238
+ </div>
239
+ <p>GET request</p>
240
+
241
+ </div>
242
+
243
+ <div class="content"><div class='highlight'><pre>get <span class="hljs-string">'/sample21/downloads/:filename'</span> <span class="hljs-keyword">do</span> |filename|</pre></div></div>
244
+
245
+ </li>
246
+
247
+
248
+ <li id="section-14">
249
+ <div class="annotation">
250
+
251
+ <div class="pilwrap ">
252
+ <a class="pilcrow" href="#section-14">&#182;</a>
253
+ </div>
254
+ <p>Send file with header to download it</p>
255
+
256
+ </div>
257
+
258
+ <div class="content"><div class='highlight'><pre> send_file <span class="hljs-string">"<span class="hljs-subst">#{<span class="hljs-constant">File</span>.dirname(__FILE_<span class="hljs-number">_</span>)}</span>/../public/downloads/<span class="hljs-subst">#{filename}</span>"</span>, <span class="hljs-symbol">:filename</span> =&gt; filename, <span class="hljs-symbol">:type</span> =&gt; <span class="hljs-string">'Application/octet-stream'</span>
259
+ <span class="hljs-keyword">end</span></pre></div></div>
260
+
261
+ </li>
262
+
263
+
264
+ <li id="section-15">
265
+ <div class="annotation">
266
+
267
+ <div class="pilwrap ">
268
+ <a class="pilcrow" href="#section-15">&#182;</a>
269
+ </div>
270
+ <p>POST request</p>
271
+
272
+ </div>
273
+
274
+ <div class="content"><div class='highlight'><pre>post <span class="hljs-string">'/sample-21-how-to-create-and-upload-envelop-to-groupdocs-account'</span> <span class="hljs-keyword">do</span></pre></div></div>
275
+
276
+ </li>
277
+
278
+
279
+ <li id="section-16">
280
+ <div class="annotation">
281
+
282
+ <div class="pilwrap ">
283
+ <a class="pilcrow" href="#section-16">&#182;</a>
284
+ </div>
285
+ <p>Set variables</p>
286
+
287
+ </div>
288
+
289
+ <div class="content"><div class='highlight'><pre> set <span class="hljs-symbol">:client_id</span>, params[<span class="hljs-symbol">:clientId</span>]
290
+ set <span class="hljs-symbol">:private_key</span>, params[<span class="hljs-symbol">:privateKey</span>]
291
+ set <span class="hljs-symbol">:email</span>, params[<span class="hljs-symbol">:email</span>]
292
+ set <span class="hljs-symbol">:name</span>, params[<span class="hljs-symbol">:name</span>]
293
+ set <span class="hljs-symbol">:lastName</span>, params[<span class="hljs-symbol">:lastName</span>]
294
+ set <span class="hljs-symbol">:fileId</span>, params[<span class="hljs-symbol">:fileId</span>]
295
+ set <span class="hljs-symbol">:callback</span>, params[<span class="hljs-symbol">:callback</span>]
296
+ set <span class="hljs-symbol">:base_path</span>, params[<span class="hljs-symbol">:basePath</span>]
297
+ set <span class="hljs-symbol">:url</span>, params[<span class="hljs-symbol">:url</span>]
298
+ set <span class="hljs-symbol">:source</span>, params[<span class="hljs-symbol">:source</span>]</pre></div></div>
299
+
300
+ </li>
301
+
302
+
303
+ <li id="section-17">
304
+ <div class="annotation">
305
+
306
+ <div class="pilwrap ">
307
+ <a class="pilcrow" href="#section-17">&#182;</a>
308
+ </div>
309
+ <p>Set download path</p>
310
+
311
+ </div>
312
+
313
+ <div class="content"><div class='highlight'><pre> downloads_path = <span class="hljs-string">"<span class="hljs-subst">#{<span class="hljs-constant">File</span>.dirname(__FILE_<span class="hljs-number">_</span>)}</span>/../public/downloads"</span></pre></div></div>
314
+
315
+ </li>
316
+
317
+
318
+ <li id="section-18">
319
+ <div class="annotation">
320
+
321
+ <div class="pilwrap ">
322
+ <a class="pilcrow" href="#section-18">&#182;</a>
323
+ </div>
324
+ <p>Remove all files from download directory or create folder if it not there</p>
325
+
326
+ </div>
327
+
328
+ <div class="content"><div class='highlight'><pre> <span class="hljs-keyword">if</span> <span class="hljs-constant">File</span>.directory?(downloads_path)
329
+ <span class="hljs-constant">Dir</span>.foreach(downloads_path) { |f| fn = <span class="hljs-constant">File</span>.join(downloads_path, f); <span class="hljs-constant">File</span>.delete(fn) <span class="hljs-keyword">if</span> f != <span class="hljs-string">'.'</span> &amp;&amp; f != <span class="hljs-string">'..'</span> }
330
+ <span class="hljs-keyword">else</span>
331
+ <span class="hljs-constant">Dir::</span>mkdir(downloads_path)
332
+ <span class="hljs-keyword">end</span>
333
+
334
+ <span class="hljs-keyword">begin</span></pre></div></div>
335
+
336
+ </li>
337
+
338
+
339
+ <li id="section-19">
340
+ <div class="annotation">
341
+
342
+ <div class="pilwrap ">
343
+ <a class="pilcrow" href="#section-19">&#182;</a>
344
+ </div>
345
+ <p>Check required variables</p>
346
+
347
+ </div>
348
+
349
+ <div class="content"><div class='highlight'><pre> raise <span class="hljs-string">'Please enter all required parameters'</span> <span class="hljs-keyword">if</span> settings.client_id.empty? <span class="hljs-keyword">or</span> settings.private_key.empty? <span class="hljs-keyword">or</span> settings.email.empty? <span class="hljs-keyword">or</span> settings.name.empty? <span class="hljs-keyword">or</span> settings.lastName.empty?</pre></div></div>
350
+
351
+ </li>
352
+
353
+
354
+ <li id="section-20">
355
+ <div class="annotation">
356
+
357
+ <div class="pilwrap ">
358
+ <a class="pilcrow" href="#section-20">&#182;</a>
359
+ </div>
360
+ <p>Prepare base path</p>
361
+
362
+ </div>
363
+
364
+ <div class="content"><div class='highlight'><pre> <span class="hljs-keyword">if</span> settings.base_path.empty?
365
+ base_path = <span class="hljs-string">'https://api.groupdocs.com'</span>
366
+ <span class="hljs-keyword">elsif</span> settings.base_path.match(<span class="hljs-string">'/v2.0'</span>)
367
+ base_path = settings.base_path.split(<span class="hljs-string">'/v2.0'</span>)[<span class="hljs-number">0</span>]
368
+ <span class="hljs-keyword">else</span>
369
+ base_path = settings.base_path
370
+ <span class="hljs-keyword">end</span></pre></div></div>
371
+
372
+ </li>
373
+
374
+
375
+ <li id="section-21">
376
+ <div class="annotation">
377
+
378
+ <div class="pilwrap ">
379
+ <a class="pilcrow" href="#section-21">&#182;</a>
380
+ </div>
381
+ <p>Configure your access to API server</p>
382
+
383
+ </div>
384
+
385
+ <div class="content"><div class='highlight'><pre> <span class="hljs-constant">GroupDocs</span>.configure <span class="hljs-keyword">do</span> |groupdocs|
386
+ groupdocs.client_id = settings.client_id
387
+ groupdocs.private_key = settings.private_key</pre></div></div>
388
+
389
+ </li>
390
+
391
+
392
+ <li id="section-22">
393
+ <div class="annotation">
394
+
395
+ <div class="pilwrap ">
396
+ <a class="pilcrow" href="#section-22">&#182;</a>
397
+ </div>
398
+ <p>Optionally specify API server and version</p>
399
+
400
+ </div>
401
+
402
+ <div class="content"><div class='highlight'><pre> groupdocs.api_server = base_path <span class="hljs-comment"># default is 'https://api.groupdocs.com'</span>
403
+ <span class="hljs-keyword">end</span></pre></div></div>
404
+
405
+ </li>
406
+
407
+
408
+ <li id="section-23">
409
+ <div class="annotation">
410
+
411
+ <div class="pilwrap ">
412
+ <a class="pilcrow" href="#section-23">&#182;</a>
413
+ </div>
414
+ <p>Write client and private key to the file for callback job</p>
415
+
416
+ </div>
417
+
418
+ <div class="content"><div class='highlight'><pre> <span class="hljs-keyword">if</span> settings.callback
419
+ out_file = <span class="hljs-constant">File</span>.new(<span class="hljs-string">"<span class="hljs-subst">#{<span class="hljs-constant">File</span>.dirname(__FILE_<span class="hljs-number">_</span>)}</span>/../public/user_info.txt"</span>, <span class="hljs-string">'w'</span>)</pre></div></div>
420
+
421
+ </li>
422
+
423
+
424
+ <li id="section-24">
425
+ <div class="annotation">
426
+
427
+ <div class="pilwrap ">
428
+ <a class="pilcrow" href="#section-24">&#182;</a>
429
+ </div>
430
+ <p>White space is required</p>
431
+
432
+ </div>
433
+
434
+ <div class="content"><div class='highlight'><pre> out_file.write(<span class="hljs-string">"<span class="hljs-subst">#{settings.client_id}</span> "</span>)
435
+ out_file.write(<span class="hljs-string">"<span class="hljs-subst">#{settings.private_key}</span>"</span>)
436
+ out_file.close
437
+ <span class="hljs-keyword">end</span>
438
+
439
+ file = <span class="hljs-keyword">nil</span></pre></div></div>
440
+
441
+ </li>
442
+
443
+
444
+ <li id="section-25">
445
+ <div class="annotation">
446
+
447
+ <div class="pilwrap ">
448
+ <a class="pilcrow" href="#section-25">&#182;</a>
449
+ </div>
450
+ <p>Get document by file GUID</p>
451
+
452
+ </div>
453
+
454
+ <div class="content"><div class='highlight'><pre> <span class="hljs-keyword">case</span> settings.source
455
+ <span class="hljs-keyword">when</span> <span class="hljs-string">'guid'</span></pre></div></div>
456
+
457
+ </li>
458
+
459
+
460
+ <li id="section-26">
461
+ <div class="annotation">
462
+
463
+ <div class="pilwrap ">
464
+ <a class="pilcrow" href="#section-26">&#182;</a>
465
+ </div>
466
+ <p>Create instance of File</p>
467
+
468
+ </div>
469
+
470
+ <div class="content"><div class='highlight'><pre> file = <span class="hljs-constant">GroupDocs::Storage::File</span>.new({<span class="hljs-symbol">:guid</span> =&gt; settings.fileId}).to_document.metadata!()
471
+ file = file.last_view.document.file.to_document
472
+ <span class="hljs-keyword">when</span> <span class="hljs-string">'local'</span></pre></div></div>
473
+
474
+ </li>
475
+
476
+
477
+ <li id="section-27">
478
+ <div class="annotation">
479
+
480
+ <div class="pilwrap ">
481
+ <a class="pilcrow" href="#section-27">&#182;</a>
482
+ </div>
483
+ <p>Construct path</p>
484
+
485
+ </div>
486
+
487
+ <div class="content"><div class='highlight'><pre> file_path = <span class="hljs-string">"<span class="hljs-subst">#{<span class="hljs-constant">Dir</span>.tmpdir}</span>/<span class="hljs-subst">#{params[<span class="hljs-symbol">:file</span>][<span class="hljs-symbol">:filename</span>]}</span>"</span></pre></div></div>
488
+
489
+ </li>
490
+
491
+
492
+ <li id="section-28">
493
+ <div class="annotation">
494
+
495
+ <div class="pilwrap ">
496
+ <a class="pilcrow" href="#section-28">&#182;</a>
497
+ </div>
498
+ <p>Open file</p>
499
+
500
+ </div>
501
+
502
+ <div class="content"><div class='highlight'><pre> <span class="hljs-constant">File</span>.open(file_path, <span class="hljs-string">'wb'</span>) { |f| f.write(params[<span class="hljs-symbol">:file</span>][<span class="hljs-symbol">:tempfile</span>].read) }</pre></div></div>
503
+
504
+ </li>
505
+
506
+
507
+ <li id="section-29">
508
+ <div class="annotation">
509
+
510
+ <div class="pilwrap ">
511
+ <a class="pilcrow" href="#section-29">&#182;</a>
512
+ </div>
513
+ <p>Make a request to API using client_id and private_key</p>
514
+
515
+ </div>
516
+
517
+ <div class="content"><div class='highlight'><pre> file = <span class="hljs-constant">GroupDocs::Storage::File</span>.upload!(file_path, {}).to_document
518
+ <span class="hljs-keyword">when</span> <span class="hljs-string">'url'</span></pre></div></div>
519
+
520
+ </li>
521
+
522
+
523
+ <li id="section-30">
524
+ <div class="annotation">
525
+
526
+ <div class="pilwrap ">
527
+ <a class="pilcrow" href="#section-30">&#182;</a>
528
+ </div>
529
+ <p>Upload file from defined url</p>
530
+
531
+ </div>
532
+
533
+ <div class="content"><div class='highlight'><pre> file = <span class="hljs-constant">GroupDocs::Storage::File</span>.upload_web!(settings.url).to_document
534
+ <span class="hljs-keyword">else</span>
535
+ raise <span class="hljs-string">'Wrong GUID source.'</span>
536
+ <span class="hljs-keyword">end</span>
537
+
538
+ name = file.name</pre></div></div>
539
+
540
+ </li>
541
+
542
+
543
+ <li id="section-31">
544
+ <div class="annotation">
545
+
546
+ <div class="pilwrap ">
547
+ <a class="pilcrow" href="#section-31">&#182;</a>
548
+ </div>
549
+ <p>Create envelope using user id and entered by user name</p>
550
+
551
+ </div>
552
+
553
+ <div class="content"><div class='highlight'><pre> envelope = <span class="hljs-constant">GroupDocs::Signature::Envelope</span>.new
554
+ envelope.name = file.name
555
+ envelope.email_subject = <span class="hljs-string">'Sing this!'</span>
556
+ envelope.create!({})</pre></div></div>
557
+
558
+ </li>
559
+
560
+
561
+ <li id="section-32">
562
+ <div class="annotation">
563
+
564
+ <div class="pilwrap ">
565
+ <a class="pilcrow" href="#section-32">&#182;</a>
566
+ </div>
567
+ <p>Add uploaded document to envelope</p>
568
+
569
+ </div>
570
+
571
+ <div class="content"><div class='highlight'><pre> envelope.add_document!(file, {})</pre></div></div>
572
+
573
+ </li>
574
+
575
+
576
+ <li id="section-33">
577
+ <div class="annotation">
578
+
579
+ <div class="pilwrap ">
580
+ <a class="pilcrow" href="#section-33">&#182;</a>
581
+ </div>
582
+ <p>Get role list for current user</p>
583
+
584
+ </div>
585
+
586
+ <div class="content"><div class='highlight'><pre> roles = <span class="hljs-constant">GroupDocs::Signature::Role</span>.get!({})</pre></div></div>
587
+
588
+ </li>
589
+
590
+
591
+ <li id="section-34">
592
+ <div class="annotation">
593
+
594
+ <div class="pilwrap ">
595
+ <a class="pilcrow" href="#section-34">&#182;</a>
596
+ </div>
597
+ <p>Create new recipient</p>
598
+
599
+ </div>
600
+
601
+ <div class="content"><div class='highlight'><pre> recipient = <span class="hljs-constant">GroupDocs::Signature::Recipient</span>.new
602
+ recipient.email = settings.email
603
+ recipient.first_name = settings.name
604
+ recipient.last_name = settings.lastName
605
+ recipient.role_id = roles.detect { |role| role.name == <span class="hljs-string">'Signer'</span> }.id</pre></div></div>
606
+
607
+ </li>
608
+
609
+
610
+ <li id="section-35">
611
+ <div class="annotation">
612
+
613
+ <div class="pilwrap ">
614
+ <a class="pilcrow" href="#section-35">&#182;</a>
615
+ </div>
616
+ <p>Add recipient to envelope</p>
617
+
618
+ </div>
619
+
620
+ <div class="content"><div class='highlight'><pre> recipient = envelope.add_recipient!(recipient)</pre></div></div>
621
+
622
+ </li>
623
+
624
+
625
+ <li id="section-36">
626
+ <div class="annotation">
627
+
628
+ <div class="pilwrap ">
629
+ <a class="pilcrow" href="#section-36">&#182;</a>
630
+ </div>
631
+ <p>Get document id</p>
632
+
633
+ </div>
634
+
635
+ <div class="content"><div class='highlight'><pre> document = envelope.documents!({})</pre></div></div>
636
+
637
+ </li>
638
+
639
+
640
+ <li id="section-37">
641
+ <div class="annotation">
642
+
643
+ <div class="pilwrap ">
644
+ <a class="pilcrow" href="#section-37">&#182;</a>
645
+ </div>
646
+ <p>Get field and add the location to field</p>
647
+
648
+ </div>
649
+
650
+ <div class="content"><div class='highlight'><pre> field = <span class="hljs-constant">GroupDocs::Signature::Field</span>.get!({}).detect { |f| f.type == <span class="hljs-symbol">:signature</span> }
651
+ field.location = {<span class="hljs-symbol">:location_x</span> =&gt; <span class="hljs-number">0</span>.<span class="hljs-number">15</span>, <span class="hljs-symbol">:location_y</span> =&gt; <span class="hljs-number">0</span>.<span class="hljs-number">73</span>, <span class="hljs-symbol">:location_w</span> =&gt; <span class="hljs-number">150</span>, <span class="hljs-symbol">:location_h</span> =&gt; <span class="hljs-number">50</span>, <span class="hljs-symbol">:page</span> =&gt; <span class="hljs-number">1</span>}
652
+ field.name = <span class="hljs-string">'EMPLOYEE SIGNATURE'</span></pre></div></div>
653
+
654
+ </li>
655
+
656
+
657
+ <li id="section-38">
658
+ <div class="annotation">
659
+
660
+ <div class="pilwrap ">
661
+ <a class="pilcrow" href="#section-38">&#182;</a>
662
+ </div>
663
+ <p>Add field to envelope</p>
664
+
665
+ </div>
666
+
667
+ <div class="content"><div class='highlight'><pre> envelope.add_field!(field, document[<span class="hljs-number">0</span>], recipient, {})</pre></div></div>
668
+
669
+ </li>
670
+
671
+
672
+ <li id="section-39">
673
+ <div class="annotation">
674
+
675
+ <div class="pilwrap ">
676
+ <a class="pilcrow" href="#section-39">&#182;</a>
677
+ </div>
678
+ <p>Send envelop</p>
679
+
680
+ </div>
681
+
682
+ <div class="content"><div class='highlight'><pre> envelope.send!({<span class="hljs-symbol">:callbackUrl</span> =&gt; settings.callback})</pre></div></div>
683
+
684
+ </li>
685
+
686
+
687
+ <li id="section-40">
688
+ <div class="annotation">
689
+
690
+ <div class="pilwrap ">
691
+ <a class="pilcrow" href="#section-40">&#182;</a>
692
+ </div>
693
+ <p>Prepare to sign url</p>
694
+
695
+ </div>
696
+
697
+ <div class="content"><div class='highlight'><pre> iframe = <span class="hljs-string">"/signature2/signembed/<span class="hljs-subst">#{envelope.id}</span>/<span class="hljs-subst">#{recipient.id}</span>"</span></pre></div></div>
698
+
699
+ </li>
700
+
701
+
702
+ <li id="section-41">
703
+ <div class="annotation">
704
+
705
+ <div class="pilwrap ">
706
+ <a class="pilcrow" href="#section-41">&#182;</a>
707
+ </div>
708
+ <p>Construct result string</p>
709
+
710
+ </div>
711
+
712
+ <div class="content"><div class='highlight'><pre> url = <span class="hljs-constant">GroupDocs::Api::Request</span>.new(<span class="hljs-symbol">:path</span> =&gt; iframe).prepare_and_sign_url</pre></div></div>
713
+
714
+ </li>
715
+
716
+
717
+ <li id="section-42">
718
+ <div class="annotation">
719
+
720
+ <div class="pilwrap ">
721
+ <a class="pilcrow" href="#section-42">&#182;</a>
722
+ </div>
723
+ <p>Generate iframe URL</p>
724
+
725
+ </div>
726
+
727
+ <div class="content"><div class='highlight'><pre> <span class="hljs-keyword">case</span> base_path
728
+ <span class="hljs-keyword">when</span> <span class="hljs-string">'https://stage-api-groupdocs.dynabic.com'</span>
729
+ iframe = <span class="hljs-string">"https://stage-api-groupdocs.dynabic.com<span class="hljs-subst">#{url}</span>"</span>
730
+ <span class="hljs-keyword">when</span> <span class="hljs-string">'https://dev-api-groupdocs.dynabic.com'</span>
731
+ iframe = <span class="hljs-string">"https://dev-apps.groupdocs.com<span class="hljs-subst">#{url}</span>"</span>
732
+ <span class="hljs-keyword">else</span>
733
+ iframe = <span class="hljs-string">"https://apps.groupdocs.com<span class="hljs-subst">#{url}</span>"</span>
734
+ <span class="hljs-keyword">end</span></pre></div></div>
735
+
736
+ </li>
737
+
738
+
739
+ <li id="section-43">
740
+ <div class="annotation">
741
+
742
+ <div class="pilwrap ">
743
+ <a class="pilcrow" href="#section-43">&#182;</a>
744
+ </div>
745
+ <p>Make iframe</p>
746
+
747
+ </div>
748
+
749
+ <div class="content"><div class='highlight'><pre> iframe = <span class="hljs-string">"&lt;iframe id='downloadframe' src='<span class="hljs-subst">#{iframe}</span>' width='800' height='1000'&gt;&lt;/iframe&gt;"</span></pre></div></div>
750
+
751
+ </li>
752
+
753
+
754
+ <li id="section-44">
755
+ <div class="annotation">
756
+
757
+ <div class="pilwrap ">
758
+ <a class="pilcrow" href="#section-44">&#182;</a>
759
+ </div>
760
+ <p>Create message</p>
761
+
762
+ </div>
763
+
764
+ <div class="content"><div class='highlight'><pre> message = <span class="hljs-string">"&lt;p&gt;File was uploaded to GroupDocs. Here you can see your &lt;strong&gt;<span class="hljs-subst">#{name}</span>&lt;/strong&gt; file in the GroupDocs Embedded Viewer.&lt;/p&gt;"</span>
765
+ <span class="hljs-keyword">rescue</span> <span class="hljs-constant">Exception</span> =&gt; e
766
+ err = e.message
767
+ <span class="hljs-keyword">end</span></pre></div></div>
768
+
769
+ </li>
770
+
771
+
772
+ <li id="section-45">
773
+ <div class="annotation">
774
+
775
+ <div class="pilwrap ">
776
+ <a class="pilcrow" href="#section-45">&#182;</a>
777
+ </div>
778
+ <p>Set variables for template</p>
779
+
780
+ </div>
781
+
782
+ <div class="content"><div class='highlight'><pre> haml <span class="hljs-symbol">:sample21</span>, <span class="hljs-symbol">:locals</span> =&gt; {<span class="hljs-symbol">:userId</span> =&gt; settings.client_id, <span class="hljs-symbol">:privateKey</span> =&gt; settings.private_key, <span class="hljs-symbol">:email</span> =&gt; settings.email, <span class="hljs-symbol">:name</span> =&gt; settings.name, <span class="hljs-symbol">:lastName</span> =&gt; settings.lastName, <span class="hljs-symbol">:iframe</span> =&gt; iframe, <span class="hljs-symbol">:massage</span> =&gt; message, <span class="hljs-symbol">:err</span> =&gt; err, <span class="hljs-symbol">:callback</span> =&gt; settings.callback,}
783
+ <span class="hljs-keyword">end</span></pre></div></div>
784
+
785
+ </li>
786
+
787
+ </ul>
788
+ </div>
789
+ </body>
790
+ </html>