タブラー形式レコードの更新

タブラー形式レコードの更新

お知らせ:当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。


メモ:APIの新しいバージョン(V2)を使用している場合は、こちらのリンクを参照してください。 

目的
updateTabularRecordsメソッドを使用して、指定したデータの特定の表形式のエントリーを更新できます。

種類:POST

OAuth認証の場合

ヘッダー名

Authorization
Zoho-oauthtoken {access_token}

スコープ

Scope=ZohoRecruit.modules.all
(または)
Scope=ZohoRecruit.modules.{scope_name}.{operation_type}
使用可能なスコープ名(大文字と小文字を区別)
操作の種類
referral, campaign, assessment, vendor, offer, attachment,
forecast, note, call, event, task, candidate, jobopening, client, department, interview, contact & custom(すべてのカスタムタブ用
ALL - データへのすべての権限
READ - タブからデータを取得

Authtoken認証の場合

パラメーター
データの種類
詳細
authtoken*
文字列
Zohoの認証情報の認証に使用する、暗号化済みの英数字の文字列です。
scope*
文字列
値に recruitapi を指定します

リクエストパラメーター

パラメーター
データの種類
詳細
id*
文字列
データの一意のIDを指定します
xmlData*
XML
データ内で更新する表データ


メモ:*が付いているパラメーターは必須です
サンプルリクエスト
https://recruit.zoho.com/recruit/private/xml/Candidates/updateTabularRecords?authtoken=<authtoken>&id=<candidateid>&xmlData=<?xmlversion='1.0' encoding='UTF-8'?> <Candidates><FL val='経験の詳細'><TR no='0'><TL val='TABULARROWID'><![CDATA[368078000002922007]]></TL><TL val='職業/役職'genType='1'uiType='1'><![CDAT A[Ja va 開発者 - Mooresville, NC]]></TL><TL val='会社' genType='1' uiType='1'><![CDATA[Lowe's]]></TL><TL val='概要' genType='1' uiType='110'><![CDATA[テスト]]></TL><TL val='勤務期間_開始' genType='1' uiType='6607'><![CDATA[01-2015]]></TL><TL val='現在勤務中'
genType='1' uiType='301'><![CDATA[false]]></TL></TR></FL></Candidates>
レスポンス
<?xml version='1.0' encoding='UTF-8'?>
<response uri='/recruit/private/xml/Candidates/updateTabularRecords'>
<result>
<Candidates>データを正常に更新しました</Candidates>
</result> </response>

メモ:
  1. 指定した表の行IDに一致するデータがない場合、そのデータは新規として扱われ、既存のデータとともに表のエントリーとして追加されます。
  2. 複数選択リスト項目で2つ以上の値を更新するには、区切り文字としてセミコロン(;)を使用します。
    例:<![CDATA[オプション1;オプション2;オプション3]]>