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

發行項
04/19/2024

注意

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

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

完成的情感分析應用程式

先決條件

Power Apps 訂閱。
在 Power Apps 中建置應用程式的基本經驗。如需詳細資訊，請參閱從頭建立應用程式。
您在下列其中一項主題所建立的自訂連接器：
- 從 OpenAPI 定義建立自訂連接器
- 從頭開始建立自訂連接器

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

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

在 make.powerapps.com 中，選取 從空白開始 > (手機) > 製作此應用程式。
在應用程式畫布上，選擇連接至資料。
在資料面板上，選擇您在先前主題中建立的連接（例如，"SentimentDemo"）。
儲存應用程式並命名為 Sentiment Analysis。

將控制項新增到應用程式

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

將矩形圖示新增為標題列，然後新增標籤「情感分析」。
新增標籤「輸入您的文字，然後按一下 [取得分數]」，然後新增文字輸入控制項。
新增帶有文字「取得分數」的按鈕。
新增標籤「情緒分數是」。在下一個區段中，您將新增公式來完成此標籤。

新增公式來推動行為

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

選擇您所建立的按鈕，然後將按鈕的 OnSelect 屬性設為連接器的名稱（包括句點）。
```
SentimentDemo.
```
Power Apps 會提供您 DetectSentiment 的自動完成選項，因為自訂連接器可提供此做法。
現在將按鈕的 OnSelect 屬性設定為下列公式。
```
ClearCollect(sentimentCollection, SentimentDemo.DetectSentiment(
    {id:"1", language:"en", text:TextInput1.Text}).documents.score)
```
此公式從 API 取得情緒分數，並將它儲存在集合中：
1. 公式會使用自訂連接器所公開的三個參數來呼叫 DetectSentiment 函數：id、language 和 text。我們在公式中指定前兩個的值，並從文字輸入控制項取得 Text 值（您也可以從應用程式中的其他地方提取前兩個值）。
2. 此函數會針對您所傳送的每個文件傳回 score。在我們的範例中，我們一次傳送一個文件。分數的範圍是從 0（負面）到 1（正面）。
3. 然後，公式會呼叫 ClearCollect 函數，移除 sentimentCollection 中的任何現有值，並從 score 中加上值。
選擇您所建立的標籤，然後將標籤的文字屬性設定為下列公式。
```
"The sentiment score is " & Round(First(sentimentCollection).score, 3) * 100 & "%"
```
此公式從集合取得情緒分數，並格式化並顯示它：
1. First() 函式會傳回 sentimentCollect 中的第一筆記錄 (在此案例中是唯一的一筆)，並顯示與該記錄相關聯的 score 欄位 (唯一的欄位)。
2. Round() 函數會將分數四捨五入至 3 位。公式的其餘部分會將結果格式化為百分比，並新增一些上下文資訊。

測試應用程式

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

選擇在右上角執行應用程式。
在文字輸入控制項中輸入短語，然後選擇取得分數。情緒分數應在幾秒鐘後顯示。

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

完成的情感分析應用程式

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

後續步驟

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

提供意見反應

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