串接遠端 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 回傳值...
});