[Power Apps]カスタムコネクタを開発してみた

Posted at 2025-05-04

背景

Power Appsで直接自作したAPIを呼び出したく、カスタムコネクタを作成してみました。カスタムコネクタはOpenAPI定義に対応しているため、Azure FunctionsでOpenAPI定義対応のFaaSを開発してみました。

前提条件

Power Apps使用可能なライセンスがあること
カスタムコネクタの作成権限があること
Azure Functionsのリソース作成権限があること
Azure FunctionsをVisual Studioを使用して開発すること
Azure Functionsの開発言語はC#であること

開発手順

Azure Functions準備

1. HTTPトリガーの関数を作成。

※パッケージ（Microsoft.Azure.WebJobs.Extensions.OpenApi）を導入する必要があるため、インプロセスモデルで関数を作成する。

分離ワーカーモデルとインプロセスモデルについては、
https://learn.microsoft.com/ja-jp/azure/azure-functions/functions-bindings-http-webhook-trigger?tabs=python-v2%2Cisolated-process%2Cnodejs-v4%2Cfunctionsv2&pivots=programming-language-csharp を参照。
※「Isolated」は分離ワーカーモデルを指します。

2. 以下、例に従って実装する。

属性については、https://tech-lab.sios.jp/archives/32091 を参照。

using System.IO;
using System.Net;
using System.Threading.Tasks;
using Microsoft.AspNetCore.Http;
using Microsoft.AspNetCore.Mvc;
using Microsoft.Azure.WebJobs;
using Microsoft.Azure.WebJobs.Extensions.Http;
using Microsoft.Azure.WebJobs.Extensions.OpenApi.Core.Attributes;
using Microsoft.Azure.WebJobs.Extensions.OpenApi.Core.Enums;
using Microsoft.Extensions.Logging;
using Microsoft.OpenApi.Models;
using Newtonsoft.Json;

namespace FunctionApp1
{
    public static class Function1
    {
        [FunctionName("Function1")]
        [OpenApiOperation(operationId: "Run", tags: new[] { "name" })]
        [OpenApiSecurity("function_key", SecuritySchemeType.ApiKey, Name = "code", In = OpenApiSecurityLocationType.Query)]
        [OpenApiParameter(name: "name", In = ParameterLocation.Query, Required = true, Type = typeof(string), Description = "The **Name** parameter")]
        [OpenApiResponseWithBody(statusCode: HttpStatusCode.OK, contentType: "application/json", bodyType: typeof(FunctionResult), Description = "The OK response")]
        public static async Task<IActionResult> Run(
            [HttpTrigger(AuthorizationLevel.Function, "get", "post", Route = null)] HttpRequest req,
            ILogger log)
        {
            log.LogInformation("C# HTTP trigger function processed a request.");

            string name = req.Query["name"];

            string requestBody = await new StreamReader(req.Body).ReadToEndAsync();
            dynamic data = JsonConvert.DeserializeObject(requestBody);
            name = name ?? data?.name;

            string responseMessage = string.IsNullOrEmpty(name)
                ? "This HTTP triggered function executed successfully. Pass a name in the query string or in the request body for a personalized response."
                : $"Hello, {name}. This HTTP triggered function executed successfully.";

            return new OkObjectResult(new FunctionResult { Message = responseMessage });
        }
    }

    public class FunctionResult
    {
        public string Message { get; set; }
    }
}