Schema's toevoegen voor gebruik met werkstromen met Azure Logic Apps

  • Artikel

Van toepassing op: Azure Logic Apps (Verbruik + Standard)

Werkstroomacties zoals Plat bestand en XML-validatie vereisen een schema om hun taken uit te voeren. Voor de xml-validatieactie is bijvoorbeeld een XML-schema vereist om te controleren of documenten geldige XML gebruiken en de verwachte gegevens in de vooraf gedefinieerde indeling hebben. Dit schema is een XML-document dat gebruikmaakt van de XSD-taal (XML Schema Definition) en de bestandsextensie .xsd heeft. De acties Plat bestand maken gebruik van een schema om XML-inhoud te coderen en decoderen.

In dit artikel wordt beschreven hoe u een schema toevoegt aan uw integratieaccount. Als u met een standaardwerkstroom voor logische apps werkt, kunt u ook rechtstreeks een schema toevoegen aan uw resource voor logische apps.

Vereisten

  • Een Azure-account en -abonnement. Als u nog geen abonnement hebt, meldt u zich aan voor een gratis Azure-account.

  • Het schemabestand dat u wilt toevoegen. Als u schema's wilt maken, kunt u de volgende hulpprogramma's gebruiken:

    Notitie

    Installeer de extensie niet naast de BizTalk Server-extensie. Het hebben van beide extensies kan onverwacht gedrag opleveren. Zorg ervoor dat er slechts één van deze extensies is geïnstalleerd.

    Op beeldschermen met hoge resolutie ondervindt u mogelijk een weergaveprobleem met de kaartontwerper in Visual Studio. U kunt dit probleem oplossen door Visual Studio opnieuw op te starten in de DPI-modus, of de registerwaarde DPIUNAWARE toe te voegen.

  • Op basis van of u werkt aan een werkstroom voor een verbruiks- of Standard-logische app, hebt u een integratieaccountresource nodig. Normaal gesproken hebt u deze resource nodig wanneer u artefacten wilt definiëren en opslaan voor gebruik in bedrijfsintegratie en B2B-werkstromen.

    Belangrijk

    Als u wilt samenwerken, moeten zowel uw integratieaccount als de resource van de logische app zich in hetzelfde Azure-abonnement en dezelfde Azure-regio bevinden.

    • Als u aan een werkstroom voor logische app Verbruik werkt, hebt u een integratieaccount nodig dat is gekoppeld aan uw logische app-resource.

    • Als u aan een werkstroom voor een standaard logische app werkt, kunt u uw integratieaccount koppelen aan uw logische app-resource, schema's rechtstreeks uploaden naar uw logische app-resource of beide, op basis van de volgende scenario's:

      • Als u al een integratieaccount hebt met de artefacten die u nodig hebt of wilt gebruiken, kunt u uw integratieaccount koppelen aan meerdere resources van de logische standaard-app waar u de artefacten wilt gebruiken. Op die manier hoeft u geen schema's te uploaden naar elke afzonderlijke logische app. Zie Uw logische app-resource koppelen aan uw integratieaccount voor meer informatie.

      • Met de ingebouwde connector Flat File kunt u een schema selecteren dat u eerder hebt geüpload naar uw logische app-resource of naar een gekoppeld integratieaccount, maar niet beide. U kunt dit artefact vervolgens gebruiken voor alle onderliggende werkstromen binnen dezelfde logische app-resource.

      Als u dus geen integratieaccount hebt of nodig hebt, kunt u de optie uploaden gebruiken. Anders kunt u de koppelingsoptie gebruiken. In beide gevallen kunt u deze artefacten gebruiken voor alle onderliggende werkstromen binnen dezelfde logische app-resource.

Beperkingen

  • Limieten zijn van toepassing op het aantal artefacten, zoals schema's, per integratieaccount. Raadpleeg limieten en configuratie-informatie voor Azure Logic Apps voor meer informatie.

  • Op basis van of u aan een werkstroom voor verbruik of standaard logische apps werkt, kunnen limieten voor de bestandsgrootte van het schema van toepassing zijn.

  • Wanneer u een integratieaccount met uw werkstroom gebruikt, voegt u meestal het schema toe aan dat account. Als u echter naar een schema verwijst of importeert dat zich niet in uw integratieaccount voorkomt, wordt mogelijk de volgende fout weergegeven wanneer u het element xsd:redefinegebruikt:

    An error occurred while processing the XML schemas: ''SchemaLocation' must successfully resolve if <redefine> contains any child other than <annotation>.'.

    U kunt deze fout oplossen door het element xsd:import of xsd:include in plaats van xsd:redefineeen URI te gebruiken.

Overwegingen voor het toevoegen van schema's

  • Als u met een werkstroom Verbruik werkt, moet u uw schema toevoegen aan een gekoppeld integratieaccount.

  • Als u met een standaardwerkstroom werkt, hebt u de volgende opties:

    • Voeg uw schema toe aan een gekoppeld integratieaccount. U kunt het schema- en integratieaccount delen over meerdere resources van de logische standaard-app en hun onderliggende werkstromen.

    • Voeg uw schema rechtstreeks toe aan de resource van uw logische app. U kunt dat schema echter alleen delen in onderliggende werkstromen in dezelfde logische app-resource.

Schema toevoegen aan integratieaccount

  1. Meld u in Azure Portal aan met uw Azure-accountreferenties.

  2. Voer in het hoofdvak van Azure Search integratieaccounts in en selecteer Integratieaccounts.

  3. Selecteer het integratieaccount waaraan u uw schema wilt toevoegen.

  4. Selecteer Schema's in het menu van uw integratieaccount onder Instellingen.

  5. Selecteer Toevoegen op de werkbalk van het deelvenster Schema's.

Schema's toevoegen aan logische app

Volg voor verbruikswerkstromen, op basis van de bestandsgrootte van uw schema, de stappen voor het uploaden van een schema dat maximaal 2 MB of meer dan 2 MB is, tot 8 MB.

Schema's toevoegen tot 2 MB

  1. Voer in het deelvenster Schema toevoegen een naam in voor uw schema. Klein bestand behouden geselecteerd. Selecteer naast het vak Schema het mappictogram. Zoek en selecteer het schema dat u uploadt.

  2. Als u gereed bent, selecteert u OK.

    Nadat het uploaden van het schema is voltooid, wordt het schema weergegeven in de lijst Schema's .

Schema's toevoegen die groter zijn dan 2 MB

Als u grotere schema's voor gebruikswerkstromen wilt toevoegen, kunt u de Azure Logic Apps REST API - Schema's gebruiken of uw schema uploaden naar een Azure-blobcontainer in uw Azure-opslagaccount. Uw stappen voor het toevoegen van schema's verschillen op basis van of uw blobcontainer openbare leestoegang heeft. Controleer dus eerst of uw blobcontainer openbare leestoegang heeft door de volgende stappen uit te voeren: Openbaar toegangsniveau instellen voor blobcontainer

Toegangsniveau van container controleren

  1. Open Azure Storage Explorer. Vouw in het Verkenner-venster uw Azure-abonnement uit als dit nog niet is uitgevouwen.

  2. Vouw Opslagaccounts {your-storage-account} >Blob Containers> uit. Selecteer uw blobcontainer.

  3. Selecteer In het snelmenu van uw blobcontainer de optie Openbaar toegangsniveau instellen.

Uploaden naar containers met openbare toegang

  1. Upload het schema naar uw opslagaccount. Selecteer Uploaden in het rechtervenster.

  2. Nadat u klaar bent met uploaden, selecteert u het geüploade schema. Selecteer op de werkbalk Kopieer-URL zodat u de URL van het schema kopieert.

  3. Ga terug naar Azure Portal waar het deelvenster Schema toevoegen is geopend. Voer een naam in voor de assembly. Selecteer Groot bestand (groter dan 2 MB).

    Het vak Inhouds-URI wordt nu weergegeven in plaats van het vak Schema .

  4. Plak de URL van uw schema in het vak Inhouds-URI . Voltooi het toevoegen van uw schema.

Nadat het uploaden van het schema is voltooid, wordt het schema weergegeven in de lijst Schema's . Op de overzichtspagina van uw integratieaccount, onder Artefacten, wordt het geüploade schema weergegeven.

Uploaden naar containers zonder openbare toegang

  1. Upload het schema naar uw opslagaccount. Selecteer Uploaden in het rechtervenster.

  2. Nadat u klaar bent met uploaden, genereert u een SAS (Shared Access Signature) voor uw schema. Selecteer In het snelmenu van uw schema de optie Shared Access Signature ophalen.

  3. Selecteer In het deelvenster Shared Access Signature de optie Shared Access Signature>maken op containerniveau. Nadat de SAS-URL is gegenereerd, selecteert u Kopiëren naast het VAK URL.

  4. Ga terug naar Azure Portal waar het deelvenster Schema toevoegen is geopend. Selecteer Groot bestand.

    Het vak Inhouds-URI wordt nu weergegeven in plaats van het vak Schema .

  5. Plak in het vak Inhouds-URI de SAS-URI die u eerder hebt gegenereerd. Voltooi het toevoegen van uw schema.

Nadat het uploaden van het schema is voltooid, wordt het schema weergegeven in de lijst Schema's . Op de overzichtspagina van uw integratieaccount, onder Artefacten, wordt het geüploade schema weergegeven.

Een schema bewerken

Als u een bestaand schema wilt bijwerken, moet u een nieuw schemabestand uploaden met de gewenste wijzigingen. U kunt echter eerst het bestaande schema downloaden om te bewerken.

  1. Open uw integratieaccount in Azure Portal als dat nog niet is geopend.

  2. Selecteer Schema's in het menu van uw integratieaccount onder Instellingen.

  3. Nadat het deelvenster Schema's is geopend, selecteert u het schema. Als u het schema eerst wilt downloaden en bewerken, selecteert u Op de werkbalk Schema's het schema downloaden en opslaan.

  4. Wanneer u klaar bent om het bijgewerkte schema te uploaden, selecteert u in het deelvenster Schema's het schema dat u wilt bijwerken. Selecteer Bijwerken op de werkbalk van het deelvenster Schema's.

  5. Zoek en selecteer het bijgewerkte schema dat u wilt uploaden.

  6. Als u gereed bent, selecteert u OK.

    Nadat het schemabestand is geüpload, wordt het bijgewerkte schema weergegeven in de lijst Schema's .

Een schema verwijderen

  1. Open uw integratieaccount in Azure Portal als dat nog niet is geopend.

  2. Selecteer Schema's in het menu van uw integratieaccount onder Instellingen.

  3. Nadat het deelvenster Schema's is geopend, selecteert u het schema en selecteert u Vervolgens Verwijderen.

  4. Selecteer Ja om te bevestigen dat u het schema wilt verwijderen.

Volgende stappen