Zum Inhalt springen
Developer

Räume und Objekte

Räume, Hallen und Fahrzeuge mit Nummer, Name, Ort und Ausstattung anlegen oder aktualisieren.

Format
CSV (Semikolon oder Komma)
Rechte
Schreibrecht Veranstaltungen
Beispieldateien
Raeume_beispiel_technisch.csv (technische Spaltennamen)
Räume_beispiel_anwender.csv (deutsche Spaltennamen)

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

Wofür ihr das braucht

Räume und Objekte sind die Orte innerhalb eines Standorts, an denen Angebote stattfinden oder die man buchen kann, zum Beispiel Kursräume, Gymnastikräume oder ein Vereinsbus. Angebote verknüpft ihr später mit einem Raum.

Bevor ihr startet

  • Ihr braucht das Recht Importe (Menüpunkt Import) und das Schreibrecht für Veranstaltungen.
  • Die Standorte solltet ihr vorher über den Import Orte angelegt haben. Die Standort-ID aus dieser Tabelle tragt ihr dann in die Spalte LOCATION_IDENTIFIER ein.
  • Ein Administratorrecht ist für diesen Import nicht nötig.

Datei vorbereiten

  • Format: CSV mit Semikolon ; oder Komma , als Trennzeichen.
  • Kopfzeile: Die erste Spalte ist OBJECT_IDENTIFIER (oder Raumnummer), die zweite OBJECT_NAME (oder Name).
  • Dateiname: Er muss .csv enthalten und mit Räume oder BOOKABLE_ beginnen, zum Beispiel Räume_Halle.csv. Alternativ beginnt die Kopfzeile mit OBJECT_IDENTIFIER;OBJECT_NAME.

Spalten

Spalte Pflicht Inhalt Beispiel
Raumnummer (auch OBJECT_IDENTIFIER, Raum ID, Buchungsobjekt ID, BOOKABLE_IDENTIFIER) ja eure Nummer des Raums oder Objekts R1
Name (auch OBJECT_NAME, Klassenraumname, BOOKABLE_NAME) ja Name des Raums oder Objekts Halle 1
Standort-ID (auch LOCATION_IDENTIFIER, Orts-Nummer) Standort-ID aus dem Import Orte HALLE1
Raumtyp (auch OBJECT_TYPE, Buchungsobjekttyp) Art des Objekts. Erlaubt sind nur die festen Kennungen von vynst: room, vehicle, vehicle-ride-request, aircraft, item, parking-spot, parking-spot-travel, virtual-room, hotel-room, seminar-room, gym, dining-area. Andere Werte bleiben ohne Art. gym
Barrierefrei ja oder nein ja
Etage (auch Stockwerk) Stockwerk EG
Fläche (auch Fläche (m²)) Fläche als ganze Zahl 480
Haustiere erlaubt ja oder nein nein
Sitzplätze (auch Sitzplatzanzahl, Betten) Anzahl als ganze Zahl 40
max. Buchungsanzahl (auch parallele Buchungen) Anzahl als ganze Zahl 2
Laderaumvolumen Volumen als ganze Zahl 6
Kraftstoffart Freitext Diesel
Straße und Hausnummer (auch Straße, Strasse) Straße mit Hausnummer des Raums Lindenweg 4
Adresszusatz (auch Zusatzadresse) zum Beispiel ein Gebäudeteil Hinterhaus
PLZ (auch Postleitzahl) Postleitzahl des Raums 30159
Ort (auch Stadt, Wohnort) Ort des Raums Hannover
Bundesland Bundesland Niedersachsen
Land (auch Staat, Landname) Land als Kürzel oder Name DE
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 des Raums 0511 1234501
E-Mail (auch E-Mail-Adresse) E-Mail-Adresse des Raums halle@example.org
Fax (auch Telefax) Faxnummer
Website (auch Homepage) Internetadresse https://www.example.org/halle-1
Beschreibung (auch Externe Beschreibung) Beschreibung für Mitglieder Große Halle mit Tribüne
Interne Beschreibung Notiz nur für euch Hallenschlüssel beim Hausmeister
Bild URL (auch Bild) Adresse des Bildes oder Nummer der Mediendatei https://www.example.org/bilder/halle-1.jpg
Sichtbarkeit wie bei Orte öffentlich
Sparte Sparten, mehrere mit |~| getrennt FB
VISIBILITY_ACCESS_TAGS Zugriffs-Tags, mehrere mit |~| getrennt

Beispiel

OBJECT_IDENTIFIER;OBJECT_NAME;LOCATION_IDENTIFIER;OBJECT_TYPE;BARRIER_FREE;FLOOR_LEVEL;FLOOR_SIZE;PETS_ALLOWED;SEATING_CAPACITY;BOOKING_LIMIT;CARGO_VOLUME;FUEL_TYPE;EXTERNAL_DESCRIPTION;INTERNAL_DESCRIPTION;IMAGE_URL;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;VISIBILITY_TYPE;UNIFIED_CATEGORY_IDENTIFIER
R1;Halle 1;HALLE1;gym;ja;EG;480;nein;40;2;;;Große Halle mit Tribüne;Hallenschlüssel beim Hausmeister;https://www.example.org/bilder/halle-1.jpg;Lindenweg 4;;30159;Hannover;Niedersachsen;DE;52.3759;9.7320;0511 1234501;halle@example.org;;https://www.example.org/halle-1;public;FB
R2;Kursraum 2;HALLE1;room;nein;1. OG;45;nein;12;1;;;Heller Kursraum mit Spiegelwand;Schlüssel im Kursbüro;;;;;;;;;;;;;;public;TUR
BUS1;Vereinsbus;VEREIN;vehicle;nein;;;nein;9;1;6;Diesel;Neunsitziger Vereinsbus;Fahrzeugschlüssel im Vereinsbüro;;;;;;;;;;;verein@example.org;;;public;FB

Beispieldateien: Raeume_beispiel_technisch.csv mit den technischen Spaltennamen, Räume_beispiel_anwender.csv mit den deutschen Spaltennamen.

Die Räume R1 und R2 liegen im Standort HALLE1 aus dem Beispiel Orte. Der Raum R1 ist eine Halle mit 40 Sitzplätzen und barrierefrei. Der Vereinsbus BUS1 gehört zum Standort VEREIN. Die Raumtypen gym, room und vehicle sind feste Kennungen von vynst.

So geht’s

  1. Öffnet Einstellungen → Import.
  2. Klickt auf Hinzufügen und wählt die Datei aus.
  3. Prüft das Protokoll auf Error:-Zeilen.

Gut zu wissen

  • Gibt es die Raumnummer schon, wird der Raum aktualisiert. Eine neue Nummer legt einen neuen Raum an.
  • Fehlt eine Spalte in der Datei, bleibt ihr Wert unverändert. Ist die Spalte vorhanden, aber eine Textzelle leer, wird der alte Text gelöscht. Bei Zahlen sowie bei ja und nein bleibt der alte Wert, wenn die Zelle leer ist. Bei neuen Räumen gilt für eine leere Ja-Nein-Zelle nein.
  • Ist die Standort-ID unbekannt, hat der Raum danach keinen Standort. Dazu gibt es keine Meldung im Protokoll. Prüft deshalb die Standort-IDs.
  • Die Standort-ID LOCATION_IDENTIFIER ist optional. Ist die Zelle leer, bleibt der bestehende Standort unverändert.
  • Verwendet als Raumnummer möglichst Buchstaben und Zahlen, zum Beispiel R1. Eine reine Zahl sucht vynst zuerst als interne Nummer.

Wenn etwas nicht klappt

Meldung im Protokoll Bedeutung Was tun
Error: skipped missing identifier or name Raumnummer oder Name fehlt. 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