The Bulk Send feature enables users to create and distribute multiple transactions with minimum effort by using:
- An eligible template, which will be used to create the transactions. A template is "eligible" if it has:
- At least one document other than the Consent Agreement
- At least one placeholder Role
- At least one Signature Field (not necessarily for the placeholder Role)
- A CSV file, which contains signer information for all placeholder Roles
This rest of this section discusses:
- Initiating a Bulk Send
- CSV Header Format
- Sample CSV File
- CSV Files with Non-ASCII Characters
- Validation Process
- Video Tutorial
Bulk Send transactions are sent at the bottom of the hour from which they were created (e.g., a Bulk Send created at 2:31 PM will be sent at 3:30 PM).
- The Bulk Send feature must be enabled on your account.
- An eligible template and suitable CSV file have been created.
The CSV file must specify the ID of the signing method. That ID is case-sensitive. For the method Signing with a Certificate, that ID is "personalCertificateSigning".
To initiate a Bulk Send:
- Click the Templates menu option. The Templates page appears.
- Click the name of an eligible template. Its page appears.
- In the Template details section of that page, click the Bulk send transactions icon. Your system Explorer opens.
- Use your system Explorer to select a suitable CSV file. OneSpan Sign will validate its file format. If the format is valid, the Bulk Send process will begin.
When initiating a Bulk Send using SMS, the phone numbers must follow the E.164 format. For example, +44 7923 123456 in Europe, and +1 247 123 4567 in North America.
This section describes the CSV header format for:
For transactions with one placeholder Role, the header row in a CSV file must have the following format:
- The string
<PlaceholderRoleName>will not appear in the file. Instead, it will be the name of a placeholder Role. Similarly, the strings
<FieldId2>will not appear in the file. Instead, they will be field ID names.
AUTH_CHALLENGEparameters are treated by OneSpan Sign as a single
FieldIdis the ID of a field that belongs to a placeholder Role. It can be used to automatically populate that field in your documents. The header row can have as many of those fields as you need.
- The rows under the header row provide values for the parameters in the header row. There is one such row for each transaction.
- If you want to specify a method of External Signer Verification (
SIGNER_VERIFICATION) such as PCC or DIGIPASS, please contact our Support Team.
If your transactions contain more than one placeholder Role, you must append a set of header fields for each additional role. All required fields must be present for each placeholder Role. For example, a header containing just the required fields for two placeholder Roles could look like this:
<PlaceholderRoleName> field always defines the start of a Role Block. Note that:
- Each Role Block must contain all required fields.
- Within a given Role Block, the order of the fields doesn't matter. Pay close attention to the wording of the previous sentence because: (1) the
AUTHfield has three columns; (2) the
FieldIdfield may have multiple parameters and therefore multiple columns.
Thus the following format is valid, even though the field order differs between its two Role Blocks:
Here is a sample CSV file for a transaction with two signers:
Signer1,David,Smith,[email protected],NONE,,,,,personalCertificateSigning,Signer2,Roger,Waters,[email protected],NONE,,,,133487, DIGIPASS
AUTH_TYPE is assigned the value
NONE for both signers; (2)
133487 is the
If the data you need to put in the CSV file contains non-ASCII characters (e.g., accented characters, Chinese characters), the CSV file should be saved with UNICODE UTF-8 encoding.
By default, Microsoft Excel saves files to CSV format using ANSI coding. The following procedure describes how to save Excel files to CSV format using UNICODE encoding.
To save an Excel file to CSV format using UNICODE UTF-8 encoding:
- Open the file in Microsoft Excel.
- From the top menu, click File > Save As, and browse to the desired directory.
- Select Save as type > CSV (Comma delimited) (*.csv).
- Beside the Save button, click Tools > Web Options....
- Click the Encoding tab.
- Click Save this document as > Unicode (UTF-8).
- In the Web Options window, click OK.
- Save the file.
OneSpan Sign validates the header row before validating any other row in a CSV file. If something is wrong with the header row, an error message is sent. If the header row is verified as valid, OneSpan Sign proceeds to validate the other rows.
The rest of this section discusses the validation of:
OneSpan Sign verifies that in the CSV file's header row:
- For each placeholder Role in the template, there is a Role Block that contains
FieldIdcolumn corresponds to a field that exists for the associated Role.
OneSpan Sign verifies that for each Role Block in each row after the header row:
- Values have been assigned to the
- The value for each
FieldIdis valid. What "valid" means in this context depends on how you've configured the field (e.g., you may have assigned a maximum length to a text field). To better understand the possibilities, see New.
AUTH_CHALLENGE together constitute the "
AUTH field" for a given Role Block.
The value assigned to
AUTH_TYPE must be
SMS. The validation process for
AUTH_CHALLENGE depends on the value assigned to
AUTH_TYPE, as explained in the rest of this section.
AUTH_TYPE = NONE for a particular Role, OneSpan Sign does not try to validate
AUTH_CHALLENGE for that Role. That's because they're not used (see the sample CSV file above).
AUTH_TYPE = CHALLENGE for a particular Role, OneSpan Sign verifies that for that Role:
- At least one
AUTH_PROMPT/AUTH_CHALLENGEpair has been specified.
- There is a 1:1 mapping between prompts and challenges (i.e., for every prompt, there is a challenge — and vice versa).
OneSpan Sign reads prompt and challenge columns from left to right, which means that both of the following are valid ordering schemes:
The above examples illustrate that all
AUTH columns must appear in the order in which they're intended to be used. Here's another example which illustrates that concept: Answer2, Answer1, Question1, Question2 is not a valid order.
AUTH_TYPE = SMS for a particular Role, OneSpan Sign verifies that for that Role there is at least one prompt. The verification process will examine only the first prompt, which should be used to specify the phone number to which an SMS message will be sent. The verification process ignores all other prompt and challenge parameters.