|
<< Click to Display Table of Contents >> RayPack > 8.0 > User Guide > PackDesigner > MSI / MST / RPP-basierte Projekte > Visueller Designer-Modus > Systeminteraktion > JSON- und XML-Dateien JSON/XML-Datei bearbeiten |
Beim Bearbeiten einer JSON/XML-Datei stehen im Editor mehrere grundlegende Einstellungen zur Verfügung. Hier können Sie wichtige Eigenschaften der Datei konfigurieren, bevor Sie spezifische Inhaltsänderungen vornehmen.
Key Settings:
1.File Name:
oDer Name der bearbeiteten JSON/XML-Datei. Der Dateiname kann hier bei Bedarf geändert werden.
2.Directory:
oDas Zielverzeichnis oder die Zieleigenschaft auf dem System, in dem die JSON/XML-Datei gespeichert oder aktualisiert wird.
▪Hinweis: Dieses Feld akzeptiert entweder die ID aus der Directory-Tabelle oder einen Eigenschaftsnamen. Fest codierte Pfade werden nicht unterstützt, um Portabilität und Flexibilität zu gewährleisten. Der Verzeichnispfad kann manuell eingegeben oder über die Schaltfläche [...] durch Durchsuchen eines standardisierten Auswahlmenüs festgelegt werden.
3.Component:
oDie mit der Datei verknüpfte Komponente. Damit können Verbindungen zwischen der Datei und Teilen des Projekts definiert werden.
4.Ignore Processing Errors:
oEin Kontrollkästchen, das – wenn aktiviert – das System anweist, auch bei auftretenden Verarbeitungsfehlern beim Umgang mit der Datei fortzufahren.
5.File Mode Options:
oDiese Optionen legen fest, wie die Datei behandelt werden soll, wenn sie bereits vorhanden ist oder zum ersten Mal erstellt wird:
▪Create or update: Aktualisierungsregeln für eine vorhandene Datei anwenden, andernfalls eine neue Datei erstellen.
▪Update only: Die Datei nur aktualisieren, wenn sie bereits vorhanden ist; andernfalls überspringen.
▪Create only: Die Datei erstellen, wenn sie nicht vorhanden ist; andernfalls überspringen.
▪Create or overwrite: Die Datei immer mit dem angegebenen Ausgangsinhalt erstellen oder überschreiben.
6.Initial Content Area:
oEin Textfeld, in das der Ausgangsinhalt der JSON/XML-Datei eingegeben oder bearbeitet werden kann.
oWichtig:
▪Dieser Inhalt wird ausschließlich beim Erstellen oder Überschreiben der Datei verwendet. Im Modus „Create or overwrite" oder beim erstmaligen Definieren des Ausgangsinhalts kann hier festgelegt werden, was beim Erstellen der Datei darin enthalten sein soll.
▪Bei Anpassungen oder Änderungen an vorhandenen JSON/XML-Dateien muss die gesamte Datei hier nicht neu erstellt werden. Diese Funktion eignet sich zum Erstellen erster Vorlagen und vereinfacht den Prozess, wenn nur geringfügige Änderungen erforderlich sind. Anstatt alle Einträge der Datei neu erstellen zu müssen, können Benutzer sich auf die eine spezifische Änderung konzentrieren.
Für weitere Änderungen kann ein Kontextmenü geöffnet werden, indem mit der rechten Maustaste auf die JSON/XML-Datei im Datei-Explorer oder Projektbaum geklickt wird. Dieses Menü bietet verschiedene Optionen zum Verwalten und Bearbeiten der Datei.
Right-Click Context Menu:
•Install first, Install earlier, Install later, Install last:
oMit diesen Optionen kann die Installationsreihenfolge der JSON/XML-Datei im Verhältnis zu anderen Dateien im Projekt gesteuert werden. Damit wird sichergestellt, dass korrekte Abhängigkeiten und Ausführungsreihenfolgen bei der Installation eingehalten werden.
•Go to row:
oDirektes Navigieren zu einer bestimmten Zeilennummer in der JSON/XML-Datei für präziseres und gezieltes Bearbeiten.
oLöscht die Datei aus dem Projekt. Vor dem endgültigen Löschen wird ein Bestätigungsdialog angezeigt.
•Add new modification:
oÖffnet den Bearbeitungsbereich für JSON/XML-Änderungseinstellungen für erweiterte, gezielte Änderungen innerhalb der Datei, der im folgenden Abschnitt behandelt wird.
Zusätzlich zur grundlegenden Bearbeitung können spezifische Änderungen an JSON/XML-Dateien vorgenommen werden. Dies ist nützlich, wenn einzelne Einträge in einem Dokument aktualisiert oder hinzugefügt werden sollen, insbesondere bei tief verschachtelten Strukturen in JSON/XML-Daten.
JSONPath for JSON/XPath for XML:
•JSONPath: Eine Abfragesyntax zum Navigieren und Adressieren bestimmter Eigenschaften, Elemente oder Arrays in einem JSON-Objekt. Mit JSONPath kann ein Teil eines JSON-Dokuments zum Aktualisieren oder Ändern identifiziert werden (z. B. $.store.books[0].author).
•XPath: Eine Abfragesprache zum Navigieren in XML-Dokumenten durch Auswahl von Knoten (Elemente, Attribute, Text usw.) aus der Dokumentstruktur. Damit können bestimmte Abschnitte der XML-Daten gezielt angesteuert werden (z. B. /catalog/book/author).
1.JSONPath/XPath:
oGeben Sie den Ausdruck ein, der den Pfad zu dem Teil der JSON/XML-Datei definiert, den Sie ändern möchten. Dieser Pfad ist essenziell, um den richtigen Knoten oder die richtige Eigenschaft für die Änderung zu identifizieren.
▪For JSON: JSONPath-Ausdrücke verwenden, um Eigenschaften und Array-Indizes anzugeben.
▪For XML: XPath-Ausdrücke verwenden, um Elemente, Attribute oder Text im XML-Dokument anzusteuern.
oXPath Guidelines for XML Creation: XPath is used to reference and modify elements in XML files. Here are some simplified examples:
▪Valid: /bookstore/book – Ein eindeutiger Pfad zum Erstellen eines neuen „book"-Elements im bookstore.
▪Valid: /bookstore/book[2] – Erstellt ein „book"-Element an zweiter Position, wenn bereits ein Buch vorhanden ist.
▪Valid with predicates: /bookstore/book[position()<3] – Wird zum Ändern vorhandener Elemente verwendet, nicht zum Erstellen neuer.
▪Invalid: //title[@lang='en'] – Platzhalter wählen mehrere Elemente aus und können nicht zum Erstellen neuer Elemente verwendet werden.Enter topic text here.
2.Value Type:
oFor JSON:
▪Der Typ der zu ändernden Daten kann anhand von Standard-Datentypen wie string, number, boolean usw. festgelegt werden.
oFor XML:
▪XML-Werte werden immer als Zeichenketten gespeichert. Stellen Sie sicher, dass alle im Änderungsbereich eingegebenen Werte als Zeichenkette formatiert sind, auch wenn sie in der eigentlichen XML-Struktur numerische oder andere Datentypen darstellen.
3.Delete:
oMit dieser Option wird die Eigenschaft oder der Knoten am angegebenen JSONPath/XPath gelöscht.
oDas System sucht anhand des Pfadausdrucks nach der Eigenschaft oder dem Knoten und entfernt diesen Teil der Datei nach Bestätigung.
4.Create Only:
oMit dieser Option wird ein neuer Wert für den angegebenen JSONPath oder XPath erstellt, jedoch nur, wenn die Eigenschaft oder der Knoten noch nicht vorhanden ist. Vorhandene Werte bleiben unverändert.
5.Update Only:
oMit dieser Option wird eine vorhandene Eigenschaft oder ein vorhandener Knoten aktualisiert, wenn dieser über JSONPath oder XPath gefunden wird. Wenn die angegebene Eigenschaft oder der Knoten nicht vorhanden ist, wird der Vorgang übersprungen.
6.Set:
oDiese Option kombiniert die Verhaltensweisen Erstellen und Aktualisieren. Wenn die Zieleigenschaft oder der Zielknoten nicht vorhanden ist, wird sie/er erstellt; andernfalls wird der vorhandene Wert aktualisiert.
7.Condition (Optional):
oEs kann eine erweiterte Bedingungslogik erstellt werden, unter der die Änderung gilt, um eine präzise Steuerung des Dateiverhaltens zu gewährleisten.