Appearance
ELO Komponente im Portal konfigurieren
In der ConnectCLOUD-Verwaltungsoberfläche (MBCOM Portal) können die spezifischen Einstellungen für die ELO-Anbindung pro Mandant vorgenommen werden. Dabei dient die Option „Aktiv“ als zentraler Schalter, über den die ELO-Schnittstelle für den jeweiligen Mandanten ein- oder ausgeschaltet wird.
Die Anbindung selbst ist in vier Hauptbereiche gegliedert, die unabhängig voneinander aktiviert und konfiguriert werden können.
Adressen
- Aktiv: Aktiviert den Adress-Export nach ELO.
- Ablagepfad: Zielpfad im ELO-Archiv (z.B.
¶Adressen¶Kunden). Unterstützt Mustache-Templates. - Name: Maskierung/Namensschema für den Archiveintrag. Unterstützt Mustache-Templates.
- Unterordner: Liste von Unterordnern, die automatisch unter dem Adresseintrag erstellt werden sollen.
Verfügbare Felder für Adressen
| Feld | Beschreibung | Beispiel |
|---|---|---|
fldAdrNr | Adressnummer | 10001 |
fldStatus | Status | Kunde |
fldErstDat | Erstellungsdatum | 2024-04-14T07:25 |
fldErstBzr | Erstellt durch (Benutzer) | ADMIN |
fldGspKz | Gesperrt-Kennzeichen (Boolean) | false |
rowReAnsNr.fldNa1 | Name 1 (Rechnungsanschrift) | Müller GmbH |
rowReAnsNr.fldNa2 | Name 2 (Rechnungsanschrift) | Einkauf |
rowReAnsNr.fldNa3 | Name 3 (Rechnungsanschrift) | |
rowReAnsNr.fldStr | Straße (Rechnungsanschrift) | Musterstraße 1 |
rowReAnsNr.fldPLZ | PLZ (Rechnungsanschrift) | 12345 |
rowReAnsNr.fldOrt | Ort (Rechnungsanschrift) | Musterstadt |
rowReAnsNr.fldLand | Land (Rechnungsanschrift) | Deutschland |
Artikel
- Aktiv: Aktiviert den Artikel-Export nach ELO.
- Ablagepfad: Zielpfad im ELO-Archiv (z.B.
¶Artikel¶Stammdaten). Unterstützt Mustache-Templates. - Name: Namensschema für den Archiveintrag. Unterstützt Mustache-Templates.
- Unterordner: Automatisch zu erstellende Unterstrukturen.
Verfügbare Felder für Artikel
| Feld | Beschreibung | Beispiel |
|---|---|---|
fldArtNr | Artikelnummer | A-100 |
fldBez1 | Bezeichnung 1 | Bürostuhl |
fldWgrNr | Warengruppennummer | W-10 |
fldSuchBeg | Suchbegriff | Möbel |
fldBarCd | Barcode | 12345678 |
fldErstDat | Erstellungsdatum | 2024-04-14T07:25 |
fldRef | Referenz | |
fldArtikelArt | Artikelart | Lagerartikel |
fldMemo | Memo-Feld | |
fldGspKz | Gesperrt-Kennzeichen (Boolean) | false |
Projekte
- Aktiv: Aktiviert den Projekt-Export nach ELO.
- Ablagepfad: Zielpfad im ELO-Archiv (z.B.
¶Projekte). Unterstützt Mustache-Templates. - Name: Namensschema für den Archiveintrag. Unterstützt Mustache-Templates.
- Unterordner: Liste von Unterordnern für die Projektakte.
Verfügbare Felder für Projekte
| Feld | Beschreibung | Beispiel |
|---|---|---|
fldPrjNr | Projektnummer | P-2024-01 |
fldBez | Bezeichnung | Neubau Lagerhalle |
fldAdrNr | Zugehörige Adressnummer | 10001 |
fldAnsp | Ansprechpartner | Herr Müller |
fldSBzrNr | Sachbearbeiter-Nummer | 1 |
fldWichtig | Wichtig-Kennzeichen | |
fldPrjSts | Projektstatus | Aktiv |
fldArt | Projektart | Standard |
fldGspKz | Gesperrt-Kennzeichen (Boolean) | false |
fldErstDat | Erstellungsdatum | 2024-04-14T07:25 |
year | Jahr des Erstellungsdatums | 2024 |
month | Monat des Erstellungsdatums | 4 |
Belege (Rechnungen/Einkauf)
- Aktiv: Aktiviert die Belegarchivierung.
- Ablagepfad: Basis-Zielpfad für Belege. Unterstützt Mustache-Templates.
- Name: Namensschema für das Dokument. Unterstützt Mustache-Templates.
- Workflows: Konfiguration von ELO-Workflows, die nach der Archivierung gestartet werden sollen.
Verfügbare Felder für Belege
| Feld | Beschreibung | Beispiel |
|---|---|---|
fldBelegNr | Belegnummer | RE-12345 |
fldArt | Belegart (z.B. RE, LS, AN) | RE |
fldBez | Bezeichnung | Rechnung Müller GmbH |
fldDat | Belegdatum | 2024-04-14T07:25 |
fldAdrNr | Adressnummer | 10001 |
fldPrjNr | Projektnummer | P-2024-01 |
fldAuftrNr | Auftragsnummer | |
fldBestellNr | Bestellnummer | |
fldLiefDat | Lieferdatum | 2024-04-14T07:25 |
fldGspKz | Gesperrt-Kennzeichen (Boolean) | false |
year | Jahr des Belegdatums | 2024 |
month | Monat des Belegdatums | 4 |
acoGPreis.totalNetAmount | Gesamt-Nettobetrag | 100.00 |
acoGPreis.totalGrossAmount | Gesamt-Bruttobetrag | 119.00 |
fldReNa1 | Name 1 (Rechnungsanschrift) | Müller GmbH |
fldReNa2 | Name 2 (Rechnungsanschrift) | Einkauf |
fldReNa3 | Name 3 (Rechnungsanschrift) | |
fldReStr | Straße (Rechnungsanschrift) | Musterstraße 1 |
fldRePLZ | PLZ (Rechnungsanschrift) | 12345 |
fldReOrt | Ort (Rechnungsanschrift) | Musterstadt |
fldReLand | Land (Rechnungsanschrift) | Deutschland |
fldReAspAnsp | Ansprechpartner (Rechnung) |
Dynamische Felder (Mustache Templates)
In den Feldern Ablagepfad und Name können Variablen in dreifachen geschweiften Klammern verwendet werden (z.B. {{{fldAdrNr}}}). Diese werden bei der Archivierung automatisch durch die entsprechenden Werte aus dem Quellsystem ersetzt. Standardmäßig sollte immer die triple mustache Syntax ({{{variable}}}) verwendet werden, um eine HTML-Codierung von Sonderzeichen zu vermeiden.
Mustache Syntax
Die ConnectCLOUD verwendet die JMustache Implementierung. Hier sind die wichtigsten Grundlagen:
- Variablen (Raw/Unescaped): Standardmäßig sollten Variablen in dreifachen geschweiften Klammern verwendet werden, um das HTML-Escaping zu umgehen, z.B.
{{{fldAdrNr}}}. - HTML-Escaping: Bei der Verwendung von doppelten Klammern
{{name}}werden Sonderzeichen (wie<oder&) in HTML-Entities umgewandelt. Da dies bei Pfaden und Namen in ELO nicht erwünscht ist, wird die Verwendung von triple mustache ({{{name}}}) empfohlen. - Verschachtelte Felder: Auf Unterobjekte kann mit dem Punkt-Operator zugegriffen werden, z.B.
{{{rowReAnsNr.fldNa1}}}. - Fehlende Werte: Wenn ein Feld nicht existiert oder
nullist, wird es standardmäßig durch einen leeren String ersetzt.
Weitere Informationen zur Syntax finden Sie in der offiziellen Mustache Dokumentation oder auf der JMustache Projektseite.
Hinweise zur Pfadangabe
- Pfade werden mit dem Paragraphen-Zeichen
¶als Trenner angegeben (ELO-Standard). - Beispiel:
¶Rechnungen¶Eingang¶{{{year}}}¶{{{fldBelegNr}}} - Ein führendes
¶stellt sicher, dass der Pfad ab der Archivwurzel aufgelöst wird. - ARCPATH: Intern werden Pfade in ELO oft mit dem Präfix
ARCPATH:adressiert. In der Konfiguration im MBCOM Portal ist dieses Präfix ebenfalls erforderlich, wenn man beispielsweise über eineExternalIDauf einen bestehenden Eintrag referenzieren möchte (siehe Beispiele unten). Ein einfaches¶am Anfang startet den Pfad ab der Archivwurzel. - Referenzierung über IDs: Es ist möglich, direkt auf bestehende ELO-Einträge über verschiedene ID-Typen zu referenzieren, um die Ablage innerhalb dieser Strukturen zu starten:
- ExternalID:
ARCPATH[EXTERNALID:MBCOM-TENANT-MBCOM]:¶...(Referenziert einen Eintrag über seine externe ID) - GUID:
ARCPATH[(GUID)]:¶...(Referenziert einen Eintrag über seine globale ELO-GUID) - ID:
ARCPATH[ID]:¶...(Referenziert einen Eintrag über seine numerische ELO-Objekt-ID)
- ExternalID:
- Beispiele für Ablagepfade:
ARCPATH[EXTERNALID:MBCOM-TENANT-MBCOM]:¶{{{fldStatus}}}ARCPATH[EXTERNALID:MBCOM-ADDRESS-{{{fldAdrNr}}}]:¶Projekte¶{{{year}}}¶{{{month}}}
- ExternalID: Jeder aus microtech exportierte Eintrag (Adresse, Artikel, Projekt, Beleg) erhält eine eindeutige
ExternalID. Diese setzt sich zusammen aus[Tenant]-[Typ]-[Nummer], z.B.demo-ADDRESS-10001. Diese ID dient der Identifizierung und verhindert Dubletten bei erneuten Synchronisationen.