Adobe Sign & OutSystems Part-1

หลังจาก OutSystems Release ODC version ออกมา วิธีการใช้งานบางอย่าง หรือการทำงานกับ 3rd party connector บางตัวก็จะมีสิ่งที่เปลี่ยนแปลงไปบ้างจาก version OutSystems 11, Adobe Sign เองก็เป็นตัวที่มีการเปลี่ยนแปลงไปครับ วันนี้เรามีตัวอย่างการ Integration กับ Adobe Sign โดยเรายังสามารถใช้ API Adobe sign ในการทำ Integration ได้ครับ

Step 1 : อย่างแรกคือเราต้องมี Account Adobe Sign ซะก่อน

Step 2 : ต่อไปให้เราสร้าง Integration Key ขึ้นมาโดย ให้เลือกเฉพาะ permissions ที่เราจะใช้ เราจะได้ Key มาใช้สำหรับเป็น Access Token ที่ API permission ที่จะใช้เช็คจาก API Document REST API — Document e-signature Software — Acrobat Sign (adobesign.com)

Step 3 : Install package Multipart/form-data, MultipartFormDataParser (Out of the box ของ ODC version เอา form-data ออกจาก หน้า consume REST API ไปแล้วนะครับ)

Step 4 : เรามาดูที่ Postman กันบ้างว่าเรามี Input, Output หน้าตาเป็นแบบไหนกันบ้าง อันนี้เราจะเห็นว่าทำการส่งไฟล์ไปแล้วเราจะได้ documentId กลับมา ต้องเก็บไว้ใช้ตอน call api send agreement ให้ end user sign

Step 5 : Create comsume REST API

Step 6 : Add Header

Step 7 : Create Secret Setting หลังจาก Publish เราจะสามารถ Manage value ได้บน ODC Portal **Secret เรียกใช้ได้บน Server Action only

Step 8 : Create Server Action Input ให้รับ FileName, FileContent (Binary)

Step 9 : Action PartAdd ใส่ Detail แบบในรูป

Step 10 : MultipartFormDataCreate เอา Parts จาก PartAdd event

Step 11 : Call REST API ใส่ Detail แบบในรูปจะเห็นว่าใช้ Secret Setting เก็บข้อมูล secret value (พวก Key, setting config ให้มาเก็บที่นี่)

Step 12 : Assign value ไปที่ Output variable

ลองเอามาใช้งานบนหน้า screen กันบ้าง

สำหรับ Part 2–3 เราจะมาดูเรื่อง Send Agreements, Web hook กันครับ