JS SDKライブラリ

JS SDKライブラリ

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

以下のSDKメソッドを呼び出す前に、JS SDKのURLをコードに含めてください:
ウィジェットにリスナーを登録する場合:
ウィジェットを初期化し、Zoho Peopleアプリケーションでのイベントのリスニングを開始するために、以下のコードスニペットを使用してください。
Quote
Zoho.embeddedApp.init();

フォームIDの取得

これは関連リストとカスタムボタンウィジェットでのみサポートされています。
ウィジェットが表示されているフォームIDを取得するには、以下を使用してください:
Quote
Zoho.People.API.getFormId()

レスポンス

Quote
String(データID)

form 項目のコンポーネントを取得する

form 項目のコンポーネントを取得するには、以下を使用してください:
Quote
Zoho。People。API。getFormComponents();

レスポンス

Quote
[{
'comptype': 'Text',
'ismandatory': 真,
'descriptionType': +10、-10,
'displayname': 'EmployeeID',
'autofillvalue': '',
'説明': '',
'formcomponentid': '115782000000020183',
'labelname': 'EmployeeID',
'maxLength': 100
}, {
'comptype': 'Text',
'ismandatory': 真,
'descriptionType': +10、-10,
'displayname': '姓',
'autofillvalue': '',
'説明': '',
'formcomponentid': '115782000000020187',
'labelname': 'LastName',
'maxLength': 100
}]

form レコードを追加する

form レコードを追加するには、以下を使用してください:
Quote
Zoho。People。API。addFormData(inputData);
 
inputData
JSON入力:
 
{formName:<フォーム名>, input:{LabelName:値, LabelName1:値}};

 フォーム名についてはこちらを参照

LabelNameについては こちらを参照

 

レスポンス

Quote
完了レスポンス: データが正常に追加されました
エラーレスポンス: エラーが発生しました

フォームデータの更新

フォームデータを更新するには、次のように使用します:
Quote
Zoho。People。API。updateFormData(inputData);
 
inputData
JSON入力:
 
{formName:<フォーム名>, input:{LabelName:値, LabelName1:値},recordId: };

 formNameについては、 こちらを参照

応答

Quote
完了応答:データが正常に更新されました
失敗応答:エラーが発生しました

データIDの取得

これは関連リストおよびカスタムボタンウィジェットにのみ対応しています。
ウィジェットが現在表示されているデータのデータIDを取得するには、使用します:
Quote
Zoho.People.API.getRecord()

データIDによるフォームデータの取得

データIDによるフォームデータを取得するには、以下のように使用します:
Quote
Zoho.People.API.getFormRecord(inputData):

 
入力データ

JSON 入力: 

{recordId:<データID>, formName: <フォーム名>};
formNameについてはこちらを参照してください。

 

Info
現在、form データIDはZoho People APIのgetRecord()から取得できます。

レスポンス

Quote
{'LabelName': 値, 'LabelName1':value2,'LabelName_downloadUrl':file アップロードする項目のダウンロードurl}

大量のフォームデータを取得する

大量のフォームデータを取得するには、以下の方法を使用してください:
Quote
Zoho。People。API。getBulkRecords(inputData)
inputData



JSON 入力:
 
{formName:<フォーム名>,startIndex:<から始まるインデックス>,limit:<制限> }


startIndex- 任意で、初期値 -1
limit- 任意で、初期値 - 200

レスポンス

Quote
[{'LabelName': 値, 'LabelName1':value2,'LabelName_downloadUrl':file アップロードする項目のダウンロードurl}, {'LabelName': value1, 'LabelName1':value22,'LabelName_downloadUrl':file アップロードする項目のダウンロードurl},
]

フォームデータのセクションごとの取得

セクション毎にフォームデータを取得するには、以下のメソッドを使用します。
Quote
Zoho。People。API。getFormDatabySection(inputData)
inputData
JSON入力:
 
{formName: ,recordId:<データID>}

formNameについては - 参照  こちら

レスポンス

Quote
[
{
'Section1': {
'ラベル名': '値', 'ラベル名': '値'
},
'Section2': {
'ラベル名': '値', 'ラベル名': '値'
},
'tabularSections': {
'ラベル名': [
{
'ラベル名': '値', 'ラベル名': '値'
}
],
'ApprovalStatus': '承認未処理'
}
]

フォームファイルのダウンロード

フォームファイルをダウンロードするには、以下のメソッドを使用します:
引用
Zoho。People。API。downloadFormFile(inputData);
 
inputData
JSON入力:
 
{fcId:,recordId:,formId:}

応答

引用
ファイルの内容

ファイルカテゴリの取得

ファイルカテゴリを取得するには、使用する:
引用
Zoho。People。API。getFileCategories();

応答

引用
[{'CatID':'1','CatName':'テスト'},{'CatID':'2','CatName':'Test1'}]

従業員ファイルのアップロード

ファイルをアップロードするには、使用する:
見積もり
Zoho。People。API。uploadEmployeeFile(fileInput);
 
fileInput
JSON Input:
 
{uploadfile: , fileName: <ファイル名>, employeeId: ,fileDesc: <説明>,catId: };

catIdを取得するには、使用してください:
見積もり
Zoho。People。API。getFileCategories();

レスポンス

見積もり
正常終了のレスポンス:データが正常に追加されました

サードパーティのAPIを呼び出す

サードパーティのAPIを呼び出すには、次のように使用してください:
Quote
Zoho。People。Http。post(requestObj);
 
inputData
JSON 入力データ:
 
var requestObj = {
url : url,
header: {'Authorization':'Zoho-oauthtoken-__token'}
params: {};
};

Notes
Zoho-oauth を使用してZoho サービスのAPIを呼び出します。

レスポンス

API からのレスポンスです。

外部連携を通じてAPIを呼び出す

外部連携を通じてAPIを呼び出すには、以下を使用します:
Quote
Zoho。People。API。invokeUrl(requestData);
入力データ






JSON形式の入力

var requestData = {url: [呼び出すURL],
connectiondetails:'名前=[接続-名前], '
params : [URLパラメータ], // 任意
methodType: <取得|POST|PUT|削除>;
extraParam={'コンテンツタイプ' : 'application/json'};// 任意
};

レスポンス

これはAPIからのレスポンスです。

ウィジェットのサンプルコード

  1. <text>
  2. これはフォームデータを取得するサンプルウィジェットです。


    Zoho CRM 管理者向けトレーニング

    「導入したばかりで基本操作や設定に不安がある」、「短期間で集中的に運用開始できる状態にしたい」、「運用を開始しているが再度学び直したい」 といった課題を抱えられているユーザーさまに向けた少人数制のオンライントレーニングです。

    日々の営業活動を効率的に管理し、導入効果を高めるための方法を学びましょう。

    Zoho CRM Training



              Zoho WorkDrive Resources



                Zoho Desk Resources

                • Desk Community Learning Series


                • Digest


                • Functions


                • Meetups


                • Kbase


                • Resources


                • Glossary


                • Desk Marketplace


                • MVP Corner


                • Word of the Day









                                  Resources

                                  Videos

                                  Watch comprehensive videos on features and other important topics that will help you master Zoho CRM.



                                  eBooks

                                  Download free eBooks and access a range of topics to get deeper insight on successfully using Zoho CRM.



                                  Webinars

                                  Sign up for our webinars and learn the Zoho CRM basics, from customization to sales force automation and more.



                                  CRM Tips

                                  Make the most of Zoho CRM with these useful tips.