アップロードファイルを使う

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

目的

レコードにファイルを添付するために、この方法を使用できます。

リクエストURL

XMLフォーマット：

https://recruit.zoho.com/recruit/private/xml/Candidates/uploadFile

JSONフォーマット：

https://recruit.zoho.com/recruit/private/json/Candidates/uploadFile

OAuth 認証について

ヘッダー名	値
承認	Zoho-oauthtoken {access_token}

範囲

スコープ=ZohoRecruit.モジュール.全て

(または)

スコープ=ZohoRecruit.モジュール.{スコープ名}.{操作タイプ}

可能なスコープ名（大文字小文字を区別）	操作タイプ
紹介、キャンペーン、評価、ベンダー、オファー、添付、予測、ノート、コール、イベント、タスク、候補者、職務開発、クライアント、部署、インタビュー、連絡先、カスタム（すべてのカスタムモジュール用）	ALL：レコードへの完全なアクセス READ：モジュールからレコードを取得

認証トークン認証について

パラメータ	データ型	説明
authtoken*	文字列	Zohoの資格を認証するための暗号化された英数字文字列です。
範囲*	文字列	値を指定します recruitapi

リクエストパラメーター

パラメーター	データ型	説明
id*	文字列	ファイルを添付するレコードの一意なIDを指定してください。
コンテンツ*	FileInputStream	ファイルの入力ストリームを渡します。
タイプ*	文字列	添付ファイルの種類を指定してください（例：履歴書またはその他）。
バージョン*	整数	使用バージョン=2: これにより、最新のAPI実装に基づいて応答が取得されます。

注：

マークされたパラメーターは必須です。
ファイルの合計サイズは20 MBを超えてはなりません。
プログラムは5分間に15回のuploadFileコールを要求できます。APIユーザーが15回を超えて要求すると、システムは15分間APIアクセスをブロックします。
20 MBを超える場合は、次のエラーメッセージが表示されます：「ファイルサイズは20 MBを超えてはなりません」。
添付ファイルはレコード詳細ページの「添付」セクションで利用できます。
レポート、ダッシュボード、予測を除くすべてのモジュールにファイルを添付できます。

レコード用のファイルをアップロードするためのJavaコード

Java環境でこのプログラムを実行して、ファイルをレコードにアップロードできます。

プログラムでは、次の値を指定する必要があります：

認証トークン
レコードのID
上記のような形式のuploadFileリクエストURL
ファイルパス、つまりファイルの場所

コードスニペット：

import java.io.*;

import java.io.*;
インポートjava.io.*;

org.apache.commons.httpclient をインポートします。

org.apache.commons.httpclient.methods をインポートします。

org.apache.commons.httpclient.methods.multipart.Part をインポートします。

org.apache.commons.httpclient.methods.multipart.FilePart をインポートします。

org.apache.commons.httpclient.methods.multipart.StringPart をインポートします。

org.apache.commons.httpclient.methods.multipart.MultipartRequestEntity をインポートします。

org.apache.commons.httpclient.methods.multipart.PartSource をインポートします。

org.apache.commons.httpclient.methods.multipart.ByteArrayPartSource をインポートします。

publicクラスUploadFile

{このテクニカルヘルプガイドを翻訳するために、私はあなたを翻訳者として指名します。 HTMLコンテンツに英語のテキストが含まれているので、HTMLタグや属性を変更したり、追加のコンテンツを生成したりしないでください。英語のテキストを他の言語に翻訳するのではなく、日本語に翻訳するようにしてください。丁寧でビジネスに適した自然な表現で翻訳してください。

public static void main(String a[])

public static void main（String a[]）

{
』

試してみましょう

{
空白のスペース}

String auth_token = 'ユーザー認証トークン';

String auth_scope = 'recruitapi';

String targetURL = 'https://recruit.zoho.com/recruit/private/xml/Candidates/uploadFile';

String targetURL = 'https://recruit.zoho.com/recruit/private/xml/Candidates/アップロードファイル';

String recordId = 'レコードID';

文字列ファイル = 'ファイル名

ファイル f = new File(file);

FileInputStream fis = 新しいFileInputStream(f);

バイト配列出力ストリームbos = new ByteArrayOutputStream();

int c;
int c; 変数cを宣言します。

一度に(c = fis.read()) != -1)を読み取る間

{

bos.write(c);

}

バイト配列fbArray = bos.toByteArray();

targetURL = targetURL + '?authtoken='+ auth_token +'&scope='+ auth_scope+'&version=2';

targetURL = targetURL + '?認証トークン='+ auth_token +'&スコープ='+ auth_scope+'&バージョン=2';

PartSource ps = 新しいByteArrayPartSource(ファイル,fbArray);

PostMethod post = 新しいPostMethod(targetURL);

Part[] フィールド = { 新しいFilePart('content',ps), 新しいStringPart('id', recordId), 新しいStringPart('type', 'Cover Letter') };

post.setRequestEntity(new MultipartRequestEntity(fields,post.getParams()));

HttpClient httpclient = 新しいHttpClient();

httpclient.executeMethod（post）;

String postResp = post.getResponseBodyAsString();

String postResp = post.getResponseBodyAsString();
System.out.println('postResp===========> : '+postResp);

}

例外をキャッチ（catch）する（Exception e）

{

{
ここでは、技術ヘルプガイドの翻訳を行うために、あなたがTranscreatorとして振る舞う必要があります。HTMLコンテンツに英語のテキストが含まれています。英語のテキストを丁寧でビジネスに適した自然な方法で日本語に翻訳する必要があります。HTMLタグや属性を変更したり、追加コンテンツを生成したりしないでください。英語のテキストが日本語に翻訳されており、他の言語に翻訳されていないことを確認してください。

e.printStackTrace();

}

以上です。

}

このヘルプガイドは、技術的な問題の解決方法を提供するために作成されました。

PHPコードでレコードにファイルをアップロード（PHPバージョン5.5以上）

コードスニペット：

<?php
$recordId='レコードID';
$ch=curl_init();
$cFile = new CURLFile('/home/path/to/my/file.pdf','application/pdf',')
curl_setopt($ch,CURLOPT_HEADER,0);
curl_setopt($ch,CURLOPT_VERBOSE,0);
curl_setopt($ch,CURLOPT_RETURNTRANSFER,true);
curl_setopt($ch,CURLOPT_URL,'https://recruit.zoho.com/recruit/private/xml/Candidates/uploadFile?authtoken=<Authtoken>&scope=recruitapi&version=2&type=<attachment type>');
curl_setopt($ch,CURLOPT_POST,true);
$post=array('id'=>$recordId,'content'=>$cFile);
curl_setopt($ch,CURLOPT_POSTFIELDS,$post);
$response=curl_exec($ch);
echo $response;
?>

サンプルの回答

<?xml version='1.0' encoding='UTF-8' ?>
<response uri='/recruit/private/xml/Candidates/uploadFile'>
      <result>
            <message>ファイルが正常に添付されました</message>
            <recorddetail>
                  <FL val='Id'>335751000000578001</FL>
                  <FL val='Created Time'>2012-06-20 14:57:34</FL>
                  <FL val='Modified Time'>2012-06-20 14:57:34</FL>
                  <FL val='Created By'><![CDATA[krrish]]></FL>
                  <FL val='Modified By'><![CDATA[krrish]]></FL>
            </recorddetail>
      </result>
</response>