共用方式為


從 Power Apps 應用程式使用自訂連接器

注意

本主題屬於在 Azure Logic Apps、Power Automate 和 Power Apps 中建立及使用自訂連接器的教學課程系列。 請務必閱讀自訂連接器概觀,以了解該程序。

在此主題中,您建置的基本應用程式將使用您在先前主題中建立的自訂連接器。 應用程式會取得文字輸入,然後使用自訂連接器來呼叫認知服務文字分析 API。 連接器會針對文字傳回情緒分數(0 到 1),而應用程式會將它顯示為百分比。 下圖顯示完成的應用程式:

完成的情感分析應用程式

先決條件

建立應用程式並新增自訂連接器

您要做的第一件事就是從空白建立應用程式,然後連接至您在先前主題中建立的自訂連接器。

  1. make.powerapps.com 中,選取 從空白開始 > 手機應用程式圖示 (手機) > 製作此應用程式

    從空白開始

  2. 在應用程式畫布上,選擇連接至資料

  3. 資料面板上,選擇您在先前主題中建立的連接(例如,"SentimentDemo")。

  4. 儲存應用程式並命名為 Sentiment Analysis

將控制項新增到應用程式

您現在建立應用程式的 UI,讓您可以輸入文字、將該文字提交至 API,並取得回覆。

  1. 將矩形圖示新增為標題列,然後新增標籤「情感分析」。

    新增標題列

  2. 新增標籤「輸入您的文字,然後按一下 [取得分數]」,然後新增文字輸入控制項。

    新增標籤和文字輸入

  3. 新增帶有文字「取得分數」的按鈕。

    新增按鈕

  4. 新增標籤「情緒分數是」。 在下一個區段中,您將新增公式來完成此標籤。

    新增標籤

新增公式來推動行為

當資料連線和 UI 就緒後,您現在可以新增驅動應用程式行為的 Power Apps 公式。 公式會透過自訂連接器來呼叫 API,並將結果儲存在集合(表格變數)中,然後在應用程式中顯示已格式化的結果。

  1. 選擇您所建立的按鈕,然後將按鈕的 OnSelect 屬性設為連接器的名稱(包括句點)。

    SentimentDemo.
    

    Power Apps 會提供您 DetectSentiment 的自動完成選項,因為自訂連接器可提供此做法。

  2. 現在將按鈕的 OnSelect 屬性設定為下列公式。

    ClearCollect(sentimentCollection, SentimentDemo.DetectSentiment(
        {id:"1", language:"en", text:TextInput1.Text}).documents.score)
    

    此公式從 API 取得情緒分數,並將它儲存在集合中:

    1. 公式會使用自訂連接器所公開的三個參數來呼叫 DetectSentiment 函數:idlanguagetext。 我們在公式中指定前兩個的值,並從文字輸入控制項取得 Text 值(您也可以從應用程式中的其他地方提取前兩個值)。

    2. 此函數會針對您所傳送的每個文件傳回 score。在我們的範例中,我們一次傳送一個文件。 分數的範圍是從 0(負面)到 1(正面)。

    3. 然後,公式會呼叫 ClearCollect 函數,移除 sentimentCollection 中的任何現有值,並從 score 中加上值。

  3. 選擇您所建立的標籤,然後將標籤的文字屬性設定為下列公式。

    "The sentiment score is " & Round(First(sentimentCollection).score, 3) * 100 & "%"
    

    此公式從集合取得情緒分數,並格式化並顯示它:

    1. First() 函式會傳回 sentimentCollect 中的第一筆記錄 (在此案例中是唯一的一筆),並顯示與該記錄相關聯的 score 欄位 (唯一的欄位)。

    2. Round() 函數會將分數四捨五入至 3 位。公式的其餘部分會將結果格式化為百分比,並新增一些上下文資訊。

測試應用程式

現在執行已完成的應用程式,確定它可以如期運作。

  1. 選擇 執行應用程式 在右上角執行應用程式。

  2. 在文字輸入控制項中輸入短語,然後選擇取得分數。 情緒分數應在幾秒鐘後顯示。

完成的應用程式看起來就像下圖:

完成的情感分析應用程式

這是簡單應用程式,但可透過自訂連接器來呼叫認知服務,以獲得強大的功能。

後續步驟

在組織內共用連接器和/或讓連接器獲得認證,這樣一來,組織外部人員也可以使用此連接器。

提供意見反應

非常感謝您提供有關連接器平台問題,或新功能構想的意見反應。 若要提供意見反應,請移至提交問題或取得連接器說明,然後選取您的意見反應類型。