etagis Interface

Allgemein

Das Modul "etagis-Interface" ermöglicht eine direkte Verbindung zwischen dem Leitstand etagis APS und KUMAVISION factory365 über eine API-Schnittstelle. Neben der klassischen Integration von Verkaufs- und Fertigungsaufträgen erweitert das Modul "etagis Interface" die Funktionalität um die Einbindung von Projektplanung und -überwachung. Dadurch werden sämtliche Prozesse aus Fertigung und Projektmanagement in einer zentralen Lösung zusammengeführt, was zu erhöhter Transparenz und Effizienz beiträgt.

Note

Hinweis Die Planung und Steuerung von Montageaufträgen ist in etagis APS nicht vorgesehen.

Warning

Achtung Der im AppSource von etagis bereitgestellte "etagis Connector" ist nicht mit KUMAVISION factory365 kompatibel und bietet nicht den Funktionsumfang des Moduls "etagis Interface".

Lizenzierung

Da über das Modul "etagis-Interface" Daten aus Microsoft Dynamics 365 Business Central in einem Fremdsystem verarbeitet, verändert und zurückgeschrieben werden (bidirektional), muss jeder etagis APS-User eine entsprechende Microsoft Dynamics 365 Business Central-Lizenz besitzen.

Im Sinne der Microsoft Lizenzbedingungen handelt es sich hierbei um Multiplexing. Für den etagis-Planer und etagis-Teamleiter werden Premium-User benötigt. Für den etagis-User (der nur lesenden Zugriff hat) ist eine Teammember-Lizenz ausreichend.

Note

Hinweis etagis Interface ist ein Freischaltmodul, dessen Nutzung nur mit zusätzlicher Lizenzierung und Aktivierung möglich ist.

Einrichtung

Im Nachfolgenden sind nur die wesentlichen Einrichtungen für die Schnittstelle innerhalb von KUMAVISION factory365 beschrieben.

Note

Hinweis Eine separate Anleitung zur Einrichtung und Installation von etagis Interface und etagis APS ist für Projektleitende sowie Administratoren verfügbar. Diese Anleitung wird Ihnen im Zuge der Projektdurchführung von Ihrer KUMAVISION-Projektleitung bereitgestellt.

Alle weitergehenden Einstellungen von etagis APS finden Sie im Handbuch der Anwendung unter Menü/Extras/Handbuch.

KUMAVISION Moduleinrichtung

Um das etagis Interface zu verwenden, aktivieren Sie den Schalter "etagis Interface aktivieren" in der KUMAVISION Moduleinrichtung.

Benutzer

Für den Zugriff von etagis APS ist die Einrichtung eines separaten Benutzers (OnPremise-Umgebungen) bzw. einer Microsoft Entra-ID (SaaS-Umgebungen) mit eingeschränktem Zugriff (siehe Benutzerberechtigungssätze) innerhalb von KUMAVISION factory365 erforderlich.

Beachten Sie hierbei die verschiedenen Möglichkeiten innerhalb der bereits erwähnten Anleitung zur Installation und Einrichtung von etagis Interface und etagis APS.

Benutzerberechtigungssätze

Als Mindestanforderung für den Zugriff der Schnittstelle müssen die folgenden Berechtigungssätze zugewiesen werden:

• D365 BASIC
  Berechtigungssatz im Auslieferungszustand von Microsoft Dynamics 365 Business Central
• SYSTEM APP - BASIC
  Berechtigungssatz im Auslieferungszustand von Microsoft Dynamics 365 Business Central
• KVSFCYETAGIS
  Berechtigungssatz im Auslieferungszustand der KUMAVISION factory365

Note

Hinweis Die Berechtigungssätze im Auslieferungszustand können nicht angepasst werden. Für kundenspezifische Erweiterungen der Berechtigungen muss ein separater Berechtigungssatz angelegt und zugewiesen werden.

Firmendaten

Damit die Planungsergebnisse aus etagis APS fehlerfrei in KUMAVISION factory395 zurückgeschrieben werden können, muss im Inforegister "Allgemein" der Firmendaten der Schalter "Datumskonflikte aktivieren" eingeschaltet sein.

Note

Hinweis Innerhalb von etagis APS werden die Fälligkeiten von Kundenaufträgen und Projekten grundsätzlich nicht angepasst. Daher müssen potenzielle Datumskonflikte bei Reservierungen, die beim Import aus etagis APS entstehen, entsprechend verarbeitet werden können.

Verwendung im Prozess

Das etagis Interface wird im Rahmen von Import- und Exportprozessen in etagis APS automatisiert im Hintergrund ausgeführt, sodass Sie nicht direkt in diese Abläufe eingebunden sind. Für die administrative Überwachung der Importe aus etagis sowie deren Weiterverarbeitung in KUMAVISION factory365 stehen dennoch verschiedene Funktionen zur Verfügung.

Note

Hinweis Die manuelle Verarbeitung der Etagis Importposten kann in der Konfiguration von etagis APS aktiviert werden.

Etagis Importposten

Sie können die Übersicht der Etagis-Importposten direkt über die Anwendersuche in KUMAVISION factory365 öffnen. Dort sehen Sie zunächst eine Zusammenfassung des Verarbeitungsprotokolls der Schnittstelle sowie eine Auflistung der Tabellen, die von etagis APS an Microsoft Dynamics 365 Business Central übertragen wurden.

Zusätzlich zum Status des jeweiligen Importpostens werden weitere Informationen bereitgestellt, darunter der Zeitstempel für den Empfang und die Verarbeitung sowie die Anzahl der erfolgreich importierten Datensätze.

Über den Wert im Feld "Anzahl Detailzeilen" bzw. über "Postenzeilen anzeigen" im Menüband lassen sich die Etagis Importpostenzeilen aufrufen. Über "Inhalt anzeigen" kann der genaue Inhalt der JSON-Datei eingesehen werden, wie er von etagis APS übermittelt wurde.

Diese Informationen sind ebenfalls in Klartext auf der Seite "Etagis Import Feldeinträge" hinterlegt und können über die entsprechenden Etagis Importpostenzeilen abgerufen werden.

Im Menüband stehen des Weiteren für den manuellen Eingriff in die Verarbeitung die Funktionsaufrufe: "Import starten", "Verarbeitet setzen" und "Verarbeitung zurücksetzen" zur Verfügung.

Note

Hinweis Die manuelle Bearbeitung von etagis Importposten ist ausschließlich in Ausnahmefällen vorgesehen oder kann während der Einführungsphase eingesetzt werden, sofern die automatische Verarbeitung in etagis APS deaktiviert ist.

Tabellendaten der Etagis-Importposten

Die unten aufgeführten Tabellen und Felder aus Microsoft Dynamics 365 Business Central werden im Rahmen der Standardkonfiguration während der Verarbeitung der Etagis Importposten berücksichtigt:

Tabellen-ID	Beschreibung	Felder
5406	FA-Zeilen immer in Kombination mit den zugehörigen FA-Arbeitsgängen	• Startdatum/-zeit • Enddatum/-zeit • Etagis Daten: Inhalt wird in der etagis Konfiguration definiert
5409	FA-Arbeitsgänge	• Art: Arbeitsplatz bzw. Arbeitsplatzgruppe • Nr.: Nummer des Arbeitsplatzes bzw. der Arbeitsplatzgruppe • Startdatum/-zeit • Enddatum/-zeit • Etagis Daten: Inhalt wird in der etagis Konfiguration definiert
1003	Projektplanzeilen (nur wenn in Konfiguration von etagis APS die Verarbeitung der Projekte aktiviert ist)	• Startdatum • Planungsdatum

Note

Hinweis Für projektspezifische Erweiterungen stehen entsprechende Events innerhalb von etagis Interface zur Verfügung. Hierbei ist zu beachten, dass auch die Konfiguration innerhalb von etagis APS für den Import als auch Export angepasst werden muss (siehe Handbuch unter Menü/Extras/Handbuch innerhalb von etagis APS).

Etagis Importpostenzeilen

Die Übersicht der Etagis Importpostenzeilen lässt sich entweder direkt über die Anwendersuche in KUMAVISION factory365 öffnen oder über das Menüband der Etagis Importposten Übersicht aufrufen.

In den Etagis Importpostenzeilen werden sämtliche Datensätze angezeigt, die von etagis APS übertragen wurden. Zu jedem Datensatz erhalten Sie neben den Primärschlüssel-Informationen auch Angaben zum Verarbeitungsstatus sowie, im Falle eines Fehlers während der Verarbeitung, eine spezifische Fehlermeldung.

Mit "Herkunftsbelegzeile anzeigen" oder "Herkunftsbeleg anzeigen" im Menüband können Sie direkt auf den entsprechenden Beleg bzw. die jeweilige Belegzeile zugreifen. Über "Feldeinträge anzeigen" lassen sich die Etagis Import Feldeinträge öffnen, die ebenfalls in der Infobox der Etagis Importpostenzeilen dargestellt werden.

Für den manuellen Eingriff in die Verarbeitung der Etagis Importposten besteht an dieser Stelle die Möglichkeit, einzelne Datensätze bei Fehlern über "Zeile zurücksetzen" im Menüband für eine erneute Verarbeitung zu aktivieren. Zudem kann der spezifische Inhalt der jeweiligen JSON-Datei, die aus etagis APS übermittelt wurde, für den entsprechenden Datensatz abgerufen werden.

Etagis Import Feldeinträge

In der Übersicht der Etagis Import Feldeinträge, die über die Etagis Importpostenzeilen aufgerufen werden kann, lassen sich die einzelnen Felder und deren Inhalte bequem einsehen. Dabei wird zu jedem Tabellenfeld in Microsoft Dynamics 365 Business Central der extrahierte Feldwert aus der JSON-Datei als Text angezeigt, ebenso wie dessen Übernahme als entsprechender Wert im Tabellenfeld. Bei Tabellenfeldern des Typs "DateTime" oder "Time" wird auch die Zeitzone berücksichtigt, die in der Microsoft Entra-Anwendung konfiguriert ist.

Etagis Import Fehlerhandling

Um sicherzustellen, dass Sie im Falle eines Fehlers während der Hintergrundverarbeitung der Etagis Importposten informiert werden, wurden die Rollencenter "Produktionsleiter" und "Projekt-Manager" um einen "Etagis Import"-Stapel sowie das Benachrichtigungssystem von Microsoft Dynamics 365 Business Central erweitert.

Note

Hinweis Die im Stapel angezeigten Informationen sowie die Benachrichtigungen beziehen sich grundsätzlich auf Fehler, die beim letzten Import aus etagis aufgetreten sind.

Stapel: "etagis Import" im Rollencenter "Produktionsleiter"

Falls bei der Verarbeitung der Etagis Importposten für Fertigungsaufträge Fehler auftreten, werden diese in diesem Stapel angezeigt. Über diesen Stapel kann anschließend die Übersicht der Etagis Importposten mit dem Status "Fehler" aufgerufen werden.

Stapel: "etagis Import" im Rollencenter "Projekt-Manager"

Falls bei der Verarbeitung der Etagis Importposten für Projekte Fehler auftreten, werden diese in diesem Stapel angezeigt. Über diesen Stapel kann anschließend die Übersicht der Etagis Importposten mit dem Status "Fehler" aufgerufen werden.

Etagis Import Benachrichtigungen

Im Rahmen von Fertigungsaufträgen und Projekten erhalten Sie in der jeweiligen Belegkarte eine Benachrichtigung, sobald fehlerhafte Etagis Importposten für den entsprechenden Vorgang vorliegen.

Über diese Benachrichtigung lässt sich per Klick direkt die Übersicht der fehlerhaften Etagis Importposten zum jeweiligen Beleg aufrufen. NutzerInnen können die Benachrichtigungen innerhalb der Belege bei Bedarf auch grundsätzlich deaktivieren.

Note

Hinweis Deaktivierte Benachrichtigungen lassen sich jederzeit über "Meine Benachrichtigungen" wieder aktivieren.

---

Microsoft, Microsoft Dynamics und Microsoft Dynamics 365 sind Marken der Microsoft-Unternehmensgruppe.