使用內容程式碼片段自訂內容

注意

自 2022 年 10 月 12 日起,Power Apps 入口網站為 Power Pages。 其他資訊:Microsoft Power Pages 現在已推出 (部落格)
我們很快就會遷移並將 Power Apps 入口網站文件與 Power Pages 文件併合。

內容程式碼片段是可編輯的小段內容,可由開發人員放在頁面範本中,方便可自訂的內容填入頁面配置的任何部分。 程式碼片段控制項負責呈現網路對向入口網站中的程式碼片段內容,開發人員會將這些控制項放在頁面範本上。

編輯程式碼片段

您可以透過入口網站管理應用程式編輯程式碼片段。 程式碼片段的主要功能在於,您可以抽出一小段內容 (而非頁面的主要複本) 另外進行編輯,如此就能實際完整管理網站上的任何靜態內容,並且可編輯。

  1. 開啟入口網站管理應用程式

  2. 移至入口網站 > 內容程式碼片段

  3. 若要建立新的程式碼片段,請選取新增

  4. 若要編輯現有程式碼片段,請按兩下以選取網格中的現有內容程式碼片段

輸入下列欄位的值:

名稱 描述
名稱 開發人員可以使用名稱將程式碼片段值放到入口網站程式碼內的頁面範本中。
網站 與程式碼片段關聯的網站。
顯示名稱 內容程式碼片段的顯示名稱。
類型​​ 內容程式碼片段類型 (文字或 HTML)。
內容程式碼片段語言 選取內容程式碼片段的語言。 若要新增其他語言,請移至啟用多語言支援
在入口網站中顯示的程式碼片段內容。 您可以輸入純文字或 HTML 標記。 您也可以將 Liquid 物件與文字或 HTML 標記值搭配使用。

使用程式碼片段

您可以使用程式碼片段來顯示文字或 HTML。 內容程式碼片段也可以使用 Liquid 物件並參照其他內容,例如實體

例如,您可以使用本文前述的步驟來建立/編輯內容程式碼片段。 編輯程式碼片段時,您可以將範例程式碼包含在記錄中。 請確認您已在環境中將客戶資料表記錄的識別碼替換為正確的識別碼。 您也可以使用其他資料表而不是客戶。

使用上述範例所示文字、HTML 或 Liquid 物件建立程式碼片段之後,就可以在入口網站頁面中使用此程式碼片段。

若要在入口網站頁面上新增程式碼片段:

  1. 建立網站範本,並使用程式碼片段 Liquid 物件來呼叫您建立的程式碼片段。

  2. 使用先前建立的網站範本來建立頁面範本

  3. 透過入口網站工作室,使用先前建立的頁面範本來建立新的頁面。

範例

下列範例會搭配範例資料使用 Microsoft Dataverse 資料庫。

  1. 開啟入口網站管理應用程式

  2. 移至入口網站 > 內容程式碼片段

  3. 若要建立新的程式碼片段,請選取新增

  4. 輸入名稱。 例如,AccountData。

  5. 選取您的網站。

  6. 輸入顯示名稱。 例如,AccountData。

  7. 選取以 HTML 做為此範例的類型。 您也可以改為選取文字。

  8. 選取語言。

  9. 複製並貼上範例值:

    {% assign account = entities.account['f4f25307-d284-ea11-a816-000d3a36ff29'] %}
    {% if account %}
    <b> Account Name is: </b> {{ account.name }} <br>
    <i> Account State: </i> {{ account.statecode.label }})
    {% endif %}
    

    將記錄的 GUID 取代為 Dataverse 資料庫中的客戶資料表記錄。

    建立內容程式碼片段。

  10. 儲存內容程式碼片段。

  11. 從左窗格選取網站範本

  12. 選取新增

  13. 輸入名稱。 例如,account-web-template。

  14. 選取您的網站。

  15. 複製並貼上來源值:

    {% include 'snippet' snippet_name:'AccountData' %}

    如果不相同,請將程式碼片段的值更新為您的程式碼片段名稱。

    網站範本。

  16. 選取儲存。

  17. 從左窗格選取頁面範本

  18. 選取新增

  19. 輸入名稱。 例如,「客戶資料程式碼片段」。

  20. 選取您的網站。

  21. 選取類型為網站範本

  22. 選取先前建立的網站範本。 在此範例中為 account-web-template。

  23. 選取儲存。

    頁面範本。

  24. 編輯您的入口網站。

  25. 選取新增 > 空白頁面。

    新增空白頁面。

  26. 輸入頁面的名稱。 例如,「客戶資料」。

  27. 輸入部分 URL。 例如,accounts-data。

  28. 選取先前建立的頁面範本。 在此範例中為「客戶資料程式碼片段」。

    網頁中繼資料。

  29. 從右上角選取瀏覽網站,以在瀏覽器中檢視頁面。

    瀏覽入口網站。

您可以依照相同的步驟處理文字 (而非 HTML) 類型的程式碼片段,例如:

{% assign account = entities.account['f4f25307-d284-ea11-a816-000d3a36ff29'] %}
{% if account %}
Account Name is: {{ account.name }} 
Account State: {{ account.statecode.label }}
{% endif %}

將記錄的 GUID 取代為 Dataverse 資料庫中的客戶資料表記錄。

當您瀏覽包含此內容程式碼片段的頁面時,資料表資訊將使用 Liquid 物件以及文字 (而不是 HTML) 來顯示。 同樣地,您也可以只使用 HTML 來顯示內容,而不使用 Liquid 物件。

請參閱

使用 Liquid 範本

注意

是否能請您告知您偏好的慣用文件語言? 請填寫問卷。 (請注意,本問卷為英文版)

完成問卷大約需要七分鐘。 本問卷將不會收集個人資料 (隱私權聲明)。