URL に特殊パラメータを追加してシートのレコードを絞り込み・ダウンロードする方法

特殊パラメータ pqv をシート URL に追加することで、シート内のレコードを検索・絞り込みしたり、絞り込んだレコードをダウンロードしたりできます。

以下では、この 2 つの利用方法を説明します。

レコードの検索と絞り込み方法

上部の検索バーでブーリアン演算子を使う方法に加えて、シート URL に特殊パラメータを付けて絞り込み検索を行うこともできます。

例：

シート URL が以下の場合：

`https://www.ragic.com/accountname/tabname/3?PAGEID=wSM`

（?PAGEID=wSM 以降は無視してください）

特殊パラメータを付けた URL は次のようになります。

https://www.ragic.com/accountname/tabname/3?pqv100003=New

1. ? の後に、パラメータ名 pqv を追加します。

2. 絞り込みに使いたいField 番号 を追加します（Field 番号の確認方法はこちらをご参照ください）。

3. Field 番号 の後に = を付け、その後ろに絞り込み条件を入力します。この例では "New" です。フィールド値がテキストの場合、大文字・小文字は区別されます。

この URL にアクセスすると、指定したフィールドの値が "New" であるレコードだけを直接検索できます。

備考：

(1) 絞り込み条件が複数ある場合は、& で区切って追加できます。

(2) 比較演算子（例：<、>、>=）を使いたい場合、たとえば「20 より大きい値のレコード」を絞り込みたい場合には、この方法は利用できません。こうした条件で絞り込む場合は、左側サイドバーをご利用ください。

絞り込みしたレコードをダウンロードする方法

ユーザーが対象レコードに対するアクセス権限を持っている場合、手動でデータをエクスポートすることもできますし、Excel ファイル、CSV ファイル、または印刷向け形式でダウンロードできる URL を利用することもできます。

絞り込みしたレコードをダウンロードするには、URL に特殊パラメータ pqv を追加します。

以下は、各出力形式の URL です。

例：

シートを Excel ファイルとしてダウンロードするには、以下の URL を使用します。

https://www.ragic.com/testaccount/practicetab/1.xlsx

絞り込みしたレコードを出力したい場合は、この URL に特殊パラメータを追加します。

https://www.ragic.com/testaccount/practicetab/1.xlsx?pqv1000105=Taiwan

1. ? より前の部分は、シートを Excel ファイルとして出力するための URL です。

2. ? の後に、パラメータ名 pqv を追加します。

3. 絞り込みに使いたいField ID を追加します（Field ID の確認方法はこちらをご参照ください）。

4. Field ID の後に = を付け、その後ろに絞り込み条件を入力します。この例では "Taiwan" です。フィールド値がテキストの場合、大文字・小文字は区別されます。

備考：

(1) 絞り込み条件が複数ある場合は、& で区切って追加できます。

(2) 比較演算子（例：<、>、>=）を使いたい場合、たとえば「20 より大きい値のレコード」を絞り込みたい場合には、この方法は使えません。その場合は、SYSAdmin が絞り込み条件を共通フィルターとして保存し、その共通フィルターの URLを使って絞り込み済みレコードをダウンロードしてください。

(3) レコードのダウンロードリンクを利用できるのは、そのシートに対してアクセス権限を持つユーザーのみです。アクセス権限がない場合、ダウンロードした Excel ファイルにはデータが含まれません。

アクセス権限のない人にもレコードをダウンロードさせたい場合は、代わりにAPI リンク付き Web 公開をご利用ください。

このリンクにも特殊 pqv パラメータを追加することで、絞り込み済みレコードのダウンロードを可能にできます。