AllgemeinDie App BRZ Interface verbindet Microsoft Dynamics 365 Business Central mit der Lohn- und Kostenrechnungsumgebung von BRZ. Sie tauscht CSV-Dateien für Mitarbeiterstammdaten, Lohnbuchungen und Projektdaten über eine SharePoint-Dokumentbibliothek aus, wobei der Dateizugriff über Microsoft Graph abgesichert ist.
Die App wird von Buchhaltungs- und Personalverrechnungs-Mitarbeitern verwendet, die von BRZ gelieferte Mitarbeiter- und Lohndaten in Business Central importieren und Projektdaten aus Business Central an BRZ exportieren. Jeder Import- oder Exportlauf wird protokolliert, sodass jederzeit nachvollzogen werden kann, welche Dateien wann verarbeitet wurden.
App EinrichtungAuf der Seite BRZ Import/Export-Einrichtung werden alle Angaben hinterlegt, die die App benötigt, um sich mit der BRZ-SharePoint-Dokumentbibliothek zu verbinden und importierte Lohndaten korrekt zu buchen. Diese Seite muss einmalig eingerichtet werden, bevor ein Import oder Export durchgeführt wird.
Für companyspezifische BRZ-Identifikatoren verwendet man die Seite Unternehmen. Diese Werte werden je Mandant gespeichert und im Projektexport berücksichtigt.
| Feld | Beschreibung |
| Tenant-ID | Die Tenant-ID (Verzeichnis-ID) der Azure AD App-Registrierung, mit der bei Microsoft Graph angemeldet wird. |
| Client ID | Die Anwendungs-ID (Client) der Azure AD App-Registrierung. |
| Geheime Clientschlüssel | Das Client Secret der App-Registrierung. Der Wert wird verschlüsselt gespeichert, nach der Eingabe werden nur Sternchen angezeigt. |
| Basis-URL | Die Basis-URL der SharePoint-Site, auf der sich die Dokumentbibliothek befindet, z. B. https://company.sharepoint.com. |
| Site-Name | Der Name der SharePoint-Unterwebsite, falls sich die Dokumentbibliothek nicht direkt unter der Basis-URL befindet. |
| Archiv Ordner | Ordner, in den eine erfolgreich importierte Datei nach der Verarbeitung verschoben wird. |
| Fehler Ordner | Ordner, in den eine Datei verschoben wird, wenn der Import mit Fehlern endet. |
| Feld | Beschreibung |
| BRZ-Bauartnr. | Die von BRZ verwendete Bauartnummer, die in die Projektexportdatei aufgenommen wird. |
| BRZ-Verwaltungskostenstelle | Die von BRZ verwendete Verwaltungskostenart, die in die Projektexportdatei aufgenommen wird. |
| Präfix Kostenstelle | Präfix, das dem Kostenstellencode in der Projektexportdatei vorangestellt wird. |
| Feld | Beschreibung |
| Lohn Fibu Buch.-Blattvorlage | Buch.-Blattvorlage, die die Fibu-Zeilen (F-Zeilen) aus dem Lohnimport aufnimmt. |
| Lohn Fibu Buch.-Blattname | Buch.-Blattname, der die Fibu-Zeilen (F-Zeilen) aus dem Lohnimport aufnimmt. |
| Lohn NCCA Buch.-Blattvorlage | Kostenrechnungs-Buch.-Blattvorlage, die die KoRe-Zeilen (B-Zeilen) aus dem Lohnimport aufnimmt. |
| Lohn NCCA Buch.-Blattname | Kostenrechnungs-Buch.-Blattname, der die KoRe-Zeilen (B-Zeilen) aus dem Lohnimport aufnimmt. |
| Kostenträger leer | Standard-Kostenträger, der verwendet wird, wenn eine Lohnzeile keinen Kostenträger angibt. |
Diese Felder liefern die Standardwerte, die verwendet werden, wenn beim Mitarbeiterimport neue Ressourcen angelegt werden.
| Feld | Beschreibung |
| Res. Prod.-Buchungsgruppe | Standard-Prod.-Buchungsgruppe, die neuen Ressourcen zugewiesen wird. |
| Res. KoRe Buchungsgruppe | Standard-KoRe-Buchungsgruppe, die neuen Ressourcen zugewiesen wird. |
| Res. Preisbildungsgruppe | Standard-Preisbildungsgruppe, die neuen Ressourcen zugewiesen wird. |
Der Teil Dateien auf der Einrichtungsseite listet je einen Eintrag pro Datensatzart (Mitarbeiter, Lohn, Projekt) und legt fest, wo die zugehörige Datei abgeholt wird. Details siehe Import/Export-Dateieinrichtung.
Öffnet die Seite CSV Feldzuordnung, auf der Business Central-Tabellenfelder mit einer Spaltenposition in der CSV-Importdatei verknüpft werden.
Öffnet die Seite Import/Export Protokoll, auf der jeder Import- und Exportlauf mit seiner Ergebnisdatei aufgelistet wird.
TODO Bild: Screenshot der Seite BRZ Import/Export-Einrichtung mit dem Bereich Verbindung sowie den Aktionen Feldzuordnung und Protokoll.
Import/Export-DateieinrichtungDer Teil Dateien auf der Seite App Einrichtung legt für jede Datensatzart fest, wo die zu importierende oder zu exportierende Datei liegt. Für jede Datensatzart (Mitarbeiter, Lohn, Projekt) gibt es eine Zeile.
| Feld | Beschreibung |
| Datensatzart | Die Art der Daten, auf die sich die Zeile bezieht: Mitarbeiter, Lohn oder Projekt. |
| Bibliothek-Name | Der genaue Name der SharePoint-Dokumentbibliothek (bzw. des Ordners), aus der die Datei abgeholt bzw. in die sie hochgeladen wird. |
| Dateiname | Der genaue Dateiname, nach dem gesucht wird, z. B. Mitarbeiter.csv. Bleibt das Feld leer, wird die neueste CSV-Datei in der Bibliothek verwendet. |
| Dateierweiterung | Die für diese Datensatzart erwartete Dateierweiterung, z. B. csv. |
| Begrenzungszeichen | Das Zeichen, mit dem die Spalten in der CSV-Datei getrennt werden, z. B. ein Semikolon. |
Bibliothek-Name, Dateiname und Begrenzungszeichen müssen zu der Datei passen, die BRZ tatsächlich liefert, sonst kann der Import die Datei nicht finden oder nicht korrekt lesen.
CSV FeldzuordnungDie Seite CSV Feldzuordnung verknüpft Business Central-Tabellenfelder mit einer Spaltenposition in der von BRZ gelieferten CSV-Datei, z. B. für den Mitarbeiterimport. Jede Zeile beschreibt ein Feld.
| Feld | Beschreibung |
| BC Tabellennr. | Die Nummer der Business Central-Tabelle, zu der das Feld gehört. |
| BC Tabellenbezeichnung | Die Bezeichnung der gewählten Tabelle (nicht editierbar, dient nur der besseren Lesbarkeit). |
| Sortierung | Die Position, an der das Feld in der CSV-Datei steht. Jede Position darf pro Tabelle nur einmal vergeben werden. |
| BC Feldnr. | Die Nummer des Feldes innerhalb der gewählten Tabelle. Verwenden Sie die Suchfunktion Feldauswahl, um das richtige Feld zu finden. |
| BC Feldbezeichnung | Die Bezeichnung des gewählten Feldes (nicht editierbar, dient nur der besseren Lesbarkeit). |
| CSV-Dateifeld | Die Spaltenbezeichnung bzw. Kennung, wie sie in der CSV-Datei vorkommt. |
Wird eine Sortierposition eingegeben, die für dieselbe Tabelle bereits vergeben ist, erscheint eine Fehlermeldung, um doppelte Zuordnungen zu vermeiden.
Arbeiten mit der AppDie App BRZ Interface tauscht Daten zwischen Business Central und BRZ aus, indem CSV-Dateien über eine SharePoint-Dokumentbibliothek ausgetauscht werden. Die App verbindet sich nie direkt mit BRZ, sondern lädt Dateien aus der gemeinsam genutzten Bibliothek herunter bzw. lädt sie dorthin hoch.
UnternehmenAuf der Liste Unternehmen werden BRZ-spezifische Mandanteninformationen gespeichert, die für den Projektexport an BRZ erforderlich sind. Der Wert wird je Mandant gepflegt und im CSV-Exportprozess wiederverwendet.
| Feld | Beschreibung |
| BRZ-BETRNR | Die BRZ-Geschäftsnummer des Unternehmens. Sie wird in die Projektexportdatei aufgenommen und dient BRZ zur eindeutigen Zuordnung des richtigen Mandanten. |
Verwenden Sie diese Seite, wenn ein Mandant mit seiner BRZ-Identifikationsnummer verknüpft werden muss, bevor Projektdaten an die BRZ-Umgebung gesendet werden. Der Wert wird in der mandantenspezifischen Einrichtung gespeichert und gehört nicht zur globalen BRZ-Import-/Export-Einrichtung.
Import/Export ProtokollDie Seite Import/Export Protokoll listet jeden von der App durchgeführten Import- und Exportlauf auf, damit Administratoren nachvollziehen können, welche Dateien wann verarbeitet wurden, und die archivierte oder fehlerhafte Datei anschließend wiederfinden.
| Feld | Beschreibung |
| Lfd.-Nr. | Eindeutiger Bezeichner dieses Protokolleintrags. |
| Art | Gibt an, ob es sich um einen Import- oder Exportlauf handelt. |
| Datensatzart | Die Art der verarbeiteten Daten: Mitarbeiter, Lohn oder Projekt. |
| Startdatum/Uhrzeit | Datum und Uhrzeit, zu der der Lauf gestartet wurde. |
| Dateiname | Name der verarbeiteten CSV-Datei. |
| Arch. Dateiname | Name, unter dem die verarbeitete Datei im Archiv- oder Fehlerordner abgelegt wurde, in der Regel der ursprüngliche Dateiname mit einem angehängten Zeitstempel. |
Diese Seite sollte nach jedem Import- oder Exportlauf als Erstes geprüft werden, um zu bestätigen, dass der Lauf abgeschlossen wurde, und um die verwendete Datei wiederzufinden.
FeldauswahlDie Seite Feldauswahl listet alle Felder von Business Central-Tabellen auf und dient als Suchhilfe beim Eintragen eines Feldes auf der Seite CSV Feldzuordnung. Sie hilft dabei, die richtige Feldnummer zu finden, ohne sie vorher zu kennen.
| Feld | Beschreibung |
| Tabellennr. | Die Nummer der Tabelle, zu der das Feld gehört. |
| Tabellenname | Der interne Name der Tabelle, zu der das Feld gehört. |
| Nr. | Die Nummer des Feldes innerhalb der Tabelle. |
| Feldbezeichnung | Die Bezeichnung des Feldes, wie sie in Business Central angezeigt wird. |
| Art | Der Datentyp des Feldes, z. B. Text, Code oder Dezimalzahl. |
| Class | Die Feldklasse, z. B. Normal oder FlowField. |
Versionshinweise
