vCard QR-Code mit Hilfe von DirectSmile

Was ist eine vCard?

Die vCard dient als elektronische Visitenkarte und ist ein praktisches Mittel Kontaktdaten einer Person mit einem klick in das Adressbuch eines E-Mail-Programms einzufügen. vCards können sowohl in HTML-Seiten eingebettet sein, als Anhang in einer Mail verschickt werden oder als QR-Code vorliegen.

Wie erstellt man einen vCard Code?

Wir brauchen als erstes die Informationen über den Aufbau einer vCard. Diese kann man sich über das Internet besorgen oder man erstellt sich eine vCard (vcf-Datei) mit Hilfe von MS Outlook.

Erstellen einer vCard mit Outlook

Gehen Sie folgendermaßen vor:

  • Markieren Sie einen Kontakt, für den Sie eine vCard erstellen möchten
  • Klicken Sie im Menü Datei auf Speichern unter
  • Klicken Sie im Feld Dateityp auf VCARD-Dateien (*.vcf)
  • Markieren Sie den Ordner, in dem Sie die vCard-Datei speichern möchten

Klicken Sie auf Speichern

Öffnen Sie diese vcf-Datei mit einem Editor, z.B. Notepad oder Editor.
Die vCard besteht aus einzelnen Eigenschaften und deren Attributen. Parameter dienen der Beschreibung der Eigenschaft.

EIGENSCHAFT[;PARAMETER]:Attribut[;Attribut]

BEGIN:VCARD
VERSION:2.1
N;LANGUAGE=de:Doe;John;Peter;Doktor;sen.
FN:Doktor John Peter Doe sen.
ORG:Doe Company
TEL;WORK;VOICE:(987) 123-4567
ADR;WORK;PREF;ENCODING=QUOTED-PRINTABLE:;;1234 North Street=0D=0A=
Anytown TX751234;United States of America;;;Deutschland
LABEL;WORK;PREF;ENCODING=QUOTED-PRINTABLE:1234 North Street=0D=0A=
Anytown TX751234=0D=0A=
United States of America
X-MS-OL-DEFAULT-POSTAL-ADDRESS:2
URL;WORK:http://www.doeweb.com
EMAIL;PREF;INTERNET:john.doe@nowhere.com
REV:20110921T113816Z
END:VCARD

Die Attribute unserer vCard Vorlage sind gefüllt mit den Informationen von Dr. Doe. Damit dieser vCard Code variabel genutzt werden kann, müssen die statischen Attribute durch Textvariablen ersetzt werden. Die Namen der Textvariablen entsprechen den Spaltenüberschriften der Datenbank. In unserem Beispiel wird eine Datenbank mit folgenden Spalten benutzt:

firstname, lastname, company, street, zip, city, country, email, website, phone

BEGIN:VCARD
VERSION:2.1
N;LANGUAGE=de:[[lastname]];[[firstname]]
FN:[[firstname]] [[lastname]]
ORG:[[company]]
TEL;WORK;VOICE:[[phone]]
ADR;WORK;PREF:;;[[street]];[[city]];;[[zip]];[[country]]
LABEL;WORK;PREF;ENCODING=QUOTED-PRINTABLE:[[street]]=0D=0A=
=0D=0A=
[[zip]] [[city]]=0D=0A=
[[country]]
X-MS-OL-DEFAULT-POSTAL-ADDRESS:2
URL;WORK:[[website]]
EMAIL;PREF;INTERNET:[[email]]
REV:[[TStamp]]
END:VCARD

Um einen funktionierenden vCard Code zu erhalten, müssen noch sämtliche Sonderzeichen encodiert werden, damit DirectSmile bei der Erstellung des QR Codes den Text korrekt interpretieren kann.

Dafür benötigen wir die folgenden Codes:

Code Beschreibung
%3A : Doppelpunkt
%2E . Punkt
%3B ; Semikolon
%3D = Gleich
%2D – Trennzeichen

Für eine schnelle Ersetzung der Sonderzeichen können Sie im Editor per STRG+H nach einem Zeichen suchen und es durch den entsprechenden Code ersetzen. Die einzigen Sonderzeichen die nicht ersetzt werden dürfen sind die eckigen Klammern, welche die Variablen umfassen.

BEGIN%3AVCARD
VERSION%3A2%2E1
N%3BLANGUAGE%3Dde%3A[[lastname]]%3B[[firstname]]
FN%3A[[firstname]]+[[lastname]]
ORG%3A[[company]]
TEL%3BWORK%3BVOICE%3A[[phone]]
ADR%3BWORK%3BPREF%3A%3B%3B[[street]]%3B[[city]]%3B%3B[[zip]]%3B[[country]]
LABEL%3BWORK%3BPREF%3BENCODING%3DQUOTED%2DPRINTABLE%3A[[street]]%3D0D%3D0A%3D
[[zip]]%20[[city]]%20%3D0D%3D0A%3D
[[country]]
X%2DMS%2DOL%2DDEFAULT%2DPOSTAL%2DADDRESS%3A2
URL%3BWORK%3A[[website]]
EMAIL%3BPREF%3BINTERNET%3A[[email]]
REV%3A[[TStamp]]
END%3AVCARD

Da wir am Ende eine Bildanfrage an das Barcode-Plug-In von DirectSmile senden, müssen alle Zeilenumbrüche ebenfalls encodiert und die Umbrüche entfernt werden. Dafür benutzen wir den folgenden Code:

Code Beschreibung
%0A Enter (LF)
BEGIN%3AVCARD%0AVERSION%3A2%2E1%0AN%3BLANGUAGE%3Dde%3A[[lastname]]%3B[[firstname]]%0AFN%3A[[firstname]]+[[lastname]]%0AORG%3A[[company]]%0ATEL%3BWORK%3BVOICE%3A[[phone]]%0AADR%3BWORK%3BPREF%3A%3B%3B[[street]]%3B[[city]]%3B%3B[[zip]]%3B[[country]]%0ALABEL%3BWORK%3BPREF%3BENCODING%3DQUOTED%2DPRINTABLE%3A[[street]]%3D0D%3D0A%3D%0A[[zip]]%20[[city]]%20%3D0D%3D0A%3D%0A[[country]]%0AX%2DMS%2DOL%2DDEFAULT%2DPOSTAL%2DADDRESS%3A2%0AURL%3BWORK%3A[[website]]%0AEMAIL%3BPREF%3BINTERNET%3A[[email]]%0AREV%3A[[TStamp]]%0AEND%3AVCARD

Nun der letzte Schritt:

An einen DirectSmile Server soll die Bildanfrage gesendet werden, damit das Barcode-Plug-In einen QR Code zurückgeben kann. Dafür müssen wir unseren Code noch in ein IMG TAG packen und noch ein paar Parameter für den Server mitgeben. So dass das fertige IMG-TAG wie folgt aussieht.

<image src=“http://your-domain.com/GetBarCode.ashx?qrversion=V10&qrencoding=Byte&t=BEGIN%3AVCARDVERSION%3A2%2E1N%3BLANGUAGE%3Dde%3A%5B%5Blastname%5D%5D%3B%5B%5Bfirstname%5D%5DFN%3A%5B%5Bfirstname%5D%5D+%5B%5Blastname%5D%5DORG%3A%5B%5Bcompany%5D%5DTEL%3BWORK%3BVOICE%3A%5B%5Bphone%5D%5DADR%3BWORK%3BPREF%3A%3B%3B%5B%5Bstreet%5D%5D%3B%5B%5Bcity%5D%5D%3B%3B%5B%5Bzip%5D%5D%3B%5B%5Bcountry%5D%5DLABEL%3BWORK%3BPREF%3BENCODING%3DQUOTED%2DPRINTABLE%3A%5B%5Bstreet%5D%5D%3D0D%3D0A%3D%5B%5Bzip%5D%5D%20%5B%5Bcity%5D%5D%20%3D0D%3D0A%3D%5B%5Bcountry%5D%5DX%2DMS%2DOL%2DDEFAULT%2DPOSTAL%2DADDRESS%3A2URL%3BWORK%3A%5B%5Bwebsite%5D%5DEMAIL%3BPREF%3BINTERNET%3A%5B%5Bemail%5D%5DREV%3A%5B%5BTStamp%5D%5DEND%3AVCARD&s=300&#8243; />
Parameter Beschreibung
<image eröffnet das Image-Tag
src=” Quelle des Bildes
GetBarCode.ashx? Funktion die auf dem Server aufgerufen werden soll
qrversion= Barcode-Typ und –Verschlüsselung des Barcodes
qrencoding= Encoding für das Erstellen des Barcodes
t= Text der mit Barcode abgebildet werden soll
s= Größe des Barcodes in px

Ergebnis:

Diesen Barcode können Sie nun mit Hilfe eines QR to vCard Reader auslesen.

Der folgende Link führt Sie auf eine Seite auf der Sie Ihren ganz persönlichen vCard QR Code erstellen können. http://dsmx2.directsmile.de/Barcode

 

 

 

Haftungsausschluss

Die auf diesen Internetseiten veröffentlichten Inhalte sind sorgfältig recherchiert. Dennoch kann fdoerner.wordpress.com keine Gewähr für die Aktualität, Richtigkeit und Vollständigkeit der bereitgestellten Informationen übernehmen. Für Schäden, die sich aus der Verwendung der abgerufenen Informationen ergeben, wird keine Haftung übernommen.

Für Internetseiten Dritter, auf die durch Hyperlink verwiesen wird, tragen die jeweiligen Anbieter die Verantwortung. fdoerner.wordpress.com hat keinen Einfluss auf Inhalt und Gestaltung der verlinkten Seiten und übernimmt keine Verantwortung für diese Seiten. Wir weisen ausdrücklich darauf hin, dass wir uns mit Inhalten Dritter, die gegen die Rechtsordnung oder die guten Sitten verstoßen, nicht identifizieren, sondern ausdrücklich davon distanzieren. Die Nutzung von Hyperlinks, die zu Seiten Dritter führen, erfolgt auf eigene Verantwortung der Nutzer.

Werbeanzeigen