串接遠端 API

建立自訂 Service

• 建立自訂的 API Service 需要繼承BasicApiService，傳入要呼叫的 url。
• 範例中使用~/api開頭是因為BasicApiService 會將覆蓋~波浪號的部分與serverUrl進行網址串接。

employee.service.ts

export class EmployeeService extends BasicApiService{
  /**
   * 取得合法的員工編號
   * @returns 合法的員工編號
   */
  getValidEmpNumber(){
    const url= '~/api/emp/validemp';
    // 呼叫之前需先設定serverUrl
    console.log(this.http.serverUrl);
    return this.http.get<string[]>(url);
  }
}        

• 設定 API Service 的serverUrl時需要使用pluginSetting物件取得entryHost站台位址，此站台位址為 Plugin 管理 中您所輸入的 Plugin 位置。

advance-field.write.component.ts

// 呼叫 API 之前要設定 serverUrl 為外掛欄未站台位址
this.empService.serverUrl = this.pluginSetting?.entryHost;
// 呼叫 API 檢查是否是有效的帳號
this.empService.getValidEmpNumber().subscribe(res => {
  // 處理 res 回傳值...
});