Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

UI Button
colorturquoise
titleXL

Info
titleInfo:

Das Feld "Externe Daten" steht für folgende Systeme zur Verfügung:

Hauptaufgabe der Formel "DSInfo"

...

Die generische Funktion DSInfo (Datensatz-Info) steht in Regeln zu Verfügung - siehe hierzu auch: Regeln, Filter und Selektionen (Regeln für Plattformen).

UI Button
colorturquoise
titleM

DSInfo für Komma-separierte Stringlisten

Die Formel DSInfo ist in erster Linie zum Auswerten des Feldes "Externe Daten" gedacht ("Ab XL"), DSInfo-Formeln können allerdings auch Komma-separierte Stringlisten aus anderen Feldern auswerten - somit können Daten auch aus anderen Bereichen extrahiert und ausgewertet werden.

Note
titleBeachten Sie:

Beim Auswerten von Daten mittels DSInfo z. B. durch Regeln, beachten Sie bitte das Folgende:

  • Wenn ein Wert ein Leerzeichen besitzt oder selbst ein Komma beinhaltet, so muss der Teil-Ausdruck in "Anführungszeichen" stehen, diese werden dann nachfolgend auch entfernt bzw. aufgelöst
UI Expand
titleBildhinweis einblenden

Einfaches Beispiel:

Eine Regel soll über DSInfo auf das Memo-Feld des Vorgangs zugreifen und folgenden Wert auswerten:

Code Block
test,5, 5 ,5

Der Wert im Memo-Feld enthält Kommata und Leerzeichen:

Code Block
"test=mein Test", "test2= mein Test", test3=meintestohneleerzeichenundkomma, "test 4= test vier ist komplex", "test,5, 5 ,5= test 5, 5, 5 ist komplex, aber klappt"

Da dieser Wert im Memo-Feld Kommata und Leerzeichen enthält, muss beim Aufbau der Formel der Wert mit "Anführungszeichen" versehen sein, damit er ausgewertet werden kann.

Code Block
$DSInfo(«Vog.Memo»,"test,5, 5 ,5")


Die Regel, die dies auswertet und in das Feld "Vorgangsbezeichnung" nach einer Neuanlage schreibt, kann den Wert korrekt auswerten.


Dieses einfache Beispiel, das auf das Memo-Feld des Vorgangs zugreift, soll Ihnen aufzeigen, dass es beim Auswerten von bestimmten Strings mit Werten sinnvoll sein kann, die Anführungszeichen obligatorisch zu verwenden.

  • Wenn ein Wert kein Leerzeichen oder Komma beinhaltet, muss der Teil-Ausdruck auch nicht zwingend in Anführungszeichen stehen

UI Button
colorturquoise
titleXL

Theoretisches Beispiel aus dem E-Commerce

Ein praktischer Nutzen kann z. B. im Bereich E-Commerce über die Anbindung externer Daten genutzt werden.
Die verfügbaren externen Daten aus dem ShopSystem werden nicht in büro+ gespeichert, stehen aber im Feld "Externe Daten" als Datenstring zur Verfügung, um mit DSInfo ausgewertet werden zu können.
Der Datenstring der Externen Daten wird nicht visuell angezeigt (die Daten werden über DSInfo ausgewertet).

Warning
titleBeachten Sie:

Die externen Daten stehen nur während der Abarbeitung der Regeln zur Verfügung und werden nicht gespeichert!

Tip
titleTipp
Wenn Sie wissen möchten, was für Daten in "Externe Daten" enthalten sind, empfiehlt es sich für einen Testzeitraum, diese Daten z.B. erst einmal komplett in ein Feld per Feldzuweisung zu schreiben (z.B.: in das Info-Feld), da die Daten ja nur temporär in "Externe Daten" zur Verfügung
  • stehen
.

Praktischer Nutzen

Ein bestimmter Wert soll aus dem Datenstring gewonnen werden.

Durch diese neue Lösung im Programmbereich, können so z. B. die "Freien Felder" in der Middleware abgelöst werden.

Beispiel:

Im Feld externe Daten befindet sich folgender Datenstring:

Code Block
orderDate="2021-02-10T10:59:32.054+0000",orderNumber="bgwootdb",salesOrderId="10e434c790fe-4711-123"

Über die Plattformregel mit der Verwendung der DSinfo-Formel kann somit explizit z. B. gezielt der Wert der salesOrderId ausgewertet werden.

Code Block
$DSInfo(Vog.ExtDaten,salesOrderId)

Die komma-separierte Key-Value-Stringliste kann nach einem bestimmten Schlüssel (Key) durchsucht werden und liefert dessen Wert (Value) zurück.

Dabei ist der KEY= die Sales-Order-Id und der VALUE="10e434c790fe-4711-123"

Hier ist eine Regeln mittels der folgenden Beschreibung zu erstellen: Regeln, Filter und Selektionen.

Tip
titleTipp:

Die  komma-separierte Key-Value-Stringliste können sich der Einfachheit halber auch als großes Gefäß vorstellen, in welchem eine Vielzahl an Werten steckt. Aus diesen vielen Werten können Sie sich von büro+ einen passenden Wert ausgeben lassen.

Praktisches Beispiel beim Einsatz der E-Commerce-Lösung: Nutzung mit Shopware 5 (in Verbindung mit der Middleware) 

Wurde in büro+ eine Shopware 5-Plattform eingerichtet, wird das Feld: EXTERNE DATEN automatisch befüllt.

Note
titleBeachten Sie:

Nach Anwenden der Regeln zum Vorbelegen, wird das Feld wieder geleert!

Hintergrund zum Feld: "Externe Daten"

Über dieses Feld kann innerhalb von microtech büro+ auf externe Daten zugegriffen werden, welche über COM zusätzlich übermittelt werden, aber nicht in ein spezifisches Feld geschrieben werden. Das Feld wird von der COM Anwendung befüllt, der Inhalt wird nicht in der büro+ Datenbank gespeichert, sondern steht nur für die Dauer der Regel-Abarbeitung der Auswertungspositionen zur Verfügung. Das Feld wird nur von der Middleware beschrieben, da es exklusiv für den Bereich "E-Commerce" gedacht ist.

Befüllung des Feldes "Externe Daten" in büro+

  • Das Feld Externe Daten im büro+ Bereich "Adressen" wird automatisch mit den Shopware-Feldern der Adresse befüllt
  • Das Feld Externe Daten im büro+ Bereich "Anschriften" wird automatisch mit den Shopware-Feldern der Anschrift befüllt
  • Das Feld Externe Daten im büro+ Bereich "Vorgänge" wird automatisch mit den Shopware-Feldern des Vorgangs befüllt

Nutzung des Feldes "Externe Daten" über die Regel-Auswertungspositionen in "Regeln für Plattformen"

Die nachfolgenden Auswertungspositionen werden in der Regel über die Funktion der "Feldzuweisung" angelegt und werden dann ausgeführt, wenn ein entsprechender Datensatz für den E-Commerce-Bereich angelegt wird.

Sofern im Datensatz die Plattform-Nummer befüllt ist, werden diese ausgeführt.

  • Auswertungsposition "Für das Vorbelegen von neuen Adress-Datensätzen"
  • Auswertungsposition "Für das Vorbelegen von neuen Anschriften-Datensätzen"
  • Auswertungsposition "Für das Vorbelegen von neuen Ansprechpartner-Datensätzen"
  • Auswertungsposition "Für das Vorbelegen von neuen Vorgangs-Datensätzen"
  • Auswertungsposition "Für das Vorbelegen von neuen Vorgangspositions-Datensätzen"

Siehe hierzu in der Hilfe auch unter: Regeln, Filter und Selektionen (https://hilfe.microtech.de/display/PROG/Regeln%2C+Filter+und+Selektionen)

Info
titleInfo:

Andere Anwendungsfälle sind auch möglich, z. B. wenn mit der Funktion DSInfo z. B. ein Export gestartet werden soll, sobald ein bestimmter Wert über die externen Daten empfangen wird. So lassen sich auch verschiedene Aktionen mittels der Regeln triggern.

Weitere Infos bei Nutzung in Zusammenhang mit Shopware 5 und Magento 2 (Middleware)

Es können grundlegend alle Felder, die auch als freie Felder aus dem Shop abfragbar sind, über das Feld "Externe Daten" in büro+ eingeladen werden. 

Das Mapping über Freie Felder in der Middleware wird über DSInfo und die neuen Regeln obsolet.

Warning
titleBeachten Sie:
  • Der Unterschied zum bisherigen Verfahren ist, dass zuvor nur auf den Gesamtinhalt des Feldes zugegriffen werden konnte, nun kann auf einzelne Werte innerhalb von Feldern zurückgegriffen werden
  • Die Funktion steht theoretisch grundsätzlich auch für andere ähnlich aufgebaute Felder in der Software zur Verfügung
  • Die Funktion wurde für den speziellen Anwendungsfall "Auswerten des Externe Daten-Felds" eingebracht

Tabellen, in denen das Feld "Externe Daten" zur Verfügung steht

  • Adressen
  • Anschriften
  • Vorgänge

...