JS SDK

JS SDK

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

前提条件

以下のSDKメソッドを呼び出す前に、JS https://js。zohocdn。com/プロジェクト/js/client_sdk。min。js をあなたのコードに組み込んでください。
Zoho プロジェクトのスタイルを利用するため、 CSS https://css。zohocdn。com/プロジェクト/styles/zps-extn/client_sdk。css をあなたのコードに組み込んでください。

初期化

これにより拡張機能が初期化されます。


zohoprojects.init().then(function(){});                                          
 
このメソッドは、他のSDKメソッドがそれの呼び出し後のみ機能するため、開始時に呼び出す必要があります。initが読み込まれている間に他の機能を使用する場合は、init関数内でそれらを使用することができます。


 zohoprojects.init().then(function () {
      zohoprojects.get('portal.name').then(function (response) 
      });

メタデータ

これにより、拡張機能の支払いおよび設定詳細が取得されます。

zohoprojects.metadata().then(function(response)
  {
       /* 出力
  {
        'data': {
        'configs': [
             {
             'name': '名前',
             'type': 'テキスト',
             'is_mandatory': true,
             'is_secure': false,
             'description': 'あなたの名前を入力してください',
             'value': 'Helen Collins'
               },
                {
                 'name': '従業員ID',
                 'type': 'テキスト',
                 'is_mandatory': true,
                 'is_secure': false,
                   'description': 'あなたの従業員IDを入力してください',
                   'value': 'EMP08'
                    }
                     ],
                    'payments_info': {
                     'edition': '試用版'
                     },
                     'status': '成功'
                      }
                     }
                    */
           });                              

コンテクスト

これは現在の場所のタブ名とデータIDを取得します。 タブ名は 'タスク' または 'issues' であり、データIDは対応するタスクまたは問題のIDです。


 zohoprojects.context().then(function(response)
 {
 /* 出力
 {
     'module_name': 'タスク',
      'entity_id': '27092000000031079'
  }
     */
      });                                         

Notes 'app_settings', 'attachment_picker', 'blueprint_during'および'top_band'の場所に対してはデータIDを提供していません。

取得する

これにより、インスタンス、現在のユーザー、ポータル、プロジェクト、タスク、および現在の場所の問題の詳細を取得します。


zohoprojects.get('task.id
').then(function(response)
{
/* 出力結果
 {
'data': 27092000000031080,
'status': 'success'
}
*/
});
                                                
以下は、取得するメソッドで使用中のキーのリストです:

インスタント

  • インスタント

現在のユーザー

  • 現在のユーザー

ポータル

  1. ポータル。試用版が有効
  2. ポータル。設定
  3. ポータル。gmtタイムゾーン
  4. ポータル。プロジェクトの数
  5. ポータル。役割
  6. ポータル。利用可能なユーザー数
  7. ポータル。ロケール
  8. ポータル。プロジェクトプレフィックス
  9. ポータル。利用可能なプロジェクト
  10. ポータル。最大ユーザー数
  11. ポータル。プロファイルID
  12. ポータル。名前
  13. ポータル。IDストリング
  14. ポータル。バグ(複数形)
  15. ポータル。プラン
  16. ポータル。バグプラン
  17. ポータル。バグ(単数形)ポータル。初期設定
  18. ポータル。拡張機能
  19. ポータル。CRMパートナーであるかどうか
  20. ポータル。プロジェクトプレフィックスを表示するかどうか
  21. ポータル。タスクプレフィックスを表示するかどうか
  22. ポータル。新しいプランであるかどうか
  23. ポータル。レイアウト
  24. ポータル。リンク

プロジェクト

  1. プロジェクト。厳格であるかどうか
  2. プロジェクト。役割
  3. プロジェクト。バグの数
  4. プロジェクト。オーナーID
  5. プロジェクト。タスク/バグのプレフィックス
  6. プロジェクト。リンク
  7. プロジェクト。説明
  8. プロジェクト。マイルストーンの数
  9. プロジェクト。更新日(ロングフォーマット)
  10. プロジェクト。タスクの数
  11. プロジェクト。更新日のフォーマット
  12. プロジェクト。ワークスペースID
  13. プロジェクト。課金ステータス
  14. プロジェクト。キー
  15. プロジェクト。チャットが有効かどうか
  16. プロジェクト。オーナー名
  17. プロジェクト。プロファイルID
  18. プロジェクト。有効なタブ
  19. プロジェクト。名前
  20. プロジェクト。公開しているかどうか
  21. プロジェクト。レイアウト詳細
  22. プロジェクト。ステータス
  23. プロジェクト。権限
  24. プロジェクト。バグが有効かどうか
  25. プロジェクト。バグのデフォルトビュー
  26. プロジェクト。バグプレフィックス
  27. プロジェクト。カスケート設定
  28. プロジェクト。完了日
  29. プロジェクト。完了日(ロングフォーマット)
  30. プロジェクト。作成日
  31. プロジェクト。作成日のフォーマット
  32. プロジェクト。作成日(ロングフォーマット)
  33. プロジェクト。カスタムステータスID
  34. プロジェクト。IDストリング
  35. プロジェクト。プロジェクト概要の表示するかどうか
  36. プロジェクト。開始日
  37. プロジェクト。開始日(ロングフォーマット)
  38. プロジェクト。更新日
  39. プロジェクト。ユーザー
  40. プロジェクト。カスタム項目
  41. プロジェクト。カスタムフィールド

タスク

  1. タスク。名前
  2. タスク。完了
  3. タスク。作成者
  4. タスク。優先度
  5. タスク。進行率
  6. タスク。開始日
  7. タスク。終了日
  8. タスク。依存性
  9. タスク。期間
  10. タスク。詳細
  11. タスク。リンク
  12. タスク。作成者
  13. タスク。作成時間
  14. タスク。作成時間の形式
  15. タスク。長い形式の作成時間
  16. タスク。カスタムフィールド
  17. タスク。深度 (サブタスクのみ適用)
  18. タスク。期間の種類
  19. タスク。ID文字列
  20. タスク。コメントが追加されました
  21. タスク。フォーラムが関連付けられました
  22. タスク。リカレンスが設定されました
  23. タスク。リマインダーが設定されました
  24. タスク。親タスクです
  25. タスク。最終更新時間
  26. タスク。最終更新時間の形式
  27. タスク。長い形式の最終更新時間
  28. タスク。マイルストーンID
  29. タスク。順序シーケンス
  30. タスク。親タスクID (サブタスクのみ適用)
  31. タスク。親タスクID (サブタスクのみ適用)
  32. タスク。ルートタスクID (サブタスクのみ適用)
  33. タスク。ステータス
  34. タスク。タスクフォロワー
  35. タスク。タスクリスト
  36. タスク。作業
  37. タスク。作業タイプ
  38. タスク。コメント
  39. タスク。サブタスク
  40. タスク。カスタムフィールド
  41. タスク。添付ファイル

問題

  1. 問題。タブ
  2. 問題。長い形式の作成時間
  3. 問題。カスタムフィールド
  4. 問題。ステータス
  5. 問題。再現可能
  6. 問題。リンク
  7. 問題。重症度
  8. 問題。報告者
  9. 問題。件名
  10. 問題。旗
  11. 問題。担当者の名前
  12. 問題。報告者ID
  13. 問題。分類
  14. 問題。作成時間の形式
  15. 問題。完了
  16. 問題。作成時間
  17. 問題。キー
  18. 問題。添付ファイルの数
  19. 問題。バグ番号
  20. 問題。バグプレフィックス
  21. 問題。コメント数
  22. 問題。エスカレーションレベル
  23. 問題。ID文字列
  24. 問題。報告者のメール
  25. 問題。報告者がZユーザーでない
  26. 問題。更新時間
  27. 問題。更新時間の形式
  28. 問題。長い形式の更新時間
  29. 問題。添付ファイル
  30. 問題。コメント
  31. 問題。閲覧回数

マイルストーン

  1. milestone。完了済み
  2. milestone。コメント数
  3. milestone。作成時間
  4. milestone。作成時間フォーマット
  5. milestone。長い作成時間
  6. milestone。終了日
  7. milestone。終了日フォーマット
  8. milestone。長い終了日
  9. milestone。フラグ
  10. milestone。コメントあり
  11. milestone。id
  12. milestone。文字列ID
  13. milestone。作業フィールドを削除
  14. milestone。最終更新時間
  15. milestone。最終更新時間フォーマット
  16. milestone。長い最終更新時間
  17. milestone。リンク
  18. milestone。名前
  19. milestone。所有者ID
  20. milestone。所有者名
  21. milestone。所有者のzpuid
  22. milestone。プロジェクト
  23. milestone。シーケンス
  24. milestone。開始日
  25. milestone。開始日フォーマット
  26. milestone。開始日の長い形式
  27. milestone。ステータス
  28. milestone。ステータス詳細

選択済みファイル

アップロード待ちのファイルは、chosen_filesに保存されます。このキーは、添付ファイルピッカーでのみサポートされます。
  • 選択済みファイル

デプロイメントカテゴリー

現在のデータセンターを取得します。

zohoprojects.get('deployment_type').then(function() {
/* 出力
com
 */
 });
                                                

権限情報

ポータルレベルの全権限と、現在ユーザーの権限詳細を取得するキーをいくつか提供しています。
  1. all_profiles: ポータル内の全権限の情報を取得します。
  2. current_profile: 現在のユーザーの権限詳細を取得します。

テーマ

Zoho プロジェクトはあなたのポータルのためのテーマをサポートしています。
  • current_theme: 現在のテーマを取得します。
zohoprojects.get('current_theme').then(function() {
 /* 出力
{mode: 'default', zpPrimary: '255, 100, 0', zpPrimaryHover: '255, 247, 243'}
 */
 });
                                                

ブループリント中

  • blueprint_during: During操作に設定された値を取得します。
zohoprojects.get('blueprint_during').then(function(res) {
 /* 出力
[ {field_id: 'UDF_CHAR1', is_visible: true, is_pii: false, is_encrypted: false}
{field_id: 'UDF_CHAR2', is_visible: true, is_pii: false, is_encrypted: false}]
 */
});

遷移

現在の遷移の詳細を取得します。
  1. transition: 現在の遷移のIDと名前を取得します。
  2. blueprint : ブループリントのIDと名前を取得します。

セット

特定のタスクや現在の場所の問題の属性を更新します。


var nameObj={name:'新しいチェックリストを作成'};
zohoprojects.set('task',nameObj).then(function(response)
  {
    /* output
   {
   'data': {
   'tasks': [
     {
      'milestone_id': '2*******************2',
       'link': {
       'timesheet': {
          'url': 'https://p*************e.********.com/restapi/ポータル/5******7/プロジェクト/2****************9/タスク/2****************9/logs/'
         },
         'self': {
           'url': 'https://p*************e.********.com/restapi/ポータル/5******7/プロジェクト/2****************9/タスク/2****************9/'
          }
         },
  'description': '',
  'duration': '0',
  'last_updated_time_long': 1542193097398,
   'details': {
   'owners': [
      {
      'name': 'JOHN MARSH',
       'id': '5************3'
       }
      ]
     },
'id': 2************0,
'key': 'WEUT-T1',
'created_person': 'Steve Banks',
'created_time_long': 1525668983347,
'created_time': '05-07-2018',
'is_reminder_set': false,
'is_recurrence_set': false,
'created_time_format': '05-07-2018 10:26:23 AM',
'subtasks': false,
'work': '0:00',
'custom_fields': [
{
'column_name': 'UDF_LONG1',
'label_name': '費用総額',
'value': '24573'
},
{
'column_name': 'UDF_LONG3',
'label_name': 'サンプル',
'value': '0'
},
{
'column_name': 'UDF_LONG2',
'label_name': 'テスト',
'value': '200'
}
],
'isparent': false,
'work_type': 'work_hrs_per_day',
'completed': false,
'priority': 'None',
'created_by': '5******3',
'percent_complete': '0',
'last_updated_time': '11-14-2018',
'name': '新しいチェックリストを作成',
'id_string': '2************9',
'last_updated_time_format': '11-14-2018 04:28:17 PM',
'tasklist': {
'name': '一般',
'id': '2************7'
},
'order_sequence': 1,
'status': {
'name': 'オープン',
'id': '2************1',
'type': 'open',
'color_code': ''
}
}
]
},
'status': '成功'
}
*/
});                                           
以下のキーは、タスクのsetメソッドで使用できます:

タスク

  1. 担当者
  2. オーナーの作業
  3. 作業タイプ
  4. 名前
  5. 開始日
  6. 終了日
  7. 開始時間
  8. 終了時間
  9. 完了率
  10. 期間
  11. 期間タイプ
  12. リマインダー
  13. 優先度
  14. 説明
  15. カスタムフィールド(このキーはカスタム項目の作成にのみ使用できます)
  16. クリア日
  17. インデックス
  18. 範囲
  19. json_string
  20. サブタスク(このキーはサブタスクの作成にのみ使用できます。 ここをクリックしてサブタスクのパラメータを確認してください。)
次のキーは問題を設定するメソッドで使用できます:

問題

  1. 件名
  2. 説明
  3. 担当者
  4. フラグ
  5. 分類ID
  6. マイルストーンID
  7. 期日
  8. モジュールID
  9. 重症度ID
  10. 再現可能ID
  11. ステータスID
  12. 解析
  13. 影響マイルID
次のキーはプロジェクトを更新するメソッドで使用できます:

プロジェクト

  1. 名前
  2. 説明
  3. ステータス
  4. 開始日
  5. 終了日
  6. 厳格なプロジェクト
  7. 公開する
  8. グループID
  9. 完了時
  10. UDF_CHAR([1-9]|[1-2][0-9]|30)。例: UDF_CHAR1
  11. UDF_TEXT([1-9]|10)
  12. UDF_LONG([1-9]|10)
  13. UDF_USER[1-5]
  14. UDF_DOUBLE([1-9]|[1-2][0-9]|30)
  15. UDF_DATE[1-5]
  16. UDF_ENCRYPT([1-9]|10)
  17. 担当者
  18. 課金方法
  19. 請求状況
  20. プロジェクト概要を表示
  21. カスタムステータス
マイルストーンを更新するためにsetメソッドで使用できる次のキー:

マイルストーン

  1. 名前
  2. 開始日
  3. 終了日
  4. 担当者
  5. フラグ
  6. 予算
  7. 閾値
  8. 収益目標
linkfilesキーを使用して、ファイルをあなたの場所に関連付けます。このキーは次の場所をサポートしています: タスク詳細タブIssue詳細タブ添付ファイルピッカータブ。最大サイズ10の配列である必要があり、以下の項目は必須です: id, 名前, 種類, permanent_url, download_url, size, created_by, created_time; preview_urlは画像ファイルに対して必須です。
  • linkfiles

linkfiles=[{
'created_time': 1561028014712,
'id': '1LavBS5sauJ-AAFJZWp8Ch9Cp2ehydahk',
'type': 'image/jpeg',
'created_by': 'Patricia Boyle',
'permanent_url': 'https://***************',
'size': 7409,
'preview_url': 'https://******************',
'name': 'sample-image.jpeg',
'download_url': 'https://drive.google.com/a/web-mailhosting.com/uc?id=1LavBS5sauJ-AAFJZWp8Ch9Cp2ehydahk&エクスポート=ダウンロード',
}]
zohoprojects.set('linkfiles', linkFiles).then(function (response) {
zohoprojects.invoke('attachment_picker.close');
});

Blueprint During

ブループリントの遷移のDuring操作を構成するときに値を設定します。

var sample = [ {field_id: 'UDF_CHAR1', is_visible: true, is_pii: false, is_encrypted: false}
{field_id: 'UDF_CHAR2', is_visible: true, is_pii: false, is_encrypted: false}];
zohoprojects.set('blueprint_during', sample).then(function(res) {
  /* output
[ {field_id: 'UDF_CHAR1', is_visible: true, is_pii: false, is_encrypted: false}
{field_id: 'UDF_CHAR2', is_visible: true, is_pii: false, is_encrypted: false}]
*/
 });                                

エクスポート先

クラウドストレージサービスにあなたのタスクをエクスポートします。「詳細のエクスポート」ポップアップに表示されるデータ項目を最大5つ選択できます。データを表示するにリンクパラメータが追加された場合、選択された場所はアクセスしやすいようにハイパーリンクとして掲載されます。


let paramObj = {
'custom_data': {
'path': 'G/pics',
'portal_id': '89031033',
'project_id': '185977000000199005'
},
'display_data' : [
{
'名前': 'Path',
'値': 'G's Drive',
'リンク': 'https://drive。google。com/drive/フォルダー/1e1xWqREV'
}, {
'名前': 'アプリ名',
'値': 'G- Drive'
}
]
      
zohoprojects。set('実行する', paramObj);

リクエスト

プラグインマニフェスト.jsonファイルで定義された接続を使用して、拡張機能からサードパーティのURLを呼び出します。外部連携のリンク名が指定されていない場合、出力は入力に基づいて提供されます。


var file = document.getElementById('inputbox').files[0];
var file_detail = {
type: 'GET',
files: [{
uploaddoc : file
type : 'binary' //ファイルがバイナリとしてアップロードされた場合
}],
parameters: {
fields: 'id,name, thumbnailLink, webViewLink, webContentLink'
}
};
var url = 'https://www。googleapis。com/drive/v3/files/1-QabBt69U8myXYRDVU-1YiCo2k-JWRfu';
zohoprojects.request(url, file_detail, 'google_drive').then(function (response)
 /* 出力
 { 
'result': {
'webContentLink': 'https://drive。google。com/uc?id=1-QabBt69U8myXYRDVU-1YiCo2k-JWRfu&エクスポートする=ダウンロードする',
'name': 'Eiffel_Tower_01.jpg',
'webViewLink': 'https://drive。google。com/file/d/1-QabBt69U8myXYRDVU-1YiCo2k-JWRfu/表示する?usp=drivesdk',
'id': '1-QabBt69U8myXYRDVU-1YiCo2k-JWRfu',
'thumbnailLink': 'https://lh3。googleusercontent。com/nhyq9mHrGDOZfNdQUHRj_xVlOoNAP5PEYkW4X2svGXKjVt53MvMGfjhQ2PlTv4cmv5-PgbjrR-c=s220'
},
'status': 'success'
}
*/});
引数の名前 データタイプ 説明
URL 文字列 差出人の拡張機能が呼び出す必要があるサードパーティURL。
オブジェクト JSONObject キー データのタイプ バリュー
    種類 string '取得する' / 'POST' / 'PUT' / '削除' / 'PATCH'
    パラメーター JSONObject APIのリクエストパラメーター。
    ヘッダー JSONObject APIのヘッダー。
    本文 JSONObject

APIの本文。

 

    ファイル JSONArray

ファイルをアップロードするためのパラメーター。

値: 実際のファイル。

*実際のファイルがアップロードされると本文は無視されます

*種類をバイナリとして指定すると、ファイルはバイナリとして送信されます。ファイルの本文も考慮されます

    replace_secure_config ブール値

プラグインマニフェストのjsonファイル内のis_secureパラメータが真である場合、このパラメータの値を真に設定します。

この形式でURLとオブジェクトパラメータに値を渡すことができます- {{名前}} //設定の名前

Zoho プロジェクトは設定値を置き換えます
メモ: 初期値は無効です。

connection_link_name 文字列 外部連携のリンク名は、zappsウェブサイトが提供するもので、plugin-manifestから取得できます。

実行する関数

Sigmaでトリガーなしにカスタム関数を実行します。関数のuuidとそのバージョンは、関数を実行するために必須です。
 

let customData = {'名前':'新しいチェックリストを作成'};
zohoprojects.function.実行('c8a9e660-95e2-11ef-9d3c-2d653cc724d7', '1.+10,-10', customData).then(function(response){
/* 出力
{ 'result':{'output':'{}','タスク':[],'outputType':'無効','メッセージ':{}},
'unique_id':'c8a9e660-95e2-11ef-9d3c-2d653cc724d7',
'コード':3009,
'function_id':1234567890,
'メッセージ':'関数が正常に実行されました',
'ステータス':'完了'
}
*/
});

    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









                                  • Related Articles

                                  • CLIを使用して拡張機能を作成する

                                    お知らせ:当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。 はじめに Zoho マーケットプレイスは、Zoho製品のために開発された拡張機能をアップロードできるデジタルプラットフォームです。また、ビジネスに役立つストアの拡張機能も利用できます。この開発者ガイドは、拡張機能のビルドとマーケットプレイスへのデプロイのお手伝いをします。 ...

                                  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.