「関連レコードの取得」

「関連レコードの取得」

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

目的

getRelatedRecords メソッドを使用して関連レコードを取得できます。
例えば、キャンペーンに関連する候補者を取得したり、クライアントに関連するタスクを取得することができます。

リクエストURL

XML 形式:
https://recruit.zoho.com/recruit/private/xml/Notes/getRelatedRecords?authtoken=Auth Token&scope=recruitapi&id=レコードID&parentModule=モジュール名&version=2

JSON 形式:
https://recruit.zoho.com/recruit/private/json/Notes/getRelatedRecords?authtoken=Auth Token&scope=recruitapi&id=レコードID&parentModule=モジュール名&version=2

OAuth 認証のために

ヘッダー名
 値
承認
 Zoho-oauthtoken {アクセストークン}

スコープ

範囲=ZohoRecruit.modules.all
(または)
範囲=ZohoRecruit.modules.{scope_name}.{operation_type}
可能なスコープ名（大文字小文字を区別）
操作タイプ
紹介、キャンペーン、評価、ベンダー、添付、
予測、ノート、コール、イベント、タスク、候補者、職務開発、クライアント、部門、インタビュー、連絡先、カスタム（すべてのカスタムモジュール用））
ALL - レコードへの完全なアクセス
READ - モジュールからレコードを取得する

認証トークン認証のために

パラメータ
 データ型
 説明
authtoken*
 String
 暗号化されたアルファベット数字文字列を使用して、Zohoの認証を行います。 
スコープ*
 文字列
 値を指定してください recruitapi

リクエストパラメーター

パラメーター
 データ型
 説明
親モジュール*
 文字列
 関連レコードを取得したいモジュール
例：キャンペーンに関連する候補者を取得したい場合、キャンペーンが親モジュールです。
id*
 整数
 関連レコードを取得したいレコードのID
新しいフォーマット
 整数
 新しいフォーマット=1: Recruitアカウントからデータを挿入する際、'null'値を含むフィールドを除外します。
新しいフォーマット=2: Recruitアカウントからデータを挿入する際、'null'値を含むフィールドも含めます。
fromIndex
 整数
 デフォルト値 - 1
toIndex
 Integer
 デフォルト値 - 20
最大値 - 200
バージョン*
 整数
 使用 バージョン=2: これにより、最新のAPI実装に基づいた応答が取得されます。
注意:
  1. *でマークされたパラメーターは必須です。
  2. getRelatedRecordsメソッドはカスタムルックアップフィールドをサポートしていません。
現在、getRelatedRecordsメソッドはNotesモジュールとAttachmentsモジュールをサポートしています。

例

レコードに添付されたファイルを表示するには
URLフォーマット：
https://recruit.zoho.com/recruit/private/xml/Attachments/getRelatedRecords?authtoken=あなたのAuth Token&newFormat=1&scope=recruitapi&parentModule=Candidates&id=508020000000957321
サンプル応答:
<response uri='/recruit/private/xml/Attachments/getRelatedRecords'>
<result>
<Attachments>
<row no='1'>
<FL val='id'>5080200000005483628</FL>
<FL val='ファイル名'>
<![CDATA[ wallpaper.jpeg ]]>
</FL>
<FL val='サイズ'>
<![CDATA[ 17.56 KB ]]>
</FL>
<FL val='修正時間'>
<![CDATA[ 2012-07-03 14:58:36 ]]>
</FL>
<FL val='SMOWNERID'>508020000000065849</FL>
<FL val='添付者'>
<![CDATA[ charles stone]]>
</FL>
<FL val='カテゴリー'>
<![CDATA[ 履歴書 ]]>
</FL>
</row>
<row no='2'>
<FL val='id'>5080200000000906253</FL>
<FL val='ファイル名'>
<![CDATA[ image.jpeg ]]>
</FL>
<FL val='サイズ'>
<![CDATA[ 8.55 KB ]]>
</FL>
<FL val='変更時間'>
<![CDATA[ 2012-07-03 14:58:35 ]]>
</FL>
<FL val='SMOWNERID'>508020000000065849</FL>
<FL val='添付者'>
<![CDATA[ charles stone]]>
</FL>
<FL val='カテゴリー'>
<![CDATA[ その他 ]]>
</FL>
</row>
<row no='3'>
<FL val='id'>5080200000009873561</FL>
<FL val='ファイル名'>
<![CDATA[ サンプル画像.jpg ]]>
</FL>
<FL val='サイズ'>
<![CDATA[ 11.47 KB ]]>
</FL>
<FL val='変更時間'>
<![CDATA[ 2012-07-03 14:58:35 ]]>
</FL>
<FL val='SMOWNERID'>508020000000065849</FL>
<FL val='添付者'>
<![CDATA[ チャールズ・ストーン]]>
<FL val='カテゴリー'>
<![CDATA[ その他 ]]>
</FL>
 
</FL>
</row>
<row no='4'>
<FL val='id'>5080200000001928374</FL>
<FL val='ファイル名'>
<![CDATA[ test-img.jpg ]]>
</FL>
<FL val='サイズ'>
<![CDATA[ 8.16 KB ]]>
</FL>
<FL val='変更時間'>
<![CDATA[ 2012-07-03 14:58:35 ]]>
</FL>
<FL val='SMOWNERID'>508020000000065849</FL>
<FL val='添付者'>
<![CDATA[ charles stone]]>
</FL>
</FL>
</row>
<row no='4'>
<FL val='id'>5080200000001928374</FL>
<FL val='ファイル名'>
<![CDATA[ test-img.jpg ]]>
</FL>
<FL val='サイズ'>
<![CDATA[ 8.16 KB ]]>
</FL>
<FL val='変更時間'>
<![CDATA[ 2012-07-03 14:58:35 ]]>
</FL>
<FL val='SMOWNERID'>508020000000065849</FL>
<FL val='添付者'>
<![CDATA[ charles stone]]>
</FL>
</FL>
</row>
<row no='4'>
<FL val='id'>5080200000001928374</FL>
<FL val='ファイル名'>
<![CDATA[ test-img.jpg ]]>
</FL>
<FL val='サイズ'>
<![CDATA[ 8.16 KB ]]>
</FL>
<FL val='変更時間'>
<![CDATA[ 2012-07-03 14:58:35 ]]>
</FL>
<FL val='SMOWNERID'>508020000000065849</FL>
<FL val='添付者'>
<![CDATA[ charles stone]]>
</FL>
</FL>
</row>
<row no='4'>
<FL val='id'>5080200000001928374</FL>
<FL val='ファイル名'>
<![CDATA[ test-img.jpg ]]>
</FL>
<FL val='サイズ'>
<![CDATA[ 8.16 KB ]]>
</FL>
<FL val='変更時間'>
<![CDATA[ 2012-07-03 14:58:35 ]]>
</FL>
<FL val='SMOWNERID'>508020000000065849</FL>
<FL val='添付者'>
<![CDATA[ charles stone]]>
</FL>
</FL>
</row>
<row no='4'>
<FL val='id'>5080200000001928374</FL>
<FL val='ファイル名'>
<![CDATA[ test-img.jpg ]]>
</FL>
<FL val='サイズ'>
<![CDATA[ 8.16 KB ]]>
</FL>
<FL val='変更時間'>
<![CDATA[ 2012-07-03 14:58:35 ]]>
</FL>
<FL val='SMOWNERID'>508020000000065849</FL>
<FL val='添付者'>
<![CDATA[ charles stone]]>
</FL>
</FL>
</row>
<row no='4'>
<FL val='カテゴリー'>
<![CDATA[ その他 ]]>
</FL>
 
</row>
</添付ファイル>
</結果>
</レスポンス>
レコードの下にあるノートを取得する

URL 形式:

https://recruit.zoho.com/recruit/private/xml/Notes/getRelatedRecords?authtoken=<Authtoken>&scope=recruitapi&id=RECORD_ID&parentModule=モジュール名
サンプル応答：
<response uri='/recruit/private/xml/Notes/getRelatedRecords'>
<result>
<Notes>
<row no='1'>
<FL val='id'>5080200000005483628</FL>
<response uri='/recruit/private/xml/Notes/getRelatedRecords'>
<result>
<Notes>
<row no='1'>
<FL val='id'>5080200000005483628</FL>
<FL val='タイトル'>
<![CDATA[ メモ ]]>
</FL>
<FL val='Note Content'>
<![CDATA[ 新しいレコードの下に注釈 ]]>
</FL>
<FL val='SMOWNERID'>508020000000065849</FL>
<FL val='Owner Name'>
<![CDATA[ James ]]>
</FL>
<FL val='SMCREATORID'>508020000000065849</FL>
<FL val='Created By'>
<![CDATA[ James ]]>
</FL>
<FL val='Created Time'>
<![CDATA[ 2012-12-12 05:00:00 ]]>
</FL>
<FL val='MODIFIEDBY'>508020000000065849</FL>
<FL val='Modified By'>
<![CDATA[ James ]]>
</FL>
<FL val='Modified Time'>
<![CDATA[ 2012-12-12 05:00:00 ]]>
</FL>
<FL val='ISVOICENOTES'>
<![CDATA[ false ]]>
</FL>

</row>
</Notes>
</result>
</response>