本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 範例結構描述


具有適用於 Organizations、個人及裝置的範例結構描述。下節會列出各種範例結構描述，並列出每個的不同之處。

## Organizations


下表列出包含在 *Organizations* 範例結構描述中的面向。

 


****  

| **"Organization" 面向 ** | **資料類型 ** | **長度 ** | **必要行為？ ** | **描述 ** | 
| --- | --- | --- | --- | --- | 
| account\$1id  | 字串  | 1024  | N  | 組織的唯一 ID  | 
| account\$1name  | 字串  | 1024  | N  | 組織名稱  | 
| organization\$1status  | 字串  | 1024  | N  | 「作用中」、「暫停」、「非作用中」、「關閉」等狀態  | 
| mailing\$1address (street1)  | 字串  | 1024  | N  | 此公司/實體的實體郵寄地址  | 
| mailing\$1address (street2)  | 字串  | 1024  | N  | 此公司/實體的實體郵寄地址  | 
| mailing\$1address (city)  | 字串  | 1024  | N  | 此公司/實體的實體郵寄地址  | 
| mailing\$1address (state)  | 字串  | 1024  | N  | 此公司/實體的實體郵寄地址  | 
| mailing\$1address (country)  | 字串  | 1024  | N  | 此公司/實體的實體郵寄地址  | 
| mailing\$1address (postal\$1code)  | 字串  | 1024 | N  | 此公司/實體的實體郵寄地址  | 
| 電子郵件  | 字串  | 1024  | N  | 組織的電子郵件 ID  | 
| web\$1site  | 字串  | 1024  | N  | 網站 URL  | 
| telephone\$1number  | 字串  | 1024  | N  | 組織的電話號碼  | 
| 描述  | 字串  | 1024  | N  | 組織的說明  | 

 


****  

| **"Legal\$1Entity" 面向 ** | **資料類型** | **長度**  | **必要行為？**  | **描述** | 
| --- | --- | --- | --- | --- | 
| registered\$1company\$1name  | 字串  | 1024  | N  | 合法實體名稱  | 
| mailing\$1address (street1)  | 字串  | 1024  | N  | 此公司/實體的實體註冊地址  | 
| mailing\$1address (street2)  | 字串  | 1024  | N  | 此公司/實體的實體註冊地址  | 
| mailing\$1address (city)  | 字串  | 1024  | N  | 此公司/實體的實體註冊地址  | 
| mailing\$1address (state)  | 字串  | 1024  | N  | 此公司/實體的實體註冊地址  | 
| mailing\$1address (country)  | 字串  | 1024  | N  | 此公司/實體的實體註冊地址  | 
| mailing\$1address (postal\$1code)  | 字串  | 1024  | N  | 此公司/實體的實體註冊地址  | 
| industry\$1vertical  | 字串  | 1024  | N  | 產業區隔  | 
| billing\$1currency  | 字串  | 1024  | N  | 帳單貨幣  | 
| tax\$1id  | 字串  | 1024  | N  | 稅務識別碼  | 

## Person


下表列出包含在 *Person* 範例結構描述中的面向。

 


****  

| **"Person" 面向** | **資料類型** | **長度** | **必要行為？** | **描述** | 
| --- | --- | --- | --- | --- | 
| display\$1name | 字串 | 1024 | N | 使用者名稱，適用於向使用者顯示。 | 
| first\$1name | 字串 | 1024 | N | 使用者的指定名稱，或大部分西方語言中的名字 | 
| last\$1name | 字串 | 1024 | N | 使用者的姓氏，或大部分西方語言中的姓氏 | 
| middle\$1name | 字串 | 1024 | N | 使用者的中間名 | 
| nickname | 字串 | 1024 | N | 使用者在現實生活中的暱稱，例如，"Bob" 或 "Bobby"，而不是 "Robert" | 
| 電子郵件 | 字串 | 1024 | N | 使用者的電子郵件地址 | 
| mobile\$1phone\$1number | 字串 | 1024 | N | 使用者的手機電話號碼 | 
| home\$1phone\$1number | 字串 | 1024 | N | 使用者的手機電話號碼 | 
| username | 字串 | 1024 | Y | 使用者的唯一識別符 | 
| profile | 字串 | 1024 | N | URI，亦即統一資源定位器，指向表示使用者線上設定檔 (如網頁) 的位置 | 
| picture | 字串 | 1024 | N | URI，亦即統一資源定位器，指向表示使用者影像的資源位置。 | 
| website | 字串 | 1024 | N | URL | 
| timezone | 字串 | 1024 | N | 使用者的時區 | 
| locale | 字串 | 1024 | N | 用於指出使用者的預設位置，以本地化貨幣、日期時間格式或數字表示等項目。 | 
| address (street1) | 字串 | 1024 | N | 此使用者的實體郵寄地址。 | 
| address (street2) | 字串 | 1024 | N | 此使用者的實體郵寄地址。 | 
| address (city) | 字串 | 1024 | N | 此使用者的實體郵寄地址。 | 
| address (state) | 字串 | 1024 | N | 此使用者的實體郵寄地址。 | 
| address (country) | 字串 | 1024 | N | 此使用者的實體郵寄地址。 | 
| address (postal\$1code) | 字串 | 1024 | N | 此使用者的實體郵寄地址。 | 
| user\$1status | 字串 | 1024 | N | 指出使用者管理狀態的值 | 

 


****  

| **"Organization\$1Person" 面向** | **資料類型** | **長度** | **必要行為？** | **描述** | 
| --- | --- | --- | --- | --- | 
| title | 字串 | 1024 | N | 組織中的職銜 | 
| preferred\$1language | 字串 | 1024 | N | 指出使用者偏好的書寫或口語語言，通常用於選取本地化的使用者界面。 | 
| employee\$1id | 字串 | 1024 | N | 字串識別符，通常是數字或英數字元，指派給個人 | 
| cost\$1center | 整數 | 1024 | N | 識別成本中心 | 
| department | 字串 | 1024 | N | 識別部門的名稱 | 
| manager  | 字串 | 1024 | N | 使用者的經理 | 
| company\$1name | 字串 | 1024 | N | 識別組織的名稱 | 
| company\$1address (street1) | 字串 | 1024 | N | 組織的實體郵寄地址 | 
| company\$1address (street2) | 字串 | 1024 | N | 組織的實體郵寄地址 | 
| company\$1address (city) | 字串 | 1024 | N | 組織的實體郵寄地址 | 
| company\$1address (state) | 字串 | 1024 | N | 組織的實體郵寄地址 | 
| company\$1address (country) | 字串 | 1024 | N | 組織的實體郵寄地址 | 
| company\$1address (postalCode) | 字串 | 1024 | N | 組織的實體郵寄地址 | 

## Device


下表列出包含在 *Device* 範例結構描述中的面向。

 


****  

| **"Device" 面向** | **資料類型** | **長度** | **必要行為？** | **描述** | 
| --- | --- | --- | --- | --- | 
| device\$1id | 字串 | 1024 | N | 唯一的英數字元裝置 ID | 
| name | 字串 | 1024 | N | 裝置的易記名稱 | 
| 描述  | 字串 | 1024 | N | 裝置的說明  | 
| X.509\$1certificates | 字串 | 1024 | N | X.509 憑證 | 
| device\$1version | 字串 | 1024 | N | 裝置版本  | 
| device\$1os\$1type | 字串 | 1024 | N | 裝置的作業系統 | 
| device\$1os\$1version | 字串 | 1024 | N | 裝置的作業系統版本號碼 | 
| serial\$1number | 字串 | 1024 | N | 裝置的序號 | 
| device\$1status | 字串 | 1024 | N | 裝置的狀態 (例如作用中、非作用中、暫停、關閉、結束) |