Element `<artifact>`¶

Zweck: Deklariert ein zusätzliches Artefakt, das ein AMA-Generierungslauf ausgibt.

Warum: Verwende dieses Element, um eine zusätzliche Datei, einen Trace, ein TIFF oder ein Workflow-Artefakt aus einem AMA-Lauf anzufordern.

Beispiel¶

<artifact type="partner_extension" filename="partner___AmaUUID__.dat"/>

Entscheidungshilfe¶

Fachlicher Nutzen: Ergänzt primäre AMA-Nachrichten um Trace, TIFF, Output-Sammlung oder Workflow-Datei.

Verwenden, wenn
- Wenn ein nachgelagerter Test- oder Auditprozess ein zusätzliches AMA-Artefakt benötigt.
Anderen Ansatz wählen, wenn
- Beim Deklarieren des primären Outputs oder beim reinen Bündeln vorhandener Dateien.
Voraussetzungen
- Platziere artifact in ama-generate und wähle unterstützten Typ und Pfad.
Alternativen
- Verwende output für primäre gerenderte Nachrichten. (Siehe: <output>)
- Verwende package zum Bündeln ausgewählter Outputs und Artefakte. (Siehe: <package>)

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¶

Keine zusätzlichen elementspezifischen Regeln. Pflichtattribute, Typen und unterstützte Werte stehen unten.

Erlaubte Elternelemente / Erlaubte Kindelemente¶

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

Erlaubte Kindelemente:

Keine