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

注意

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

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

先決條件

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

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

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

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 函數：id、language 和 text。 我們在公式中指定前兩個的值，並從文字輸入控制項取得 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. 在文字輸入控制項中輸入短語，然後選擇取得分數。 情緒分數應在幾秒鐘後顯示。

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

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

後續步驟

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

• 共用您的連接器
• 認證您的連接器

提供意見反應

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