Element `<output>`¶

Zweck: Deklariert eine erzeugte AMA-Nachrichtenausgabe.

Warum: Verwende dieses Element, um Template und Dateinamen für eine AMA-Nachrichtenausgabe festzulegen.

Beispiel¶

<output type="ORDERS" templateRef="recpTpl" filename="RECP___AmaUUID__"/>

Entscheidungshilfe¶

Fachlicher Nutzen: Macht konkreten AMA-Nachrichtentyp, Templateauswahl und Dateiname explizit.

Verwenden, wenn
- Wenn ein AMA-Task eine primäre Nachricht aus einem deklarierten Template ausgeben muss.
Anderen Ansatz wählen, wenn
- Beim Deklarieren des Templates oder eines zusätzlichen Trace-Artefakts.
Voraussetzungen
- Referenziere ein deklariertes Template und liefere einen sicheren Dateinamenvertrag.
Alternativen
- Verwende artifact für zusätzliche Traces, Dateien oder Workflow-Ausgaben. (Siehe: <artifact>)

Vollständige Beispiele¶

Profilierte EDIFACT-Ausgabe rendern und ihre Artefakte paketieren

Verwende die AMA-Familie, wenn partnerspezifische EDIFACT-Trennzeichen, Templates, Ausgabenamen, Nebenartefakte und Archivpakete gemeinsam modelliert werden müssen.

ama-edifact-package/templates/order.template.edi
UNH+__message_id__+ORDERS:D:96A:UN'

ama-edifact-package/datamimic.xml
<setup rngSeed="42">
    <ama-generate defaultEdifactProfileRef="unoc3" variablePrefix="__" variableSuffix="__">
        <edifactProfiles>
            <profile id="unoc3" decimal="." data="+" comp=":" release="?" term="'"/>
        </edifactProfiles>
        <templates>
            <template id="order_template"
                      path="templates/order.template.edi"
                      edifactProfileRef="unoc3"
                      sourceScripted="True"/>
        </templates>
        <variable name="message_id" generator="IncrementGenerator"/>
        <output type="ORDERS" templateRef="order_template" filename="ORDERS___message_id__"/>
        <artifact type="edi_outputs" folder="edi"/>
        <artifact type="edifact_trace_csv" filename="ORDERS___message_id___trace.csv"/>
        <package type="zip" filename="ORDERS___message_id__.zip"/>
    </ama-generate>
</setup>

Regeln und ungültige Kombinationen¶

Ein AMA-Output erfordert type oder das veraltete messageType.

Attribute: type, messageType

Warum: Der Renderer benötigt den Nachrichtentyp, um ausgabespezifische Variablen und Steuerwerte auszuwählen.

Gültige Kombination
<output type="RECP" templateRef="recpTpl" filename="RECP.edi"/>

Ungültige Kombination
<output templateRef="recpTpl" filename="RECP.edi"/>

Verwende type oder das veraltete messageType, niemals beides.

Attribute: type, messageType

Warum: Beide Attribute bezeichnen denselben Nachrichtentyp; unterschiedliche Werte wären mehrdeutig.

Gültige Kombination
<output type="RECP" templateRef="recpTpl" filename="RECP.edi"/>

Ungültige Kombination
<output type="RECP" messageType="ABRP" templateRef="recpTpl" filename="RECP.edi"/>

Erlaubte Elternelemente / Erlaubte Kindelemente¶

Erlaubte Elternelemente: ama-generate, else, else-if, if, while

Erlaubte Kindelemente:

Keine