Der CCC-Service verbindet als "Mittelsmann" GIS-unwillige Fachapplikationen mit den Kartenapplikationen des AGI.
Mittels der "INIT"-Nachrichten wird dabei in der User-Session das Pairing für einen User zwischen der Fachapplikation und der entsprechenden GIS-Applikation initialisiert.
Die Session stellt sicher, dass die Nachrichten für den Benutzer korrekt von der Fachapplikation an die Kartenapplikation des AGI weitergereicht wird.
Die Kommunikation erfolgt bidirektional über Web Socket. Sprich die Fach- und Kartenapplikationen sind sowohl Sender wie auch Empfänger von Nachrichten.
| Name | Richtung | Typ | Beschreibung |
|---|---|---|---|
| connectApp | F > CCC | INIT | Anfrage der Fachapplikation, in die entsprechende Session aufgenommen zu werden. |
| connectGis | K > CCC | INIT | Anfrage der Kartenapplikation, in die entsprechende Session aufgenommen zu werden. |
| notifySessionReady | CCC > F,K | INIT | Nachricht des CCC-Service an Fach- und Kartenapplikation, dass beide Seiten der Session beigetreten sind, und nun "RUN"-Nachrichten ausgetauscht werden können. |
| createGeoObject | F > K | RUN | Versetzt den Web GIS Client, nach Zoom auf den entsprechenden Ort, in den Editiermodus. Anschliessend erfasst der Benutzer an der entsprechenden Stelle die neue Geometrie. |
| editGeoObject | F > K | RUN | Mit dieser Nachricht wird die bestehende Geometrie eines Fachobjektes im GIS editiert. Verhalten des Web GIS Client analog zu «createGeoObject». |
| showGeoObject | F > K | RUN | Bewirkt das zentrierte und selektierte Anzeigen des übergebenen Fachobjektes in der Karte des Web GIS Client. |
| cancelEditGeoObject | F > K | RUN | Aufforderung an die Kartenapplikation, den Edit-Status zu beenden. |
| notifyObjectUpdated | F > K | RUN | Benachrichtigung, dass Informationen eines Fachobjektes geändert wurde → Kartenapplikation lädt darauf beispielsweise die Karte neu. |
| notifyEditGeoObjectDone | K > F | RUN | Mit dieser Nachricht sendet der Web GIS Client nach dem Beenden des Editierens die erfasste / geänderte Geometrie des Fachobjektes an die Fachapplikation. |
| notifyGeoObjectSelected | K > F | RUN | Nach Empfang dieser Nachricht zeigt die Fachapplikation die Informationen des auf der Karte selektierten Fachobjektes an. |
| notifyError | Tri-Dir | ERR | Damit werden Fach- und Kartenapplikation über Fehler benachrichtigt. Absender ist bei Protokollfehlern der CCC-Service, bei Verarbeitungsfehlern die Fachapplikation oder die Kartenapplikation. |
Details: Spezifikation V1.0 (PDF)
| Name | Richtung | Typ | Beschreibung |
|---|---|---|---|
| changeLayerVisibility | F > K | RUN | Aufforderung an die Kartenapplikation, eine geladene Ebene auf sichtbar/unsichtbar zu schalten. |
| reconnectGis / reconnectApp | F,K > CCC | RUN | Anfrage eines V1.2-Clients, nach einem Verbindungsunterbruch wieder in die bestehende Session aufgenommen zu werden. |
| disconnectGis / disconnectApp | F,K > CCC | RUN | Signalisiert dem Server, dass der V1.2-Client die Session absichtlich beendet. Sofortige Terminierung ohne Reconnect-Grace-Period. |
| keyChange | CCC > F,K | RUN | Aufforderung des Servers an einen V1.2-Client, die Keys auszutauschen. |
notifySessionReady wird mit V1.2 um connectionKey und sessionNr erweitert.
createGeoObject, editGeoObject, showGeoObject wurden mit in V1.2 um optionales style-Objekt erweitert.
Details: Protokoll V1.2 Erweiterung
| Thema | Link |
|---|---|
| Service betreiben (Docker) | docs/user/running.md |
| HTML-Testclient verwenden | docs/user/test-client.md |
| Architektur | docs/dev/architektur.md |
| Entwicklerdokumentation | docs/dev/readme.md |