Zet-CLIツールを使用して内部ウィジェットまたはWebタブパッケージを作成する - Zoho People

Zet-CLIツールを使用して内部ウィジェットまたはWebタブパッケージを作成する - Zoho People

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

Zoho Extension Toolkit(ZET)は、開発者がZoho Peopleと連携するウィジェットやWebタブ用アプリケーションパッケージを作成するためのコマンド折れ線グラフインターフェースです。

前提条件

  • 次のコマンドを使用してインストールを認証します。

Quote
node -v
npm -v

CLIのインストール

  1. 以下のコマンドを実行してzapps cliノードパッケージをインストールします。
Quote
npm install -g Zoho-extension-toolkit

2. インストールが正常に完了したことを確認するには、次のコマンドを実行します。
Quote
zet
'zet'コマンドのヘルプ情報が表示されます。

プロジェクトの作成

1. 次のコマンドを実行してプロジェクトディレクトリを指定します。
Quote
cd {directory}
例: cd desktop

2. 次のコマンドを実行して新しいプロジェクトを作成します:
Quote
zet init
プロジェクトテンプレートを作成できるZohoサービスの一覧が表示されます。

3. リストからZoho Peopleを選択し、プロジェクト名を入力します。    
指定したディレクトリに、必要な基本ファイルとフォルダ構成を備えたサンプルプロジェクトが表示されます。



Info
プロジェクトテンプレートディレクトリには、初期設定のplugin-manifestファイルが作成済みです。このファイルは拡張機能のJSONパラメーターをホスティング前に設定するために重要です。拡張機能に関するメタデータ(ウィジェットやWebタブの詳細、ロケーション、コネクタなど)が含まれています。plugin-manifestファイルの詳細については、こちらをクリックしてください。

プロジェクトの開発

  1. 作成したプロジェクトフォルダへ移動します。appフォルダ内に、初期設定で 'widget.html' という名前のHTMLファイルが見つかります。
  2. widget.htmlファイルには、ウィジェットやWebタブの構造、デザイン、コンポーネントが含まれています。HTMLファイルからウィジェットやWebタブを作成できます。
  3. 必要に応じて、JavaScriptファイルやスタイルシートを作成し、追加のデザインや機能を加えることでウィジェットやWebタブを拡張できます。(任意)
    Idea
    複数のHTMLファイルを単一のウィジェットまたはWebタブパッケージとしてまとめ、Zoho Peopleの対応インターフェースで利用できます。この機能を有効にするには、plugin-manifest.jsonファイルでロケーション識別子を正しく設定してください。
  4. ウィジェットやWebタブでZoho People APIを利用するには、JS SDKライブラリで提供されているJS SDK APIヘルパーを活用できます。
  5. plugin-manifest.jsonファイルの設定方法については、次のトピックをご参照ください。

plugin-manifest.jsonファイルの設定

  1. プロジェクトフォルダでウィジェットまたはWebタブの開発が完了したら、テキストエディタでplugin-manifest.jsonファイルを開き、ウィジェットまたはWebタブのロケーション識別子を指定します。
  2. ホワイトリストに登録するドメインを追加します。
    Info
    内部ウィジェットやWebタブは、初期設定でZoho Peopleサーバー内からのみアクセスが許可されており、他のすべてのURLはブロックされます。特定のソースからデータを取得する権限を与えるには、アクセスを許可したいURLをホワイトリストに登録してください。
  3. plugin-manifest.jsonファイルを保存します。
Widget 場所 識別子

Zoho People における Widget の位置
場所 識別子
ダッシュボード
people.ダッシュボード
カスタムボタン
people。custombutton
関連リスト
people。form。relatedlist

Web タブ 場所 識別子

Zoho People における Web タブの位置
場所 識別子
ホーム
people.ホーム
サービス
people.サービス
            


単一の郵便番号ファイルで複数のHTMLファイルをサポートするためのPlugin-manifest.jsonファイル設定

  1. {
  2. 'locale': [
  3. 'en'
  4. ],
  5. 'サービス': 'PEOPLE',
  6. 'whiteListedDomains': [],
  7. 'タブ': {
  8. 'widgets': [
  9. {
  10. '場所': 'people.ホーム',
  11. '名前': 'Zoho People Extension',
  12. 'url': '/app/widget。html',
  13. 'ロゴ': ''
  14. },
  15. {
  16. '場所': 'people.ダッシュボード',
  17. '名前': 'Zoho People Extension',
  18. 'url': '/app/時間.html',
  19. 'ロゴ': ''
  20. },
  21. {
  22. '場所': 'people。custombutton',
  23. '名前': 'Zoho People Extension',
  24. 'url': '/app/移動する.html',
  25. 'ロゴ': ''
  26. }
  27. ]
  28. },
  29. 'config': [],
  30. 'connectors': [],
  31. 'cspDomains': {
  32. '接続-src': []
  33. }
  34. }

テスト Widget または Web タブ

  1. 以下のコマンドを使用してプロジェクトディレクトリに移動します:
Quote
cd {プロジェクト directory}
  1. 次のコマンドを実行して、ローカルHTTPサーバーを開始します。これにより、ウィジェットやWebタブをローカルで実行し、テスト環境インスタンスでテストできます:
Quote
zet run
      


3. このコマンドによりローカルサーバーが起動し、拡張機能がローカルで実行されます。
拡張機能はポート5000で実行されます。このコマンドを実行する前に利用可能であることを確認してください。
4. サーバーを認証するには、拡張機能のテスト時に developer 方法を有効にしてください。


認証とパック

  1. 以下のコマンドを使用してプロジェクトディレクトリに移動します。
Quote
cd {プロジェクト directory}
  1. 以下のコマンドを実行してアプリケーションを認証します。
Quote
zet 認証
この操作により、アプリパッケージの認証が行われ、違反があれば表示されます。違反がある場合は、開発者コンソールで郵便番号ファイルを更新する前に修正してください。



3. Zoho People へアップロード可能なウィジェットまたはWebタブの郵便番号を生成するには、次のコマンドを実行します。
Quote
zet pack


     
ウィジェットまたはWebタブの郵便番号ファイルは、プロジェクトディレクトリ内の「dist」フォルダに作成されます。このファイルを使用してZoho Peopleアプリケーションへアップロードしてください。
Info
内部ウィジェットまたはWebタブの郵便番号ファイルを作成したら、Zoho Peopleにアップロードして、ウィジェットやWebタブとして該当するインターフェースで利用できます。
ウィジェットのアップロード方法については、Zoho Peopleでのウィジェットの利用を参照してください。
Webタブのアップロード方法については、Zoho PeopleでのWebタブの利用を参照してください。

注意事項

  1. ウィジェットまたはwebタブ 郵便番号フォルダーには、初期設定でAppフォルダー内にwidget。htmlファイルが格納されています。このファイルがインデックスファイルとなり、ページのウィジェットとして組み込まれます。
  2. Appフォルダー内に新たなフォルダーを作成し、widget。htmlファイルをその新規フォルダーに移動した場合、Zoho Peopleアカウントにウィジェットを追加する際、下記の形式でインデックスファイル名を指定する必要があります。
Quote
/ / .html
  1. ウィジェット 郵便番号フォルダーは、zet packコマンドのみを使用して梱包済みの場合に有効な郵便番号ファイルとして認識されます。他のコマンドでウィジェットファイルをアップロードすると失敗します。
Quote
zet pack

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

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

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

    Zoho CRM Training



              Zoho Campaigns Resources

                Zoho WorkDrive Resources




                  • Desk Community Learning Series


                  • Digest


                  • Functions


                  • Meetups


                  • Kbase


                  • Resources


                  • Glossary


                  • Desk Marketplace


                  • MVP Corner


                  • Word of the Day


                  • Ask the Experts









                                  • Related Articles

                                  • Zoho People Kiosk

                                    Zoho People Kioskとは Zoho People Kioskを使用すると、出退勤情報を就業場所(現場)で管理できます。従業員は、スマートフォンなどのカメラで自身の写真を撮影するだけで、顔認証で出退勤を記録できます。かんたんな設定で、プロジェクト先のオフィスの受付などで使用できます。また、リモートオフィスや倉庫などで働く従業員の出退勤情報の管理にも役立ちます。 Zoho People Kioskの設定 [設定]→[出退勤]→[設定]→[キオスク設定]の順に移動します。 Zoho ...
                                  • Zoho Peopleのウェブタブ

                                    お知らせ:当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。 Zoho PeopleのWebタブでは何をするのでしょうか? Zoho PeopleのWebタブは、外部ウェブサイトまたはZoho CLIとJS SDKを使用して作成したカスタムウェブページ/ウェブアプリをロードするように設計されています。これはZoho ...
                                  • Zoho PeopleのWebhook

                                    Webhookとは この機能を使用すると、特定の処理が実行されたときの、外部アプリへのリアルタイムのデータ転送や通知を自動化できます。ユーザーがZoho Peopleで処理を実行するたびに、指定したURLに通知が送信されることで、遅延なく最新の情報を把握できます。また、 外部アプリと効率的に連携が可能です。 Webhookはユーザー定義の「HTTPコールバック」とも呼ばれ、HTTP ...
                                  • 接続 - Zoho People

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

                                    Zoho PeopleのZoho Invoice連携 Zoho PeopleとZoho Invoiceを連携することで、Zoho Peopleの工数表などのデータを、Zoho Invoiceに同期し、請求書関連の処理をかんたんに行うことができるようになります。 Zoho Invoiceと連携するには ホーム画面から[設定]→[マーケットプレイス]→[Zoho]→[Zoho Finance Suite](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.