Info |
---|
|
Das Feld "Externe Daten" steht für folgende Systeme zur Verfügung: |
...
Die generische Funktion DSInfo (Datensatz-Info) steht in Regeln zu Verfügung - siehe hierzu auch: Regeln, Filter und Selektionen (Regeln für Plattformen).
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 |
---|
|
Beim Auswerten von Daten mittels DSInfo z. B. durch Regeln, beachten Sie bitte das Folgende: - Wenn ein Wert ein Leerzeichen
hat - 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 |
---|
title | Bildhinweis einblenden |
---|
| Einfaches Beispiel: Mittels PARAMETER - VORGÄNGE UND ZWISCHENBELEGE - REGELN soll ein Feld mittels Feldzuweisung befüllt werden. Aus der DSInfo-Datenstruktur soll der Wert von "test 3" in das Feld geschrieben werden. Image Removed
Beim Erfassen der Formel wird im Feldeditor mittels der Anführungszeichen gewährleistet, dass der Wert korrekt ausgewertet werden kann. Image Removed
|
- Wenn ein Wert kein Leerzeichen oder Komma beinhaltet, muss der Teil-Ausdruck auch nicht zwingend in Anführungszeichen stehen
UI Expand |
---|
title | Bildhinweis einblenden |
---|
| In diesem Beispiel ist der auszuwertende Bereich ohne Komma oder Leerzeichen, sondern ein zusammenhängender Text: "test2" - es ist keine Nutzung von Anführungszeichen erforderlich. Image Removed
|
|
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 |
---|
|
Die externen Daten stehen nur während der Abarbeitung der Regeln zur Verfügung und werden nicht gespeichert! |
Tip |
---|
|
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. |
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 |
---|
|
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. |
Wurde in büro+ eine Shopware 5-Plattform eingerichtet, wird das Feld: EXTERNE DATEN automatisch befüllt.
Note |
---|
|
Nach Anwenden der Regeln zum Vorbelegen, wird das Feld wieder geleert! |
Ü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.
- 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
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 |
---|
|
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. |
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 |
---|
|
- 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
|
- Adressen
- Anschriften
- Vorgänge
...
Eine Regel soll über DSInfo auf das Memo-Feld des Vorgangs zugreifen und folgenden Wert auswerten: 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" |
Image Added
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") |
Image Added
Die Regel, die dies auswertet und in das Feld "Vorgangsbezeichnung" nach einer Neuanlage schreibt, kann den Wert korrekt auswerten. Image Added
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
|