Help:VCard format

From semantic-mediawiki.org
Jump to: navigation, search
VCard format
Exports data in vCard format.
Available languages
deenzh-hans
Further Information
Provided by: Semantic Result Formats
Added: 1.4.2
Removed: still supported
Requirements: none
Format name: vcard
Enabled by default: 
Indicates whether the result format is enabled by default upon installation of the respective extension.
yes
Authors: Markus Krötzsch, Denny Vrandecic, Frank Dengler
Categories: export
Group:
Table of Contents

↓ INFO ↓

The result format vcard, part of Semantic Result Formats, is used to produce links for downloading data from a wiki in vCard format. It is a special format for data export as explained in Help:Inline queries, and therefore properties must use known labels to specify how the wiki data relates to the vCard format.

Parameters

Data fields

Properties in printout statements should use one of the following labels, or otherwise are ignored in the resulting vCard. The available fields are:

  • name (displayed full name)
  • prefix (something like "Dr.")
  • suffix (something like "Jr.")
  • firstname
  • extraname (middle name)
  • lastname
  • birthday (a date)
  • homepage
  • note (any other text)
  • email
  • workphone
  • cellphone
  • homephone
  • organization
  • workpostofficebox
  • workextendedaddress
  • workstreet
  • worklocality
  • workregion
  • workpostalcode
  • workcountry
  • homepostofficebox
  • homeextendedaddress
  • homestreet
  • homelocality
  • homeregion
  • homepostalcode
  • homecountry

Most fields including the phone numbers have no special format and will take whatever you give them.

Example

{{#ask: [[Category:Person]]
| ?firstname
| ?lastname
| ?mail = email
| ?url = homepage
| ?skype = note
| format=vcard
}}

This would display a link to download the vCard. Examples can be found on any person page on semanticweb.org, e.g. Markus Krötzsch. The example shows that you have to lable the queried properties in case they do not correspond to the name of the data fields mentioned below, e.g property "mail" has to be labled with "email".

Remarks

Lists of vCards work very well on most address book tools with the notable exception of MS Outlook. Outlook users can only import the first contact in each vCard file, and must therefore import contacts individually from many links, or consider moving to another tool for personal information management, such as Thunderbird. Outlook also is reported to fail at character decoding in some cases, e.g. if names use non-latin letters.



This documentation page applies to all SMW versions from 1.4.2 to the most current version.
      Other languages: dezh-hans

Help:VCard format en 1.4.2