Freigeben über


So geht's: Erstellen Sie eine grundlegende Asset-Management-API mit Azure Functions (Vorschau)

Dieser Artikel führt Sie durch das Erstellen einer einfachen Pseudo-API für eine Objektverwaltungsanwendung mit Azure Functions. Die API macht einen einzelnen Vorgang verfügbar, um eine Liste von Ressourcen zurückzugeben. Außerdem erfahren Sie, wie Sie mithilfe der API-Verwaltung einen benutzerdefinierten Connector in Power Platform erstellen.

Hinweis

Previewfunktionen sind nicht für den Produktionseinsatz gedacht und können eine eingeschränkte Funktionalität aufweisen. Diese Funktionen sind vor einer offiziellen Veröffentlichung verfügbar, damit Kunden frühzeitig zugreifen und Feedback geben können.

Diese grundlegende API bietet eine Pseudoobjektliste und ist bereit für die Integration mit Power Platform mithilfe eines benutzerdefinierten Connectors über die API-Verwaltung.

Voraussetzungen

Erstellen einer neuen Azure-Funktion im Azure-Portal

  1. Wechseln Sie zum Azure-Portal.

  2. Wählen Sie Ressource erstellen>Web>Function App.

  3. Wählen Sie "Verbrauch" aus.

  4. Geben Sie die erforderlichen Details ein:

    Einzelheit Description
    Subscription Wählen Sie Ihr Abonnement aus.
    Ressourcengruppe Erstellen Sie einen neuen oder verwenden Sie einen vorhandenen
    Name der Funktions-App Wählen Sie einen eindeutigen Namen aus.
    Runtime-Stack Node.js
    Region Wählen Sie eine Region in der Nähe von Ihnen aus.
  5. Wählen Sie Überprüfen + erstellen und danach Erstellen aus.

    Funktion in Azure erstellen

  6. Wechseln Sie nach Abschluss der Bereitstellung zur neuen Funktions-App.

  7. Wählen Sie Funktion erstellen aus.

  8. Wenn Sie gefragt werden, wählen Sie: Entwicklungsumgebung: Entwickeln im Portal.

  9. Wählen Sie den HTTP-Trigger als Vorlage aus, geben Sie ihm den Namen GetAssets, und legen Sie die Autorisierungsstufe auf "Anonym" fest, da in diesem einfachen Beispiel keine Authentifizierung erforderlich ist.

    HTTP-Trigger erstellen

  10. Wählen Sie "Erstellen" aus, um die Funktion zu erstellen.

  11. Ersetzen Sie auf der Registerkarte "Code + Test " den Funktionscode durch den Pseudo-API-Code aus dem nächsten Abschnitt.

  12. Wählen Sie Speichern aus.

Implementieren der Pseudo-API

Bearbeiten GetAssets/index.js , um eine simulierte Liste von Ressourcen zurückzugeben:

module.exports = async function (context, req) {
    context.res = {
        // status: 200, /* Defaults to 200 */
        body: [
            { id: 1, name: "Laptop", type: "Electronics", status: "Available" },
            { id: 2, name: "Projector", type: "Electronics", status: "In Use" },
            { id: 3, name: "Desk", type: "Furniture", status: "Available" },
            { id: 4, name: "Office Chair", type: "Furniture", status: "In Use" },
            { id: 5, name: "Monitor", type: "Electronics", status: "Available" },
            { id: 6, name: "Whiteboard", type: "Office Supply", status: "Available" },
            { id: 7, name: "Phone", type: "Electronics", status: "In Use" },
            { id: 8, name: "Tablet", type: "Electronics", status: "Available" },
            { id: 9, name: "Printer", type: "Electronics", status: "Maintenance" },
            { id: 10, name: "Filing Cabinet", type: "Furniture", status: "Available" }
        ]
    };
};

Veröffentlichen Ihrer Funktions-App über die API-Verwaltung

  1. Suchen Sie im Azure-Portal nach API Management-Dienste, und wählen Sie die entsprechende Option aus.

  2. Wählen Sie +Erstellen aus, um eine neue API-Verwaltungsinstanz zu erstellen. Die Entwicklerebene ist für Entwicklung/Tests kostenlos.

  3. Geben Sie die erforderlichen Details ein, und stellen Sie die Instanz bereit.

  4. Öffnen Sie nach der Bereitstellung Ihre API-Verwaltungsinstanz.

  5. Wählen Sie im linken Menü APIs>+ API hinzufügen>Funktions-App aus.

    API hinzufügen

  6. Wählen Sie Ihre Function-App und die GetAssets Funktion aus.

    Import-API

  7. Schließen Sie den Assistenten ab, um den Import Ihrer Funktion als API-Vorgang durchzuführen.

  8. Wechseln Sie nach dem Import zu Ihrer API in der API-Verwaltung.

  9. Wählen Sie im oberen Menü "Einstellungen" für Ihre API aus.

  10. Legen Sie unter Sicherheit die Option Abonnement erforderlich auf Aus fest. Dadurch wird die Notwendigkeit eines Abonnementschlüssels (API-Schlüssels) beim Aufrufen der API entfernt.

    Sicherheitseinstellungen aktualisieren

  11. Speichern Sie Ihre Änderungen.

Erstellen eines benutzerdefinierten Connectors in Power Platform mithilfe der API-Verwaltung (über das Azure-Portal)

  1. Wählen Sie in den API-Verwaltungsdiensten im linken Menü innerhalb von APIs Die Option "Power Platform" aus.

  2. Wählen Sie "Verbinder erstellen" aus.

  3. Wählen Sie Ihre API aus:

    Erstellen eines benutzerdefinierten Connectors

  4. Wählen Sie Ihre Umgebung und den Anzeigenamen aus, und wählen Sie dann "Erstellen" aus. Der benutzerdefinierte Connector wird in Ihrer ausgewählten Umgebung erstellt.

  5. Wechseln Sie in Power Apps zu benutzerdefinierten Connectors , um Ihren neuen Connector zu überprüfen, zu bearbeiten und zu testen.

    Testen eines benutzerdefinierten Connectors

Nächste Schritte

  • Erstellen Sie eine neue Code-App unter Verwendung dieses benutzerdefinierten Connectors und des Power Apps SDK.
  • Erweitern Sie die API mit weiteren Vorgängen nach Bedarf. Vergessen Sie nicht, den Connector mit den neuen Vorgängen zu aktualisieren, wenn Sie dies tun.
  • Sichern Sie Ihre API, wenn Sie über Die Entwicklung/Tests hinausgehen.