# Archivierung in docuvita einrichten

Diese Seite beschreibt die Einrichtung des Archivierungswegs über docuvita. Sie ist
technischer als der übrige Teil des Handbuchs — die Schritte gehören in die Hände der IT oder
des Systembetreuers.

<p class="callout danger">Benötigt werden Lizenzen für <strong>FINN.ghost</strong>, <strong>docuvita</strong> und den <strong>docuvita.Autoprofiler</strong>. Ohne den Autoprofiler ist dieser Weg nicht möglich.</p>

Wer nur eine einfache Ablage der Rechnung braucht, ist mit *Journal* oder *Archiv* besser
bedient. Siehe [Archivierung](https://wiki.dako-it.com/books/finngmi-handbuch/page/archivierung).

## Voraussetzungen

Auf dem Server, auf dem der **docuvita.Autoprofiler** läuft, muss ein
[MSSQL-ODBC-Treiber](https://learn.microsoft.com/de-de/sql/connect/odbc/download-odbc-driver-for-sql-server)
installiert sein. Für weitergehende Anpassungen kann zusätzlich ein
[PostgreSQL-ODBC-Treiber](https://odbc.postgresql.org/) nötig sein.

## Die Arbeitsschritte im Überblick

1. Importstrecke in den docuvita.Autoprofiler laden und anpassen
2. Ordner für die Ablage anlegen und in FINN.ghost hinterlegen
3. Ordner für die Verknüpfung von docuvita und SelectLine anlegen
4. Importbenutzer in docuvita einrichten
5. Objekttyp-Definitionen in docuvita heraussuchen
6. Skript zur Erstellung des Archiveintrags in der SelectLine einrichten

## 1. Importstrecke laden und anpassen

Die vorbereitete Konfiguration steht als Anhang bereit:
[GMI.cfg](https://wiki.dako-it.com/attachments/61).

Im **docuvita.Autoprofiler** in den Reiter *Autoprofiler* wechseln, unten im Fenster auf den
**Pfeil nach links** klicken, die heruntergeladene Datei auswählen und öffnen. Damit liegt die
Basiskonfiguration im Autoprofiler und muss noch angepasst werden.

### Reiter Eigenschaften

Benutzername und Passwort auf die Werte des Importbenutzers setzen, den Sie in Schritt 4
anlegen.

![Autoprofiler, Reiter Eigenschaften](https://wiki.dako-it.com/uploads/images/gallery/2025-06/1xAgrafik.png)

### Reiter Konfigurationswerte

Hier werden die Werte an Ihre Installation von FINN.ghost, docuvita und SelectLine angepasst.

![Autoprofiler, Reiter Konfigurationswerte](https://wiki.dako-it.com/uploads/images/gallery/2025-06/uEtgrafik.png)

| Schlüssel | Was einzutragen ist |
| ------------------ | ------------------------------------------------------ |
| Belegbezeichnung | der Name des Belegobjekttyps, häufig `BELEG` statt `LIEFERANTENBELEG_DAKOIT` |
| `IMPORTFOLDER` | der **Basispfad** der Ablage — nicht der Unterordner `in` |
| `POSTIMPORTSKRIPT` | der Ablagepfad des Skripts aus Schritt 6 |
| `CSVFOLDER` | der Basispfad aus Schritt 3 |
| `CONNECTIONSL` | der Verbindungsstring zur SelectLine-Datenbank |

<p class="callout warning">Beim <code>IMPORTFOLDER</code> weichen die beiden Seiten bewusst ab: Legt FINN.ghost die Dateien unter <code>D:\dvImport\GetMyInvoices\in</code> ab, lautet der Wert im Autoprofiler <code>D:\dvImport\GetMyInvoices</code> — also ohne <code>in</code>. Der Autoprofiler ergänzt seine Unterordner selbst.</p>

Für beide Verbindungsstrings sind in der Konfiguration Beispiele hinterlegt.

## 2. Ablageordner anlegen und in FINN.ghost hinterlegen

Im Ordner, in dem die Rechnungen abgelegt werden, **müssen** vier Unterordner existieren:

| Unterordner | Zweck |
| ------------- | ---------------------------------- |
| `in` | hier legt FINN.ghost die Dateien ab |
| `error` | fehlgeschlagene Verarbeitungen |
| `log` | Protokolle des Autoprofilers |
| `target` | verarbeitete Dateien |

FINN.ghost schreibt in den Unterordner **`in`**, zum Beispiel `C:\GMI\GMI\in`. Genau dieser
Pfad wird in den Einstellungen von FINN.ghost hinterlegt.

Siehe [Archivierung](https://wiki.dako-it.com/books/finngmi-handbuch/page/archivierung).

<p class="callout danger">Fehlt einer der vier Unterordner, arbeitet der Autoprofiler nicht. Er legt sie nicht selbst an.</p>

## 3. Ordner für die Verknüpfung mit der SelectLine

Das Skript aus Schritt 6 erzeugt CSV-Dateien und braucht denselben Ordneraufbau. Also einen
weiteren Ordner — etwa `C:\GMI\SL` — mit den Unterordnern `in`, `error`, `log` und `target`.

Für das Skript selbst empfiehlt sich eine Ablage daneben, etwa
`C:\GMI\GMI\CreateCSVForSL.cs`.

## 4. Importbenutzer in docuvita einrichten

Um einen Importbenutzer anlegen zu können, brauchen Sie ein Konto, das Mitglied der
Rechtegruppe **Importadmingruppe** ist.

In docuvita anmelden, in den Reiter **Importe** wechseln und auf **Hinzufügen** klicken.

![Importbenutzer in docuvita anlegen](https://wiki.dako-it.com/uploads/images/gallery/2025-06/grafik.png)

Benutzername und Passwort eintragen — diese Daten brauchen Sie in Schritt 1. Alle anderen
Felder können leer bleiben.

<p class="callout info">Über eingetragene E-Mail-Adressen lassen sich Benachrichtigungen im Fehlerfall versenden. Das funktioniert nur, wenn im docuvita-System ein zentrales E-Mail-Konto konfiguriert ist.</p>

## 5. Objekttyp-Definitionen heraussuchen

Als Administrator an docuvita anmelden, in den Reiter **Administration** wechseln und im
Konfigurationsbaum **Objekttypen** auswählen.

![Objekttypen in docuvita](https://wiki.dako-it.com/uploads/images/gallery/2025-06/9fZgrafik.png)

Benötigt werden die Namen von drei Objekttypen — im Beispiel
`LIEFERANTENAKTE_DAKOIT`, `LIEFERANTENORDNER_DAKOIT` und `LIEFERANTENBELEG_DAKOIT`.

<p class="callout warning">Diese Bezeichnungen hängen von Ihrer docuvita-Konfiguration ab und lauten bei Ihnen mit hoher Wahrscheinlichkeit anders. Sie müssen aus dem eigenen System abgelesen werden.</p>

<p class="callout danger">Die Importstrecke geht davon aus, dass das Schlüsselfeld der Lieferantenakten <code>AdressNumber</code> heißt. Ist das nicht der Fall, muss das Import-Template im docuvita.Autoprofiler angepasst werden.</p>

![Import-Template, Schlüsselfeld](https://wiki.dako-it.com/uploads/images/gallery/2025-06/2BJgrafik.png)

![Import-Template, Zuordnung](https://wiki.dako-it.com/uploads/images/gallery/2025-06/rCBgrafik.png)

## 6. Skript für den Archiveintrag in der SelectLine

Das Skript steht als Anhang bereit:
[CreateCSVForSL.cs](https://wiki.dako-it.com/attachments/62).

Darin muss der Ausgabepfad auf den Unterordner `in` des Ordners aus Schritt 3 zeigen. Im
Beispiel `C:\GMI\SL\in`.

<p class="callout info">Zu ändern ist die Zeile mit <code>File.WriteAllText</code>. Sie lautet danach: <code>File.WriteAllText(@"C:\GMI\SL\in\" + Guid.NewGuid() + ".csv", xmlString);</code></p>

## Was FINN.ghost dabei liefert

Zu jeder Rechnung legt FINN.ghost zwei Dateien im Ordner `in` ab: die Rechnung als PDF und
eine Beschreibungsdatei mit Belegart, Belegnummer, Lieferantennummer und -name, Bruttobetrag,
Belegdatum sowie den Sachkonten der Belegpositionen.

<p class="callout warning">Übergeben werden ausschließlich PDF-Dateien. Liegt eine Rechnung im Portal in einem anderen Format vor, wird sie bei diesem Archivierungsweg übersprungen und im Protokoll vermerkt.</p>

## Weiter

[Schlagworte im Portal](https://wiki.dako-it.com/books/finngmi-handbuch/page/schlagworte-im-portal)