Business Cards

About

Use this document type to send an virtual business card when a form is submitted.  The card details are populated using answers from the form.  When opened through a supporting application (like an email client), the file can automatically use the contents to create a contact.  Business Card documents are usually sent by email through an email data destination, but can also be sent by SMS. 

A number of document types are available, and multiple documents can be sent with a single form submission.  Read more about documents here.

NOTE: Most email clients will recognize the *.vcf file extension as contact information and most will allow you to create a new contact based on the information. However, this behaviour may differ depending on the client. For cloud storage destinations, the vCard file will simply be sent to and stored in the destination’s configured location.

 

vCard File Format

Business Card documents are available as a vCard file. vCard is a standard file format for electronic business cards. Different version types are available that structure the data in different ways.

See below for the raw data of a vCard file created by a form submission.  The UID shows the reference number of the form submission that generated the document.

BEGIN:VCARD
VERSION:3.0
PRODID:-//ProntoForms//NONSGML v1.0//EN
UID:ProntoForms-20140722-18590001
TZ:America/Toronto
FN:John
N:Smith;John
ORG:Company ABC
TITLE:Sales manager
EMAIL:johndoe@abc.com
ADR;TYPE=work:535 Legget Drive, Kanata, ON
ADR;TYPE=home:123 Avenue Street, Ottawa, ON
GEO:null;null
TEL;TYPE=WORK,VOICE:6136136134
END:VCARD

[ top ]

 

admin.pngnouser.pngnomobile.png

Settings

Create the document, select vCard as the document type, then follow the instructions below.

vcard.png

 

Document Basics

Name/Description

Give the document a unique name. Optionally provide a description.

 

Filename

This is the name of the file that will be sent through data destinations.  

  • Use Data Record Expression Language to reference answers in your forms.
  • Static text can also be included.
  • For example, %r -- %a[Customer Name] would name the file like "20140812-180001002  -- John Smith."

filename.png

  • Some data destinations will overwrite files with duplicate names.  Make sure file names are unique by including one or more of:
    • %r - the submission's reference number -- e.g. 20140920-1815562464
    • %r[id] - the submission's ID - e.g. 1815562464
    • %t - the time the form was submitted

[ top ]

 

Document Timezone Source

Choose a document time zone source. This is the time zone for all dates and times in your document.

  • Team Preference Setting: Will use the time zone chosen for the team
  • Data Record: Will use the time zone the form submission is made from (as chosen on the mobile device).
  • Custom: Choose a time zone.

timezonesource.png

[ top ]

 

Auto-Link new forms to this document

Selecting this option will add the document as an "Additional Document" to forms created or imported after this option is set.  Submissions made against these forms will be downloadable in this document format from the "Data" tab of the portal.

autolink.png

[ top ]

 

Card Details

vCard Version

Select a vCard version. This controls the basic structure of the data.  Read here for more information on vCard versions.

Basic Fields

Fill the contact information.  Use Data Record Expression Language to reference questions in the form.  For example, %a[First Name] would use the answer to a question with the label "First Name."

fields.png

[ top ]  

 

Email Address and Phone Number Fields

Enter question labels to fill these fields.  Make sure that these questions are the correct data type in the form (Email for Email, Phone for Phone Number).  This will ensure that only correctly formatted values are used.

phonenumber.png

[ top ]

 

Geo Source

If you want to include a Geo location in the vCard, choose where in the form the geo stamp should be pulled from. This documents where the mobile device was when the contact information was collected.

geosource.png

[ top ]

 

When set up is complete, press "Create."  Link the document to a form in order to use it. 

create.png

[ top ]

 

Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request

Comments