# 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 {#kurz-erklaert}

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](/organisation/integrationen/pool/jung-dms-und-cie/abruf-und-wiedervorlagen#daten-fliessen).
- i-Planner soll regelmäßig Daten von JDC abrufen: [Automatischen Abruf einrichten](/organisation/integrationen/pool/jung-dms-und-cie/abruf-und-wiedervorlagen#automatischen-abruf-einrichten).
- Erledigte Aktivitäten sollen bei JDC als erledigt ankommen: [Erledigte Wiedervorlagen an JDC zurückmelden](/organisation/integrationen/pool/jung-dms-und-cie/abruf-und-wiedervorlagen#erledigte-wiedervorlagen-jdc-zurueckmelden).

Was du dafür brauchst, steht unter [JUNG, DMS & CIE › Voraussetzungen](/organisation/integrationen/pool/jung-dms-und-cie/uebersicht#voraussetzungen).

## Welche Daten fließen {#daten-fliessen}

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 {#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.

1. Öffne unter **Organisation › Accounts** den JDC-Account.
2. Schalte im Bereich **Automatischer Abruf** den gleichnamigen Schalter ein.
3. 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](/organisation/integrationen/pool/jung-dms-und-cie/fehlerbehebung#abruf-status-unklar).

## Erledigte Wiedervorlagen an JDC zurückmelden {#erledigte-wiedervorlagen-jdc-zurueckmelden}

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.

::callout
---
color: amber
icon: i-heroicons-exclamation-triangle
---
Die Rückmeldung läuft still. Schlägt sie fehl, zeigt i-Planner das nicht an und versucht es auch nicht erneut. Die Aktivität bleibt in i-Planner trotzdem erledigt. Siehst du bei JDC eine Wiedervorlage noch offen, schließe sie dort selbst ab.
::

Bleibt eine Wiedervorlage bei JDC offen, steht die Ursache unter [Fehlerbehebung](/organisation/integrationen/pool/jung-dms-und-cie/fehlerbehebung#wiedervorlage-noch-offen).

## Häufige Fragen {#haeufige-fragen}

::faq
  :::faq-item{question="Wie oft ruft i-Planner Daten von JDC ab — und kann ich den Abruf sofort starten?"}
  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.
  :::

  :::faq-item{question="Schickt i-Planner meine Kunden- oder Vertragsdaten an JDC?"}
  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.
  :::

  :::faq-item{question="Wir haben mehrere JDC-Accounts — welcher meldet erledigte Wiedervorlagen zurück?"}
  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 {#weitere-themen}

- [JUNG, DMS & CIE](/organisation/integrationen/pool/jung-dms-und-cie/uebersicht): die Integration einrichten und den Account anlegen.
- [Fehlerbehebung](/organisation/integrationen/pool/jung-dms-und-cie/fehlerbehebung): wenn der Abruf nicht startet oder eine Wiedervorlage offen bleibt.
- [Accounts](/organisation/accounts/uebersicht): den Zeitplan und die Verbindungsprüfung eines Accounts im Einzelnen.
- [Audit-Log](/organisation/audit-log): auffällige Prüfergebnisse im Protokoll **Accounts**.