Eigene Implementierung des Abfallkalenders auf der Kundenwebseite

Aus awm web Hilfe
Wechseln zu: Navigation, Suche


Die Formulardaten für die Auswahlfelder des Abfallkalenders (Kalender, Zone und Abfallart oder Kalender, Ort, Straße, Hausnummer und Abfallart) werden über verschiedene Webservice-Calls befüllt.

Die Abfallarten mit den dazugehörigen Abfuhrterminen werden auf unserem Server aufgrund der Benutzerauswahl im Formular evaluiert und je nach OutputType in Form eines JSON-Arrays, als Downloadlink für eine CSV-, PDF- oder iCal-Datei zurückgeschickt.

Das Styling des Frontends beruht derzeit auf bootstrap und jquery-Combobox. Die Einflüsse von Content Management Systemen (CMS) auf unser CSS sind uns derzeit nicht bekannt. Auch die Einflüsse unseres CSS auf das Design ihres Content Management Systems wurden bisher noch nicht analysiert.


Folgende Aufrufe müssen der Reihe nach ausgeführt werden um das Formular korrekt zu befüllen:

1. Abfragen der verfügbaren Kalender:

https://services.infeo.at/aloa/api/KUNDENNAME/wastecalendar/calendars

Response-Beispiel:

AK CalendarsResponse.png


2. Abfragen der verfügbaren Zonen: Anhand des ausgewählten Kalenders können die dazugehörigen Zonen geladen werden.

https://services.infeo.at/aloa/api/KUNDENNAME/wastecalendar/zones/?calendarId=2

Response-Beispiel:

AK ZonesResponse.png


3. Abfragen der verfügbaren Müllarten: Anhand des ausgewählten Kalenders und der Zone können die dazugehörigen Abfallarten geladen werden.

https://services.infeo.at/aloa/api/KUNDENNAME/wastecalendar/fractions/?calendarId=2&zoneId=1

Response-Beispiel:

AK FractionsForZoneResponse.png


4. Abfragen der verfügbaren Orte: Anhand des ausgewählten Kalenders können die dazugehörigen Orte geladen werden.

https://services.infeo.at/aloa/api/KUNDENNAME/wastecalendar/cities/?calendarId=2

Response-Beispiel:

AK CitiesResponse.png


5. Abfragen der verfügbaren Straßen: Anhand des ausgewählten Ortes können die dazugehörigen Straßen geladen werden.

https://services.infeo.at/aloa/api/KUNDENNAME/wastecalendar/streets/?calendarId=2&cityId=1

Response-Beispiel:

AK AddressesResponse.png


6. Abfragen der verfügbaren Hausnummern: Anhand der ausgewählten Straße können die dazugehörigen Hausnummern geladen werden.

https://services.infeo.at/aloa/api/KUNDENNAME/wastecalendar/housenumbers/?calendarId=2&cityId=1&streetId=1

Response-Beispiel:

AK HousenumbersResponse.png


7. Abfragen der verfügbaren Müllarten: Anhand des ausgewählten Kalenders und der Adresse können die dazugehörigen Abfallarten geladen werden.

https://services.infeo.at/aloa/api/KUNDENNAME/wastecalendar/fractions/?calendarId=2&cityId=1&streetId=1&housenumber=3

Response-Beispiel:

AK FractionsForAddressResponse.png


8. Abfragen der verfügbaren Abfuhrtermine: Anhand des ausgewählten Kalenders und der Zone / Adresse können die dazugehörigen Abfuhrtermine geladen werden.

https://services.infeo.at/aloa/api/KUNDENNAME/wastecalendar/export/?calendarId=2&cityid=1&streetid=1&housenumber=3&fractionIds=1&outputType=json

bzw.

https://services.infeo.at/aloa/api/KUNDENNAME/wastecalendar/export/?calendarId=2&zoneId=1

Response-Beispiel:

AK AbfuhrtermineResponse.png


Ausgabeformate

  • outputType=json: wenn kein expliziter outputType angegeben wird ist 'json' der Default. Dieser outputType gibt die Daten in JSON zurück.
  • outputType=pdf: gibt einen Stream für eine PDF-Datei zurück der im Browser mit einem „Speichern unter“-Dialog abgefangen wird.
  • outputType=csv: gibt einen Stream für eine CSV-Datei zurück der im Browser mit einem „Speichern unter“-Dialog abgefangen wird.
  • outputType=ical: gibt einen Stream für eine iCalendar-Datei zurück der im Browser mit einem „Speichern unter“-Dialog abgefangen wird.