Docusign SOAP API Developer Guide

Total Page:16

File Type:pdf, Size:1020Kb

Docusign SOAP API Developer Guide Information Guide 1 DocuSign SOAP API Developer Guide 221 Main Street, Suite 1000, San Francisco, CA 94105 Ι Tel. 866.219.4318 Ι www.docusign.com Ι © DocuSign, Inc. DocuSign SOAP API Developer Guide 2 Copyright ©2003-2016 DocuSign, Inc. All rights reserved. For information about DocuSign trademarks, copyrights and patents refer to the DocuSign Intellectual Property page (https://www.docusign.com/IP) on the DocuSign website. All other trademarks and registered trademarks are the property of their respective holders. No part of this document may be reproduced or transmitted in any form or by any means, electronic or mechanical, for any purpose, without the express written permission of DocuSign, Inc. Under the law, reproducing includes translating into another language or format. Every effort has been made to ensure that the information in this manual is accurate. DocuSign, Inc. is not responsible for printing or clerical errors. Information in this document is subject to change without notice. DocuSign API Developer Guide June 3, 2016 If you have any comments or feedback on our documentation, please send them to us at: [email protected]. Summary of changes for this version: Added tabOrder property to the Tab element that allows senders to set the order in which tabs are shown to users on a page when signing. Note that this option is not available for all account plans. Update the note for the CorrectAndResendEnvelope method to say if automatic reminders are enabled for the envelope, then resending the envelope resets the automatic reminder date and the resend date is used for determining when to send reminder messages. 221 Main Street, Suite 1000, San Francisco, CA 94105 Ι Tel. 866.219.4318 Ι www.docusign.com Ι © DocuSign, Inc. DocuSign SOAP API Developer Guide 3 Table of Contents DocuSign SOAP API Introduction ...................................................................................................... 18 DocuSign Security Requirements and API Call Limits ....................................................................... 18 Integrator Keys ............................................................................................................................ 18 Integrator Key Usage ............................................................................................................. 19 API Call Rate Limits ..................................................................................................................... 19 Authentication .................................................................................................................................... 20 HTTP Header Authentication ................................................................................................. 21 SOAP Header Authentication ................................................................................................. 22 Optional Authentication Mechanism: XML Signature .................................................................... 23 Send On Behalf Of Functionality .................................................................................................. 25 Functions Supported and Not Supported by Send On Behalf Of ............................................ 25 Send On Behalf Of SOAP Examples ...................................................................................... 26 Using Encrypted Passwords in SOAP .......................................................................................... 27 SOAP DSAPI.ASMX and API.ASMX Endpoints ................................................................................. 30 Using DocuSign WSDLs .................................................................................................................... 31 Using DocuSign WSDL’s in the .Net Environment ....................................................................... 31 Creating a Web Reference in Visual Studio 2010 for WSDL files: .......................................... 31 HTTP Header: ........................................................................................................................ 32 Using DocuSign WSDL’s in the Salesforce Environment ............................................................. 32 Providing the Authentication Header ...................................................................................... 32 DocuSign Time Track Header ............................................................................................................ 33 DocuSign Service API ....................................................................................................................... 34 Overview ........................................................................................................................................... 34 Commonly Used Terms ............................................................................................................... 34 Code Samples ............................................................................................................................. 35 Basic Process Flow...................................................................................................................... 37 Example Usage Diagram ............................................................................................................. 37 Placing DocuSign Tags ................................................................................................................ 38 File Limitations ............................................................................................................................. 38 Methods Exposed in the DocuSign Service API ........................................................................... 38 DocuSign Service API Function Groups ............................................................................................ 42 Sending Function Group .................................................................................................................... 44 CreateAndSendEnvelope and CreateEnvelope ........................................................................... 44 221 Main Street, Suite 1000, San Francisco, CA 94105 Ι Tel. 866.219.4318 Ι www.docusign.com Ι © DocuSign, Inc. DocuSign SOAP API Developer Guide 4 Schema .................................................................................................................................. 44 Request XML Data Structure Outline ..................................................................................... 50 Document .............................................................................................................................. 56 Recipient ................................................................................................................................ 58 IDCheckInformationInput........................................................................................................ 64 Rules and Restrictions for OpenTrust Envelopes ................................................................... 65 Tab ........................................................................................................................................ 66 Anchor Tab ............................................................................................................................ 72 Notification ............................................................................................................................. 73 EnvelopeNotification .............................................................................................................. 73 EnvelopeStatus ...................................................................................................................... 74 Rules for CreateAndSendEnvelope and CreateEnvelope....................................................... 74 Sample Code ......................................................................................................................... 77 CreateEnvelopeFromTemplates .................................................................................................. 79 Schema .................................................................................................................................. 80 TemplateReference ................................................................................................................ 81 Schema .................................................................................................................................. 81 EnvelopeInformation .............................................................................................................. 82 FieldData ............................................................................................................................... 84 Rules for CreateEnvelopeFromTemplates ............................................................................. 85 Template Execution Rules ..................................................................................................... 88 Rules for Mapping Data from PDF Forms .............................................................................. 88 Error Rules ............................................................................................................................. 89 Sample Code ......................................................................................................................... 89 CreateEnvelopeFromTemplatesAndForms .................................................................................
Recommended publications
  • Acrobat Application Security Guide (All Versions)
    Acrobat Application Security Guide (all versions) Acrobat® Family of Products © 2012 Adobe Systems Incorporated. All rights reserved. Adobe Application Security Guide for the Adobe® Acrobat Family of Products. If this guide is distributed with software that includes an end user agreement, this guide, as well as the software described in it, is furnished under license and may be used or copied only in accordance with the terms of such license. Except as permitted by any such license, no part of this guide may be reproduced, stored in a retrieval system, or transmitted, in any form or by any means, electronic, mechanical, recording, or otherwise, without the prior written permission of Adobe Systems Incorporated. Please note that the content in this guide is protected under copyright law even if it is not distributed with software that includes an end user license agreement. The content of this guide is furnished for informational use only, is subject to change without notice, and should not be construed as a commitment by Adobe Systems Incorporated. Adobe Systems Incorporated assumes no responsibility or liability for any errors or inaccuracies that may appear in the informational content contained in this guide. Please remember that existing artwork or images that you may want to include in your project may be protected under copyright law. The unauthorized incorporation of such material into your new work could be a violation of the rights of the copyright owner. Please be sure to obtain any permission required from the copyright owner. Any references to company names in sample templates are for demonstration purposes only and are not intended to refer to any actual organization.
    [Show full text]
  • Best Practices for Model-Driven Development with Adobe® Livecycle® ES2 Guides Guiding People Through the Data Capture Experience
    Adobe LiveCycle ES2 Technical Guide Best Practices for Model-Driven Development with Adobe® LiveCycle® ES2 Guides Guiding people through the data capture experience. Introduction Background Guides in Adobe LiveCycle ES2 are Flash Player compatible wizard-like panels that help guide people through a data capture experience. Guides can dynamically change and adapt based on input data to ensure that only relevant questions are asked and accurate data is captured. These rich and engaging experiences help reduce transaction abandonment rates that are prevalent with more complex data collection interfaces. In LiveCycle ES2, Guides use the concept of model-driven development, which is the next level of abstraction in writing software applications. This abstraction offers improved productivity and makes applications that are higher in quality and easier to create, compared to lower-level development techniques. Model-driven development separates the data structures and constraint logic from the user interface and display logic. Models can then be shared and reused by other applications that capture, display or process the same data. The previous incarnation of guides was known as “form guides,” and used an XDP form as both the model and host of the form guide definition. Form guides were built directly in LiveCycle Designer, and were rendered by LiveCycle Forms into a SWF (pronounced “swiff”) file for display in the Flash Player. With the release of LiveCycle ES2, the Guide Builder tool has been moved to LiveCycle Workbench and a new application model has been introduced. The application model (.fml) is created in the Data Modeler tool, which is also a new part of the LiveCycle Workbench in ES2.
    [Show full text]
  • Designer Scripting Reference
    Designer Scripting Reference AEM 6.2 Forms Legal notices For legal notices, see http://help.adobe.com/en_US/legalnotices/index.html. Last updated 5/24/16 Contents About the Scripting Reference . 1 Subforms and containers . 1 Version mapping to the XML Forms Architecture (XFA) . 2 XML Form Object Model Class Hierarchy . 3 object class . 3 list class . 4 treeList class . 5 tree class . 5 node class . 6 container class . 8 content class . 9 model class . 10 textNode class . 11 Scripting Objects . 13 arc . 13 area . 14 assist . 15 barcode . 16 bind . 18 bindItems . 19 bookend . 20 boolean . 21 border . 22 break (deprecated) . 23 breakAfter . 25 breakBefore . 26 i button . 28 calculate . 28 caption . 29 certificate . 31 certificates . 31 checkButton . 33 choiceList . 34 color . 35 comb . 36 command . 37 connect . 37 connectionSet . 39 connectString . 39 contentArea . 40 corner . 41 dataGroup (deprecated) . 42 dataModel . 43 dataValue . 44 dataWindow . 45 date . 46 dateTime . 47 dateTimeEdit . 48 decimal . 49 defaultUi (deprecated) . 50 delete . 51 desc . 52 digestMethod . 53 digestMethods . 54 draw . 55 dSigData . 57 effectiveInputPolicy . 59 effectiveOutputPolicy . 59 encoding . 60 encodings . 61 encrypt . 62 event . 63 eventPseudoModel . 64 exclGroup . 66 exData . 69 execute . 70 exObject . 71 extras . 72 field . 73 fill . 78 filter . 79 float . 80 ii font . ..
    [Show full text]
  • (Acrf.Pdf) Using SAS Program, FDF Files, Excel and Javascript in Acrobat Chen-Jung Wu, Firma Clinical Research
    PharmaSUG 2021 - Paper AP-071 An efficient method to review annotation and create bookmark for case report form (acrf.pdf) using SAS program, FDF files, excel and JavaScript in Acrobat Chen-Jung Wu, Firma Clinical Research ABSTRACT A common method to annotate case report form (acrf.pdf) is to use Acrobat comment tool to draw box and add text; however, this method is time consuming. If the case report form is changed due to protocol amendment, it may need another round to annotate manually. Besides, regular SDTM process involves several people to prepare the package including case report form so it always has some inconsistent issues related to typo, font size and font style. Therefore, converting annotation to excel can help to fix typo issue and update wording quickly; comparing the excel with the metadata in xpt and define.xml. Moreover, making use of excel to remap annotation to migrate page to new version of case report form is another efficient method if there are any changes for case report form due to the protocol amendment. INTRODUCTION A case report form is a paper or electronic questionnaire specifically used in clinical trial research. Figure 1. an example of a blank CRF page. An annotated case report form (acrf.pdf) is a blank CRF with annotations that document the location of the data with the corresponding names of the datasets and the names of those variables included in the submitted datasets. Figure 2. an example of an annotated CRF page for SDTM For annotating case report form (acrf.pdf) with related SDTM variables (Figure 3), it is time consuming.
    [Show full text]
  • What's New in Adobe Digital Enterprise Platform Document
    Discover What’s New in Adobe Digital Enterprise Platform Document Services Designer 10.0 Niall O’Donovan | Assure Dynamics © 2011 Adobe Systems Incorporated. All Rights Reserved. Adobe Confidential. Niall O’Donovan at www.assuredynamics.com © 2011 Adobe Systems Incorporated. All Rights Reserved. Adobe Confidential. 2 Customer experience management does not start here © 2011 Adobe Systems Incorporated. All Rights Reserved. Adobe Confidential. 3 Customer experience management does not even start here © 2011 Adobe Systems Incorporated. All Rights Reserved. Adobe Confidential. 4 Customer experience management starts here! © 2011 Adobe Systems Incorporated. All Rights Reserved. Adobe Confidential. Awesome new features in Designer 10.0 . Add Flash content to a form. Control object formatting using style sheets. Access Solutions, such as Interactive Statements. More new features are included, but we'll discuss those later. © 2011 Adobe Systems Incorporated. All Rights Reserved. Adobe Confidential. 6 Flash in Adobe XML Forms Architecture (XFA) is easy! © 2011 Adobe Systems Incorporated. All Rights Reserved. Adobe Confidential. 7 Developing Flash for XFA © 2011 Adobe Systems Incorporated. All Rights Reserved. Adobe Confidential. 8 Working with Flash in XFA Set the URL for the swf Set image, swf deactivated Settings for interacting with swf © 2011 Adobe Systems Incorporated. All Rights Reserved. Adobe Confidential. 9 Getting started Adobe Digital Enterprise Platform Document Services - Designer 10.0 . Designer includes a new Flash Field object. Requires Acrobat or Adobe Reader 10 or later (preferably 10.1 or later). Set Target Version option to Acrobat and Adobe Reader 10.0 or later. Save form as Adobe Dynamic XML Form (*.pdf). Adobe Flash Builder 4.5.0 .
    [Show full text]
  • Implementing Forms, Workflows, and E-Signatures with Adobe Experience Manager Forms a Best Practices Guide
    Implementing forms, workflows, and e-signatures with Adobe Experience Manager Forms A best practices guide May 2017 TABLE OF CONTENTS 3 Transform enrollment with Adobe Experience Manager Forms 4 Design forms quickly for multiple channels and devices 7 Scale for multiple brands and regions 8 Produce a document of record to meet compliance objectives 9 Go paperless with e-signatures 10 Process submitted forms efficiently 12 Empower mobile workers on tablets or smartphones 13 Measure and optimize form experiences 15 Additional resources 2 Transform enrollment with Adobe Experience Manager Forms Adobe Experience Manager Forms helps government agencies, financial organizations, and other regulated industries streamline application enrollment, process submissions efficiently, and enable dynamic, personalized correspondence for standout customer experiences across any device or channel. Experience Manager Forms works seamlessly with Adobe Marketing Cloud solutions to transform disjointed customer journeys into connected and consistent experiences Read this customer story to find out how a South across multiple channels. African financial institution cut unnecessary steps and increased form completion. In this guide, you will find useful tips on creating simple to complex forms across the enterprise for various devices and channels, meet Adobe Experience Manager compliance goals and efficiently connect form data to backend systems. Forms was a major force in simplifying how we interact You will also learn how to setup analytics for forms and optimize with customers. We can cut experience via A/B testing seven-step processes down to four steps with more control over each form. Additionally, we output completed forms to PDF, giving the customer a copy to help ensure accuracy and add a layer of hands-on service.
    [Show full text]
  • Assembler Service and DDX Reference
    bbc Assembler Service and DDX Reference Adobe Experience Manager 6.3 Forms May 2017 Legal Notices For more information, see http://help.adobe.com/en_US/legalnotices/index.html.s Contents 1 About This Help .........................................................................................................................12 Additional information...............................................................................................................................................................12 Part I: DDX User Document 2 Introducing Document Description XML.................................................................................14 DDX document structure ..........................................................................................................................................................14 DDX building blocks....................................................................................................................................................................14 DDX principles...............................................................................................................................................................................15 Result elements ......................................................................................................................................................................16 Source elements.....................................................................................................................................................................18
    [Show full text]
  • Annotating Crfs More Efficiently Noory Kim, Bhagyashree Shivakumar, Statistics & Data Corporation
    PharmaSUG 2021 - Paper AD-036 Annotating CRFs More Efficiently Noory Kim, Bhagyashree Shivakumar, Statistics & Data Corporation ABSTRACT Annotating a CRF entirely by hand can be tedious and time-consuming. Also, the result can be fragile: A change in the CRF, such as the addition or deletion of pages, can require a lot of rework (as it is not possible to drag and drop annotations between pages of a PDF file). How can we streamline our process and make its output more robust? This paper presents a way to update the metadata of CRF annotations iteratively, in which SAS® and SAS XML Mapper process and transfer the metadata between Excel and PDF files. The metadata can be adjusted either by resizing boxes within a PDF file or by replacing values in an Excel spreadsheet. This approach assumes users have access to SAS XML Mapper and a version of Adobe Acrobat that can import and export XFDF files. Knowledge of a programming language other than SAS is not required. INTRODUCTION The annotated case report form (aCRF) is a required component of the clinical data submission package sent to the FDA (Food and Drug Administration). It is a PDF (Portable Document Format) document bundled with the SDTM (Study Data Tabulation Model) data sets in the package. Manually annotating a CRF can be time-consuming within a PDF editor (such as Adobe Acrobat) due to the inability to drag and drop an annotation between different pages. Also, if the CRF is updated, then the only manual option is to copy and paste between the file with the older version and the file with the newer version.
    [Show full text]
  • Coldfusion and Pdfs Kevin Schmidt [email protected]
    ColdFusion and PDFs Kevin Schmidt [email protected] PowerpointPowerpoint Templates Templates Who am I? Kevin Schmidt Managing Partner ikaria consulting, llc Email: [email protected] Twitter: @kevpocalypse Powerpoint Templates ABOUT PDF (Portable Document Format) What is a PDF? Portable Document Format (PDF) is a file format used to present and exchange documents reliably, independent of software, hardware, or operating system. Invented by Adobe, PDF is now an open standard maintained by the International Organization for Standardization (ISO). PDFs can contain links and buttons, form fields, audio, video, and business logic. They can also be signed electronically and are easily viewed using free Acrobat Reader DC software. Why PDF? • Uniformity • Ease of Use • Standards Powerpoint Templates TYPES OF PDFS Acrobat Forms (AcroForms) AcroForms are the original PDF forms technology, first introduced in 1998. AcroForms accept input in both Forms Data Format (FDF) and XML Forms Data Format (xFDF). Many 3rd party vendors support AcroForms. XML Forms Architecture (XFA) XFA forms are inherently XML rather than PDF, and are incompatible with conventional PDF files. XFA forms “break” Adobe’s Acrobat software, in the sense that Acrobat cannot be used to modify an AEM Forms Designer-created document. XFA forms are not yet fully supported by third party PDF viewers’ vendors. Currently Adobe AEM Forms server software is required to process XFA forms in a server environment. Powerpoint Templates COLDFUSION SUPPORT FOR PDFs History: ColdFusion has a long history of support for PDFs and is continually adding new PDF features with each version to make working with PDFs even easier. Topics: .
    [Show full text]
  • Using-Designer.Pdf
    Using Designer AEM 6.3 Forms Legal notices For legal notices, see http://help.adobe.com/en_US/legalnotices/index.html. Last updated 4/26/17 Contents Welcome to Designer . 1 About Designer . 1 Using Designer in the SAP environment . 1 Using Designer in different spaces . 2 New features in Designer . 2 Render XFA forms as HTML5 forms . 2 Support for Turkish Lira locale . 2 Support for Japanese Postal barcode . 3 Accessibility Checker . 3 Add document title to the PDF title bar . 3 Support for Hindi language . 3 New features in Designer . 3 Preview your XDP forms in HTML in Designer . 3 Preview your XDP forms in HTML in forms manager . 4 Accessibility Checker . 4 Add document title to the PDF title bar . 4 Where to find documentation, samples, and tutorials . 4 Get started with samples and tutorials . 5 Add calculations to forms . 5 Enhance forms by using scripts . 5 Getting Started . 7 About forms . 7 Interactive forms . 7 Non-interactive forms . 8 Print and fill forms . 8 About form designs . 8 Form design layouts . 9 i Fixed layout . 9 Flowable layout . 9 Parts of a form design . 10 Master pages . 10 Pages . 11 Content areas . 11 Subforms . 11 Tables . 12 Field objects . 12 Boilerplate or static objects . 13 Installing and configuring Designer . 13 Configuring JVM settings . 13 Looking at the workspace . 14 About editors . 14 About palettes . 17 Customizing the workspace . .23 Managing library palettes . 28 Steps to creating a form design . 33 Basic steps to creating a form design . 33 Plan the form design . 33 Create the form design .
    [Show full text]
  • Acrobat Implementation of the PDF Specification 9.5.3 3D Views 7
    bbc Acrobat® Implementation of the PDF Specification Adobe® Acrobat SDK April 2007 Version 8.1 © 2007 Adobe Systems Incorporated. All rights reserved. Adobe® Acrobat SDK Implementation of the PDF Specification Edition 1.0, April 2007 If this guide is distributed with software that includes an end user agreement, this guide, as well as the software described in it, is furnished under license and may be used or copied only in accordance with the terms of such license. Except as permitted by any such license, no part of this guide may be reproduced, stored in a retrieval system, or transmitted, in any form or by any means, electronic, mechanical, recording, or otherwise, without the prior written permission of Adobe Systems Incorporated. Please note that the content in this guide is protected under copyright law even if it is not distributed with software that includes an end-user license agreement. The content of this guide is furnished for informational use only, is subject to change without notice, and should not be construed as a commitment by Adobe Systems Incorporated. Adobe Systems Incorporated assumes no responsibility or liability for any errors or inaccuracies that may appear in the informational content contained in this guide. Please remember that existing artwork or images that you may want to include in your project may be protected under copyright law. The unauthorized incorporation of such material into your new work could be a violation of the rights of the copyright owner. Please be sure to obtain any permission required from the copyright owner. Any references to company names, company logos and user names in sample material or sample forms included in this documentation and/or software are for demonstration purposes only and are not intended to refer to any actual organization or persons.
    [Show full text]
  • Best Practices Document for Designing Forms Version 0.4
    Best Practices Document for Designing Forms Version 0.4 Best Practices for Designing Forms Page 1 of 48 Adobe XFA Training Materials Copyright 2005 Adobe Systems Incorporated. All rights reserved. NOTICE: All information contained herein is the property of Adobe Systems Incorporated. No part of this publication (whether in hardcopy or electronic form) may be reproduced or transmitted, in any form or by any means, electronic, mechanical, photocopying, recording, or otherwise, without the prior written consent of the Adobe Systems Incorporated. PostScript is a registered trademark of Adobe Systems Incorporated. All instances of the name PostScript in the text are references to the PostScript language as defined by Adobe Systems Incorporated unless otherwise stated. The name PostScript also is used as a product trademark for Adobe Systems’ implementation of the PostScript language interpreter. Except as otherwise stated, any reference to a “PostScript printing device,” “PostScript display device,” or similar item refers to a printing device, display device or item (respectively) that contains PostScript technology created or licensed by Adobe Systems Incorporated and not to devices or items that purport to be merely compatible with the PostScript language. Adobe, the Adobe logo, Acrobat, the Acrobat logo, Acrobat Capture, Distiller, PostScript, the PostScript logo and Reader are either registered trademarks or trademarks of Adobe Systems Incorporated in the United States and/or other countries. Apple, Macintosh, and Power Macintosh are trademarks of Apple Computer, Inc., registered in the United States and other countries. PowerPC is a registered trademark of IBM Corporation in the United States. ActiveX, Microsoft, Windows, and Windows NT are either registered trademarks or trademarks of Microsoft Corporation in the United States and/or other countries.
    [Show full text]