共用方式為

Azure API 管理中的問題範本

Azure API 管理提供您能夠使用一組可設定內容的範本來自訂開發人員入口網站頁面的內容。 使用 DotLiquid 語法和您選擇的編輯器，例如 適用於設計工具的 DotLiquid，以及一組提供的當地語系化 字串資源、Glyph 資源，以及 頁面控件，您可以彈性地使用這些範本來設定頁面的內容。

本節中的範本可讓您自定義開發人員入口網站中 [問題] 頁面的內容。

備註

範例預設範本會包含在下列檔中，但由於持續改善，可能會有所變更。 您可以在開發人員入口網站中瀏覽至所需的個別範本，以檢視實時默認範本。 如需使用範本的詳細資訊，請參閱 如何使用範本自定義 API 管理開發人員入口網站。

備註

下列檔內容與已淘汰的開發人員入口網站有關。 您可以照舊繼續使用，直到其在 2023 年 10 月淘汰，屆時便會將其從所有 API 管理服務中移除。 已被取代的入口網站只會接收重要的安全性更新。 如需詳細資訊，請參閱下列文章：

適用於：開發人員 | 基本 | 標準 | 進階

問題清單

範本允許您在開發人員入口網站中自訂問題清單頁面的正文。

問題清單開發人員入口網站

默認範本

<div class="row">
  <div class="col-md-9">
    <h2>{% localized "IssuesStrings|WebIssuesIndexTitle" %}</h2>
  </div>
</div>
<div class="row">
  <div class="col-md-12">
    {% if issues.size > 0 %}
    <ul class="list-unstyled">
      {% capture reportedBy %}{% localized "IssuesStrings|WebIssuesStatusReportedBy" %}{% endcapture %}
      {% assign replaceString0 = '{0}' %}
      {% assign replaceString1 = '{1}' %}
      {% for issue in issues %}
      <li>
        <h3>
          <a href="/issues/{{issue.id}}">{{issue.title}}</a>
        </h3>
        <p>{{issue.description}}</p>
        <em>
          {% capture state %}{{issue.issueState}}{% endcapture %}
          {% capture devName %}{{issue.subscriptionDeveloperName}}{% endcapture %}
          {% capture str1 %}{{ reportedBy | replace : replaceString0, state }}{% endcapture %}
          {{ str1 | replace : replaceString1, devName }}
          <span class="UtcDateElement">{{ issue.reportedOn | date: "r" }}</span>
        </em>
      </li>
      {% endfor %}
    </ul>
    <paging-control></paging-control>
    {% else %}
    {% localized "CommonResources|NoItemsToDisplay" %}
    {% endif %}
    {% if canReportIssue %}
    <a class="btn btn-primary" id="createIssue" href="/Issues/Create">{% localized "IssuesStrings|WebIssuesReportIssueButton" %}</a>
    {% elsif isAuthenticated %}
    <hr />
    <p>{% localized "IssuesStrings|WebIssuesNoActiveSubscriptions" %}</p>
    {% else %}
    <hr />
    <p>
      {% capture signIntext %}{% localized "IssuesStrings|WebIssuesNotSignin" %}{% endcapture %}
      {% capture link %}<a href="/signin">{% localized "IssuesStrings|WebIssuesSignIn" %}</a>{% endcapture %}
      {{ signIntext | replace : replaceString0, link }}
    </p>
    {% endif %}
  </div>
</div>

控制項

範本 Issue list 可以使用下列 頁面控件。

資料模型

財產 類型 說明
Issues Issue 實體的集合。 目前使用者可以看到的問題。
Paging 頁面調度 實體。 應用程式集合的分頁資訊。
IsAuthenticated 布爾值 目前使用者是否登入開發人員入口網站。
CanReportIssues 布爾值 目前使用者是否有權提出問題。
Search 字串 這個屬性已被取代，不應使用。

範例範本資料

{
    "Issues": [
        {
            "Id": "5702b68bb16653124c8f9ba7",
            "ApiId": "570275f1b16653124c8f9ba3",
            "Title": "I couldn't figure out how to connect my application to the API",
            "Description": "I'm having trouble connecting my application to the backend API.",
            "SubscriptionDeveloperName": "Clayton",
            "IssueState": "Proposed",
            "ReportedOn": "2016-04-04T18:46:35.64",
            "Comments": null,
            "Attachments": null,
            "Services": null
        }
    ],
    "Paging": {
        "Page": 1,
        "PageSize": 10,
        "TotalItemCount": 1,
        "ShowAll": false,
        "PageCount": 1
    },
    "IsAuthenticated": true,
    "CanReportIssue": true,
    "Search": null
}

後續步驟

如需使用範本的詳細資訊，請參閱 如何使用範本自定義 API 管理開發人員入口網站。

  • Last updated on