Daten abrufen und Wiedervorlagen melden
Welche Daten zwischen i-Planner und JDC fließen, wie du den automatischen Abruf einrichtest und wann i-Planner erledigte Wiedervorlagen an JDC zurückmeldet.
Ist ein JDC-Account angelegt, ruft i-Planner nach Zeitplan Daten bei JUNG, DMS & CIE ab und meldet erledigte Wiedervorlagen an JDC zurück. Hier steht, welche Daten dabei fließen, wie du den Zeitplan einstellst und wann eine Rückmeldung an JDC geht.
Kurz erklärt
An JDC gehen die Zugangsdaten zur Anmeldung und die Erledigung verknüpfter Wiedervorlagen. Einen Datenabruf startet i-Planner nur nach dem Zeitplan Automatischer Abruf am JDC-Account. Einen Abruf auf Knopfdruck gibt es nicht, und die Seite des Accounts zeigt weder einen Verlauf noch Ergebnisse der Abrufe. Setzt du in der Kundenverwaltung eine Aktivität auf erledigt, die mit einer Wiedervorlage in JDC verknüpft ist, stellt i-Planner die Wiedervorlage bei JDC auf den Status „Erledigt“.
Typische Aufgaben:
- Du willst wissen, was an JDC geht: Welche Daten fließen.
- i-Planner soll regelmäßig Daten von JDC abrufen: Automatischen Abruf einrichten.
- Erledigte Aktivitäten sollen bei JDC als erledigt ankommen: Erledigte Wiedervorlagen an JDC zurückmelden.
Was du dafür brauchst, steht unter JUNG, DMS & CIE › Voraussetzungen.
Welche Daten fließen
An JDC gehen die Zugangsdaten zur Anmeldung und die Erledigung verknüpfter Wiedervorlagen. Zurück kommen die Ergebnisse der Zugangsdaten-Prüfung. Den Datenabruf nach Zeitplan startet i-Planner im Hintergrund.
Was i-Planner bei Verbindungsprüfung und Rückmeldung an JDC übermittelt
| Was | Wann |
|---|---|
| Client-ID und Client Secret als Anmeldung beim Anmeldedienst von JDC | Bei der Verbindungsprüfung (automatisch nach dem Anlegen, über Verbindung prüfen und bei der täglichen Prüfung) und bei jeder Rückmeldung einer erledigten Wiedervorlage. Für die Rückmeldung nimmt i-Planner die Zugangsdaten des zuletzt angelegten aktiven JDC-Accounts mit Client-ID. |
| Die Erledigung einer Wiedervorlage: Status „Erledigt“, Ergebnis „Abschluss“ und Änderungsgrund „Datenpflege“ | Sobald eine Aktivität, die mit dieser Wiedervorlage verknüpft ist, in i-Planner auf erledigt gesetzt wird |
Die Verbindungsprüfung verwendet eine erfolgreiche Anmeldung bis zu 25 Minuten weiter. Prüft i-Planner in dieser Zeit erneut einen Account mit derselben Client-ID, fragt es JDC nicht noch einmal, sondern meldet wieder Erfolg.
Was zurückkommt und wo es landet
| Was | Wo du es siehst | Wann |
|---|---|---|
| Ergebnis der Zugangsdaten-Prüfung | Auf der Seite des Accounts unter Organisation › Accounts. Bei Erfolg die Meldung Verbindung erfolgreich und neben der Überschrift grün Verbunden mit Datum und Uhrzeit. Bei Ablehnung rot die Fehlermeldung, zum Beispiel Zugangsdaten fehlerhaft., und das Fenster Validierung fehlgeschlagen. | Direkt nach Account anlegen und bei jedem Klick auf Verbindung prüfen |
| Ergebnis der täglichen Prüfung | Im Status des Accounts: verbunden oder Fehler. Wechselt der Account dabei auf Fehler, bekommt der Accountinhaber zusätzlich die Benachrichtigung „Verbindung fehlgeschlagen:“ mit dem Namen des Accounts und einem Link zu dessen Seite. | Einmal täglich für alle aktiven JDC-Accounts |
| Auffällige Prüfergebnisse: Abgelehnt, Vorübergehend, Hängt fest oder Wiederhergestellt | Unter Organisation › Audit-Log im Protokoll Accounts. Eine erfolgreiche Prüfung steht dort nur, wenn der Account vorher auf Fehler stand. | Bei jeder Prüfung mit einem solchen Ergebnis, ob nach dem Anlegen, über Verbindung prüfen oder täglich |
| Datenabruf nach Zeitplan | Läuft im Hintergrund. Die Seite des Accounts zeigt weder einen Verlauf noch Ergebnisse der Abrufe. | Nach dem Zeitplan unter Automatischer Abruf, Zeitzone Europe/Berlin |
War JDC bei einer Prüfung nicht erreichbar, ändert i-Planner den Status des Accounts nicht.
Automatischen Abruf einrichten
Ohne Zeitplan startet i-Planner keinen Datenabruf bei JDC. Einen Abruf auf Knopfdruck gibt es nicht. Den Zeitplan stellst du am JDC-Account ein, sobald er angelegt ist.
- Öffne unter Organisation › Accounts den JDC-Account.
- Schalte im Bereich Automatischer Abruf den gleichnamigen Schalter ein.
- Lege Intervall und Einheit fest, je nach Einheit zusätzlich An diesen Tagen, Tag im Monat und Uhrzeit. i-Planner speichert die Werte automatisch.
| Feld | Pflicht | Was eintragen |
|---|---|---|
| Automatischer Abruf | Nein | Schalter: „Ruft die Daten dieses Accounts nach Zeitplan automatisch ab.“ Ausschalten löscht den Zeitplan. |
| Intervall | Nein | Wie viele Einheiten zwischen zwei Abrufen liegen, als Zahl von 1 bis 99. Voreinstellung 1. Zum Beispiel 12 mit Stunde(n) für zweimal täglich. |
| Einheit | Nein | Stunde(n), Tag(e), Woche(n) oder Monat(e). Voreinstellung Tag(e). |
| An diesen Tagen | Nein | Nur bei Woche(n): die Wochentage Mo bis So, mindestens einer. Voreinstellung Mo. |
| Tag im Monat | Nein | Nur bei Monat(e): ein Tag vom 1. bis zum 28., Voreinstellung 1. |
| Uhrzeit | Nein | Nur bei Tag(e), Woche(n) und Monat(e): im 15-Minuten-Raster, Zeitzone Europe/Berlin. Voreinstellung 06:00. |
Der erste Abruf startet nicht beim Einschalten, sondern zum nächsten geplanten Zeitpunkt. Das gilt auch nach jeder Änderung am Zeitplan.
Der Abruf startet nur, solange alle vier Bedingungen erfüllt sind:
- Der Schalter Account aktiv unter Stammdaten ist an.
- Die Verbindung ist erfolgreich geprüft. Neben der Überschrift des Accounts steht dann Verbunden.
- Unter Organisation › Integrationen ist bei JUNG, DMS & CIE Integration aktivieren eingeschaltet.
- Automatischer Abruf ist eingeschaltet.
Fehlt eine davon, pausiert der Abruf, etwa wenn die tägliche Prüfung der Zugangsdaten den Account auf Fehler gesetzt hat. Einen Verlauf der Abrufe oder ihre Ergebnisse zeigt die Seite des Accounts nicht an.
Wie du prüfst, ob der Abruf starten kann, steht unter Fehlerbehebung.
Erledigte Wiedervorlagen an JDC zurückmelden
Ist eine Aktivität in der Kundenverwaltung mit einer Wiedervorlage in JDC verknüpft, musst du die Wiedervorlage bei JDC nicht zusätzlich abschließen. Sobald du die Aktivität auf erledigt setzt, stellt i-Planner die Wiedervorlage bei JDC auf den Status „Erledigt“. Als Ergebnis trägt es „Abschluss“ ein, als Änderungsgrund „Datenpflege“.
Das funktioniert auf zwei Wegen:
- im Fenster der Aktivität über das Feld Status
- in einer Liste von Aktivitäten über die Aktion Status mit der Auswahl Erledigt für die markierten Zeilen und Speichern
Dafür muss alles Folgende zutreffen:
- Unter Organisation › Accounts gibt es einen JDC-Account, dessen Schalter Account aktiv an ist und in dem eine Client-ID steht.
- Die Aktivität ist mit einer Wiedervorlage in JDC verknüpft.
- Die Aktivität ist keine Notiz.
- Es geht ums Erledigen. Setzt du die Aktivität auf einen anderen Status oder später wieder zurück, erfährt JDC davon nichts.
- Du erledigst die Aktivität auf einem der beiden genannten Wege. Andere Wege melden nichts an JDC.
Bleibt eine Wiedervorlage bei JDC offen, steht die Ursache unter Fehlerbehebung.
Häufige Fragen
So oft, wie du es am Account unter Organisation › Accounts im Bereich Automatischer Abruf einstellst. Mit Intervall und Einheit wählst du alle 1 bis 99 Stunden, Tage, Wochen oder Monate. Bei Tagen, Wochen und Monaten kommt eine Uhrzeit im 15-Minuten-Raster dazu, Zeitzone Europe/Berlin. Einen Abruf auf Knopfdruck gibt es in der Oberfläche nicht. Nach dem Einschalten und nach jeder Änderung am Zeitplan startet der erste Abruf erst zum nächsten geplanten Zeitpunkt.
Bei der Verbindungsprüfung und bei der Rückmeldung erledigter Wiedervorlagen nicht. Für die Prüfung gehen nur Client-ID und Client Secret an den Anmeldedienst von JDC. Bei der Rückmeldung gehen außer den Zugangsdaten für die verknüpfte Wiedervorlage nur der Status „Erledigt“, das Ergebnis „Abschluss“ und der Änderungsgrund „Datenpflege“ an JDC.
Der zuletzt angelegte JDC-Account unter Organisation › Accounts, dessen Schalter Account aktiv an ist und in dem eine Client-ID steht. Stimmen seine Zugangsdaten nicht, schlägt die Rückmeldung still fehl.
Weitere Themen
- JUNG, DMS & CIE: die Integration einrichten und den Account anlegen.
- Fehlerbehebung: wenn der Abruf nicht startet oder eine Wiedervorlage offen bleibt.
- Accounts: den Zeitplan und die Verbindungsprüfung eines Accounts im Einzelnen.
- Audit-Log: auffällige Prüfergebnisse im Protokoll Accounts.