Freigeben über


So erstellen Sie eine grundlegende Asset-Management-API mit Azure Functions

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

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

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" }
        ]
    };
};

Machen Sie Ihre Funktions-App über API management verfügbar

  1. Suchen Sie im Azure portal nach API Management Services.

  2. Wählen Sie + Create aus, um eine neue API Management Instanz 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 Management Instanz.

  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 in API Management zu Ihrer API.

  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 von API Management (aus Azure portal)

  1. Im linken Menü innerhalb von APIs in API Management Services wählen Sie 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 Custom 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 mit diesem benutzerdefinierten Connector mit Power Apps Clientbibliothek für Code-Apps
  • 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.