ビジュアル関数の作成と利用

ビジュアル関数は、データをロード、結合、変換する1つ以上のQuiverカードで構成されます。Quiver内のビジュアル関数は、Foundry内の基礎となるデータに影響を与えることも、オントロジーの変更を加えることもありません。ビジュアル関数は、Quiver分析内のデータ入力に対して一連の論理的なステップを自動的に適用します。

関数の作成

分析にカードを追加し、関数の論理パス、入力および出力を作成します。ビジュアル化とテーブルカードは関数の一部にはできませんのでご注意ください。

この例では、ティープラントの高品質なバッチの平均カフェインを返すKPIを作成しました。この分析では、特定のプラントオブジェクトと数値パラメーター（高品質バッチにフィルター処理するため）を使用して計算されます。

論理的なステップには、リンクされたオブジェクトのインポート、フィルタリングおよび集約が含まれますが、論理は任意に複雑になることがあります。

画面の左上にある fx アイコンを選択して関数パネルを開き、新しい関数を作成 を選択します。

これにより、関数編集モードが開き、関数パネルに新しい未公開の関数が作成されます。右側のパネルは、関数エディタです。

関数の出力に含まれるグラフ上のカードを選択します。この例では、KPIが含まれる数値メトリックカードです。

画面下部の Set as output をクリックします。

また、右側の関数エディタの出力セクションのドロップダウンを使用して、出力を選択することもできます。

出力を設定すると、分析グラフ内の適格入力が紫色で強調表示されます。これは、ハイライトされたカードを関数の入力として選択できることを意味します。

入力として設定するカードを選択し、それぞれに対して Set as input をクリックします。これらは、関数のユーザーが設定できるようにしたいオブジェクトやメトリックです。

また、右側の関数エディタで Add input をクリックして入力を選択することもできます。

関数に名前と説明を付けます。

関数のプレビュー

プレビューモードを開くには、ヘッダー上部の Preview ボタンをクリックします。

プレビューモードでは、左側のバーで入力値を変更し、左下の関数の出力値にどのような影響があるかを確認できます。

関数の公開

右上の Publish をクリックして関数を公開します。他のユーザーが関数を表示および使用できるようにするために、適切な権限があるフォルダーに公開してください。

関数は使用する準備ができました。

関数の使用

上部のメニューまたは検索バーから Cards タブを選択し、「ビジュアル関数」で始まるカードを検索し、目的の出力タイプ（例：数値の場合は Num ）のものを選択します。

検索バーで Functions タブを選択して、関数が作成された場所に関係なく、アクセス可能なすべての関数を表示します。使用したいものを選択します。

関数がこの分析で作成された場合は、関数パネルの + ボタンを使っても関数を選択できます。

選択すると、カードが分析に追加されます。エディタパネルで関数の入力を設定できます。入力が設定されると、カードは関数の結果を返します。

また、エディタパネルを使用して、関数のバージョンを変更することもできます。カードが常に関数の最新バージョンの結果を返すようにするには、自動更新トグルを有効にしてください。

関数の更新

関数を公開した後、関数にオーナーやエディタのアクセス権を持つユーザーが編集できるようになります。まず、関数のエディタパネルを開く必要があります。

関数が作成された分析にいる場合は、関数パネルを開き、編集したい関数をクリックします。

そうでない場合は、Foundry内の関数ファイルをクリックして関数を直接開きます。次に、上部の Edit ボタンをクリックします。

これにより、関数が作成された分析で関数が開きます。

最後に、ヘッダー上部の関数名の隣にある設定アイコン（）をクリックして、関数エディタパネルを開きます。

右側のエディタパネルで、タイトル、説明、入力、出力の変更を行い、準備ができたら Republish ボタンをクリックします。

これにより、関数の新しいバージョンが保存されます。分析で関数を使用する際に、どのバージョンを適用するか選択できます。以前のバージョンのロジックを調べるには、別のタブで関数を開き（ヘッダー上部の関数名をクリック ）、画面右上のドロップダウンを使用してバージョンを変更します。

関数の共有

関数を公開すると、関数は保存されたフォルダのユーザーの権限を継承します。つまり、このフォルダにアクセスできるユーザーは、この関数を分析で使用できます。

さらに、共有パネルを使用して、関数をユーザーやユーザーグループと共有することもできます。これを行うには、別のタブで関数を開きます（ヘッダー上部の関数名をクリック ）、右上の Share をクリックします。

よくある質問

関数は何個の出力を持つことができますか？

関数は1つの出力しか持つことができません。

関数は何個の入力を持つことができますか？

関数は、必要なだけの入力を持つことができます。

どのような出力タイプがサポートされていますか？

関数は、単一のオブジェクト、オブジェクトセット、時系列、または任意のタイプのメトリックを返すことができます。

テーブルやビジュアル化（カテゴリー化されているかどうかに関わらず）は、関数の出力としてサポートされていません。

ビジュアル関数とコード関数の違いは何ですか？

コード関数は、Quiverの外部でコードリポジトリ内のTypeScriptで記述されます。Quiver分析やWorkshopなどの他のアプリケーションで使用することができます。

ビジュアル関数は、Quiver内でコードを1行も書かずに構築されます。関数にアクセスできるすべてのユーザーがQuiver分析で使用できます。現時点では、Quiverの外部で使用することはできません。