注: 以下の翻訳の正確性は検証されていません。AIPを利用して英語版の原文から機械的に翻訳されたものです。
ビジュアル関数を作成して使用する
ビジュアル関数は、データを読み込み、結合し、加工する1個以上の Quiver カードで構成されます。Quiver のビジュアル関数は、Foundry の基盤となるデータに影響を与えたり、オントロジーを変更したりするものではありません。ビジュアル関数は、Quiver 分析内のデータ入力に一連のロジックステップを自動的に適用します。
行および列のアクセス制御（制限付きビュー、オブジェクトセキュリティポリシー、プロパティセキュリティポリシーを含む）は、ビジュアル関数でユーザーが閲覧できるデータを絞り込みます。これらの制御は関数の出力には適用されません。出力はダッシュボードに埋め込んだり、エクスポートしたり、基盤となるデータへのアクセス権がないユーザーと共有したりできます。データが下流に流れても保護を保持するには、これらの制御をマーキングまたは機密情報区分ベースのアクセス制御と組み合わせてください。モデルの全体像については、アクセス制御の伝播を参照してください。
関数を作成する
分析にカードを追加して、関数に含めたい入力と出力を含む、関数のロジックの経路を作成します。可視化カードとテーブルカードは、関数に含めることができません。
この例では、茶のプラントで生産される高品質なバッチの平均カフェイン量を返す KPI を作成しています。分析では、特定のプラントオブジェクトを対象に、数値パラメーターを使用して（高品質なバッチに絞り込んで）これを計算します。
ロジックステップには、リンクされたオブジェクトのインポート、絞り込み、集計が含まれますが、ロジックの複雑さに制限はありません。
画面の左上にある fx アイコンを選択して関数パネルを開き、関数を新規作成を選択します。
これにより、関数の編集モードが開き、関数パネルに新しい未公開の関数が作成されます。右側のパネルが関数エディターです。
グラフ上で、関数の出力を含むカードを選択します。この例では、KPI を含む数値メトリックカードです。
画面下部の出力として設定をクリックします。
または、右側の関数エディターの出力セクションにあるドロップダウンを使用して、出力を選択することもできます。
出力を設定すると、分析グラフ内の入力として使用できるカードが紫色で強調表示されます。強調表示されたカードは、いずれも関数の入力として選択できます。
入力として設定するカードを選択し、それぞれで入力として設定をクリックします。これらは、関数を使用するユーザーが設定できるようにしたいオブジェクトまたはメトリクスです。
または、右側の関数エディターで入力を追加をクリックして、入力を選択することもできます。
関数に名前と説明を付けます。
関数をプレビューする
プレビューモードを開くには、上部のヘッダーにあるプレビューボタンをクリックします。
プレビューモードでは、左側のサイドバーで入力値を変更し、その変更が関数の出力値にどのような影響を与えるかを左下で確認できます。
関数を公開する
右上の公開をクリックして関数を公開します。ほかのユーザーが関数を閲覧して使用できるように、適切な権限が設定されたフォルダーで公開してください。
これで関数を使用できるようになります。
関数を使用する
上部のメニューまたは検索バーからカードタブを選択し、名前が「ビジュアル関数」で始まるカードを検索して、目的の出力タイプのカードを選択します（たとえば、数値の場合は数値）。
検索バーで Quiver 関数タブを選択すると、関数が作成された場所に関係なく、アクセスできるすべてのビジュアル関数が表示されます。使用する関数を選択します。
検索バーのコード関数タブを使用して、オブジェクトセット、カテゴリカルプロット、値、または時系列を返すコード関数を検索し、追加することもできます。
この分析で作成された関数であれば、関数パネルにある関数の + ボタンを使用することもできます。
関数を選択すると、分析にカードが追加されます。エディターパネルで関数の入力を設定できます。入力を設定すると、カードが関数の結果を返します。
エディターパネルを使用して、関数のバージョンを変更することもできます。カードが常に最新バージョンの関数の結果を返すようにするには、自動更新トグルを有効にしてください。
関数を更新する
関数を公開すると、その関数に対する所有者または編集者のアクセス権を持つユーザーが編集できるようになります。まず、関数のエディターパネルを開く必要があります。
関数を作成した分析を開いている場合は、関数パネルを開き、編集する関数をクリックします。
そうでない場合は、Foundry で関数のファイルをクリックして、関数を直接開くことができます。次に、上部の編集ボタンをクリックします。
これにより、関数を作成した分析でその関数が開きます。
最後に、上部のヘッダーにある関数名の横の設定アイコン（
）をクリックして、関数エディターパネルを開きます。
右側のエディターパネルで、タイトル、説明、入力、出力に必要な変更を加えます。準備ができたら、再公開ボタンをクリックします。
これにより、関数の新しいバージョンが保存されます。分析で関数を使用する際には、適用するバージョンを選択できます。関数を別のタブで開き（上部のヘッダーにある関数名をクリックします 
）、画面右上のドロップダウンメニューでバージョンを変更すると、以前のバージョンのロジックを確認できます。
関数を共有する
関数を公開すると、保存先のフォルダーに対するユーザーの権限が関数に継承されます。つまり、このフォルダーにアクセスできるユーザーは、分析でこの関数を使用できます。
また、共有パネルを使用して、ユーザーやユーザーグループに関数を追加で共有できます。共有するには、関数を別のタブで開き（上部のヘッダーにある関数名をクリックします ）、右上の共有をクリックします。
FAQ
関数には出力をいくつ設定できますか？
関数には出力を1個だけ設定できます。
関数には入力をいくつ設定できますか？
関数には必要な数だけ入力を設定できます。
どのような出力タイプに対応していますか？
関数は、単一のオブジェクト、オブジェクトセット、時系列、または任意の種類のメトリクスを返すことができます。
テーブルおよび可視化（カテゴリカルかどうかに関係なく）は、関数の出力として利用できません。
ビジュアル関数とコード関数の違いは何ですか？
コード関数は、Quiver の外部にあるコードリポジトリで、コード (TypeScript) を使って記述します。Quiver の分析や、Workshop などのほかのアプリケーションで使用できます。
Quiver では、コードを書かずにビジュアル関数を作成できます。ビジュアル関数にアクセスできるユーザーは誰でも、Quiver の分析でその関数を使用できますが、Quiver の外部では使用できません。