Zum Inhalt springen
Developer

Orte

Standorte wie Hallen, Schulen oder Vereinsheime mit Adresse und Kontakt anlegen oder aktualisieren.

Format
CSV (Semikolon oder Komma)
Rechte
Schreibrecht Veranstaltungen
Beispieldateien
Orte_beispiel_technisch.csv (technische Spaltennamen)
Orte_beispiel_anwender.csv (deutsche Spaltennamen)

Kurz gesagt: Ihr tragt jeden Standort mit einer eigenen Nummer in eine Tabelle ein. vynst legt die Orte an oder aktualisiert sie, anhand dieser Nummer.

Wofür ihr das braucht

Orte sind die Gebäude oder Anlagen, in denen Angebote stattfinden, zum Beispiel Sporthallen, Schulen oder das Vereinsheim. Räume und Angebote ordnet ihr später einem Ort zu. Deshalb importiert ihr die Orte als Erstes.

Bevor ihr startet

  • Ihr braucht das Recht Importe (Menüpunkt Import) und das Schreibrecht für Veranstaltungen.
  • Ein Administratorrecht ist für diesen Import nicht nötig.
  • Die Standort-Nummern braucht ihr später auch für die Räume und Angebote. Verwendet dieselbe Nummer überall.

Datei vorbereiten

  • Format: CSV mit Semikolon ; oder Komma , als Trennzeichen. Excel-Dateien gehen auch, jedes Blatt wird dann als eigene Datei behandelt.
  • Kopfzeile: Die erste Zeile enthält die Spaltennamen. Die ersten beiden Spalten sind Standort-ID und Standortname (oder LOCATION_IDENTIFIER und LOCATION_NAME), in dieser Reihenfolge.
  • Dateiname: Er muss .csv enthalten. Gut passen Namen wie Orte_Verein.csv.

Spalten

Spalte Pflicht Inhalt Beispiel
Standort-ID (auch LOCATION_IDENTIFIER, Standort ID, Orts-Nummer) ja eure Nummer des Standorts HALLE1
Standortname (auch LOCATION_NAME, Standort-Name, Name) ja Name des Standorts Sporthalle Nord
Straße und Hausnummer (auch Straße, Strasse) Straße mit Hausnummer Lindenweg 4
Hausnummer nur, wenn Straße und Hausnummer getrennt stehen 4
PLZ (auch Postleitzahl) Postleitzahl 30159
Ort (auch Stadt, Wohnort) Ort Hannover
Bundesland Bundesland Niedersachsen
Land (auch Staat, Landname) Land als Kürzel oder Name, ohne Angabe gilt Deutschland DE
Adresszusatz (auch Zusatzadresse) zum Beispiel ein Gebäudeteil Hinterhaus
ADDRESS_GEO_LAT (auch lat) Breitengrad als Dezimalzahl mit Punkt 52.3759
ADDRESS_GEO_LNG (auch lng) Längengrad als Dezimalzahl mit Punkt 9.7320
Telefon (auch Telefonnummer) Telefonnummer 0511 1234500
E-Mail (auch E-Mail-Adresse) E-Mail-Adresse halle@example.org
Fax (auch Telefax) Faxnummer 0511 1234509
Website (auch Homepage) Internetadresse https://www.example.org/halle-nord
Beschreibung (auch Externe Beschreibung) Beschreibung für Mitglieder Große Halle mit Tribüne
Interne Beschreibung Notiz nur für euch Schlüssel beim Hausmeister
Standortart (auch Standorttyp, Ortstyp) Art des Standorts: Gebäude, Treffpunkt, Virtueller Ort, Flughafen oder Partnerstandort. Andere Arten werden nicht übernommen, der Ort wird dann als „nicht definiert“ geführt. Gebäude
Sichtbarkeit Wer den Ort sieht: öffentlich, Mit Token, Mit Login, Ausgewählte Nutzer / Tags, Sparte oder Schule öffentlich
VISIBILITY_ACCESS_TAGS Zugriffs-Tags, mehrere mit |~| getrennt
Sparte (auch Sparten-ID, Kategorie-ID) Sparten des Ortes, mehrere mit |~| getrennt FB|~|TUR
Bild URL (auch Bild) Adresse des Bildes oder Nummer der Mediendatei https://www.example.org/bilder/halle-nord.jpg

Beispiel

LOCATION_IDENTIFIER;LOCATION_NAME;INTERNAL_DESCRIPTION;EXTERNAL_DESCRIPTION;LOCATION_TYPE;ADDRESS_STREET_LEVEL;ADDRESS_CO;ADDRESS_ZIP;ADDRESS_CITY;ADDRESS_ADMIN_LEVEL_1;ADDRESS_COUNTRY;ADDRESS_GEO_LAT;ADDRESS_GEO_LNG;MAIN_PHONE;MAIN_EMAIL;MAIN_FAX;MAIN_WEBSITE;IMAGE_URL;VISIBILITY_TYPE;UNIFIED_CATEGORY_IDENTIFIER
HALLE1;Sporthalle Nord;Schlüssel beim Hausmeister;Große Halle mit Tribüne;building;Lindenweg 4;Hinterhaus;30159;Hannover;Niedersachsen;DE;52.3759;9.7320;0511 1234500;halle@example.org;0511 1234509;https://www.example.org/halle-nord;https://www.example.org/bilder/halle-nord.jpg;public;FB|~|TUR
VEREIN;Vereinsheim;Schlüssel im Vereinsbüro;Vereinsheim mit Küche;building;Am Sportplatz 2;;30449;Hannover;Niedersachsen;DE;52.3759;9.7320;;verein@example.org;;;;public;FB
SCHULE;Grundschule Am Park;Schulsekretariat im Hauptgebäude;Pausenhof mit Spielgeräten;building;Parkstraße 12;;30165;Hannover;Niedersachsen;DE;52.3759;9.7320;0511 7654321;;;https://www.example.org/schule-am-park;;public;TUR

Beispieldateien: Orte_beispiel_technisch.csv mit den technischen Spaltennamen, Orte_beispiel_anwender.csv mit den deutschen Spaltennamen.

Die drei Zeilen legen die Standorte HALLE1, VEREIN und SCHULE an. Die Anwender-Datei enthält dieselben Zeilen mit den deutschen Spaltennamen. Die Sporthalle HALLE1 wird im Beispiel für Räume und Angebote verwendet.

So geht’s

  1. Öffnet Einstellungen → Import.
  2. Klickt auf Hinzufügen und wählt die Datei aus.
  3. Prüft nach dem Durchlauf das Protokoll, ob Zeilen mit Error: übersprungen wurden.

Gut zu wissen

  • Gibt es die Standort-ID schon, wird der Ort aktualisiert. Eine neue Nummer legt einen neuen Ort an.
  • Fehlt eine Spalte in der Datei, bleibt ihr Wert beim Ort unverändert. Ist die Spalte vorhanden, aber eine Textzelle leer (zum Beispiel Telefon oder Beschreibung), wird der alte Text gelöscht. Bei den Spalten Sparte und VISIBILITY_ACCESS_TAGS ersetzt die vorhandene Spalte die bisherigen Werte, auch wenn die Zelle leer ist.
  • Verwendet als Standort-ID möglichst Buchstaben und Zahlen, zum Beispiel HALLE1. Eine reine Zahl sucht vynst zuerst als interne Nummer. Dabei kann ein anderer Ort getroffen werden.
  • vynst gleicht die Adresse mit einem Geo-Dienst ab. Findet der Dienst einen Treffer, übernimmt vynst dessen Schreibweise und Koordinaten. Sonst gilt die Adresse aus der Datei.
  • Zeilen ohne Standort-ID oder ohne Standortname werden übersprungen und im Protokoll mit ihren Werten aufgeführt.

Wenn etwas nicht klappt

Meldung im Protokoll Bedeutung Was tun
Error: skipped missing LOCATION_IDENTIFIER or LOCATION_NAME / Standort-ID or Standortname Die Zeile hat keine Standort-ID oder keinen Standortnamen. Darunter steht die Zeile als LINE-DATA. Die Zeile ergänzen und nur diese Zeile erneut importieren.
Error: skipped empty line Eine leere Zeile wurde übersprungen. Nichts.
Error: less then one line Die Datei enthält keine Datenzeile. Prüft, ob die Datei vollständig ist.
Read: 12 rows So viele Zeilen wurden gelesen. Nichts.
FAILED: No matching processor found. Dateiname oder Kopfzeile passen zu keinem Import. Die ersten beiden Spalten und den Dateinamen prüfen.

Siehe auch