Erste Schritte mit TruvioSense
Diese Anleitung beschreibt die Installation und Einrichtung von TruvioSense in einer Business Central-Umgebung.
Vor Beginn müssen folgende Voraussetzungen erfüllt sein:
- Microsoft Dynamics 365 Business Central online, Version 26.2 oder höher
- ExFlow - Erweiterung zur Kreditorenbuchhaltungsautomatisierung installiert
- Administratorzugriff auf Business Central, einschließlich der Berechtigung, Aufgabenwarteschlangeneinträge in allen Unternehmen zu erstellen
- Eine Authentication Email beim Business Central-Benutzer, der das Onboarding durchführt
- Pop-up-Fenster für Business Central im Browser zugelassen
- Mindestens 3–6 Monate historische Rechnungsdaten für beste Ergebnisse
IT-Admin Einrichtungsanleitung
Der erste Abschnitt dieser Anleitung richtet sich an IT-Administratoren, die einen Microsoft Entra-Mandanten für die Truvio Core API-Integration vorbereiten.
Um eine sichere Kommunikation mit dem TruvioSense KI-Dienst zu ermöglichen, muss ein dedizierter Dienstbenutzer erstellt werden.
Bevor sich der Dienstbenutzer vom ERP bei der Core API anmelden kann, muss ein IT-Administrator:
- Sicherstellen, dass ein dedizierter Dienstbenutzer in Microsoft Entra ID existiert, der zur Authentifizierung vom ERP verwendet wird.
- Mandantenweite Administratoreinwilligung für die Truvio Entra-Anwendung erteilen.
- Die App-Rolle Truvio.SubscriptionService dem Dienstbenutzer zuweisen.
Sobald diese Voraussetzungen erfüllt sind, kann das Dienstkonto verwendet werden, um sich vom ERP aus bei der Core API anzumelden.
Voraussetzungen
- Ein Konto mit der Berechtigung, mandantenweite Administratoreinwilligung für Anwendungen in Microsoft Entra zu erteilen (typischerweise ein Globaler Administrator oder Administrator für privilegierte Rollen).
- Zugriff auf das Azure-Portal mit Rechten zur Verwaltung von Unternehmensanwendungen im Mandanten.
- Ein Dienstbenutzer in Microsoft Entra ID verfügbar (falls noch nicht vorhanden, einen erstellen).
Diese Anleitung beschreibt die Schritte, die ein Microsoft Entra-Administrator abschließen muss, bevor sich ein Benutzer vom ERP bei der Truvio Core API anmelden kann.
Schritt 1: Dienstbenutzer in Entra vorbereiten
Erstellen (oder identifizieren) Sie einen dedizierten Dienstbenutzer in Microsoft Entra ID, der zur Authentifizierung vom ERP bei der Core API verwendet wird.
Der Dienstbenutzer sollte ein Standard-Mitgliedskonto im Mandanten sein. Behandeln Sie die Zugangsdaten als gemeinsame Dienstidentität und speichern Sie sie sicher.
Schritt 2: Administratoreinwilligung für die Truvio Entra-Anwendung erteilen
Öffnen Sie als Mandantenadministrator den unten stehenden Einwilligungslink in einem Browser und melden Sie sich mit einem Konto an, das die Berechtigung hat, mandantenweite Einwilligung zu erteilen.
Überprüfen Sie die angeforderten Berechtigungen und klicken Sie auf Accept, um die mandantenweite Einwilligung zu erteilen.
Nach Erteilung der Einwilligung erscheint die Truvio-Anwendung im Mandanten unter Microsoft Entra ID -> Enterprise applications.
Schritt 3: Die App-Rolle Truvio.SubscriptionService dem Dienstbenutzer zuweisen
- Melden Sie sich im Azure-Portal an.
- Navigieren Sie zu Microsoft Entra ID -> Enterprise applications.
- Suchen und öffnen Sie die Truvio-Anwendung, für die in Schritt 2 die Einwilligung erteilt wurde.
- Gehen Sie zu Users and groups -> Add user/group.
- Wählen Sie unter Users den in Schritt 1 erstellten Dienstbenutzer aus.
- Wählen Sie unter Select a role die Rolle Truvio.SubscriptionService.
- Klicken Sie auf Assign.
Nur Prinzipale, denen die App-Rolle Truvio.SubscriptionService zugewiesen wurde, können sich bei der Core API authentifizieren.
Schritt 4: TruvioSense in Business Central einrichten
Alle Schritte außerhalb des ERP-Systems sind nun abgeschlossen. Die weiteren Schritte erfolgen in Business Central.
Die Einrichtungsseite heißt TruvioSense - Coding & Approvals Setup. Öffnen Sie sie über die Suche nach dem Seitennamen oder über ExFlow Setup --> TruvioSense - Coding & Approvals --> TruvioSense setup.
Die Einrichtungsseite steuert TruvioSense für alle Unternehmen der Datenbank an einer Stelle. Die Unternehmensliste zeigt alle Unternehmen. Wenn ein Unternehmen in der Liste ausgewählt wird, zeigen die Abschnitte Companies und Vendors die Einstellungen für dieses Unternehmen. Die Seite öffnet sich mit dem aktuellen Unternehmen ausgewählt, und das aktuelle Unternehmen wird fett angezeigt. Auf dieser Seite können keine Unternehmen hinzugefügt oder gelöscht werden.
Die Seite hat drei Abschnitte:
- Companies (oben) — die Aufgabenwarteschlangenkategorie für das ausgewählte Unternehmen sowie die Statusfelder Job handler scheduled und Continuous export enabled
- Unternehmensliste — alle Unternehmen der Datenbank mit Company identifier und Enabled. Das aktuelle Unternehmen wird fett angezeigt
- Vendors (unten) — die Kreditoren des in der Liste ausgewählten Unternehmens
Abschnitt Companies
| Feld | Beschreibung |
|---|---|
| Job queue category | Die Aufgabenwarteschlangenkategorie, die für die TruvioSense-Aufträge im ausgewählten Unternehmen verwendet wird. Die Kategorie muss in diesem Unternehmen vorhanden sein. Eine Kategorie ist erforderlich, bevor der Auftragshandler geplant werden kann |
| Job handler scheduled | Yes, wenn der TruvioSense-Auftragshandler in der Aufgabenwarteschlange vorhanden ist. Der Auftragshandler wird von allen Unternehmen gemeinsam genutzt. Schreibgeschützt |
| Continuous export enabled | Yes, wenn der TruvioSense-Dienst verfügbar ist, sodass Dokumente direkt nach ihrer Erstellung exportiert werden. ExFlow kann diese Funktion vorübergehend ausschalten, wenn der Dienst nicht antwortet. Schreibgeschützt |
Unternehmensliste
| Feld | Beschreibung |
|---|---|
| Name | Der Name des Unternehmens. Schreibgeschützt |
| Company identifier | Der Name des Unternehmens, wie er an den TruvioSense-Dienst gesendet wird, in einem URL-sicheren Format. Schreibgeschützt |
| Enabled | Aktiviert TruvioSense für das Unternehmen. Dokumente werden nur für aktivierte Unternehmen exportiert. Ein Unternehmen kann erst aktiviert werden, wenn das Datenupgrade ausgeführt wurde |
Abschnitt Vendors
| Feld | Beschreibung |
|---|---|
| Vendor No. | Die Kreditorennummer |
| Name | Der Kreditorenname |
| Enabled | Aktiviert TruvioSense für den Kreditor. Dokumente des Kreditors werden exportiert und zur Vorhersage der Kontierung im ExFlow Importbuchblatt verwendet |
| Status | Der neueste Status des Kreditors vom TruvioSense-Dienst. Damit lassen sich Kreditoren mit Problemen finden |
| Document images sent | Die Anzahl der für den Kreditor gesendeten Dokumentbilder. Per Drilldown öffnet sich TruvioSense Documents, gefiltert auf die gesendeten Dokumente des Kreditors |
Der Abschnitt Vendors enthält außerdem die Aktionen Enable all vendors und Disable all vendors, mit denen alle Kreditoren im ausgewählten Unternehmen auf einmal geändert werden.
Erweiterung installieren
- Öffnen Sie Business Central
- Suchen Sie nach Extension Management
- Installieren Sie TruvioSense - Coding & Approvals von SignUp Software AB
- Warten Sie, bis die Installation abgeschlossen ist
- Starten Sie die Sitzung bei Aufforderung neu
Datenupgrade ausführen
- Öffnen Sie TruvioSense - Coding & Approvals Setup
- Wählen Sie Related --> Run data upgrade
Das Datenupgrade wird für alle Unternehmen der Datenbank ausgeführt. Es bereitet die vorhandenen ExFlow-Dokumentverweise vor, erstellt das Standard-Prediction mapping und legt den Startpunkt für den initialen Export pro Kreditor fest. Solange das Datenupgrade nicht ausgeführt wurde, kann kein Unternehmen aktiviert werden und View predictions bleibt nicht verfügbar.
Onboarding
Das Onboarding verbindet die Business Central-Umgebung mit dem TruvioSense-Dienst. Verwenden Sie den in den Schritten 1–3 vorbereiteten Dienstbenutzer.
- Wählen Sie in TruvioSense - Coding & Approvals Setup die Aktion Onboarding --> Onboard
- Welcome — wählen Sie Next
- Login — ein separates Fenster öffnet sich. Melden Sie sich mit dem Dienstbenutzer an, schließen Sie die Schritte in diesem Fenster ab und kehren Sie dann zur Onboarding-Seite zurück. Wenn sich das Fenster nicht öffnet, lassen Sie Pop-ups für die Website zu und versuchen Sie es erneut. Dieser Schritt wird übersprungen, wenn die Umgebung bereits angemeldet ist
- Register — überprüfen Sie die Angaben, die die Umgebung gegenüber TruvioSense identifizieren:
- URL — die URL der Business Central-Umgebung
- ERP System Name — BC
- Onboarding Usage — External oder Internal, übernommen aus ExFlow Global Setup
- Environment Type — der Typ der Umgebung, zum Beispiel Produktion oder Sandbox
- Region — die Azure-Region, in der TruvioSense die Daten verarbeitet und speichert. Dies ist das einzige Feld, das geändert werden kann. Leer lassen, um die Standardregion zu verwenden
- Tenant ID — die Mandanten-ID der Umgebung
- Subscription Service Name und Authentication Email — das Abonnement, für das die Umgebung registriert ist, und die E-Mail-Adresse des angemeldeten Business Central-Benutzers
- URL — die URL der Business Central-Umgebung
- Wählen Sie Next und bestätigen Sie die Registrierung
- Finish — wählen Sie Finish, um den Assistenten zu schließen
Das Feld Authentication Email beim Business Central-Benutzer muss einen Wert enthalten, andernfalls bricht die Registrierung mit einem Fehler ab.
Onboarding Usage wird in ExFlow Global Setup in der Gruppe TruvioSense festgelegt. Der Standardwert ist External. Nach einem abgeschlossenen Onboarding sollte der Wert nicht mehr geändert werden.
Onboarding-Status prüfen
Wählen Sie Onboarding --> Onboarding status, um die Verbindung zum TruvioSense-Dienst anzuzeigen:
| Feld | Bedeutung |
|---|---|
| Core Client Id | Die ID, die die Umgebung gegenüber dem Core-Dienst identifiziert |
| Service Configuration | Yes, wenn die Dienstkonfiguration gelesen wurde |
| Core Service Login | Yes, wenn die Umgebung beim Core-Dienst angemeldet ist |
| Core Service Subscription State | Der Abonnementstatus der Umgebung |
| Service URL | Die Adresse des TruvioSense-Dienstes, basierend auf der beim Onboarding gewählten Region und Umgebung |
| KeyVault Source | Die Quelle der Key-Vault-Konfiguration |
Verwenden Sie Login to core services, um sich erneut anzumelden, und Logout of core services, um sich abzumelden. Solange die Umgebung abgemeldet ist, funktionieren keine TruvioSense-Funktionen.
Unternehmen aktivieren
- Öffnen Sie TruvioSense - Coding & Approvals Setup
- Für jedes zu aktivierende Unternehmen:
- Wählen Sie das Unternehmen in der Liste aus
- Wählen Sie im Abschnitt Companies eine Job queue category
- Setzen Sie Enabled auf Yes
- Wählen Sie das Unternehmen in der Liste aus
Beginnen Sie mit einem Unternehmen, um zu überprüfen, ob alles funktioniert, bevor Sie weitere Unternehmen aktivieren.
Kreditoren aktivieren
TruvioSense arbeitet pro Kreditor. Wählen Sie bei in der Liste ausgewähltem Unternehmen im Abschnitt Vendors die zu aktivierenden Kreditoren aus:
- Setzen Sie Enabled pro Kreditor, oder
- Verwenden Sie Enable all vendors oder Disable all vendors, um alle Kreditoren des Unternehmens auf einmal zu ändern
Gute Kandidaten:
- Kreditoren mit 20+ historischen Rechnungen
- Regelmäßige, wiederkehrende Rechnungsmuster
- Konsistente Kontierung
Schlechte Kandidaten:
- Einmalige Kreditoren
- Kreditoren mit stark variierenden Rechnungstypen
- Neue Kreditoren ohne Historie
Auftragshandler planen
Der Auftragshandler führt die Hintergrundverarbeitung aus: Er startet den Dokumentexport und die Aktualisierung der Kreditoreninformationen.
- Öffnen Sie TruvioSense - Coding & Approvals Setup
- Wählen Sie Schedule job handler und bestätigen Sie
Bevor der Auftragshandler geplant werden kann, muss für das aktuelle Unternehmen eine Job queue category ausgewählt sein. Job handler scheduled zeigt dann Yes. Der Auftragshandler wird von allen Unternehmen gemeinsam genutzt und muss daher nur einmal geplant werden.
Der Aufgabenwarteschlangeneintrag läuft alle 60 Minuten, Montag bis Freitag, zwischen 06:00 und 18:00 Uhr. Seine Beschreibung lautet Handles scheduling of TruvioSense related jobs.
Hintergrundaufträge
TruvioSense verwendet drei Aufgabenwarteschlangenaufträge. Nur der Auftragshandler wird manuell geplant. Der Auftragshandler erstellt die beiden anderen Aufträge bei jeder Ausführung, sodass nur der Eintrag des Auftragshandlers dauerhaft in Job Queue Entries bleibt. Der Exportauftrag und der Auftrag für Kreditoreninformationen haben dieselbe Beschreibung. Sie lassen sich über Object ID to Run unterscheiden.
Die Aufträge werden einmal pro Datenbank eingerichtet, nicht einmal pro Unternehmen:
- Schedule job handler prüft die Aufgabenwarteschlange in allen Unternehmen. Wenn in einem Unternehmen bereits ein Auftragshandler vorhanden ist, wird kein neuer erstellt
- Die Aufgabenwarteschlangeneinträge werden in dem Unternehmen erstellt, in dem Schedule job handler ausgeführt wird, mit der Job queue category dieses Unternehmens
- Jede Ausführung des Exportauftrags und des Auftrags für Kreditoreninformationen umfasst alle Unternehmen, bei denen Enabled auf Yes steht. Nicht aktivierte Unternehmen werden übersprungen
- Für die Planung des Auftragshandlers ist die Berechtigung erforderlich, Aufgabenwarteschlangeneinträge in allen Unternehmen zu lesen
Um die Aufgabenwarteschlangeneinträge zu finden, öffnen Sie Job Queue Entries in dem Unternehmen, in dem der Auftragshandler geplant wurde.
| Codeunit | Name | Beschreibung in der Aufgabenwarteschlange | Ausführungszeitpunkt | Funktionsweise |
|---|---|---|---|---|
| 12069082 | ExMLJobHandler | Handles scheduling of TruvioSense related jobs. | Wiederkehrend: alle 60 Minuten, Montag bis Freitag, 06:00–18:00 Uhr. Wird einmalig mit Schedule job handler erstellt | Plant die beiden anderen Aufträge. Bei jeder Ausführung prüft er in allen Unternehmen, ob ein aktiver Exportauftrag und ein aktiver Auftrag für Kreditoreninformationen vorhanden sind (Status Ready, Waiting oder In Process). Ist ein Auftrag nicht aktiv, erstellt er dafür einen neuen Aufgabenwarteschlangeneintrag im aktuellen Unternehmen. Der Eintrag startet sofort, läuft einmal und verwendet die Job queue category des Unternehmens. Ein bereits aktiver Auftrag wird nicht erneut gestartet. Hat der Eintrag des Auftragshandlers im aktuellen Unternehmen den Status Error oder On Hold, wird er beim Öffnen der Einrichtungsseite neu gestartet |
| 12069080 | ExMLExport | ExFlow machine learning automation service | Einmal pro Ausführung des Auftragshandlers. Kann auch mit Run document export gestartet werden | Exportiert gebuchte Rechnungen für alle aktivierten Unternehmen, die neuesten zuerst. Gutschriften werden nicht exportiert. Überspringt Dokumente von nicht aktivierten Kreditoren sowie Dokumente, die älter als der Export-Startpunkt des Kreditors sind. Für jedes Dokument wird zuerst die PDF-Datei gesendet (Document image sent = Yes), dann das gebuchte Dokument mit seiner Kontierung (Posted document sent = Yes). Schlägt ein Schritt fehl, wird der Grund in Error message gespeichert und das Dokument bei der nächsten Ausführung erneut versucht. Stoppt für ein Unternehmen, in dem das Datenupgrade nicht ausgeführt wurde |
| 12069104 | ExMLVendorInsights | ExFlow machine learning automation service | Einmal pro Ausführung des Auftragshandlers. Kann auch mit Update vendor insights gestartet werden | Aktualisiert den Kreditoren-Status für alle aktivierten Unternehmen. Für jeden Kreditor wird Status geleert. Für aktivierte Kreditoren wird anschließend der neueste Status vom TruvioSense-Dienst abgerufen. Hat der Dienst noch keine Daten für den Kreditor, bleibt Status leer. Stoppt für ein Unternehmen, in dem das Datenupgrade nicht ausgeführt wurde |
Einstellungen der Aufgabenwarteschlangeneinträge
Die Tabelle zeigt, wie jeder Auftrag in Job Queue Entries eingerichtet ist. ExFlow füllt diese Werte automatisch aus. Verwenden Sie Schedule job handler, um den Auftragshandler zu erstellen, anstatt den Eintrag manuell anzulegen.
| Feld | Auftragshandler | Dokumentexport | Kreditoreninformationen |
|---|---|---|---|
| Object Type to Run | Codeunit | Codeunit | Codeunit |
| Object ID to Run | 12069082 | 12069080 | 12069104 |
| Object Caption to Run | ExMLJobHandler | ExMLExport | ExMLVendorInsights |
| Description | Handles scheduling of TruvioSense related jobs. | ExFlow machine learning automation service | ExFlow machine learning automation service |
| Job Queue Category Code | Die Job queue category des Unternehmens, in dem der Auftragshandler geplant ist | Wie beim Auftragshandler | Wie beim Auftragshandler |
| Recurring Job | Yes | No | No |
| No. of Minutes between Runs | 60 | – | – |
| Run on | Montag bis Freitag | – | – |
| Starting Time / Ending Time | 06:00 / 18:00 | – | – |
| Maximum No. of Attempts to Run | 1 | 1 | 1 |
| Earliest Start Date/Time | Der Zeitpunkt, zu dem Schedule job handler gewählt wird | Der Zeitpunkt, zu dem der Auftragshandler den Eintrag erstellt | Der Zeitpunkt, zu dem der Auftragshandler den Eintrag erstellt |
| Status bei Erstellung | Ready | Ready | Ready |
| Erstellt durch | Schedule job handler auf der Einrichtungsseite | Den Auftragshandler, bei jeder Ausführung | Den Auftragshandler, bei jeder Ausführung |
| Verwendet für | Starten der beiden anderen Aufträge | Senden von PDF-Dateien und gebuchten Rechnungen an TruvioSense, damit der Dienst das Vorhersagemodell pro Kreditor aufbauen kann | Aktualisieren des Kreditoren-Status im Abschnitt Vendors der Einrichtungsseite |
| Manuell starten | – | Related --> Run document export auf der Einrichtungsseite | Related --> Update vendor insights auf der Einrichtungsseite |
Ein manueller Start führt den Auftrag sofort in der aktuellen Sitzung aus, nicht über die Aufgabenwarteschlange. Der Auftrag umfasst trotzdem alle aktivierten Unternehmen.
Die PDF-Dateien von Dokumenten im ExFlow Importbuchblatt werden nicht von diesen Aufträgen gesendet. Sie werden durch den kontinuierlichen Export gesendet, wenn das Buchblattdokument aktualisiert wird, sofern Continuous export enabled Yes anzeigt.
Auf initialen Datenexport warten
Nach der Aktivierung von Kreditoren exportiert das System historische gebuchte Rechnungen im Hintergrund über die Aufgabenwarteschlange.
- Der Auftragshandler startet den Export bei jeder Ausführung
- Gebuchte Rechnungen von aktivierten Kreditoren in aktivierten Unternehmen werden zusammen mit der PDF-Datei jeder Rechnung an den ML-Dienst gesendet
- Überwachen Sie den Fortschritt auf der Seite TruvioSense Documents
Der initiale Export sendet die neuesten gebuchten Rechnungen pro Kreditor, bis zu einer vom TruvioSense-Dienst festgelegten Grenze. Rechnungen ohne PDF-Anhang werden nicht exportiert. Der initiale Export kann je nach Datenvolumen mehrere Stunden dauern. Es ist keine Benutzeraktion erforderlich.
Um einen Export sofort zu starten, wählen Sie Related --> Run document export.
Einrichtung überprüfen
Bestätigen Sie nach einigen Stunden, dass das System funktioniert:
| Prüfpunkt | Vorgehensweise |
|---|---|
| Dokumente exportiert | Öffnen Sie TruvioSense Documents — überprüfen Sie, dass Document image sent und Posted document sent = Yes sind und Error message leer ist |
| Kreditorenstatus | Im Abschnitt Vendors der Einrichtungsseite steigt Document images sent im Laufe der Zeit, und Status zeigt den neuesten Status vom Dienst |
| Aufgabenwarteschlange läuft | Suchen Sie Job Queue Entries — der Eintrag des TruvioSense-Auftragshandlers sollte den Status Ready anzeigen |
| Vorhersagen verfügbar | Verarbeiten Sie eine neue Rechnung im ExFlow Importbuchblatt und wählen Sie TruvioSense --> View predictions (24–48 Stunden nach dem ersten Export abwarten) |
Weitere Aktionen auf der Einrichtungsseite
| Aktion | Beschreibung |
|---|---|
| Documents | Öffnet TruvioSense Documents |
| Prediction mapping | Öffnet die Zuordnung von Vorhersagefeldern zu Buchblattfeldern. Siehe Vorhersagen verwenden |
| Run document export | Führt den Export für alle aktivierten Unternehmen und Kreditoren sofort aus |
| Update vendor insights | Ruft den neuesten Kreditoren-Status sofort vom Dienst ab |
| Reset data | Markiert alle Dokumente als nicht gesendet und setzt den Export-Startpunkt für alle Kreditoren zurück, sodass alle Dokumente erneut exportiert werden. Dies kann nicht rückgängig gemacht werden |