Analyse

Das Analysemodul ermöglicht es, alle relevanten Daten eines Einkaufsbelegimports gebündelt zu exportieren und auf einem anderen System wieder zu importieren. Damit können Support-Fälle reproduziert und analysiert werden, ohne direkten Zugriff auf das Kundensystem zu benötigen.

Der Abschnitt Voraussetzung erläutert die notwendige Konfiguration. Der Abschnitt Analyse Export beschreibt den Export von Analysedaten. Der Abschnitt Analyse Import beschreibt den Import von Analysedaten auf einem Zielsystem. Der Abschnitt Typischer Workflow zeigt den empfohlenen Ablauf für die Fehleranalyse.

Voraussetzung

Damit die Analyse-Aktionen auf den Seiten sichtbar und nutzbar sind, muss der Entwickler-Analyse-Modus in der Candis Schnittstelle Einrichtung aktiviert werden.

Aktivieren Sie hierzu das Feld Developer Analysis Mode auf der Einrichtungsseite. Sobald dieses Feld aktiviert ist, werden die Aktionen Export und Import in der Aktionsgruppe Analysis auf den folgenden Seiten angezeigt:

• Candis Einkaufsbelegimport (Kartenansicht)
• Candis Einkaufsbelegimporte (Listenansicht)

Hinweis

Solange der Entwickler-Analyse-Modus nicht aktiviert ist, bleiben die Analyse-Aktionen ausgeblendet.

Analyse Export

Der Analyse Export erstellt eine ZIP-Datei, die alle relevanten Daten eines ausgewählten Einkaufsbelegimports enthält. Diese Datei kann anschließend an den Support übermittelt werden.

Navigation

Öffnen Sie die Seite Candis Einkaufsbelegimporte und wählen Sie den gewünschten Import aus. In der Aktionsleiste finden Sie die Gruppe Analysis mit der Aktion Export.

Alternativ können Sie den Export auch direkt auf der Kartenansicht Candis Einkaufsbelegimport über dieselbe Aktionsgruppe auslösen.

Ablauf

1. Wählen Sie die Aktion Export in der Aktionsgruppe Analysis.
2. Es erscheint ein Hinweis, dass der Export sensible Daten enthalten kann. Bestätigen Sie mit Ja, um fortzufahren.
3. Es wird eine ZIP-Datei erstellt und zum Download angeboten.

Enthaltene Daten

Die exportierte Datei enthält folgende Informationen:

Bereich	Beschreibung
System-Info	Connector-Version, BC-Version, Mandant, Umgebungstyp, Tenant-ID
Export	Alle Felder des Einkaufsbelegimport-Datensatzes
Header	Alle zugehörigen Einkaufsbelegimport-Kopfzeilen
Zeilen	Alle Positionszeilen der zugehörigen Kopfzeilen
Dateien	Alle verknüpften Dateien (Metadaten, keine Dateiinhalte)
HTTP-Protokolle	Alle HTTP-Anfragen und -Antworten zum Import
Prozessfehler	Alle während der Verarbeitung aufgetretenen Fehler
Einrichtung	Die aktuelle Candis Schnittstelle Einrichtung
MwSt.-Buchungsmatrix	Alle MwSt.-Buchungsmatrix-Einträge

Ausgabeformat

Die ZIP-Datei enthält zwei Dateien mit identischem Inhalt in unterschiedlichen Formaten:

• CandisAnalysis_<Lfd.Nr.>_<Datum>.json — maschinenlesbare JSON-Datei
• CandisAnalysis_<Lfd.Nr.>_<Datum>.csv — tabellarische CSV-Datei (Semikolon-getrennt)

Der Dateiname der ZIP-Datei folgt dem Schema CandisAnalysis_<Lfd.Nr.>_<Datum>.zip.

Analyse Import

Der Analyse Import liest eine zuvor exportierte Analysedatei ein und rekonstruiert die enthaltenen Datensätze auf dem lokalen System. So kann ein Support-Fall ohne Zugriff auf das Originalsystem nachgestellt werden.

Navigation

Öffnen Sie die Seite Candis Einkaufsbelegimporte und wählen Sie in der Aktionsgruppe Analysis die Aktion Import.

Voraussetzungen

• Der Developer Analysis Mode muss in der Candis Schnittstelle Einrichtung aktiviert sein.
• Die zu importierende Datei muss im JSON- oder CSV-Format vorliegen und zuvor über den Analyse Export erzeugt worden sein.

Ablauf

1. Wählen Sie die Aktion Import in der Aktionsgruppe Analysis.
2. Wählen Sie die gewünschte Analysedatei (JSON oder CSV) aus.
3. Das Format wird automatisch erkannt und die Daten werden importiert.
4. Nach erfolgreichem Import erscheint eine Bestätigungsmeldung.

Hinweise

• Überschreiben bestehender Daten: Existieren bereits Datensätze mit der gleichen laufenden Nummer, werden diese vollständig durch die importierten Daten ersetzt.
• Platzhalter-Stammdaten: Werden in den importierten Daten Kreditoren oder Sachkonten referenziert, die auf dem Zielsystem nicht existieren, werden automatisch Platzhalter-Datensätze angelegt. Diese dienen ausschließlich der Fehleranalyse.
• Kein produktiver Einsatz: Der Import ist ausschließlich für die Fehleranalyse auf Entwicklungs- oder Testsystemen vorgesehen.

Typischer Workflow

Der empfohlene Ablauf für die Analyse eines Support-Falls ist:

1. Kunde/Partner: Aktiviert den Developer Analysis Mode in der Candis Schnittstelle Einrichtung.
2. Kunde/Partner: Öffnet die Seite Candis Einkaufsbelegimporte, wählt den betroffenen Import und führt den Analyse Export aus.
3. Kunde/Partner: Übermittelt die erzeugte ZIP-Datei an den Support.
4. Support: Aktiviert den Developer Analysis Mode auf dem eigenen Testsystem.
5. Support: Führt den Analyse Import mit der erhaltenen Datei durch.
6. Support: Reproduziert und analysiert das Problem anhand der importierten Daten.