Challenge Overview
The goal of this challenge is to build a DocuSign PDF Tagging application. We would like to emulate the experience that you see in the current DocuSign iOS application. If you've never seen that application or are new to DocuSign please check the Software Guidelines for helpful resources.
See below for the expected application flow:
Login Requirements:
- User logs in to application using DocuSign credentials.
Envelope Config Requirements:
- User selects a PDF to send. (Please provide some hard-coded sample PDFs - you do not need to search local or remote filestores for the PDF)
- User can add one or more recipients by typing in their Full Name and email address.
- NOTE: Each recipient will require a "recipientId". You can use a simple counter to fill this value in (1,2,3...)
PDF Tagger View Requirements:
- PDF selected in Envelope Config is displayed.
- User can zoom in or zoom out anywhere on the PDF.
- If there are multiple pages in the PDF document, then provide a way for the user to navigate between pages.
- Create a hidden menu (see below) with the various "tags" (also referred to as "tabs") that can be placed on the document.
- Click here to view the available tags and the associated parameters for each.
- Use placeholder images for the tags in your submission.
- User should be able to tap a location on the document to open a menu where they can select the tag they wish to place. Upon tag selection, the tag image will be placed at the location of the original touch.
- Tags that are already placed on the PDF can be moved by dragging the image.
- Tags that are already placed can be scaled smaller. Maintain the proportions of the image. The base image should be considered 100% scale. Do not allow scales above 100%
- User should have a way to remove tags that have already been placed.
- A "Done" button should be available at all times for the user to complete the tagging experience.
PDF Tagger View Controller Requirements:
- Track the following information about each tag placed on the document. This data will be used to populate the JSON data element in the HTTP POST request. See below for more details.
- Type
- Scale
- Document Page
- Recipient
- X,Y coordinates
- When the user clicks "Done" a multipart HTTP POST request should be sent to the DocuSign REST API.
- The HTTP POST will include the recipient data provided in Envelope Config, the unaltered binary for the PDF file (do not add the tag images to the PDF!), and a JSON Data Element which contains the tag coordinates.
- Example code for both the POST and the JSON element are attached to this challenge.
This application must be developed using Objective C, HTML5 based applications will not be accepted.
You may use any open source software you desire to deliver this, as long as it is defined in your documentation. You mat not use any propretary code which would require a license fee. If you have any questions about this please raise it in the challenge forums.
DocuSign Resources:
DocuSign Developer Center: https://www.docusign.com/developer-center
Get a Free DocuSign Sandbox: https://www.docusign.com/developer-center/get-started
DocuSign REST API Explorer: http://iodocs.docusign.com/
Your first DocuSign API Call: https://www.docusign.com/developer-center/quick-start/first-api-call
View the Current Tagging Experience
To view the current DocuSign tagger in action download the DocuSign iOS app and follow the below steps. If you do not have a production DocuSign account you can create a free 14 day trial to use the mobile app (you’re free developer account credentials will not work for the mobile app!).
View the current DocuSign tagger in action:
- Download and install the latest DocuSign iOS app from the App Store.
- On the app home page click the SEND A DOCUMENT button.
- Provide a test document from a cloud source, local library, or camera (i.e. png file). The type of file type does not matter for this walkthrough.
- With a file selected, on the following screen click the ADD A SIGNER button.
- On the following screen configure the recipient’s name, email and role. For testing purposes enter YOUR email address, anything for the name, and select REMOTE SIGNER for the Role. Click NEXT.
- The following screen will show you a view of the test file/document you selected. Finger tap anywhere on the document.
- An on-screen tab menu will appear – select the first tag (Sign Here tag) to place at the location you tapped.
- You’ll see the signature tag placed on the document. Now click the SEND button at top right.
If you entered your email address in step 5 then you will receive an email notification very quickly. Open the email and click the View Documents link to view and sign the test document. (Note that these extra steps after step 8 listed above are ancillary to this development challenge – it’s just to help you understand the entire process).
Final Submission Guidelines
Submission Guidelines:
Please provide your xCode project and detailed setup instructions for your application. A video walkthrough is required.