はじめに
Google Maps PinboardのAppをインストールしていただきありがとうございます。このガイドは、このAppをご自身のデータと接続するためのサポートを目的として書かれたものです。最初のステップでは、AppのDataFlowがAppstoreから正しくダウンロードされていること、そしてデータがAppで適切に使用される正しいフォーマットであることを確認します。
必要条件
このAppは、Grid Builderという名前のツールを使用して、Appが必要とするスキーマにデータをマップします。Grid Builderにまだ慣れていない場合は、 こちら でGrid Builderのウォークスルーを参照してください。必須ではありませんが、MySQLクエリがどのように機能するかについて実践的な知識もあると便利です。 下の図は、データがDataFlowを通って供給され、その後Google Maps Pinboar Appに出力される順序を示しています。
- DomoのAppstoreからGoogle Maps Pinboard Appを購入した場合は、まずAppのページにある ［Try It］ ボタンを選択して、AppとそのDataFlowをお使いのインスタンスに展開してください。DomoでAppを使用するページに名前を付けるように求められます。
-
DataFlowがインスタンスに適切に展開されていることを再度確認します。確認するには、Domoの左上隅の［データ］ボタンをクリックしてData Centerに移動します（下の画像を参照してください）。
- Data Center画面左側で ［DataFlow］ を選択し、Data Centerの検索バーを使用して「Google Maps Pinboard」を検索します。検索した名前に一致するDataFlowが表示されます。
- 以上のステップに従っても、作成したページ内にAppが見つからない場合や、Data Center内にDataFlowが見つからない場合、テクニカルサポートまでお問い合わせください。サポートへのお問い合わせ方法については、「 ヘルプとサポート 」を参照してください。
ステップ1：データを準備する
Google Maps Pinboardは、マップ上の表示ピンを介して位置データを表示します。つまり、データの各行が位置を表し、対応する列が位置の定量的または定性的なデータを表すフォーマットでデータを取得する必要があります。位置は複数の行に一覧表示することができ、データが実行されると、Appは特定の位置に対するデータを集計します。Appが必要とする位置データの一部は、位置の緯度と経度です。 経度と緯度データがない場合、次の3つの方法のいずれかで取得できます。- ジオコーディングアプリケーションを使用して位置データの経度と緯度を取得します
- データを政府のデータベースにJoinして、おおよその経度と緯度を取得します。これは通常、郵便番号やお住いの国の同等のコードで行われます。
- 位置データの経度と緯度を得るためにサポートが必要な場合、Domoコンサルタントまたはテクニカルサポートにお問い合わせください。サポートへのお問い合わせ方法については、「 ヘルプとサポート 」を参照してください。
日付列とプライマリーグループの列を使用してデータをJoinできるのであれば、複数のDataSetをAppのソースデータとして使用できます。Grid BuilderにどのようにJoinするかについての情報は、このガイドの後のセクションで説明します。Appでは、簡単な計算を行ってメトリクスを計算できます。例えば、上の例のDataSetのように「Sales」列がある場合、各位置に勤務する社員の数を表す列は次のようになります。
SUM（Sales）/AVG（Employees） 、この計算により、社員ごとの売り上げが分かります。ステップ2：DataFlowにソースデータを追加する
データの準備が完了したら、DomoのDataFlowに移動し、AppのDataFlowにデータを入力として追加する必要があります。次のステップに従い、データを追加します。-
確認するには、Domoの左上隅の［データ］ボタンをクリックしてData Centerに移動します（下の画像を参照してください）。
- Data Centerを開いたら、左側の DataFlow アイコンを選択します。Data Centerの検索バーで「Google Maps Pinboard」を検索します。「Google Maps Pinboard」と書かれたDataFlowが表示されているはずです。
- Google Maps Pinboard DataFlowを選択して詳細ビューに進み、ページ右側の鉛筆のアイコンをクリックして、DataFlowを編集します。
- DataSetの右上隅の ［x］ をクリックして、サンプルDataSet「Google Maps Store Sample」を削除します。「Google Maps Pinboard - Grid Builder」と「Google Maps Pinboard - Settings」をDataFlowの入力として保持します。
- ［DataSetを選択］ ボタンをクリックして、DataFlowにDataSetを追加します。
- DataSetを追加したら、ページの下部までスクロールし、 ［保存］ ボタンを選択します。
- DomoのData Centerに戻ります。
ステップ3：Grid Builderを編集する
3番目のステップでは、入力データと一致するようにGrid Builderの適切なフィールドを編集する必要があります。 変更を加えたときに、ウェブブラウザーにプロセス全体でエラーが発生した場合に備えて、作業内容をExcelスプレッドシートにコピーしてすべての変更を追跡することを推奨します。 Grid Builderを編集するには、以下のステップに従ってください。- Appに付属するGrid Builderウェブフォームに進みます。「Google Maps Pinboard - Grid Builder」という名前になります。Data Centerの左側から ［DataSet］ を選択し、「Google Maps Pinboard - Grid Builder」を検索します。DataSetを選択し、詳細ビューで右側にあるスパナアイコンをクリックして、次に ［ウェブフォームを編集］ を選択します。
- このAppは通常、日付フィルターを使用しませんが、フィルターを含めたい場合、「 Grid Builder Walkthrough 」を参照してください。
- FROM列で、最初のDataSetの名前に一致するようにC100行の値を変更します（下の画像例の#1を参照してください）。
- SELECT列で、行の値をDataSetの列名と置き換えます。これで、FROM列に表示されます。最初の5行（C100～C500）が必須フィールドです。最初の行で、位置IDとして使用するデータから列の名前を入力します。位置IDがない場合は、位置名列をここで使用することができます。2行目に、日付がある場合は日付列の名前を入力します。現在の日付を使用する場合は、値を「CURRENT_DATE()」のままにします。3行目には位置名列を使用します。4行目には緯度の列、5行目には経度の列を使用します。以上5つの行は、この順序でなければなりません（下の画像例の#2を参照してください）。
- SELECT列に、メトリクスの追加の定量列およびフィルターの定性列として使用するDataSetの列の名前を入力します。
- AS列では、最初の5行の値は決して変更しないでください。これらは、データがマップされている名前であり、AppのDataFlowが想定している名前です。追加の定量的および定性的メトリクスの情報がある行については、必要に応じて、これらの列をこの列に再入力するか、新しい名前を選択することができます（上の画像例の#3を参照してください）。
- Include列は空白のままにするか、情報を入力した各行に「1」を含める必要があります（上の画像例の#4を参照してください）。
- 追加の表をJoinする場合は、Joinする追加のテーブルに対してこのプロセスを繰り返します。新しいDataSetはそれぞれ、「C」列の100個単位の値の、次の一組に割り当てる必要があります。追加のJoinは通常、「JoinType」にLEFTを使用し、最初のDataSetの日付と位置でJoinします。例えば、Join条件は以下のようになります。C100.Node =
C200.Location AND C100.Date = C200.Date。「JoinType」と「JoinCondition」列の編集とGrid BuilderのJoinの詳細については、「 Grid Builder Walkthrough 」を参照してください（上の画像例の#5を参照してください）。 - DataSetの情報を入力すると、すぐにフィルターの設定が必要になります。フィルターとして使用するGrid Builderの行で、「FilterId」、「FilterName」、「FilterInputType」の3つのフィルター列を更新する必要があります。
- 上から順に、フィルターとして使用される各行に、「FilterId」列の後続の行ごとに1から始まり番号が増えるよう割り当てます。「FilterName」の列でフィルターに名前を付け、「FilterInputType」の列の値に「Multi Select」または「Single Select」のいずれかを選択します（「Multi Select」と「Single Select」フィルタータイプが何をするかの詳細については、「 Grid Builder Walkthrough 」を参照してください）。
- 最後に、ページの上部にある ［保存して次へ］ を選択してDataSetを保存します。
ステップ4：メトリクスフォームを編集する
Appを設定する最後のステップは、メトリクスフォームを編集することです。 以下のステップに従ってメトリクスフォームを編集します。- Data Centerで、メトリクスフォームに移動します。「Google Maps Pinboard - Metrics」という名前になります。
- DataSetを選択し、スパナメニューを選択してウェブフォームを編集します。
- Appで表示させたいメトリクスごとに、フォームの行に記入します。最初の列は「Id」列なので、各メトリクスに1から始まり、前の行に1つずつ増加する1つの番号を割り当てます。
- 「Name」列に、Appで表示するメトリクスの名前を入力します。
- 「Calculation」列に、各メトリクスの計算を入力します。単純な計算しかサポートされていません。単純な合計、平均、最大、最小を使用できます。計算には以下のようなものがあります。「SUM(column)」または「AVG(column)」、単純な単一演算「SUM(columnA)」+「SUM(columnB)」、「SUM(columnA)」* MIN(columnB)」、比率計算「SUM(columnA)/ “SUM(columnB)* 100”」などです。より複雑な計算は、あらかじめGrid Builderで計算しておく必要があります。
- 「DataType」列に「Currency」、「Number」、「Percent」のいずれかを入力します。これにより、Appにメトリクスの表示方法を指示します。
- 「SortHighToLow」列で、メトリクスの棒グラフを最高から最低の順に表示する場合、「true」と入力します。メトリクスの棒グラフを最低から最高の順に表示する場合、「false」と入力します。
- 「UnitOfMeasurement」列に、メトリクスの単位を書き入れるか、行を空白にします（例：「ドル」、「人」、「リファラル」など）。
- 「Description」列で、メトリクスに関する簡単な説明を入力するか、行を空白にします。
ステップ5：検証
Grid Builderとメトリクスフォームを設定したら、Appをチェックしてメトリクスを検証する準備が整います。検証には以下のプロセスを推奨します。- KPIカードを作成してメトリクスをテストします。Appの出力データではなく、ソースデータにもとづいてこれらのカードを作成します。例えば、Appで位置別の売り上げを表示する場合は、位置別の売り上げを表示する棒グラフタイプのカードを作成します。この場合には、KPIカードの日付範囲が、Appで表示されている日付範囲と一致させます。
- KPIカードのデータをAppのデータと比較します。フィルターのオプションと日付範囲がAppとKPIカードで一致していることを確認してください。
- 不一致があれば、Grid BuilderでJoin条件やグループ化を変更する必要があるか確認してください。計算も必ず再チェックしてください。
- 検証する必要があるメトリクスがあれば、この処理を繰り返します。