Einrichtung DATEV Beleganzeige Drittanbieter

"DATEV Beleganzeige Drittanbieter" ist erforderlich, um den Beleglink in DATEV Rechnungswesen zu aktivieren. Dieser ist pro Buchungszeile ersichtlich und soll auf die in ELO liegende Rechnung verweisen.

Ziel: Klick in Rechnungswesen auf den Link in der Buchungszeile -> in ELO öffnet sich automatisch die entsprechend Rechnung im Archiv.

To do: Hierfür müssen zwei Komponenten installiert, eingerichtet und anschließend miteinander verknüpft werden:

Mindestanforderungen

• Installation .NET 4.8

1. Installation DATEV Beleganzeige Drittanbieter

1. Öffnen Sie hierzu zunächst den DATEV Installationsmanagerund wählen "<Alle Produkte>" als Filter aus:

Wählen Sie dann über die Spalte „Produkt“ den Eintrag „DATEV Beleganzeige Drittanbieter“ aus. „DATEV Beleganzeige Drittanbieter“ steht Ihnen in der Regel spätestens nach drei Werktagen nach der Bestellung zum Download bereit.

2. Wählen Sie das Produkt mit Rechtsklick aus und wählen den Punkt „installieren“. Es öffnet sich ein Hinweisfenster zur Installation einzelner Komponenten. Bestätigen Sie diesen bitte mit dem Button „Ignorieren“.

3. Es öffnet sich das Installationsfenster des Produkts „DATEV Beleganzeige Drittanbieter“. Über die Auswahl des Buttons „Installieren“ wird die Installation gestartet.

Wichtig: Die Installation muss an jedem Terminal-Server / Client (bei Client-Server-Struktur) mit DATEV Rechnungswesen erfolgen. Nur so können die Belege über ELO angezeigt werden.

2. Installation DocumentLinkConnector

Die DocumentLinkConnector-ZIP haben Sie von uns per E-Mail erhalten.

1. Entpacken Sie das in unserer Einrichtungsmail mitgelieferte ZIP-Archiv an eine beliebige Stelle, in diesem Beispiel in C:\DocumentLinkConnector. Falls ein anderer Pfad genutzt wird, gilt diese Änderung auch für die weiteren Schritte dieser Anleitung. Der entpackte Ordner enthält drei wichtige Dateien:

• exe
  Die eigentliche Applikation des "DocumentLinkConnector". Der Pfad zur exe-Datei muss im "DATEV Beleganzeige Drittanbieter" hinterlegt werden, damit die Applikation bei Klick auf dem Beleglink aufgerufen wird.
• exe.config
  Konfigurationsdatei für die Applikation. In dieser Konfiguration kann eingestellt werden, ob der ELO Java Client oder der ELO Web Client verwendet werden soll.
• Configuration.dll
  Die System-Bibliothek, welche für den Betrieb benötigt wird. Die Datei sollte neben der DocumentLinkConnector.exe liegen.

2. Öffnen sie die DocumentLinkConnector.exe.config in einem Textbearbeitungsprogramm (z.B. Editor/Notepad).

Achtung: Wenn Ihnen keine Dateiendungen angezeigt werden, kann die Konfigurationsdatei wie eine exe Datei aussehen.

Pro Installation können Sie sich entweder für den WebClient oder für den JavaClient entscheiden. Ein Parallelbetrieb ist nicht vorgesehen. In der Regel wird der JavaClient dafür genutzt.

3. Die Konfigurationen (DocumentLinkConnector.exe.config) erfolgen über XML-Elemente. Unten sehen Sie die verschiedenen Konfigurationen, ersetzen Sie den Inhalt der DocumentLinkConnector.exe.config durch einen der folgenden Einträge:

Alte DocumentLinkExtractor Version:

JavaClient

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
 <startup> 
   <supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.8" />
 </startup>
 <appSettings>
    <!-- configuration for JavaClient -->
    <add key="targetEloClient" value="JavaClient" />
 </appSettings>
</configuration>

WebClient ab ELO12

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
  <startup> 
    <supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.8" />
  </startup>
  <appSettings>
    <!-- configuration for WebClient >= 12 --> 
    <add key="targetEloClient" value="WebClient" />
    <add key="webClientUrl" value="https://server:9090/ix-elo/plugin/de.elo.ix.plugin.proxy/web/#/archive/{{guid}}" />
 
  </appSettings>
</configuration>

WebClient ELO 10,11

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
  <startup> 
    <supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.8" />
  </startup>
  <appSettings>
    <!-- configuration for WebClient ELO 10, 11 -->
    <add key="targetEloClient" value="WebClient" />
    <add key="webClientUrl" value="https://server:9090/web-elo/#/archive/{{guid}}" />
 
  </appSettings>
</configuration>

Neue DocumentLinkExtractor Version:

Alle relevanten Information sind von ELO dokumentiert in:

Document Link Connector Einrichtung

Dort einfach der Einrichtung folgen.

3. Verbindung DATEV Beleganzeige Drittanbieter und DocumentLinkConnector

 Anschließend muss der "DATEV Beleganzeige Drittanbieter" mit dem "DocumentLinkConnector" verknüpft werden.

1. Wechseln Sie zum folgenden Ordner: "C:\Program Files (x86)\DATEV\PROGRAMM\R0000075" (dieser ist erst nach der Installation von "DATEV Beleganzeige Drittanbieter" ersichtlich).

2. Ändern Sie die dort befindliche Custom.ini Datei, indem Sie den Inhalt durch folgenden Eintrag ersetzen:

[ELO1]
COMMAND="C:\DocumentLinkConnector\DocumentLinkConnector.exe" %1

-> abhängig davon, wo Sie die DocumentLinkConnector.exe gespeichert haben.

Für die DDMS Migration muss folgender Eintrag hinzugefügt werden:

[DDMS]
COMMAND="C:\DocumentLinkConnectorDDMS\DocumentLinkConnector.exe" guid=(%1)

-> abhängig davon, wo Sie die DocumentLinkConnector.exe gespeichert haben.

Wichtig: Der Teil in den [eckigen Klammern] MUSS wie oben ersichtlich durch ELO1 ersetzt werden!

Hinweis: Wenn Sie der offiziellen ELO Anleitung Document Link Connector Einrichtung folgen, müssen keine zwei verschiedenen Versionen vom Document Link Connector installiert werden. Beide Pfade können auf die gleiche .exe zeigen.

3. Optional: Falls die Custom.ini nicht vorhanden sein sollte, führen sie die FremdconnectorInst.exe aus und geben den Pfad der DocumentLinkConnector.exe an:

Die .ini muss danach aber dennoch bearbeitet werden.

4. Zusätzliche Notizen

1. Migration von DMS Classic:

Bei der Migration von DMS Classic muss DATEV Rewe explizit gesagt werden, dass DMS Classic nicht mehr zur Verfügung steht, da DATEV dort sonst einen direkten Weg benutzt. Das wird über eine Signaldatei gesteuert. Diese wird im Normalfall automatisch durch den Export aus DMS Classic gesetzt. Wenn Fehler auftreten, die so wirken, als ob nicht die Custom.ini befragt werden würde, dann lohnt es sich, das einmal zu überprüfen.
Details dazu sind hier unter Punkt 4 zu finden: Datev Helpcenter Beleglink

Konkret handelt es sich dabei um die Datei dmsclassic.deactivated die in dem Pfad

\\SERVERNAME>\WINDVSW1\DATEV\DATEN\K0005100\DATA

vorhanden sein muss.

Weiterhin muss auch die Datei elo.activated im selben Pfad vorhanden sein.

Die Konfig kann auch in der von ELO bereitgestellten Document Link Connector Einrichtung Anleitung nachgeschaut werden, aber hier zusätzlich eine Beschreibung:

Diese Konfig sollte bei einer DATEV DMS classic Migration verwendet werden:

Ganz wichtig: Das Passwort muss Base64 encoded sein.

<?xml version="1.0" encoding="utf-8"?>

<configuration>
    <startup>
        <supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.8" />
    </startup>

    <appSettings>
        <add key="indexServerUrl" value="https://<SERVERNAME>/ix-elo/ix" />
        <add key="indexServerUser" value="<USERNAME>" />
        <add key="indexServerPassword" value="<XXX>" />
        <add key="searchKey" value="DATEV_GUID" />

        //Wenn Web Client
        <add key="targetEloClient" value="WebClient" />
        <add key="webClientUrl" value="https://<SERVERNAME>/web-elo/#/archive/{{guid}}" />

        //Wenn Java Client
        <add key="targetEloClient" value="JavaClient" />
    </appSettings>

    <system.web>
        <membership defaultProvider="ClientAuthenticationMembershipProvider">
            <providers>
                <add name="ClientAuthenticationMembershipProvider" type="System.Web.ClientServices.Providers.ClientFormsAuthenticationMembershipProvider, System.Web.Extensions, Version=4.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35" serviceUri="" />
            </providers>
        </membership>
        <roleManager defaultProvider="ClientRoleProvider" enabled="true">
            <providers>
                <add name="ClientRoleProvider" type="System.Web.ClientServices.Providers.ClientRoleProvider, System.Web.Extensions, Version=4.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35" serviceUri="" cacheTimeout="86400" />
            </providers>
        </roleManager>
    </system.web>
</configuration>

Tragen Sie unter "USERNAME" den Benutzer "DocumentLinkConnector-READ_ONLY" ein, welcher aus Datensicherheitsgründen im System lediglich mich Leserechten versehen wird.