BasicInfo.Builder (larksuite-oapi 2.8.5 API)

java.lang.Object
- com.lark.oapi.service.corehr.v2.model.BasicInfo.Builder

封闭类:: BasicInfo

public static class BasicInfo.Builder
extends Object

构造器概要

构造器
构造器和说明

Builder()

构造器
构造器和说明
`Builder()`

方法概要

所有方法实例方法具体方法
限定符和类型	方法和说明
`BasicInfo.Builder`	`additionalName(Name additionalName)` 常用名示例值：
`BasicInfo.Builder`	`additionalNationalityIdList(String[] additionalNationalityIdList)` 其他国籍，可以通过[查询国籍信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-nationality/search)接口获得示例值：[6862995757234914824]
`BasicInfo.Builder`	`addressList(AddressForUpdate[] addressList)` 示例值：
`BasicInfo.Builder`	`bankAccountList(BankAccountForUpdate[] bankAccountList)` 示例值：
`BasicInfo.Builder`	`bornCountryRegion(String bornCountryRegion)` 出生国家/地区，可以通过[查询国家/地区信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-country_region/search)接口获取示例值：
`BasicInfo`	`build()`
`BasicInfo.Builder`	`citizenshipStatusIdList(String[] citizenshipStatusIdList)` 公民身份，如需获取具体值，请联系人员档案管理员示例值：[6862995757234914824]
`BasicInfo.Builder`	`cityOfBirth(String cityOfBirth)` 出生城市示例值：example
`BasicInfo.Builder`	`customFields(ObjectFieldData[] customFields)` person对象上的自定义字段，可以通过[获取自定义字段列表](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/query)接口获得示例值：
`BasicInfo.Builder`	`dateEnteredWorkforce(String dateEnteredWorkforce)` 参加工作日期，格式："YYYY-MM-DD" 示例值：2010-09-09
`BasicInfo.Builder`	`dateOfBirth(String dateOfBirth)` 生日示例值：2011-09-09
`BasicInfo.Builder`	`dependentList(DependentForUpdate[] dependentList)` 示例值：
`BasicInfo.Builder`	`disableCardNumber(String disableCardNumber)` 示例值：身份证号+残疾类型（1-7）+ 残疾程度分级（1-4）+[补发编号]
`BasicInfo.Builder`	`email(String email)` 个人邮箱示例值：xxx@bytedance.com
`BasicInfo.Builder`	`emergencyContactList(EmergencyContactForUpdate[] emergencyContactList)` 示例值：
`BasicInfo.Builder`	`ethnicityRace(String ethnicityRace)` 民族 / 种族，枚举值可查询[获取字段详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口获取，按如下参数查询即可：;- object_api_name：person;- custom_api_name：ethnicity_race 示例值：han
`BasicInfo.Builder`	`expectedGraduateDate(String expectedGraduateDate)` 示例值：2023-01-10
`BasicInfo.Builder`	`genderId(String genderId)` 性别，枚举值可查询[获取字段详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口获取，按如下参数查询即可： ;- object_api_name = person;- custom_api_name = gender 示例值：male
`BasicInfo.Builder`	`homeAddress(String homeAddress)` 家庭地址（待废弃）示例值：xx市xx街道xx路xx号
`BasicInfo.Builder`	`hukouLocation(String hukouLocation)` 示例值：北京市海淀区北三环西路
`BasicInfo.Builder`	`hukouType(String hukouType)` 户口类型，枚举值可查询[获取字段详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口获取，按如下参数查询即可：;- object_api_name：person_info_chn;- custom_api_name：hukou_type 示例值：local_urban_residence
`BasicInfo.Builder`	`internationalAreaCode(String internationalAreaCode)` 区号，枚举值可查询[获取字段详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口获取，按如下参数查询即可： ;- object_api_name = phone;- custom_api_name = international_area_code 示例值：86_china
`BasicInfo.Builder`	`isDisabled(Boolean isDisabled)` 示例值：
`BasicInfo.Builder`	`isMartyrFamily(Boolean isMartyrFamily)` 示例值：
`BasicInfo.Builder`	`isOldAlone(Boolean isOldAlone)` 示例值：
`BasicInfo.Builder`	`legalName(Name legalName)` 常用名示例值：
`BasicInfo.Builder`	`legalNames(NameForUpdate[] legalNames)` 法定姓名列表示例值：
`BasicInfo.Builder`	`maritalStatus(String maritalStatus)` 婚姻状况，枚举值可查询[获取字段详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口获取，按如下参数查询即可：;- object_api_name：person;- custom_api_name：marital_status 示例值：single
`BasicInfo.Builder`	`martyrCardNumber(String martyrCardNumber)` 示例值：00001
`BasicInfo.Builder`	`motherName(String motherName)` 母亲姓名示例值：example
`BasicInfo.Builder`	`name(Name name)` 常用名示例值：
`BasicInfo.Builder`	`nationalIdList(NationalIdForUpdate[] nationalIdList)` 国家证件示例值：
`BasicInfo.Builder`	`nationalIdV2s(NationalIdForUpdate[] nationalIdV2s)` 国家证件v2 示例值：
`BasicInfo.Builder`	`nationalityId(String nationalityId)` 国籍示例值：6862995757234914824
`BasicInfo.Builder`	`nationalityV2Id(String nationalityV2Id)` 国籍（新），可以通过[查询国籍信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-nationality/search)接口获得示例值：
`BasicInfo.Builder`	`nativeRegion(String nativeRegion)` 籍贯，可以通过[查询省份/行政区信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-country_region_subdivision/search)接口获取示例值：6822114062122064111
`BasicInfo.Builder`	`passports(PassportForUpdate[] passports)` 护照列表示例值：
`BasicInfo.Builder`	`personalIdNumber(String personalIdNumber)` 证件号（待废弃，建议使用national_id_list，如果与national_id_list同时传值，则national_id_list会被忽略）示例值：3101xxxx1234567890
`BasicInfo.Builder`	`personalIdType(String personalIdType)` 证件类型（待废弃，建议使用national_id_list，如果与national_id_list同时传值，则national_id_list会被忽略），可以通过[批量查询国家证件类型](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/national_id_type/list)接口获取示例值：
`BasicInfo.Builder`	`personalProfileList(PersonalProfileForUpdate[] personalProfileList)` 示例值：
`BasicInfo.Builder`	`personForCountries(PersonForCountryForUpdate[] personForCountries)` 多国个人信息示例值：
`BasicInfo.Builder`	`phoneNumber(String phoneNumber)` 手机号示例值：138xxxx1234
`BasicInfo.Builder`	`politicalAffiliation(String politicalAffiliation)` 政治面貌，枚举值可查询[获取字段详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口获取，按如下参数查询即可：;- object_api_name：person_info_chn;- custom_api_name：political_affiliation 示例值：
`BasicInfo.Builder`	`preferredNameV2(NameForUpdate preferredNameV2)` 常用姓名v2 示例值：
`BasicInfo.Builder`	`regionOfBirth(String regionOfBirth)` 出生省份示例值：example
`BasicInfo.Builder`	`religion(String religion)` 宗教信仰，枚举值可查询[获取字段详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口获取，按如下参数查询即可：;- object_api_name：person;- custom_api_name：religion 示例值：buddism
`BasicInfo.Builder`	`residentTaxList(ResidentTaxForUpdate[] residentTaxList)` 示例值：
`BasicInfo.Builder`	`taxInfoMys(TaxInfoMysForUpdate taxInfoMys)` 马来税务信息示例值：
`BasicInfo.Builder`	`userGeo(String userGeo)` 数据驻留地（部分租户开通此功能），枚举值可查询[获取字段详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口获取。
`BasicInfo.Builder`	`visas(VisaForUpdate[] visas)` 签证列表示例值：
`BasicInfo.Builder`	`workerId(String workerId)` 人员编号示例值：DDD00001

从类继承的方法 java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 构造器详细资料
  - Builder
```
public Builder()
```
- 方法详细资料
  - name
```
public BasicInfo.Builder name(Name name)
```
    常用名
    示例值：
    
    参数:
    
    name -
    
    返回:
  - phoneNumber
```
public BasicInfo.Builder phoneNumber(String phoneNumber)
```
    手机号
    示例值：138xxxx1234
    
    参数:
    
    phoneNumber -
    
    返回:
  - internationalAreaCode
```
public BasicInfo.Builder internationalAreaCode(String internationalAreaCode)
```
    区号，枚举值可查询[获取字段详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口获取，按如下参数查询即可： ;- object_api_name = phone;- custom_api_name = international_area_code
    示例值：86_china
    
    参数:
    
    internationalAreaCode -
    
    返回:
  - email
```
public BasicInfo.Builder email(String email)
```
    个人邮箱
    示例值：xxx@bytedance.com
    
    参数:
    
    email -
    
    返回:
  - dateOfBirth
```
public BasicInfo.Builder dateOfBirth(String dateOfBirth)
```
    生日
    示例值：2011-09-09
    
    参数:
    
    dateOfBirth -
    
    返回:
  - personalIdNumber
```
public BasicInfo.Builder personalIdNumber(String personalIdNumber)
```
    证件号（待废弃，建议使用national_id_list，如果与national_id_list同时传值，则national_id_list会被忽略）
    示例值：3101xxxx1234567890
    
    参数:
    
    personalIdNumber -
    
    返回:
  - personalIdType
```
public BasicInfo.Builder personalIdType(String personalIdType)
```
    证件类型（待废弃，建议使用national_id_list，如果与national_id_list同时传值，则national_id_list会被忽略），可以通过[批量查询国家证件类型](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/national_id_type/list)接口获取
    示例值：
    
    参数:
    
    personalIdType -
    
    返回:
  - dateEnteredWorkforce
```
public BasicInfo.Builder dateEnteredWorkforce(String dateEnteredWorkforce)
```
    参加工作日期，格式："YYYY-MM-DD"
    示例值：2010-09-09
    
    参数:
    
    dateEnteredWorkforce -
    
    返回:
  - genderId
```
public BasicInfo.Builder genderId(String genderId)
```
    性别，枚举值可查询[获取字段详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口获取，按如下参数查询即可： ;- object_api_name = person;- custom_api_name = gender
    示例值：male
    
    参数:
    
    genderId -
    
    返回:
  - nationalityId
```
public BasicInfo.Builder nationalityId(String nationalityId)
```
    国籍
    示例值：6862995757234914824
    
    参数:
    
    nationalityId -
    
    返回:
  - nationalityV2Id
```
public BasicInfo.Builder nationalityV2Id(String nationalityV2Id)
```
    国籍（新），可以通过[查询国籍信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-nationality/search)接口获得
    示例值：
    
    参数:
    
    nationalityV2Id -
    
    返回:
  - additionalNationalityIdList
```
public BasicInfo.Builder additionalNationalityIdList(String[] additionalNationalityIdList)
```
    其他国籍，可以通过[查询国籍信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-nationality/search)接口获得
    示例值：[6862995757234914824]
    
    参数:
    
    additionalNationalityIdList -
    
    返回:
  - citizenshipStatusIdList
```
public BasicInfo.Builder citizenshipStatusIdList(String[] citizenshipStatusIdList)
```
    公民身份，如需获取具体值，请联系人员档案管理员
    示例值：[6862995757234914824]
    
    参数:
    
    citizenshipStatusIdList -
    
    返回:
  - homeAddress
```
public BasicInfo.Builder homeAddress(String homeAddress)
```
    家庭地址（待废弃）
    示例值：xx市xx街道xx路xx号
    
    参数:
    
    homeAddress -
    
    返回:
  - workerId
```
public BasicInfo.Builder workerId(String workerId)
```
    人员编号
    示例值：DDD00001
    
    参数:
    
    workerId -
    
    返回:
  - userGeo
```
public BasicInfo.Builder userGeo(String userGeo)
```
    数据驻留地（部分租户开通此功能），枚举值可查询[获取字段详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口获取。;按如下参数查询即可： ;- object_api_name = pre_hire;- custom_api_name = user_geo
    示例值：
    
    参数:
    
    userGeo -
    
    返回:
  - legalName
```
public BasicInfo.Builder legalName(Name legalName)
```
    常用名
    示例值：
    
    参数:
    
    legalName -
    
    返回:
  - additionalName
```
public BasicInfo.Builder additionalName(Name additionalName)
```
    常用名
    示例值：
    
    参数:
    
    additionalName -
    
    返回:
  - residentTaxList
```
public BasicInfo.Builder residentTaxList(ResidentTaxForUpdate[] residentTaxList)
```
    示例值：
    
    参数:
    
    residentTaxList -
    
    返回:
  - bornCountryRegion
```
public BasicInfo.Builder bornCountryRegion(String bornCountryRegion)
```
    出生国家/地区，可以通过[查询国家/地区信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-country_region/search)接口获取
    示例值：
    
    参数:
    
    bornCountryRegion -
    
    返回:
  - isDisabled
```
public BasicInfo.Builder isDisabled(Boolean isDisabled)
```
    示例值：
    
    参数:
    
    isDisabled -
    
    返回:
  - disableCardNumber
```
public BasicInfo.Builder disableCardNumber(String disableCardNumber)
```
    示例值：身份证号+残疾类型（1-7）+ 残疾程度分级（1-4）+[补发编号]
    
    参数:
    
    disableCardNumber -
    
    返回:
  - isOldAlone
```
public BasicInfo.Builder isOldAlone(Boolean isOldAlone)
```
    示例值：
    
    参数:
    
    isOldAlone -
    
    返回:
  - isMartyrFamily
```
public BasicInfo.Builder isMartyrFamily(Boolean isMartyrFamily)
```
    示例值：
    
    参数:
    
    isMartyrFamily -
    
    返回:
  - martyrCardNumber
```
public BasicInfo.Builder martyrCardNumber(String martyrCardNumber)
```
    示例值：00001
    
    参数:
    
    martyrCardNumber -
    
    返回:
  - dependentList
```
public BasicInfo.Builder dependentList(DependentForUpdate[] dependentList)
```
    示例值：
    
    参数:
    
    dependentList -
    
    返回:
  - religion
```
public BasicInfo.Builder religion(String religion)
```
    宗教信仰，枚举值可查询[获取字段详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口获取，按如下参数查询即可：;- object_api_name：person;- custom_api_name：religion
    示例值：buddism
    
    参数:
    
    religion -
    
    返回:
  - bankAccountList
```
public BasicInfo.Builder bankAccountList(BankAccountForUpdate[] bankAccountList)
```
    示例值：
    
    参数:
    
    bankAccountList -
    
    返回:
  - nationalIdList
```
public BasicInfo.Builder nationalIdList(NationalIdForUpdate[] nationalIdList)
```
    国家证件
    示例值：
    
    参数:
    
    nationalIdList -
    
    返回:
  - personalProfileList
```
public BasicInfo.Builder personalProfileList(PersonalProfileForUpdate[] personalProfileList)
```
    示例值：
    
    参数:
    
    personalProfileList -
    
    返回:
  - emergencyContactList
```
public BasicInfo.Builder emergencyContactList(EmergencyContactForUpdate[] emergencyContactList)
```
    示例值：
    
    参数:
    
    emergencyContactList -
    
    返回:
  - addressList
```
public BasicInfo.Builder addressList(AddressForUpdate[] addressList)
```
    示例值：
    
    参数:
    
    addressList -
    
    返回:
  - maritalStatus
```
public BasicInfo.Builder maritalStatus(String maritalStatus)
```
    婚姻状况，枚举值可查询[获取字段详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口获取，按如下参数查询即可：;- object_api_name：person;- custom_api_name：marital_status
    示例值：single
    
    参数:
    
    maritalStatus -
    
    返回:
  - ethnicityRace
```
public BasicInfo.Builder ethnicityRace(String ethnicityRace)
```
    民族 / 种族，枚举值可查询[获取字段详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口获取，按如下参数查询即可：;- object_api_name：person;- custom_api_name：ethnicity_race
    示例值：han
    
    参数:
    
    ethnicityRace -
    
    返回:
  - nativeRegion
```
public BasicInfo.Builder nativeRegion(String nativeRegion)
```
    籍贯，可以通过[查询省份/行政区信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-country_region_subdivision/search)接口获取
    示例值：6822114062122064111
    
    参数:
    
    nativeRegion -
    
    返回:
  - hukouType
```
public BasicInfo.Builder hukouType(String hukouType)
```
    户口类型，枚举值可查询[获取字段详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口获取，按如下参数查询即可：;- object_api_name：person_info_chn;- custom_api_name：hukou_type
    示例值：local_urban_residence
    
    参数:
    
    hukouType -
    
    返回:
  - hukouLocation
```
public BasicInfo.Builder hukouLocation(String hukouLocation)
```
    示例值：北京市海淀区北三环西路
    
    参数:
    
    hukouLocation -
    
    返回:
  - customFields
```
public BasicInfo.Builder customFields(ObjectFieldData[] customFields)
```
    person对象上的自定义字段，可以通过[获取自定义字段列表](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/query)接口获得
    示例值：
    
    参数:
    
    customFields -
    
    返回:
  - expectedGraduateDate
```
public BasicInfo.Builder expectedGraduateDate(String expectedGraduateDate)
```
    示例值：2023-01-10
    
    参数:
    
    expectedGraduateDate -
    
    返回:
  - politicalAffiliation
```
public BasicInfo.Builder politicalAffiliation(String politicalAffiliation)
```
    政治面貌，枚举值可查询[获取字段详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口获取，按如下参数查询即可：;- object_api_name：person_info_chn;- custom_api_name：political_affiliation
    示例值：
    
    参数:
    
    politicalAffiliation -
    
    返回:
  - legalNames
```
public BasicInfo.Builder legalNames(NameForUpdate[] legalNames)
```
    法定姓名列表
    示例值：
    
    参数:
    
    legalNames -
    
    返回:
  - personForCountries
```
public BasicInfo.Builder personForCountries(PersonForCountryForUpdate[] personForCountries)
```
    多国个人信息
    示例值：
    
    参数:
    
    personForCountries -
    
    返回:
  - passports
```
public BasicInfo.Builder passports(PassportForUpdate[] passports)
```
    护照列表
    示例值：
    
    参数:
    
    passports -
    
    返回:
  - visas
```
public BasicInfo.Builder visas(VisaForUpdate[] visas)
```
    签证列表
    示例值：
    
    参数:
    
    visas -
    
    返回:
  - nationalIdV2s
```
public BasicInfo.Builder nationalIdV2s(NationalIdForUpdate[] nationalIdV2s)
```
    国家证件v2
    示例值：
    
    参数:
    
    nationalIdV2s -
    
    返回:
  - preferredNameV2
```
public BasicInfo.Builder preferredNameV2(NameForUpdate preferredNameV2)
```
    常用姓名v2
    示例值：
    
    参数:
    
    preferredNameV2 -
    
    返回:
  - motherName
```
public BasicInfo.Builder motherName(String motherName)
```
    母亲姓名
    示例值：example
    
    参数:
    
    motherName -
    
    返回:
  - cityOfBirth
```
public BasicInfo.Builder cityOfBirth(String cityOfBirth)
```
    出生城市
    示例值：example
    
    参数:
    
    cityOfBirth -
    
    返回:
  - regionOfBirth
```
public BasicInfo.Builder regionOfBirth(String regionOfBirth)
```
    出生省份
    示例值：example
    
    参数:
    
    regionOfBirth -
    
    返回:
  - taxInfoMys
```
public BasicInfo.Builder taxInfoMys(TaxInfoMysForUpdate taxInfoMys)
```
    马来税务信息
    示例值：
    
    参数:
    
    taxInfoMys -
    
    返回:
  - build
```
public BasicInfo build()
```

类 BasicInfo.Builder

构造器概要

方法概要

从类继承的方法 java.lang.Object

构造器详细资料

Builder

方法详细资料

name

phoneNumber

internationalAreaCode

email

dateOfBirth

personalIdNumber

personalIdType

dateEnteredWorkforce

genderId

nationalityId

nationalityV2Id

additionalNationalityIdList

citizenshipStatusIdList

homeAddress

workerId

userGeo

legalName

additionalName

residentTaxList

bornCountryRegion

isDisabled

disableCardNumber

isOldAlone

isMartyrFamily

martyrCardNumber

dependentList

religion

bankAccountList

nationalIdList

personalProfileList

emergencyContactList

addressList

maritalStatus

ethnicityRace

nativeRegion

hukouType

hukouLocation

customFields

expectedGraduateDate

politicalAffiliation

legalNames

personForCountries

passports

visas

nationalIdV2s

preferredNameV2

motherName

cityOfBirth

regionOfBirth

taxInfoMys

build