YAML-tools in XMLSpy

YAML-editor en -validator

  • Syntaxismarkering
  • Controle op de correcte syntaxis van YAML-bestanden
  • YAML-rasterweergave
  • Valideer YAML-bestanden op basis van een JSON-schema of een YAML-schema
  • Ondersteuning voor YAML-schema's
  • YAML-query's met XQuery
  • Converteer YAML naar JSON / XML
  • Converteer XML naar YAML
  • Converteer JSON naar YAML
  • Genereer een JSON-schema vanuit YAML
  • Genereer een YAML-schema op basis van YAML
  • Converteer een XSD-schema naar een YAML-schema

Voordelen van YAML:

Kort gezegd: "YAML is geen markup-taal." YAML YAML is een data-serialisatieformaat dat door mensen gemakkelijk te lezen is en dat veel gebruikt wordt voor configuratiebestanden, data-uitwisseling en applicatieprogrammatie. De meeste programmeertalen bieden bibliotheken of ingebouwde ondersteuning voor het verwerken van YAML-bestanden. Het is ontworpen om eenvoudig te lezen en te schrijven, waardoor het een uitstekende keuze is voor configuraties die door mensen bewerkt moeten worden.

Een van de belangrijkste voordelen van YAML is de eenvoud en flexibiliteit. YAML gebruikt inspringing en dubbele punten om hiërarchische structuren te definiëren, waardoor het beknopt en gemakkelijk te begrijpen is. Het ondersteunt verschillende datatypes, waaronder scalaire waarden (strings, getallen, booleans), sequenties (lijsten) en mappings (sleutel-waarde paren). YAML ondersteunt ook ankers en aliassen, waardoor data hergebruikt kan worden en complexe datastructuren efficiënt weergegeven kunnen worden.

YAML-bestanden eindigen doorgaans met de extensie .yaml of .yml.

YAML-editor: Tekstweergave

YAML-editor in XMLSpy

Veel moderne applicaties en systemen maken gebruik van een combinatie van XML, JSON en YAML voor configuratiebestanden, data-uitwisseling en API-payloads.

Naast het bewerken van YAML-bestanden, biedt XMLSpy uitgebreide ondersteuning voor XML en JSON. Het ondersteunen van al deze formaten in één editor geeft ontwikkelaars de flexibiliteit om met bestanden uit verschillende bronnen te werken en deze naadloos in hun projecten te integreren.

De XMLSpy YAML-tools omvatten:

  • YAML-bestanden bewerken met syntaxmarkering
  • Codeopvouwen en regelnummers
  • Controle op correcte syntaxis
  • YAML-validator
  • Genereren van een schema op basis van een YAML-document
  • Een YAML-converter met één klik

YAML-rasterweergave

Naast de teksteditor bevat XMLSpy een rasterweergave waarmee YAML-documenten op een visuele manier kunnen worden bewerkt. De YAML-rasterweergave zal ontwikkelaars die bekend zijn met de XML-rasterweergave en de JSON-rasterweergave van XMLSpy direct vertrouwd voorkomen.

De YAML-grid biedt een grafische weergave van de documentstructuur, die direct begrijpelijker is dan de bijbehorende code in tekstweergave. Met de gridweergave kunt u op een gebruiksvriendelijkere manier met YAML-gegevens interageren, waardoor fouten die kunnen ontstaan door handmatig bewerken van ruwe YAML-bestanden (zoals verkeerde inspringing) worden verminderd. De mogelijkheid om secties van de YAML-gegevens uit te klappen en in te klappen maakt het eenvoudig om door grote bestanden te navigeren en specifieke elementen te lokaliseren.

Visuele YAML-editor in XMLSpy

Innovatieve functies zoals de tabelweergave (zoals te zien is in het geselecteerde gebied hierboven) en XPath/XQuery-filters maken YAML Grid bijzonder nuttig, en de Grid View biedt een reeks tools die het werken met YAML vereenvoudigen:

  • De structuur van het YAML-document kan eenvoudig worden aangepast door objecten in de tabel toe te voegen, te verwijderen of te verplaatsen. Volledige tekstblokken kunnen snel worden herschikt (bijvoorbeeld door ze te sorteren of te verplaatsen).
  • De inhoud kan eenvoudig worden bewerkt in de rasterweergave, vooral door gebruik te maken van de functies die beschikbaar zijn binnen de individuele cellen.
  • De tabelweergave maakt het mogelijk om een knooppunt met onderliggende knooppunten in een tabel weer te geven, waardoor de informatie gemakkelijker te begrijpen is. Elk onderliggend object wordt weergegeven in een aparte rij. U kunt de tabelweergave activeren en deactiveren, afhankelijk van de inhoud die u wilt bekijken.
  • De weergaveopties helpen u snel de relatie tussen een alias en een ankerpunt te bepalen.
  • Filters en formules kunnen worden gebruikt om gegevens te filteren en te verwerken, afhankelijk van de behoefte.
  • De inhoud kan visueel worden bewerkt met behulp van drag-and-drop functionaliteit en contextmenu's die afhankelijk zijn van het datatype.

YAML-validator

Omdat de YAML-specificatie geen schema bevat, ondersteunt XMLSpy het valideren van YAML-documenten aan de hand van JSON-schema's, om de dataconsistentie te waarborgen en fouten op te sporen. Er wordt ondersteuning geboden voor zowel traditionele JSON-schema's als YAML-schema's, die JSON-schema's zijn geschreven in YAML-syntax. JSON-schema's en YAML-schema's kunnen eenvoudig worden bewerkt in de grafische JSON-schema-editor van XMLSpy.

U kunt een schema toewijzen aan uw YAML-document in het tabblad "JSON" van het informatievenster van XMLSpy. Na validatie worden de resultaten in het document gemarkeerd en worden details weergegeven in het venster "Berichten". U kunt op een fout in het venster "Berichten" klikken om direct naar die fout in het document te gaan, zodat u snel problemen kunt oplossen.

Converteer YAML

Om compatibiliteit en onderlinge bruikbaarheid te garanderen, ondersteunt XMLSpy met één klik conversie tussen YAML, XML en JSON.

Dit omvat het omzetten van:

  • JSON naar YAML
  • XML naar YAML
  • YAML naar JSON / XML
  • YAML omzetten naar JSON-schema
  • YAML naar YAML-schema
  • XML-schema (XSD) omzetten naar een YAML-schema
Converteer JSON naar YAML in XMLSpy

XMLSpy kan een JSON-schema of een YAML-schema genereren op basis van een bestaand YAML-bestand. Deze functie is erg handig, omdat het u snel een schema oplevert dat gebaseerd is op een bestaand YAML-document, waardoor u de tijd en moeite bespaart die gepaard gaan met het handmatig creëren van een schema. U kunt het gegenereerde schema vervolgens aanpassen of uitbreiden aan de hand van uw specifieke wensen.

YAML-bestanden bevragen met XQuery

In tegenstelling tot XML hebben JSON en YAML geen officiële querytaal. Echter, JSON kan worden doorzocht met XPath/XQuery 3.1 expressies, en XMLSpy heeft diezelfde functionaliteit beschikbaar gemaakt voor YAML-documenten in het XPath/XQuery-venster.

Om snel te beginnen, selecteert u een doel locatie in het actieve YAML-bestand en kiest u "XPath kopiëren" in het rechtermuisklikmenu. Plak vervolgens die expressie in het paneel voor de XPath/XQuery-bouwer als startpunt. Om de expressie te wijzigen, bevat de XPath/XQuery-bouwer functies voor automatische aanvulling en het bouwen van expressies door middel van klikken, met behulp van een uitgebreide lijst met operatoren, expressies en ingebouwde functies.

Tijdens het werken geeft de evaluator de resultaten van uw XQuery-expressie weer, zodat u uw werk kunt testen en verfijnen.

Gebruik XQuery om een YAML-document te bevragen

De mogelijkheid om XQuery te gebruiken voor YAML-bestanden is een andere innovatieve functie die uniek is voor XMLSpy.