kintoneで項目を利用した絞り込み条件クエリURLの作成方法

こんにちは、エムザス ITサービス部です。
kintoneは、特定の条件に基づいてレコードを絞り込むためのクエリURLを作成することができます。画面に追加したコンポーネントの値を元にクエリを作成する時など、様々な場面でこの機能を使うことがあると思いますので、ぜひ参考にしてください！

お知らせ①

🌟無料＆登録不要でプラグインのお試しが可能！🌟

kintoneユーザーの皆さん！

エムザスのkintoneプラグインはもう試しましたか？🤔
エムザスでは以下のようなプラグインを開発しています！👇

EMレポ - レコードの内容をPDF / Excelに出力できるプラグイン

EMsheet - kintoneのレコードをExcelのように表示して編集できるプラグイン

EMdocMaker - アプリの関連図や定義書を出力し、アプリの分析ができるプラグイン

       

EMログ - 標準の監査ログでは取得できないアプリの操作ログを取得できるプラグイン

   

 

 

 

 

デモ環境で、ほとんどの機能が今すぐお試しいただけます✨

＼無料 & 登録不要！／

デモ環境で今すぐプラグインを試す！

 

さらに、お客様のドメインで無料で3ヶ月間、すべての機能を試すこともできます！🎉

＼たった1分で申し込み完了！／

3ヶ月無料でフル機能お試しを申し込む！

それでは、本題に入ります！

絞り込み条件クエリURLの基本概念

絞り込み条件とは
特定のフィールドに基づいてレコードを選択する条件のことです。たとえば、特定の担当者やステータスに基づいてレコードをフィルタリングできます。

クエリURLの構造
kintoneのクエリURLは、以下のような形式になります。

https://{サブドメイン}/k/{アプリID}/?query={条件}

必要なフィールドの選定

どのフィールドを使用するかを考慮する際には、以下の点を確認してください。

・どのデータが最も重要か

・絞り込み条件に適したフィールドコードを確認する方法（アプリの設定から確認可能）

コード例の紹介

以下のコードは、kintoneのレコード詳細画面が表示されたときに、「担当者」と「ステータス」のフィールド値を使って絞り込み条件を含むクエリURLを生成する例です。

(function() {
    "use strict";

    // レコード詳細画面の表示イベント
    kintone.events.on('app.record.detail.show', function(event) {
        const record = event.record;

        // フィールドから値を取得
        const assignee = record['担当者'].value; // フィールドコードを指定
        const status = record['ステータス'].value;

        // ベースURLを定義
        const baseUrl = `${location.protocol}//${location.host}/k/${kintone.app.getId()}/`;

        // URLエンコード
        const encodedURL = encodeURIComponent(`担当者="${assignee}" and ステータス="${status}`);


        // クエリ付きURLを作成
        const finalUrl = `${baseUrl}?query=${encodedURL}`;

        // URLを表示
        console.log(finalUrl);
        alert(finalUrl); // アラートで表示
        location.href = finalUrl; //一覧ページに遷移する
        window.open(finalUrl); //新たにウィンドウを開く 
    });
})();

コードの詳細解説

• ベースURLの定義: kintoneのドメインとアプリIDを使って、クエリを追加するための基本的なURLを構築します。
• URLエンコード: encodeURIComponentを用いて、クエリをURLエンコードします。これにより、特殊文字やスペースが含まれていても、安全にURLに組み込むことができます。
• 表示: 生成したURLをコンソールに表示し、アラートで確認、location.hrefを使って一覧ページに遷移し、さらにwindow.openを使って新しいウィンドウを開くことができます。

おわりに

kintoneで絞り込み条件を持つクエリURLを作成することで、特定のレコードに迅速にアクセスできるようになります。この方法を活用して、業務の効率化を図りましょう。
これについてはdeveloper networkにも詳しく書いてありますので確認してみてください。

ブログの一覧ページへ