vCard

Represents an RFC6350 (vCard) object, enabling contact-centric processing, extraction, and integration in Grooper.

Remarks

The VCard Type Handler class provides support for vCard files (.vcf, text/vcard, text/directory) within Batch Folders. It enables Grooper to recognize, process, and manipulate vCard contact files as attachments, supporting downstream extraction, conversion, and export workflows.

Overview

• VCardTypeHandler is automatically selected for files with the .vcf extension or with text/vcard or text/directory MIME types.
• Integrates with Batch Folders to enable document-centric workflows, including classification, extraction, and export of contact data.
• Parses vCard content according to RFC6350, supporting standard and extended vCard fields.

vCard Handling

• Loads and parses vCard files as attachments to Batch Folders.
• Provides access to key contact properties (name, company, title, email, phone, address, etc.) for downstream processing and extraction.
• Handles single and multi-contact vCard files, exposing the primary contact's information via viewable properties.

Available Commands

• ExpandPhoto: Extracts the embedded photo (if available) from the vCard and saves it as a child document under the Batch Folder.

Usage Notes

• Use VCard Type Handler to enable contact-aware processing in Grooper, including extraction and export of contact data and photos.
• Combine with Content Type and Data Model configuration to extract structured data from vCard files.
• Suitable for processing contact archives, CRM exports, and other vCard-based content in batch workflows.

For more information, see the documentation for Batch Folder, Attachment Type, and contact data extraction in Grooper.

Properties

Name	Type		Description
Version	String	►	The vCard specification version used to format this contact. Indicates the version of the vCard standard (e.g., "3.0", "4.0") used in the file.
First Name	String	►	The first name of the contact. Extracted from the vCard's structured name field.
Last Name	String	►	The last name (family name) of the contact. Extracted from the vCard's structured name field.
Additional Names	String	►	Additional names (middle names or initials) included on the vCard. Extracted from the vCard's structured name field.
Honorific Prefix	String	►	The honorific prefix part of the contact's name (e.g., "Dr.", "Mr."). Extracted from the vCard's structured name field.
Honorific Suffix	String	►	The honorific suffix part of the contact's name (e.g., "Jr.", "PhD"). Extracted from the vCard's structured name field.
Full Name	String	►	The full formatted name of the contact. The display name as specified in the vCard (FN property).
Nickname	String	►	The nickname of the contact, if specified. Extracted from the vCard's NICKNAME property.
Birthdate	DateTime	►	The birth date of the contact, if specified. Extracted from the vCard's BDAY property.
Company	String	►	The company or organization to which the contact belongs. Extracted from the vCard's ORG property.
Title	String	►	The job title or position of the contact. Extracted from the vCard's TITLE property.
Role	String	►	The role or function of the contact within the organization. Extracted from the vCard's ROLE property.
Home Website Address	String	►	The home/personal website address of the contact. Extracted from the vCard's URL property (home type).
Work Website Address	String	►	The company/work website address of the contact. Extracted from the vCard's URL property (work type).
Notes	String	►	Notes or comments associated with the contact. Extracted from the vCard's NOTE property.
Email Addresses	String	►	The email addresses associated with the contact. Extracted from the vCard's EMAIL properties. Multiple addresses may be present.
Phone Numbers	String	►	The phone numbers associated with the contact. Extracted from the vCard's TEL properties. Multiple numbers may be present.
Addresses	String	►	The postal addresses associated with the contact. Extracted from the vCard's ADR properties. Multiple addresses may be present.

Context Menu Commands

Command	Shortcut	Description
image Expand Photo		Extracts the embedded photo from the vCard (if available) and saves it as a child document under the Batch Folder.