GEFEG.FX 2021-Q3 Release: Your EDI team saves valuable troubleshooting time with better error messages – and other improvements

Was ist Neu im GEFEG.FX Quartals-Release 2021-Q3?

Neue Datenpakete in GEFEG.FX

UN/EDIFACT D.21A

• Neue Version

GS1 EANCOM® Anwendungsempfehlungen

• Neu: In Abstimmung mit GS1 Germany werden ab sofort die Anwendungsempfehlungen in GEFEG.FX als separates Modul bereitgestellt.

Einfach von EDI zu APIs? Jetzt Datenmodelle in APIs wiederverwenden. Model-First mit GEFEG.FX

Ab sofort unterstützt GEFEG.FX die Entwicklung von APIs auf Basis von OpenAPI 3.x. Und das Beste ist: Man kann die bestehenden Datenmodelle und Nachrichten in APIs weiterverwenden.

Mehr zum Thema

Verständlichere Fehlermeldungen und weitere Verbesserungen bei der Nachrichtenvalidierung

Damit ein Geschäftsprozess störungsfrei abgewickelt wird, muss eine Nachricht fehlerfrei sein – das heißt, sie muss den unternehmensspezifischen EDI-Richtlinien entsprechen.  Aus diesem Grund ist die Überprüfung eingehender oder ausgehender Geschäftsnachrichten auf Fehler eine Standardaufgabe für EDI-Teams. Unsere Software GEFEG.FX unterstützt EDI-Teams bei diesen Aufgaben, indem beispielsweise Nachrichten in einer Testumgebung validiert werden können, Testszenarien systematisch getestet werden oder auch Fehlermeldungen verständlich und eindeutig auf den Fehler hinweisen. Folgende Verbesserungen unterstützen Sie noch besser beim Validieren und Testen.

Schnellere Fehlerbehebung durch verständlichere Fehlermeldungen!

Das Ergebnis einer Validierung in GEFEG.FX ist ein Fehlerprotokoll, das neben technischen Meta-Informationen auch menschenlesbare Fehlermeldungen ausgibt. Anhand der Fehlermeldung erkennt der Anwender nicht nur die Stelle, an der ein Fehler aufgetreten ist, sondern versteht auch sofort die inhaltliche Abweichung von der Spezifikation. In GEFEG.FX wird die Note „Check“ sowohl für die Fehlermeldung als auch für die Ausgabe der Fehlerstelle verwendet:
„Das Datumsformat ist falsch. Geben Sie „ram:DateTimeString“ im Format CCYYMMDD an.“

Ab der aktuellen GEFEG.FX Version können Sie Fehlermeldungen noch genauer beschreiben. Bauen Sie verständliche Bezeichnungen in Ihre “Check”-Note ein, indem Sie einen Link zu einer anderen Note in der Fehlermeldung einbetten. Wenn Sie ein Datumsfeld mit einer GEFEG.FX-Note genauer beschreiben, zum Beispiel mit der Information “Lieferdatum” aus der Note “Definition”, wird die oben genannte Fehlermeldung mit folgendem Text ausgegeben:
„Das Datumsformat ist falsch. Geben Sie das „Lieferdatum“ im Format CCYYMMDD an.“

Dadurch wird die Fehlermeldung verständlicher und die Korrektur erfolgt schneller, da der Anwender sofort die richtige Stelle in der Nachricht erkennt.

Dokumentieren Sie Ihre Testnachrichten mit einem Klick!

Üblicherweise werden Nachrichten, und meist auch Testnachrichten von Datenformaten des klassischen EDI, wie z.B. ASC X12, UN/EDIFACT, IDoc, Flatfile etc. in einem Texteditor geöffnet.

Als GEFEG.FX-Anwender können Sie Ihre Testnachrichten auch mit GEFEG.FX-Reports, insbesondere dem GEFEG.FX Transaction Analyzer, visualisieren: Sowohl erfahrene EDI-Experten als auch EDI-Anfänger können mit Hilfe der Gegenüberstellung von Beispielnachricht und Standard den Inhalt der Nachricht bewerten, genauer interpretieren und eventuelle Fehler ablesen.

From now on, you can also conveniently generate the GEFEG.FX Transaction Analyzer report from the reports directory of the test data folder and create the test message similar to the EDI segment report as documentation.

No XML file ready for testing? Create your XML test files from your GEFEG.FX schema!

Validation in the XML schema environment involves checking whether an XML file, often also called an XML instance, meets the specifications of a schema, i.e. is valid in the sense of the XML syntax. If the XML test file cannot be provided by the EDI partner or internal applications, GEFEG.FX can help with the following XML export: XML sample file.

This export generates an XML file based on the structure of the GEFEG.FX schema. If example values for elements and attributes have been specified in the GEFEG.FX schema, these are taken over and output as element and attribute values of the XML file.

This procedure has now been extended. From now on, you can also control the output of sample values for element and attribute variants. With variants you create slightly different versions of elements, for example buyer and seller for the party roles. Decide whether to output examples for all variants, i.e. buyer AND seller, or only for the first variant, i.e. buyer only. We recommend outputting the example values for all variants, so that there is as large a representation as possible of the possible elements in the XML file.

Would you like further explanations about variants in XML Schemas? Our support team will be pleased to assist you.

How do I recognize unused data elements and data element groups?

The EDI Guide Editor in GEFEG.FX lists the message structure as a data tree in the data area. Unused data elements and data element groups at the end of a segment are grayed out and therefore immediately visible. But how can I recognize unused data elements that are present in the middle of a segment? Until now, this was only recognizable via the GEFEG.FX note “Status”. An “N” or “X” marks the non-use of a data element or data element group.

With the current release you will find the following innovation: with the status assignment “N” or “X” a cross is shown at the data element or data element group, so that the non-use is made clear at first glance. Especially when revising an EDI Guide or in a mapping project, it is now possible to quickly determine whether a data element is used or not.

In the following example, the action code is not needed in the ORDERS Guide: The status is therefore set to “N”. The cross next to the data element tag 1229 visualizes the non-use.