ファイルをアップロードしてウィジェットを作成する

ファイルをアップロードしてウィジェットを作成する

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

このヘルプページは Creator 6 をご利用のユーザー向けです。旧バージョン(Creator 5)をご利用の場合は、こちらをクリックしてください。ご利用中のCreator のバージョンを確認することもできます。
ウィジェットを作成する前に、Command Line Interface(CLI)をインストールしておく必要があります。詳細はこちら

メモ: 内部ホスティングの場合、ウィジェット ZIP ファイルの最大サイズは 10 MB で、ZIP ファイル内に含められるファイル数は 255 個までです。
Creator では、ウィジェットは 2 通りの方法で作成できます。
  1. ウィジェットファイルをアップロードする
  2. Figma ファイルをインポートする

ウィジェットファイルをアップロードする

  1. ターミナルを開きます。
  2. 次のコマンドを実行して新規プロジェクトを作成します。
    $ zet init
  3. Zoho サービスの一覧が表示されます。
  4. 必要なサービスとしてZoho Creatorを選択します。

  5. プロジェクト名を入力します。サンプルプロジェクトが該当のフォルダディレクトリ内に作成されます。
  6. 次のコマンドを実行してプロジェクトフォルダを開きます。
    $ cd {Project_name}

  7. プロジェクトフォルダ内の app フォルダを開きます。


    1. 以下の手順に従って、ウィジェット用のmanifest.jsonファイルを設定できます。

      1. プロジェクト用のフォルダを作成した後、次のコマンドを実行してプロジェクトフォルダを開きます。
        $ cd {Project_name} プロジェクトフォルダ内の App フォルダを開きます。

      2. このフォルダ内で plugin-manifest.json ファイルを探します。

      3. ウィジェットで使用するアプリケーションコンポーネント(アプリケーション、フォーム、レポート)について、名前項目と種類項目を指定してファイルを設定します。

    2. フォルダ内の Widget.html ファイルを探し、その Widget.html ファイルにコードを入力します。widget.html ファイルには、ウィジェットの構造、デザイン、コンポーネントが含まれます。ウィジェット内で Zoho Creator API を使用するには、JS SDK ライブラリで提供されている API ヘルパーを利用できます。

    3. 次のコマンドを実行してアプリケーションを認証します。
      $ zet 認証
    4. これによりアプリパッケージが認証され、違反がないか検証されます。検出された問題は、開発者コンソールで ZIP を更新する前に修正する必要があります。
    5. 次のコマンドを実行してプロジェクトをパッケージ化します。
      $ zet pack

    6. アプリケーションの ZIP ファイルが、プロジェクトディレクトリ内の dist フォルダに作成されます。

    7. ウィジェットを埋め込みたいアプリの設定ページに移動し、Widgets を選択します。
    8. 作成ボタンをクリックします。

    9. 新規 Widget」ペインが表示されます。

    10. ウィジェットの名前を入力します。
    11. Hosting ドロップダウンリストで Internal オプションを選択します。
    12. Widget File 項目で、dist フォルダ内のパッケージ済み ZIP ファイルをアップロードします。
    13. /widget.htmlIndex File 項目に入力します。/widget.html ファイルがインデックスファイル、つまりページに組み込まれるウィジェット本体となるファイルです。
      メモ:
      1. ウィジェット ZIP フォルダには、初期設定で App フォルダ内に widget.html ファイルが含まれています。
      2. App フォルダ内に別のフォルダを作成し、widget.html ファイルをその新しいフォルダに移動した場合は、インデックスファイル名を次の形式で指定する必要があります。
        /<folder-name>/<filename>.html
    14. 作成をクリックします。作成したウィジェットが Widgets ページに追加されます。
    15. このウィジェットは、アプリケーション内のすべてのページに対して、ページビルダー上のドラッグ&ドロップ要素として表示されます。
    外部ホスティング

    上記の手順は、ウィジェットを Creator 内部でホストする(つまり、Creator 上でホストする)場合の手順です。代わりに、ウィジェットを外部でホストし、Creator と連携させることもできます。

    ウィジェットを外部ホスティングする場合の手順は次のとおりです。

    1. アプリケーション設定 ページに移動し、ウィジェット オプションをクリックします。
    2. ウィジェットページで 新規ウィジェット ボタンをクリックします。新規ウィジェットペインが表示されます。

    3. ウィジェットの名前を入力します。
    4. Hosting ドロップダウンリストで External オプションを選択します。
    5. Index File 項目に、外部ホスティングしているウィジェットのインデックスページ URL を入力します。

    6. 作成 をクリックします。作成したウィジェットが ウィジェット ページに追加されます。
    7. このウィジェットは、アプリケーション内のすべてのページのページビルダーで、ドラッグ&ドロップ要素として表示されます。

    Figma ファイルのインポート

    Figma のデザインを Creator のウィジェットに変換できます。開始するには、Figma UI Kit からウィジェットを作成 にアクセスし、このキットの使用方法に関する手順を確認してから、Figma でファイルのデザインを続行します。デザインが確定したら、フレーム URLアクセストークン をコピー&ペーストして、Figma ファイル内のデザインから直接ウィジェットを生成します。手順はこちら
    UI キットでサポートされているコンポーネントの一覧について詳しくは、こちらをクリックしてください。