表形式レコードの追加

表形式レコードの追加

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

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

目的
addTabularRecordsメソッドを使用して、特定のデータに表情報を追加できます。

種類: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

データに挿入する必要がある表データ

メモ:*が付いているパラメーターは必須です。

利用できるタブ

候補者、求人、面接、連絡先、クライアント、すべてのカスタムタブ
リクエスト例
<FL val='学歴の詳細'>
<TR no='0'>
<TL val='教育/研究機関'><![CDATA[テスト組織 ]]></TL>
<TL val='学位'><![CDATA[B.Tech]]></TL>
<TL val='期間_From'><![CDATA[01-2036]]></TL>
<TL val='期間_To'><![CDATA[01-2050]]></TL>
</TR> </FL>
<FL val='経験の詳細'>
<TR no='0'>
<TL val='職位/肩書き'><![CDATA[テスト]]</TL>
<TL val='会社'><![CDATA[テスト]]</TL>
<TL val='概要'><![CDATA[テスト]]></TL>
<TL val='勤務期間_From'><![CDATA[01-1955]]></TL>
<TL val='現在勤務中'><![CDATA[false]]></TL>
</TR> </FL>
<FL val='表5'>
<TR no='0'>
<TL val='ラベル3'><![CDATA[テスト]]></TL>
<TL val='日付範囲_To'><![CDATA[09/03/2017]]></TL>
</TR>
</FL>
</Candidates>
レスポンス
<?xml version='1.0' encoding='UTF-8'?>
<response uri='/recruit/private/xml/Candidates/addTabularRecords'>
<result>
<Candidates>データを追加しました</Candidates>
</result>
</response>

メモ:

  1. 各データに追加できる表エントリーは最大10件です。
  2. 内容に特殊文字が含まれる場合は、Recruitにデータを送信する際にCDATAを使用してください。これにより、XML解析エラーによる追加/更新操作の失敗を回避できます。
  3. addTabularRecords APIは、対象のデータに含まれる既存の表データを上書きします。
  4. 複数選択リスト項目に2つ以上の値を追加するには、区切り文字としてセミコロン(;)を使用してください。
    例:<![CDATA[オプション1;オプション2;オプション3]]>