Help:Ergebnisformat vcard

From semantic-mediawiki.org
Ergebnisformat vcard
Gibt die Ergebnisse im vCard-Dateiformat aus
Weitere Informationen
Software: Semantic Result Formats
Verfügbar seit: 1.4.2
Verfügbar bis: aktuell unterstützt
Voraussetzungen: keine
Name: vcard
Standardmäßig aktiviert:Gibt an, ob das Ergebnisformat standardmäßig mit Installation der betreffenden Softwareerweiterung aktiviert ist. ja
Autoren: Markus Krötzsch, Denny Vrandečić, Frank Dengler
Kategorie(n): Export
Inhaltsverzeichnis


Das Ergebnisformat vcard wird dazu eingesetzt Abfrageergebnisse (Spezial:Semantische Suche, eingebettete Abfragen) im vCard-Format (vcf-Datei) exportieren zu können. Es handelt sich um ein spezielles Ergebnisformat für den Datenexport. Die Attribute müssen daher standardisierte Bezeichnungen haben, um das Verhältnis der Daten im Wiki in Bezug auf das vCard-Format beschreiben zu können. Es wird Semantic MediaWiki von der Softwareerweiterung Semantic Result Formats bereitgestellt.

Parameter[edit]

Die folgende Tabelle gibt einen Überblick über die verfügbaren Parameter, beschreibt sie kurz und gibt deren Standardwerte mitsamt dem zugehörigen Eingabetyp an.

Parameter Typ Standard Beschreibung
filename Text vCard.vcf Legt fest, welcher Name für die Ausgabedatei verwendet werden soll

Datenfelder[edit]

Die Attribute müssen entweder entsprechend den folgenden Datenfeldern benannt werden oder in der Ausgabeanweisung die entsprechende Bezeichnung zugewiesen bekommen. Anderenfalls werden die entsprechend Daten in der exportierten Datei ignoriert. Die verfügbaren Datenfelder lauten:

  • name (zeigt den vollen Namen an)
  • prefix (bspw. „Dr.“)
  • suffix (bspw. „Jr.“)
  • firstname
  • extraname (ein weiterer Vorname)
  • lastname
  • birthday (im Datumsformat)
  • homepage
  • note (ein beliebiger Text)
  • email
  • workphone
  • cellphone
  • homephone
  • organization
  • workpostofficebox
  • workextendedaddress
  • workstreet
  • worklocality
  • workregion
  • workpostalcode
  • workcountry
  • homepostofficebox
  • homeextendedaddress
  • homestreet
  • homelocality
  • homeregion
  • homepostalcode
  • homecountry

Den allermeisten Feldern, einschließlich den Rufnummernfeldern wird kein besonderes Format zugewiesen. Es können dort quasi beliebige Angaben gemacht werden.

Beispiel[edit]

{{#ask: [[Kategorie:Person]]
| ?Vorname=firstname
| ?Nachname=lastname
| ?URL=homepage
| format=vcard
}}

Diese Abfrage zeigt einen Link zum Herunterladen der abgefragten Daten als vCard. Beispiele hierzu könne auf den Benutzerseiten auf der Website semanticweb.org angesehen werden, z. B. die Webseite von Markus Krötzsch (siehe dort in der oberen rechten Ecke des Informationsbereich recht oben auf der Seite).

Das Beispiel zeigt auch, dass das abgefragte Attribut mit der entsprechenden Bezeichnung aus dem Abschnitt Datenfelder versehen werden muss, sofern es nicht den der Bezeichnung entsprechenden Namen hat. Beispielsweise muss das Attribut „Name“ nicht mit einer Bezeichnung versehen werden, wohl aber das Attribut „Vorname“ mit der Bezeichnung firstname.

Hinweis[edit]

vCard-Listen sind, mit Ausnahme von bspw. MS Outlook, mit den allermeisten Adressprogrammen problemlos nutzbar. Die Nutzer von MS Outlook können jeweils nur den ersten der in einer vCard-Liste enthaltenen Kontakte importieren, so dass alle Kontakte jeweils aus einer eigenständigen Datei heraus importiert werden müssen. Es sind zudem Berichte bekannt, dass Zeichen nicht-lateinischer Alphabete fehlerhaft importiert werden. Alternativ zu MS Outlook könnte man auch zu einem anderen Programm wechseln, z. B. zu Mozilla Thunderbird.



Diese Dokumentationsseite gilt für alle SMW-Versionen von 1.4.2 bis zur aktuellsten Version.
      Andere Sprachen: zh-hans