Help:Ergebnisformat vcard

From semantic-mediawiki.org
Jump to: navigation, search
Ergebnisformat vcard
Has description::Gibt die Ergebnisse im vCard-Dateiformat aus
Weitere Informationen
Software: Has component::Semantic Result Formats
Verfügbar seit: Has minimum version::1.4.2
Verfügbar bis: Has maximum version::aktuell unterstützt
Voraussetzungen: Has further requirements::keine
Name: Has format name::vcard
Standardmäßig aktiviert:{{#info:Gibt an, ob das Ergebnisformat standardmäßig mit Installation der betreffenden Softwareerweiterung aktiviert ist.}} Is enabled by default::ja
Autoren: Has author::Markus Krötzsch, Has author::Denny Vrandecic, Has author::Frank Dengler
Kategorie(n): Has category::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

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

{{#smwdoc:vcard|language=de}}

Datenfelder

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

{{#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

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.



{{#set: |docinfo status=effective }}{{#set: |worn by =Template:Docinfo |warning =Master page updated }}{{#set:

|worn by =Template:Docinfo
|warning =No description
}}{{#set:

|revision id=17143 |namespace=Help |docinfo progress =100 |docinfo priority =3 }}{{#set:docinfo master page=Help:VCard format }}{{#set:docinfo master rev =17133 }}{{#set:docinfo category=Category:Result formats}}{{#set:docinfo author=User:Markus Krötzsch}}{{#set:docinfo editor=User:Kghbln}}{{#set:docinfo support=User:Kghbln}}{{#set:docinfo language=de}}

Diese Dokumentationsseite gilt für alle SMW-Versionen von 1.4.2 bis zur aktuellsten Version.
Andere Versionen: {{#ask: Docinfo master page::Help:VCard format Docinfo language::de from version::!1.4.2|
   ?from version = |
   ?to version = |
   sort = from version|
   order = desc|
   link=none|
   format=list|
   sep=, |
   template=versionlink|
   limit = 3|
   searchlabel = […]
  }}       Andere Sprachen: {{#ask: Docinfo master page::Help:VCard format from version::1.4.2 Docinfo language::!de|
  ?Docinfo language =|
  link=none|
  format=list|
  sep=, |
  template=languagelink|
  sort = Docinfo language|
  order = asc|
  limit = 10|
  searchlabel = […]
}}

Docinfo master page::Help:VCard format Docinfo language::de from version::1.4.2

{{#set:Release status=current}}

{{#set:Is master page=false}}