人員

有了部門、職稱與職務的組織架構，則可以新增與修改人員帳號資料，請參考以下資料：

人員說明：維護人員資訊
API 文件：UofxService.BASE.OrgEmpl

取得公司所有的人員資料¶

命名空間: Ede.Uofx.OpenApi.Sdk.NetStd.Service

方法名稱: UofxService.BASE.OrgEmpl.GetAll
var empls = await UofxService.BASE.OrgEmpl.GetAll();

回傳結果

命名空間: Ede.Uofx.OpenApi.Sdk.NetStd.Models.Base

物件名稱: EmployeeInfoModel

屬性	型態	說明
Account	`string`	帳號
Name	`string`	姓名
EnglishName	`string`	英文名
EmployeeNumber	`string`	員工編號
BusinessCard	`string`	名片
Gender	`string`	性別: Male, Female, Other
BirthDate	`DateTime?`	出生日期
IdCardNumber	`string`	身份證號碼
Enabled	`bool`	是否啟用
Locked	`bool`	是否鎖定
HireDate	`DateTime?`	到職日
ResignationDate	`DateTime?`	離職日
PhoneNumber	`string`	電話號碼
Email	`string`	電子郵件地址
EmailEx	`string`	電子郵件地址2
DeptCode	`string`	部門代碼

取得指定人員¶

命名空間: Ede.Uofx.OpenApi.Sdk.NetStd.Service

方法名稱: UofxService.BASE.OrgEmpl.Get
var user = UserModel.Create(UserType.Account, "Justin");
var empl = await UofxService.BASE.OrgEmpl.Get(user);

輸入參數

請參考使用者物件

回傳結果

命名空間: Ede.Uofx.OpenApi.Sdk.NetStd.Models.Base

物件名稱: EmplViewModel

屬性	型態	說明
Account	`string`	帳號
Name	`string`	姓名
LoginValidation	`List<string>`	登入驗證方式
EmployeeNumber	`string`	員工編號
ExpiredTime	`DateTime?`	帳號過期時間，過此時間後將無法使用
Gender	`string`	性別: Male, Female, Other
EnglishName	`string`	英文名
IdCardNumber	`string`	身份證號碼
BirthDate	`DateTime?`	出生日期
PhoneNumber	`string`	電話號碼
BusinessCard	`string`	名片
HireDate	`DateTime?`	到職日
Email	`string`	電子郵件地址
EmailEx	`string`	電子郵件地址2
Active	`bool`	是否啟用

取得指定人員部門資訊¶

命名空間: Ede.Uofx.OpenApi.Sdk.NetStd.Service

方法名稱: UofxService.BASE.OrgEmpl.GetDept
var user = UserModel.Create(UserType.Account, "Justin");
var emplDept = await UofxService.BASE.OrgEmpl.GetDept(user);

輸入參數

請參考使用者物件

回傳結果

命名空間: Ede.Uofx.OpenApi.Sdk.NetStd.Models.Base

物件名稱: EmplDeptViewModel

屬性	型態	說明
Depts	`List<DeptItem>`	所屬部門

命名空間: Ede.Uofx.OpenApi.Sdk.NetStd.Models.Base

物件名稱: DeptItem

屬性	型態	說明
Code	`string`	部門代碼
Name	`string`	部門名稱
IsMainDept	`bool`	是否為主部門 (員工只會有一個主部門)
SuperVisorAccount	`string`	簽核主管帳號
SuperVisorEmplNumber	`string`	簽核主管員編
JobTitle	`JobTitleItem`	職位名稱
JobFuncs	`List<JobFuncItem>`	職務項目

命名空間: Ede.Uofx.OpenApi.Sdk.NetStd.Models.Base

物件名稱: JobTitleItem

屬性	型態	說明
Code	`string`	職位代碼
Name	`string`	職位名稱

命名空間: Ede.Uofx.OpenApi.Sdk.NetStd.Models.Base

物件名稱: JobFuncItem

屬性	型態	說明
Code	`string`	職務代碼
Name	`string`	職務名稱

新增人員¶

命名空間: Ede.Uofx.OpenApi.Sdk.NetStd.Service

方法名稱: UofxService.BASE.OrgEmpl.CreateEmpl

await UofxService.BASE.OrgEmpl.CreateEmpl(new EmpCreateRequestModel()
{
   Account = "jane",
   Name = "Jane",
   Gender = "Male",
   EnglishName = "Jane",
   EmployeeNumber = "EMP00234",
   ExpiredTime = DateTime.Now.AddYears(3),
   IdCardNumber = "A123456789",
   BirthDate = new DateTime(1992, 8, 25),
   PhoneNumber = "0912345678",
   BusinessCard = "Jane Doe - Project Manager",
   HireDate = new DateTime(2019, 4, 10),
   Email = "jane.doe@example.com",
   EmailEx = "jane.doe@corp.com",

   Depts = new List<EmpCreateOfDeptItemRequestModel>
   {
       new EmpCreateOfDeptItemRequestModel
       {
           Code = "Demo",
           IsMainDept = true,
           JobTitleCode = "Title1",
           JobFuncs = new List<string> { "PM", "SP" }
       },
       new EmpCreateOfDeptItemRequestModel
       {
           Code = "Demo2",
           IsMainDept = false,
           JobTitleCode = "Title2",
           JobFuncs = new List<string> { "PM" }
       }
   }
});

輸入參數

命名空間: Ede.Uofx.OpenApi.Sdk.NetStd.Models.Base

物件名稱: EmpCreateRequestModel

屬性	型態	必填	說明
Account	`string`	V	帳號
Name	`string`	V	姓名
LoginValidation	`List<string>`		登入驗證方式，請參考附錄>登入驗證填寫方式
EnglishName	`string`		英文名
EmployeeNumber	`string`		員工編號
ExpiredTime	`DateTime?`		離職日期
Gender	`string`		性別: Male, Female, Other
IdCardNumber	`string`		身份證號碼
BirthDate	`DateTime?`		出生日期
PhoneNumber	`string`		電話號碼
BusinessCard	`string`		名片
HireDate	`DateTime?`		到職日
Email	`string`		電子郵件地址
EmailEx	`string`		電子郵件地址2
Depts	`List<EmpCreateOfDeptItemRequestModel>`	V	部門

命名空間: Ede.Uofx.OpenApi.Sdk.NetStd.Models.Base

物件名稱: EmpCreateOfDeptItemRequestModel

屬性	型態	必填	說明
Code	`string`	V	部門代碼
IsMainDept	`bool`	V	是否為主部門，至少要有一個部門為主部門
JobTitleCode	`string`	V	職稱代碼
JobFuncs	`List<string>`		職務代碼

更新基本資料¶

命名空間: Ede.Uofx.OpenApi.Sdk.NetStd.Service

方法名稱: UofxService.BASE.OrgEmpl.Update

await UofxService.BASE.OrgEmpl.Update(new EmplUpdateRequestModel()
{
   User = UserModel.Create(UserType.Account, "Justin"),
   Account = "jane",
   Name = "Jane Doe",
   Gender = "2",
   EnglishName = "Jane Doe",
   EmployeeNumber = "EMP00234",
   IdCardNumber = "A123456789",
   BirthDate = new DateTime(2000, 8, 25),
   PhoneNumber = "0912345678",
   BusinessCard = "Jane Doe - Project Manager",
   HireDate = new DateTime(2023, 4, 10),
   Email = "jane.doe@example.com",
   EmailEx = "jane.doe@corp.com",
});

輸入參數

命名空間: Ede.Uofx.OpenApi.Sdk.NetStd.Models.Base

物件名稱: EmplUpdateRequestModel

屬性	型態	必填	說明
User	UserModel	V	要修改的人員
Account	`string`	V	帳號
Name	`string`	V	姓名
LoginValidation	`List<string>`		登入驗證方式，請參考附錄>登入驗證填寫方式
EmployeeNumber	`string`		員工編號
Gender	`string`		性別: Male, Female, Other
EnglishName	`string`		英文名
IdCardNumber	`string`		身份證號碼
BirthDate	`DateTime?`		出生日期
PhoneNumber	`string`		電話號碼
BusinessCard	`string`		名片
HireDate	`DateTime?`		到職日
Email	`string`		電子郵件地址
EmailEx	`string`		電子郵件地址2

更新鎖定狀態¶

命名空間: Ede.Uofx.OpenApi.Sdk.NetStd.Service

方法名稱: UofxService.BASE.OrgEmpl.UpdateAcctLocked
await UofxService.BASE.OrgEmpl.UpdateAcctLocked(new EmplUpdateAcctLockedRequestModel()
{
   User = UserModel.Create(UserType.Account, "Justin"),
   Locked = false
});

輸入參數

命名空間: Ede.Uofx.OpenApi.Sdk.NetStd.Models.Base

物件名稱: EmplUpdateAcctLockedRequestModel

屬性	型態	必填	預設值	說明
User	UserModel	V		要修改的人員
Locked	`bool`	V		是否鎖定

更新啟用狀態¶

命名空間: Ede.Uofx.OpenApi.Sdk.NetStd.Service

方法名稱: UofxService.BASE.OrgEmpl.UpdateAcctStatus
await UofxService.BASE.OrgEmpl.UpdateAcctStatus(new EmplUpdateAcctStatusRequestModel()
{
   User = UserModel.Create(UserType.Account, "Justin"),
   Active = true
});

輸入參數

命名空間: Ede.Uofx.OpenApi.Sdk.NetStd.Models.Base

物件名稱: EmplUpdateAcctStatusRequestModel

屬性	型態	必填	預設值	說明
User	UserModel	V		要修改的人員
Active	`bool`	V		是否啟用

更新帳號到期日¶

命名空間: Ede.Uofx.OpenApi.Sdk.NetStd.Service

方法名稱: UofxService.BASE.OrgEmpl.UpdateAcctExpiredTime

await UofxService.BASE.OrgEmpl.UpdateAcctExpiredTime(new EmplUpdateAcctExpiredTimeRequestModel()
{
   User = UserModel.Create(UserType.Account, "Justin"),
   ExpiredTime = new DateTime(2024, 11, 30)
});

輸入參數

命名空間: Ede.Uofx.OpenApi.Sdk.NetStd.Models.Base

物件名稱: EmplUpdateAcctExpiredTimeRequestModel

屬性	型態	必填	預設值	說明
User	UserModel	V		要修改的人員
ExpiredTime	`DateTimeOffset?`		null	過期時間

更新離職日¶

命名空間: Ede.Uofx.OpenApi.Sdk.NetStd.Service

方法名稱: UofxService.BASE.OrgEmpl.UpdateEmplResignationDate

await UofxService.BASE.OrgEmpl.UpdateEmplResignationDate(new EmplUpdateResignationDateRequestModel()
{
   User = UserModel.Create(UserType.Account, "Justin"),
   ResignationDate = new DateTime(2024, 11, 30)
});

輸入參數

命名空間: Ede.Uofx.OpenApi.Sdk.NetStd.Models.Base

物件名稱: EmplUpdateResignationDateRequestModel

屬性	型態	必填	預設值	說明
User	UserModel	V		要修改的人員
ResignationDate	`DateTimeOffset?`		null	離職日

更新簽核主管¶

簽核主管並非部門主管 (此兩個是不同的概念)，僅是用來表示表單簽核時，要傳送給哪位人員簽核。

命名空間: Ede.Uofx.OpenApi.Sdk.NetStd.Service

方法名稱: UofxService.BASE.OrgEmpl.UpdateSupervisor

await UofxService.BASE.OrgEmpl.UpdateSupervisor(new EmplUpdateSupervisorRequestModel()
{
   User = UserModel.Create(UserType.Account, "Justin"),
   DeptCode = "Demo",
   SupervisorType = SupervisorType.DeptManager,
});

輸入參數

命名空間: Ede.Uofx.OpenApi.Sdk.NetStd.Models.Base

物件名稱: EmplUpdateSupervisorRequestModel

屬性	型態	必填	說明
User	UserModel	V	要修改的人員
DeptCode	`string`	V	要更新的員工部門 (員工所屬每個部門都能各自設定簽核主管)
SupervisorType	SupervisorType	V	簽核主管類型
Supervisor	UserModel		簽核人，當 SupervisorType 輸入 Customize 時，此屬性用來指定簽核主管

更新所屬部門¶

一位員工可以有多個兼職部門，但只能有一個主要部門，使用此方法請一次輸入全部的所屬部門，如原本所屬部門不在輸入清單中，則此員工將會被從此部門移除。

命名空間: Ede.Uofx.OpenApi.Sdk.NetStd.Service

方法名稱: UofxService.BASE.OrgEmpl.UpdateEmplDept

await UofxService.BASE.OrgEmpl.UpdateEmplDept(new EmplUpdateDeptRequestModel()
{
   User = UserModel.Create(UserType.Account, "Justin"),
   Depts = new List<DeptRequestModel>
       {
           new DeptRequestModel
           {
               Code = "Demo",
               IsMainDept = false,
               JobTitleCode = "Title3",
               JobFuncs = new List<string> { "RD" }
           },
           new DeptRequestModel
           {
               Code = "Demo2",
               IsMainDept = true,
               JobTitleCode = "Title4",
               JobFuncs = new List<string> { "SP" }
           }
       }
});

輸入參數

命名空間: Ede.Uofx.OpenApi.Sdk.NetStd.Models.Base

物件名稱: EmplUpdateDeptRequestModel

屬性	型態	必填	預設值	說明
User	UserModel	V		要修改的人員
Depts	`List<DeptRequestModel>`	V		所屬部門

命名空間: Ede.Uofx.OpenApi.Sdk.NetStd.Models.Base

物件名稱: DeptRequestModel

屬性	型態	必填	說明
Code	`string`	V	部門代碼
IsMainDept	`bool`	V	是否為主部門，至少要有一個部門為主部門
JobTitleCode	`string`	V	職稱代碼
JobFuncs	`List<string>`		職務代碼

更新主要部門¶

此方法僅會更新員工的主要部門，原兼職部門不會異動。

命名空間: Ede.Uofx.OpenApi.Sdk.NetStd.Service

方法名稱: UofxService.BASE.OrgEmpl.UpdateEmplMainDept

await UofxService.BASE.OrgEmpl.UpdateEmplMainDept(new EmplUpdateMainDeptRequestModel()
{
   User = UserModel.Create(UserType.Account, "Justin"),
   MainDept = new DeptRequestModelBase
   {
       Code = "Demo3",
       JobTitleCode = "Title5",
       JobFuncs = new List<string> { "RD" }
   }
});

輸入參數

命名空間: Ede.Uofx.OpenApi.Sdk.NetStd.Models.Base

物件名稱: EmplUpdateMainDeptRequestModel

屬性	型態	必填	預設值	說明
User	UserModel	V		要修改的人員
MainDept	`DeptRequestModelBase`	V		主要部門

命名空間: Ede.Uofx.OpenApi.Sdk.NetStd.Models.Base

物件名稱: DeptRequestModelBase

屬性	型態	必填	說明
Code	`string`	V	部門代碼
JobTitleCode	`string`	V	職稱代碼
JobFuncs	`List<string>`		職務代碼

刪除人員¶

此方法僅會更新員工的主要部門，原兼職部門不會異動。

命名空間: Ede.Uofx.OpenApi.Sdk.NetStd.Service

方法名稱: UofxService.BASE.OrgEmpl.Delete
var user = UserModel.Create(UserType.Account, "Justin");
var result = await UofxService.BASE.OrgEmpl.Delete(user);

輸入參數

請參考使用者物件