如何:使用伺服器邏輯與外部服務互動

在本指南中,您將設定一個網頁,該網頁將使用伺服器邏輯從外部服務 httpclient 伺服器物件讀取、寫入、更新和刪除記錄。

備註

此範例使用 https://services.odata.org/TripPinRESTierService ,但您可以使用其他公開可用的免費測試工具。

步驟 1:建立伺服器邏輯

  1. 登入 Power Pages。

  2. 選擇站點 + 編輯。

  3. 流覽至 [ 設定 ] 工作區,然後選取 [ 伺服器邏輯 (預覽版)]

    螢幕擷取畫面顯示在 [設定] 工作區中選取伺服器邏輯的位置。

  4. 選取 [+新增伺服器邏輯]

  5. 輸入伺服器邏輯的名稱。 此名稱會在 API 中用作建構伺服器邏輯 API 時的資源識別碼。 例如:

    房產 範例值
    名稱 services.odata.org
    顯示名稱 Performing CRUD operations using OData service
  6. 選取 [+新增角色] 以指派適當的 Web 角色。 在伺服器邏輯中新增管理員角色在此範例中,選取 [管理員],稍後以管理員身分登入以繼續。

  7. 選取 ,然後新增。

  8. 選取伺服器邏輯,然後選取 [編輯程式碼]。

    選取編輯程式碼

  9. 在在 Microsoft Visual Studio Code for the Web 編輯對話方塊中,選取開啟 Visual Studio Code 以撰寫自訂邏輯。

    您會在檔案中找到預先定義的方法和腳本。

  10. 定義伺服器邏輯方法,以使用外部服務讀取、編輯、建立、刪除作業。

    在get()方法之前新增下列baseUrl常數

    
     const baseUrl  = "https://services.odata.org/TripPinRESTierService";
    
    
  11. 將 get、 post、 put 和 del 示例函數替換為以下程式碼

    
    async function get() { 
       try { 
          Server.Logger.Log("GET called"); // Logger reference 
          if (!Server.Context.QueryParameters["username"]) { 
                const response = await Server.Connector.HttpClient.GetAsync( 
                   `${baseUrl}/People?$select=UserName,FirstName,LastName,MiddleName,Age`, 
                   {'content-type':'application/json'}); 
                return response; 
          } 
          else {             
                const id = Server.Context.QueryParameters["username"]; // Context reference 
                const response = await Server.Connector.HttpClient.GetAsync( 
                   `${baseUrl}(${id})/People?$select=UserName,FirstName,LastName,MiddleName,Age`, 
                   {'content-type':'application/json'}); 
                return response; 
          }         
       } catch (err) { 
          Server.Logger.Error("GET failed: " + err.message); 
          return JSON.stringify({ status: "error", method: "GET", message: err.message }); 
       } 
    } 
    
    async function post() { 
       try { 
          Server.Logger.Log("POST called"); 
          const data = JSON.parse(Server.Context.Body);            
          const url = `${baseUrl}/${data.serviceSession}/People`; 
          const { serviceSession, ...body } = data;  
          const response = await Server.Connector.HttpClient.PostAsync( 
                url,  
                JSON.stringify(body), 
                {'content-type':'application/json'}); 
          return response; 
       } catch (err) { 
          Server.Logger.Error("POST failed: " + err.message); 
          return JSON.stringify({ status: "error", method: "POST", message: err.message }); 
       } 
    }  
    
    async function put() { 
       try { 
          Server.Logger.Log("PUT called"); 
          const data = JSON.parse(Server.Context.Body);         
          const url = `${baseUrl}/${data.serviceSession}/People('${data.UserName}')`; 
          const { UserName, ...body1 } = data; 
          const { serviceSession, ...body } = body1; 
          const response = await Server.Connector.HttpClient.PatchAsync( 
                url,  
                JSON.stringify(body), 
                {'content-type':'application/json'}); 
          return response; 
       } catch (err) { 
          Server.Logger.Error("PUT failed: " + err.message); 
          return JSON.stringify({ status: "error", method: "PUT", message: err.message }); 
       } 
    }    
    
    async function del() { 
       try { 
          // "delete" keyword should not be used in script file. 
          Server.Logger.Log("DEL called"); 
          const username = Server.Context.QueryParameters["username"]; 
          const serviceSession = Server.Context.QueryParameters["serviceSession"]; 
          const url = `${baseUrl}/${serviceSession}/People('${username}')`; 
          const response = await Server.Connector.HttpClient.DeleteAsync( 
                url,  
                {'content-type':'application/json'}); 
          return response; 
       } catch (err) { 
          Server.Logger.Error("Deletion failed: " + err.message); 
          return JSON.stringify({ status: "error", method: "DEL", message: err.message }); 
       } 
    } 
    
  12. 儲存檔案。

    小提示

    使用 Ctrl+S 來儲存。

第 2 步:創建網頁

  1. 啟動 Power Pages 設計工作室。

  2. 在 [頁面] 工作區中,選取 [+ 頁面]。

    新增頁面

  3. 在 [ 描述頁面以建立頁面 ] 對話方塊中,選取 [ 新增頁面的其他方式]。

  4. 在 新增頁面 對話方塊中,輸入詳細資料。

    1. 在 [名稱 ] 方塊中,輸入 [伺服器邏輯 ],然後選取 [ 從空白 版面配置開始]。
    2. 選取 ,然後新增。

    輸入值以新增頁面

  5. 選擇右上角的編輯 代碼 選項。

  6. 在在 Visual Studio Code 網頁版對話方塊中,選取 開啟 Visual Studio Code。

  7. 將 HTML 頁面中找到的程式碼取代為下列內容:

    <div class="row sectionBlockLayout text-left" style="min-height: auto; padding: 8px;">
    <div class="container" style="display: flex; flex-wrap: wrap;">
       <div class="col-md-12 columnBlockLayout" style="padding: 16px; margin: 60px 0px; min-height: 200px;">
          <!-- Sample code for Web API demonstration -->
          <style>
          #processingMsg {
             padding: 6px 12px;
             background: #eee;
             border-radius: 4px;
             position: fixed;
             top: 10px;
             left: 50%;
             transform: translateX(-50%);
             display: none;
             z-index: 9999;
             text-align: center;
             font-weight: bold;
          }
    
          table {
             border-collapse: collapse;
             width: 100%;
             margin-top: 10px;
             font-family: Arial, sans-serif;
          }
    
          th,
          td {
             border: 1px solid #ccc;
             padding: 6px;
             text-align: left;
          }
    
          button {
             cursor: pointer;
             border: 1px solid #aaa;
             padding: 4px 8px;
             border-radius: 4px;
             background: #fff;
             font-size: 14px;
             margin-right: 2px;
          }
    
          button.add {
             color: green;
          }
    
          button.save {
             color: green;
          }
    
          button.cancel {
             color: orange;
          }
    
          button.delete {
             color: red;
          }
    
          input {
             width: 95%;
             box-sizing: border-box;
          }
    
          td.actions {
             white-space: nowrap;
          }
    
          td[data-attribute="UserName"] {
             background: #f9f9f9;
             cursor: default;
          }
          </style>
    
          <div id="processingMsg">Processing...</div>
          <div id="dataTable"></div>
    
          <script src="https://code.jquery.com/jquery-3.6.0.min.js"></script>
          <script>
          $(function () {
    
             // Safe WebAPI wrapper for Power Pages
             (function (webapi, $) {
                function safeAjax(opts) {
                var d = $.Deferred();
                shell.getTokenDeferred().done(function (token) {
                   opts.headers = opts.headers || {};
                   opts.headers["__RequestVerificationToken"] = token;
                   $.ajax(opts)
                      .done((data, ts, jq) => validateLoginSession(data, ts, jq, d.resolve))
                      .fail(d.reject);
                }).fail(() => d.rejectWith(this, arguments));
                return d.promise();
                }
                webapi.safeAjax = safeAjax;
             })(window.webapi = window.webapi || {}, jQuery);
    
             // Notification overlay
             const notify = (() => {
                const $m = $('#processingMsg'); let s = 0, t;
                return {
                show: (msg = 'Processing...') => { $m.text(msg); if (!s) $m.show(); s++; },
                hide: () => { s = Math.max(0, s - 1); if (!s) t = setTimeout(() => $m.hide(), 200); }
                };
             })();
    
             function ajaxCall(msg, opts) {
                notify.show(msg);
                return webapi.safeAjax(opts)
                .fail(r => alert(r.responseJSON?.error?.message || 'Server error'))
                .always(notify.hide);
             }
    
             // Table columns
             const cols = [
                { name: 'UserName', label: 'User Name', editable: false },
                { name: 'FirstName', label: 'First Name' },
                { name: 'LastName', label: 'Last Name' },
                { name: 'MiddleName', label: 'Middle Name' },
                { name: 'Age', label: 'Age' }
             ];
    
             let data = [];
             let serviceSession = '';
             function render() {
                const html = `<table>
                <thead>
                   <tr>
                      ${cols.map(c => `<th>${c.label}</th>`).join('')}
                      <th>Actions <button class="add">➕</button></th>
                   </tr>
                </thead>
                <tbody>
                   ${data.map(r => `<tr data-UserName="${r.UserName}">
                      ${cols.map(c => `<td data-attribute="${c.name}" data-value="${r[c.name] || ''}">
                            ${r[c.name] || ''}
                      </td>`).join('')}
                      <td class="actions">
                            <button class="delete">🗑️</button>
                      </td>
                   </tr>`).join('')}
                </tbody>
          </table>`;
                $('#dataTable').html(html);
             }
    
             // Double click row to edit except username
             $('#dataTable').on('dblclick', 'tr', function () {
                const $tr = $(this);
                if ($tr.hasClass('editing')) return;
                $tr.addClass('editing');
                $tr.find('td[data-attribute]').each(function () {
                const $td = $(this);
                if ($td.data('attribute') === 'UserName') return;
                const old = $td.text().trim();
                $td.html(`<input type="text" value="${old}" data-attr="${$td.data('attribute')}"/>`);
                });
                $tr.find('.actions').append('<button class="save">✅</button><button class="cancel">❌</button>');
             });
    
             $('#dataTable').on('click', '.save', function () {
                const $tr = $(this).closest('tr');
                const username = $tr.data('username');
                const updates = {};
                $tr.find('input').each(function () {
                const attr = $(this).data('attr');
                let value = $(this).val().trim();
    
                if (attr === 'Age') {
                   value = Number(value);
                   if (isNaN(value)) value = null; // safety fallback
                }
    
                updates[attr] = value;
                });
    
                ajaxCall('Updating...', {
                type: 'PUT',
                url: `/_api/serverlogics/services.odata.org`,
                contentType: 'application/json',
                data: JSON.stringify(Object.assign({ UserName: username, serviceSession: `${serviceSession}` }, updates)),
                success: () => { Object.assign(data.find(x => x.UserName === username), updates); render(); }
                });
             });
    
             $('#dataTable').on('click', '.cancel', () => render());
    
             $('#dataTable').on('click', '.delete', function () {
                const username = $(this).closest('tr').data('username');
                if (!confirm('Delete ' + username + '?')) return;
                ajaxCall('Deleting...', {
                type: 'DELETE',
                url: `/_api/serverlogics/services.odata.org?username=${username}&serviceSession=${serviceSession}`,
                success: () => { data = data.filter(x => x.UserName !== username); render(); }
                });
             });
    
             $('#dataTable').on('click', '.add', function () {
                const r = {
                serviceSession: `${serviceSession}`,
                UserName: 'user' + Math.floor(Math.random() * 9000 + 1000),
                FirstName: 'New',
                LastName: 'Person',
                MiddleName: '',
                Age: 25
                };
                ajaxCall('Adding...', {
                type: 'POST',
                url: `/_api/serverlogics/services.odata.org`,
                contentType: 'application/json',
                data: JSON.stringify(r),
                success: () => { data.unshift(r); render(); }
                });
             });
    
             // Initial load
             ajaxCall('Loading...', {
                type: 'GET',
                url: `/_api/serverlogics/services.odata.org`,
                contentType: 'application/json'
             }).done(resp => {
                const parsed = JSON.parse(resp.data);
                const body = JSON.parse(parsed.Body);
    
                const ctx = body['@odata.context'];
                const match = ctx.match(/\\S\\[^)]*\\/);
                serviceSession = match ? match[0] : '';
    
                data = (body.value || []).map(r => ({
                UserName: r.UserName,
                FirstName: r.FirstName,
                LastName: r.LastName,
                MiddleName: r.MiddleName,
                Age: r.Age
                }));
                render();
             });
    
          });
          </script>
       </div>
    </div>
    </div>
    
  8. 儲存檔案

    備註

    此程式碼會建立互動式資料表介面,以使用 Power Pages 伺服器邏輯示範使用外部 OData 服務的 CRUD (建立、讀取、更新、刪除) 作業。 它包括響應式表格佈局的CSS樣式、處理通知覆蓋層,以及JavaScript功能讓使用者可以查看從外部服務擷取的資料、點擊➕按鈕來新增記錄、雙擊表格列來編輯現有記錄(不包括使用者名稱欄位),透過✅儲存變更,透過❌取消編輯,並使用🗑按鈕刪除記錄。 程式碼使用 jQuery 和安全的 WebAPI 包裝函式,對 /_api/serverlogics/services.odata.org 端點進行經過驗證的 AJAX 呼叫,處理回應資料以剖析 OData 內容,並管理後續作業的服務工作階段。

  9. 返回 Power Pages 設計工具。

  10. 在 [ 您正在 Visual Studio Code for the Web 中編輯程式碼] 對話方塊中,遵循指示,然後按一下 [同步處理 ] 按鈕。

步驟 3:使用伺服器邏輯讀取、檢視、編輯、建立和刪除

若要測試伺服器邏輯功能:

  1. 選取 [預覽],然後選擇 [桌面]。
  2. 使用指派給您先前建立之伺服器邏輯使用者角色的使用者帳戶登入您的入口網站。 正如我們在上一個步驟中選取 [管理員 ] 角色一樣,在此範例中,請以管理員身分登入。
  3. 移至先前建立的 伺服器邏輯 網頁。
  4. 驗證操作。

伺服器邏輯概觀
作者伺服器邏輯
伺服器物件如何使用伺服器邏輯與 Dataverse 資料表互動