Zum Inhalt

Ausgabe-Artefakte und Logs wählen

Wähle eine Ausgabe nach ihrem beabsichtigten Seiteneffekt. Dateiexporter erzeugen Platform-Artefakte; LogExporter schreibt eine kleine Diagnoseansicht in das Task-Log. Konsolenausgabe ist ein Implementierungswerkzeug der Runtime und wird bewusst nicht als Agent-Authoring-Ziel angeboten.

artifact-and-log-targets.xml
1
2
3
4
5
6
7
8
<setup numProcess="1">
    <generate name="customers"
              count="3"
              target="CSV(delimiter=';'),JSON(use_ndjson=True),LogExporter">
        <key name="id" generator="IncrementGenerator"/>
        <key name="status" constant="active"/>
    </generate>
</setup>

Das erzeugt ein semikolongetrenntes CSV-Artefakt, ein NDJSON-Artefakt und drei begrenzte Diagnose-Logeinträge aus demselben Produkt. Verwende mehrere Ziele nur, wenn jeder Seiteneffekt eine explizite Anforderung ist.

Agent-Authoring-Grenze

Authoring trennt diese Intents:

  • file_export verlangt ein registriertes Artefaktformat wie CSV, JSON, XML, XLSX, TXT, PARQUET, SQL, Template oder OpenSearchBulk.
  • log rendert den registrierten LogExporter und besitzt kein Formatfeld.
  • memstore, Datenbank, MongoDB, Kafka und RabbitMQ sind eigene Zielfamilien, weil sie unterschiedliche Lebensdauer-, Client-, Operations- und Delivery-Verträge haben.

Der Live-Authoring-Katalog liefert die exakte Menge registrierter Dateiformate. Agents dürfen weder Exporternamen erfinden noch Logging als Dateiformat modellieren.

Dateiziele wählen

  • Verwende CSV für tabellarischen Austausch und Optionen wie delimiter, quotechar, quoting und line_terminator nur bei einer entsprechenden Consumer-Anforderung.
  • Verwende JSON(use_ndjson=True) für ein JSON-Objekt pro Zeile; JSON ohne Option schreibt ein Array.
  • Verwende JSONSingle, XMLSingle oder TemplateSingle, wenn jeder Datensatz ein eigenes Artefakt benötigt. Diese routingfähigen Exporter dürfen ein dynamisches targetEntity verwenden; Streaming-Exporter für mehrere Datensätze nicht.
  • Verwende Template für eine projekteigene Datei name.ext.template, wenn das Zielformat nicht anderweitig modelliert ist. Verhalten bei fehlenden Platzhaltern und Datensatztrenner sind explizite Zieloptionen.
  • Verwende OpenSearchBulk für OpenSearch-Bulk-Importdaten. Metadatenfelder sind $$_action$$, $$_index$$, $$_id$$ und $$_routing$$; andere Felder bilden den Dokumentinhalt.

Lasse auf der DATAMIMIC Platform storageId und exportUri weg, damit erzeugte Dateien im Task-bezogenen Artefaktpfad der Artifact View landen. Setze exportUri nur mit einer storageId, die einen eigenen <object-storage> auswählt; der Wert ist ein relativer Pfadpräfix und kein Dateiname. Diese Ausgaben liegen außerhalb der Platform Artifact View. Die generierte <generate>-Referenz besitzt die aktuellen Attribute und Regeln; die Authoring-Zielreferenz besitzt die agentenseitigen Intent-Modelle.