Schnittstelle BVV Sprachprüfungen
für VHS-Sprachprüfungsseite des Bayerischen Volkshochschulverbandes
wir haben eine Schnittstelle zum Datenabruf für die VHS-Sprachprüfungsseite des bvv entwickelt.
Sofern bei der Veranstaltungen nachfolgende Bedingungen erfüllt sind, können über die Schnittstelle Daten zur Veranstaltung abgerufen werden:
- Die Veranstaltung ist "aktiv"
- Die Veranstaltung befindet sich in der Phase "Durchführung"
- Der Wert der Eigenschaft "publizierbar im Internet" steht in der Veranstaltung auf "ja"
- Die Nummer des Veranstaltungsziels ist 8-12 oder 100-209
Der Datenabruf beinhaltet folgende Informationen:
- Autowert der Veranstaltung
- Nummer der Veranstaltung
- Titel der Veranstaltung
- Beschreibung der Veranstaltung
- Information der Veranstaltung
- Szenario der Veranstaltung
- Name des Veranstaltungsziels der Veranstaltung
- Nummer des Veranstaltungsziels der Veranstaltung
- Name der Veranstaltungsart der Veranstaltung
- Nummer der Veranstaltungsart der Veranstaltung
- Name des Niveaus der Veranstaltung
- Nummer des Niveaus der Veranstaltung
- Name des Fachgebiets der Veranstaltung
- Nummer des Fachgebiets der Veranstaltung
- Name des (Bezugs-)Ortes der Veranstaltung
- Zusatzbezeichnung des (Bezugs-)Ortes der Veranstaltung
- Stockwerk des (Bezugs-)Ortes der Veranstaltung
- Adresse des (Bezugs-)Ortes der Veranstaltung
- Name des Ortes der Veranstaltung
- Zusatzbezeichnung des Ortes der Veranstaltung
Information zum Niveau:
Das Niveau kann in der Veranstaltung zugewiesen werden. Nutzen Sie dafür das Objekt Niveau und legen Sie die benötigten Niveaus mit Name und Nummer an.
Und so gehen Sie vor, um den Datenabruf zu ermöglichen:
- Erstellen Sie die Schnittstelle
- Gehen Sie in das Objekt "Schnittstelle"
- Klicken Sie auf ... neben "Schnittstelle erstellen"
- Suchen Sie nach der Vorlage "BVV Sprachprüfungen"
- Klicken Sie auf "erstellen"
- erstellen Sie im verlinkten Objekt "Zugänge" einen Zugang
- verknüpfen Sie einen (bestehenden) Kontakt, der Zugang zur Schnittstelle erhalten soll oder
- erstellen Sie einen neuen Kontakt, der Zugang zur Schnittstelle erhalten soll.
- Übermittelns sie den temporär im Zugang oder im Kontakt angezeigten Token auf sicherem Weg an die Person, die über die Schnittstelle auf die Daten zugreifen können soll.
- Alle Veranstaltungen die über die API erreichbar sind, werden auch im Report "BVV Sprachprüfungen" gelistet.
Die API für den Bayerischen Volkshochschulverband wurde auf der Basis der Allgemeingültige REST-API für cmxOrganize entwickelt.