BISO SH Online-Termine

API-Endpunkte

• Für BISO SH werden die Endpunkte im Controller KtShApiController definiert.
• Die Import-Logik ist in ImportInboxShService zu finden.
• Die Endpunkte sind hier dokumentiert: Wichtig sind die Endpunkte unter {{backend_root}}/api/ktsh/*

Beispiel-Requests

sendFormData

POST {{baseUrl}}/api/ktsh/sendFormData

{
  "data": {
    "anrede": "Herr",
    "nationalitaet": "CH",
    "name": "Skywalker",
    "vorname": "Luke",
    "strasse": "Desert Road",
    "nummer": "99",
    "plz": "9999",
    "ort": "Tatooine",
    "geburtsdatum": "20.05.1967",
    "tel_mobil": "079 999 88 44",
    "email": "luke@skywalker.com",
    "date_guid": "019fea52-b51e-77fc-bdbd-6514265af6cb",
    "fragestellung": "Ich möchte mich über eine Lehrstelle informiern",
    "erfahren_durch": "Freunde",
    "ideen": "Welche Ideen sind vorhanden",
    "beratung_durch": "Beratung durch",
    "klasse": "Klasse",
    "schulhaus" : "Schulhaus",
    "lehrperson" : "Lehrer/in"
    }
}

Konfiguration

Werte-Mapping

Folgendes Mapping muss für SH konfiguriert werden:

Anrede -> Geschlecht:

INSERT INTO value_map
(context,"key",external_value,biso_value) VALUES
     ('api_ktsh','anrede_geschlecht','Herr','m'),
     ('api_ktsh','anrede_geschlecht','Frau','f');

** Nationalität**

INSERT INTO value_map
(context,"key",external_value,biso_value) VALUES
     ('api_ktsh','nationalitaet_id','CH', 1)
;

Erfahren durch

Alle via Import Inbox eröffneten Fälle erhalten denselben "Erfahren durch"-Wert (z.B. "Direktanmeldung"). biso_value ist die ID des entsprechenden Eintrags in der Werteliste "Erfahren durch" (Tabelle beratung_erfahren_durch); external_value wird nicht verwendet. Ohne Eintrag bleibt das Feld bei der Fall-Eröffnung leer.

INSERT INTO value_map
(context,"key",external_value,biso_value) VALUES
     ('api_ktsh','beratung_erfahren_durch_id', NULL, <ID Direktanmeldung>)
;

Hilfsabfrage zum Ermitteln der ID:

SELECT id, erfahren_durch FROM beratung_erfahren_durch;

Admin > Parameter

• termin_email_organizer in Parameter setzen (Vcal-Organizer) oder api-User Person mit Mail zuordnen