PATCH/business-support/human-resource/extension-properties/{extensionPropertyId}

인사 부가 정보를 부분 수정한다.

Authorization

oauth2

OAuth 2.0 인증.
자세한 인증 방식은 인가·인증을 참고한다.

Scope

businessSupport.humanResource

HTTP Request

PATCHhttps://www.worksapis.com/v1.0/business-support/human-resource/extension-properties/{extensionPropertyId}

Path Parameters

ParameterTypeDescription
extensionPropertyId string 

부가 정보 키 또는 외부 키


required 

Header Parameters

HeadertypeDescription
Authorization string 

Bearer {token}


required 

Request Body

extensionProperty

PropertyTypeDescription
displayOrder integer 

부가 정보 노출 순서


format : int32 
visible boolean 

부가 정보 노출 여부. false이면 부가 정보를 노출하지 않으므로 편집할 수 없다.

 
editable boolean 

부가 정보 수정 여부

 
extensionPropertyName string 

부가 정보명

 
i18nNames array (i18nNames) 

부가 정보 다국어

 
propertyType string 

부가 정보 종류

  • INPUT: 단문
  • TEXTAREA: 장문
  • DATE: 날짜
  • DROPDOWN: 선택형
  • BOOLEAN: 라디오 버튼(예/아니요) 형식으로 표현된다.

Allowed values : INPUT, TEXTAREA, DATE, DROPDOWN, BOOLEAN 
dropdownItems array (ExtensionPropertyDropdownItem) 

DROPDOWN - Item 정보

 
externalKey string 

부가 정보 외부 키

 

i18nNames

PropertyTypeDescription
language string 

다국어 언어 코드


Allowed values : ko_KR, ja_JP, en_US, zh_CN, zh_TW 
name string 

부가 정보명

 

ExtensionPropertyDropdownItem

PropertyTypeDescription
displayOrder integer 

부가 정보 - DROPDOWN - 노출 순서


format : int32 
i18nNames array (i18nNames) 

부가 정보 - DROPDOWN - 항목 다국어

 
itemName string 

부가 정보 - DROPDOWN - 항목명

 

Request Example

Example 1

1{2  "extensionPropertyName": "사내 동호회",3  "displayOrder": 1,4  "editable": true,5  "i18nNames": [6    {7      "language": "ko_KR",8      "name": "사내 동호회"9    }10  ],11  "propertyType": "DROPDOWN",12  "dropdownItems": [13    {14      "displayOrder": 1,15      "i18nNames": [16        {17          "language": "ko_KR",18          "name": "미식회"19        }20      ],21      "itemId": "1a4fe403-a9b9-4ce7-8fe4-03a9b96ce7d9",22      "itemName": "미식회"23    },24    {25      "displayOrder": 2,26      "i18nNames": [27        {28          "language": "ko_KR",29          "name": "축구 동호회"30        }31      ],32      "itemId": "0bcb458c-73b0-4912-8b45-8c73b0c9128b",33      "itemName": "축구 동호회"34    }35  ],36  "visible": true,37  "externalKey": "EXT-PRO-3"38}

Response

HTTP 200

OK

PropertyTypeDescription
extensionPropertyId string 

부가 정보 ID


readOnly : true 
extensionPropertyName string 

부가 정보명

 
i18nNames array (i18nNames) 

부가 정보 다국어

 
visible boolean 

부가 정보 노출 여부

 
editable boolean 

부가 정보 수정 여부

 
displayOrder integer 

부가 정보 노출 순서


format : int32 
propertyType string 

부가 정보 종류

  • INPUT: 단문
  • TEXTAREA: 장문
  • DATE: 날짜
  • DROPDOWN: 선택형
  • BOOLEAN: true/false/null

Allowed values : INPUT, TEXTAREA, DATE, DROPDOWN, BOOLEAN 
dropdownItems array (ExtensionPropertyDropdownItem) 

DROPDOWN - Item 정보

 
externalKey string 

부가 정보 외부 키

 

i18nNames

PropertyTypeDescription
language string 

다국어 언어 코드


Allowed values : ko_KR, ja_JP, en_US, zh_CN, zh_TW 
name string 

부가 정보명

 

ExtensionPropertyDropdownItem

PropertyTypeDescription
displayOrder integer 

부가 정보 - DROPDOWN - 노출 순서


format : int32 
i18nNames array (i18nNames) 

부가 정보 - DROPDOWN - 항목 다국어

 
itemId string 

부가 정보 - DROPDOWN - 항목 ID, 수정 시 필수 항목


readOnly : true 
itemName string 

부가 정보 - DROPDOWN - 항목명

 

Response Example

Example 1

1{2  "displayOrder": 0,3  "editable": true,4  "extensionPropertyId": "string",5  "extensionPropertyName": "string",6  "i18nNames": [7    {8      "language": "ko_KR",9      "name": "string"10    }11  ],12  "propertyType": "TEXTAREA",13  "dropdownItems": [14    {15      "displayOrder": 0,16      "extensionPropertyId": "string",17      "i18nNames": [18        {19          "language": "ko_KR",20          "name": "string"21        }22      ],23      "itemId": "string",24      "itemName": "string"25    }26  ],27  "visible": true28}