diff --git a/README.md b/README.md index c997d42..eaf8477 100644 --- a/README.md +++ b/README.md @@ -9,7 +9,7 @@ It downloads templates via the Adobe Sign API, converts them to DocuSign format, 1. **Authenticates** with Adobe Sign via OAuth (one-time browser flow, tokens saved to `.env`) 2. **Downloads** templates — PDF, metadata, and form field definitions -3. **Converts** each template to a DocuSign `envelopeTemplate` JSON, mapping all field types, coordinates, and recipient roles +3. **Converts** each template to a DocuSign `envelopeTemplate` JSON, mapping all field types, coordinates, recipient roles, and conditional field logic 4. **Authenticates** with DocuSign via JWT grant (one-time browser consent, then fully automated) 5. **Uploads** the converted template to DocuSign via the REST API @@ -31,24 +31,13 @@ pip install -r requirements.txt ``` **2. Create a `.env` file** in the project root (never commit this): +```bash +cp .env-sample .env ``` -# Adobe Sign -ADOBE_CLIENT_ID=your-adobe-client-id -ADOBE_CLIENT_SECRET=your-adobe-client-secret - -# DocuSign -DOCUSIGN_CLIENT_ID=your-integration-key -DOCUSIGN_CLIENT_SECRET=your-client-secret -DOCUSIGN_USER_ID=your-docusign-user-guid -DOCUSIGN_ACCOUNT_ID=your-docusign-account-id -DOCUSIGN_PRIVATE_KEY_PATH=/path/to/private.key -DOCUSIGN_AUTH_SERVER=account-d.docusign.com -DOCUSIGN_BASE_URL=https://demo.docusign.net/restapi -DOCUSIGN_REDIRECT_URI=http://localhost:8080/callback -``` - -Use `account-d.docusign.com` and `https://demo.docusign.net/restapi` for sandbox. -For production replace with `account.docusign.com` and your account's base URL (e.g. `https://na3.docusign.net/restapi`). +Then fill in your credentials. See [.env-sample](.env-sample) for the full list of +variables with descriptions. Use `account-d.docusign.com` and +`https://demo.docusign.net/restapi` for sandbox; for production replace with +`account.docusign.com` and your account's base URL (e.g. `https://na3.docusign.net/restapi`). **3. Authenticate with Adobe Sign** (one-time): ```bash @@ -107,7 +96,7 @@ If multiple templates share the same name, the most recently modified one is use ## Field type mapping See [field-mapping.md](field-mapping.md) for the full Adobe Sign → DocuSign tab type table, -including edge cases and known gaps. +conditional logic mapping, and known gaps. ## Known API quirks and bugs