折れ線グラフの作成

折れ線グラフには、データ・グループ内のデータが表示されます。これらのデータは、線で接続された一定の間隔でプロットすることができます。 折れ線グラフの視覚化を使用して、時間の経過に伴う傾向を表示したり、複数のデータ・セットを比較したりすることができます。

このタスクについて

折れ線グラフの構造は以下のとおりです。
「折れ線グラフ」カードの例
カードのタイトル
カードに割り当てられている固有のラベルまたは見出し。
カードのツールチップ
ツールチップには、カードに表示されるデータに関する追加の詳細が示されます。
閾値
グラフ上の有意値またはそれより下の有意値の線。
Y 軸のタイトル
グラフの垂直軸に割り当てられているラベル。
X 軸のタイトル
グラフの横軸に割り当てられているラベル。
凡例
データ・グループのラベル。
フッター・リンク
クリック可能なフィールドまたはリンク (ラベル付き)。 例えば、View all です。
カード・ビルダー を使用して、折れ線グラフを作成できます。

手順

  1. ナビゲーション・メニューから、 「カード・ビルダー」をクリックします。
  2. 「新規カード」をクリックします。

「一般」 タブで、カードを定義します。

  1. カードに名前を割り当てます。
    カードは、カード・ライブラリー内でその名前によって参照されます。
  2. カード・タイプを選択します。
    カードのタイプとして Chart を選択し、バリアントとして Line を選択します。

「データ」 タブで、カードにデータを追加します。

  1. データを取得するための GraphQL 照会を追加します。
    「追加」 をクリックし、 のような照会を作成します。 詳しくは、 カードへの照会の追加を参照してください。
  2. 照会で使用する変数を定義します。
    「クエリー変数」 フィールドで、 のコードに似た形式を使用して、JSON 形式で変数を定義します。
  3. 照会を実行します。
  4. で返されるデータと同様に、照会に対してデータが返されることを確認します。
  5. 「変換」 タブで、折れ線グラフ上の視覚化のためにデータを変換するコードを追加します。
    のようなコードを使用するか、デフォルト変換を使用します。
  6. 「完了」をクリックします。
    照会によって返されたデータがグラフに表示されます。
  7. 折れ線グラフのデータ・グループを構成します。
    この例では、データ・グループ orderLineChartが使用可能です。 グラフに線として表示するデータグループを選択します。
  8. オプション: ラベルと色をオーバーライドします。

「スタイル」 タブで、カードのスタイルを定義します。

  1. 「ディメンション」で、カードの幅と高さを大きくします。
  2. 「軸」で、X 軸のスケールと使用するラベルを設定します。 X 軸のしきい値を設定できます。
  3. 「軸」で、Y 軸のスケールと使用するラベルを設定します。 Y 軸のしきい値を設定できます。
  4. 「中央」に、大きい数値を説明するテキスト・ラベルを追加します。
  5. 「凡例」で、凡例をオンにし、UI 上での位置を設定します。
  6. 「動作」で、凡例およびツールチップとの対話の動作を構成します。
  7. 「フッター」 を展開し、 「フッター・リンク」 をオンに設定してラベルを割り当て、ページ ID を入力します。

    フィールドにページ ID を追加することも、ライブラリーからページを選択することもできます。 ページを選択するには、 「Select from libaray」をクリックします。 あるいは、フッターに外部リンクを追加することもできます。 クリックすると、このリンクが新しいタブで開きます。

    注: 一部のページには、以下のフラグが立てられています。This page requires context.警告。 つまり、これらのページでは、コンテンツをページ上で正しくレンダリングするためにコンテキスト変数が必要ですが、これらの変数がページ・コンテキストで欠落しています。 ページ・コンテキスト変数を追加するには、 ページ・コンテキスト変数の構成を参照してください。

    ページを選択した後、テンプレート変数を追加してページ・コンテンツを動的にすることができます。 つまり、変数に従ってカスタマイズされたコンテンツを使用して、同じページを複数回使用できます。

  8. 「保存」をクリックします。

以下の照会は、計画された出荷日ごとのオーダーの合計数量を取得します。 照会に tenantId 変数が含まれています。
query orders($tenantId: String) {
  orderLineChart: businessObjects(
    simpleFilter: {tenantId: $tenantId, type: Order}
    hint: {viewId: "orderflow"}
    cursorParams: {first: 10, sort: {fieldPath: "plannedShipDate", order: ASC}}
    aggregationParams: {dimension: {fieldPath: "plannedShipDate", type: STRING}, reduce: {expression: {fieldPath: "quantity", operator: SUM, type: INT}, output: {resultAlias: "buyers", type: INT}}}
  ) {
    totalCount
    pageInfo {
      endCursor
      hasNextPage
    }
    edges {
      object {
        id
        ... on Order {
          buyer {
            id
            name
          }
          quantity
          plannedShipDate
        }
      }
    }
    aggregationResultsTotalCount
    aggregationResults {
      dimensionValues {
        name
        value
      }
      values {
        name
        value
      }
    }
  }
}
以下のコードは、照会で使用する変数を定義する方法の例です。
{
  "tenantId": "{{ tenantId }}"
}

以下のコードは、照会によって返されるデータの例です。 この例では、計画された出荷日ごとにオーダーの合計数が返されます。
{
  "data": {
    "orderLineChart": {
      "totalCount": 214,
      "pageInfo": {
        "endCursor": "ZGJmMTRhMzItYTk4OS00YzI1LTkzYTItNDM2MjZmOWI5OTdj",
        "hasNextPage": true,
        "__typename": "PageInfo"
      },
      "edges": [
        {
          "object": {
            "id": "edf9bcbf-7338-4f71-a4af-6b5dfc39b852",
            "buyer": {
              "id": "74cd668c-6a8a-42da-87d7-d7df9b1bcb62",
              "name": "LightTree",
              "__typename": "Organization"
            },
            "quantity": 124,
            "plannedShipDate": "2021-06-23T00:00:00.000Z",
            "__typename": "Order"
          },
          "__typename": "BusinessObjectEdge"
        },
        {
          "object": {
            "id": "e41ee68a-e8b7-4da6-a6df-e5588224a037",
            "buyer": {
              "id": "74cd668c-6a8a-42da-87d7-d7df9b1bcb62",
              "name": "LightTree",
              "__typename": "Organization"
            },
            "quantity": 320,
            "plannedShipDate": "2021-06-23T00:00:00.000Z",
            "__typename": "Order"
          },
          "__typename": "BusinessObjectEdge"
        },
        {
          "object": {
            "id": "e255eb2a-ecd9-4bb0-8bbc-497926bf0afb",
            "buyer": {
              "id": "74cd668c-6a8a-42da-87d7-d7df9b1bcb62",
              "name": "LightTree",
              "__typename": "Organization"
            },
            "quantity": 512,
            "plannedShipDate": "2021-06-23T00:00:00.000Z",
            "__typename": "Order"
          },
          "__typename": "BusinessObjectEdge"
        },
        {
          "object": {
            "id": "dca11046-74ae-4fab-b1d8-a83aee2b9a90",
            "buyer": {
              "id": "74cd668c-6a8a-42da-87d7-d7df9b1bcb62",
              "name": null,
              "__typename": "Organization"
            },
            "quantity": 512,
            "plannedShipDate": "2021-06-23T00:00:00.000Z",
            "__typename": "Order"
          },
          "__typename": "BusinessObjectEdge"
        },
        {
          "object": {
            "id": "dbf14a32-a989-4c25-93a2-43626f9b997c",
            "buyer": {
              "id": "74cd668c-6a8a-42da-87d7-d7df9b1bcb62",
              "name": "LightTree",
              "__typename": "Organization"
            },
            "quantity": 512,
            "plannedShipDate": "2021-06-23T00:00:00.000Z",
            "__typename": "Order"
          },
          "__typename": "BusinessObjectEdge"
        }
      ],
      "aggregationResultsTotalCount": 10,
      "aggregationResults": [
        {
          "dimensionValues": [
            {
              "name": "plannedShipDate",
              "value": "2021-06-23T00:00:00.000Z",
              "__typename": "NameValuePair"
            }
          ],
          "values": [
            {
              "name": "buyers.sum",
              "value": "24940.0",
              "__typename": "NameValueNumValuePair"
            }
          ],
          "__typename": "AggregationResult"
        },
        {
          "dimensionValues": [
            {
              "name": "plannedShipDate",
              "value": "2021-07-15T00:00:00.000Z",
              "__typename": "NameValuePair"
            }
          ],
          "values": [
            {
              "name": "buyers.sum",
              "value": "1113.0",
              "__typename": "NameValueNumValuePair"
            }
          ],
          "__typename": "AggregationResult"
        },
        {
          "dimensionValues": [
            {
              "name": "plannedShipDate",
              "value": "2021-07-06T00:00:00.000Z",
              "__typename": "NameValuePair"
            }
          ],
          "values": [
            {
              "name": "buyers.sum",
              "value": "1350.0",
              "__typename": "NameValueNumValuePair"
            }
          ],
          "__typename": "AggregationResult"
        },
        {
          "dimensionValues": [
            {
              "name": "plannedShipDate",
              "value": "2021-07-22T00:00:00.000Z",
              "__typename": "NameValuePair"
            }
          ],
          "values": [
            {
              "name": "buyers.sum",
              "value": "484.0",
              "__typename": "NameValueNumValuePair"
            }
          ],
          "__typename": "AggregationResult"
        },
        {
          "dimensionValues": [
            {
              "name": "plannedShipDate",
              "value": "2021-08-06T00:00:00.000Z",
              "__typename": "NameValuePair"
            }
          ],
          "values": [
            {
              "name": "buyers.sum",
              "value": "2478.0",
              "__typename": "NameValueNumValuePair"
            }
          ],
          "__typename": "AggregationResult"
        },
        {
          "dimensionValues": [
            {
              "name": "plannedShipDate",
              "value": "2021-07-24T00:00:00.000Z",
              "__typename": "NameValuePair"
            }
          ],
          "values": [
            {
              "name": "buyers.sum",
              "value": "176.0",
              "__typename": "NameValueNumValuePair"
            }
          ],
          "__typename": "AggregationResult"
        },
        {
          "dimensionValues": [
            {
              "name": "plannedShipDate",
              "value": "2021-08-10T00:00:00.000Z",
              "__typename": "NameValuePair"
            }
          ],
          "values": [
            {
              "name": "buyers.sum",
              "value": "1907.0",
              "__typename": "NameValueNumValuePair"
            }
          ],
          "__typename": "AggregationResult"
        },
        {
          "dimensionValues": [
            {
              "name": "plannedShipDate",
              "value": "2021-08-11T00:00:00.000Z",
              "__typename": "NameValuePair"
            }
          ],
          "values": [
            {
              "name": "buyers.sum",
              "value": "1495.0",
              "__typename": "NameValueNumValuePair"
            }
          ],
          "__typename": "AggregationResult"
        },
        {
          "dimensionValues": [
            {
              "name": "plannedShipDate",
              "value": "2021-06-25T00:00:00.000Z",
              "__typename": "NameValuePair"
            }
          ],
          "values": [
            {
              "name": "buyers.sum",
              "value": "956.0",
              "__typename": "NameValueNumValuePair"
            }
          ],
          "__typename": "AggregationResult"
        },
        {
          "dimensionValues": [
            {
              "name": "plannedShipDate",
              "value": "2021-06-30T00:00:00.000Z",
              "__typename": "NameValuePair"
            }
          ],
          "values": [
            {
              "name": "buyers.sum",
              "value": "732.0",
              "__typename": "NameValueNumValuePair"
            }
          ],
          "__typename": "AggregationResult"
        }
      ],
      "__typename": "BusinessObjectsCursor"
    }
  },
  "loading": false,
  "networkStatus": 7
}

以下のコードでは、 COMMON.SHIPMENT_STATUS.ON_TIME がグループとして追加されています。 オンタイム出荷は、合計出荷数から遅延出荷数を減算することにより、変換で計算されます。



{
	"errors": "{{ #? this.errors }}",
	"totalCount": "{{ this.data.orderLineChart.aggregationResultsTotalCount }}",
	"pageInfo": "{}",
	"results": {
		"{{ #each this.data.orderLineChart.aggregationResults }}": {
			"group": "orderLineChart",
			"x-axis-key": "{{new Date(this.dimensionValues[0].value).toDateString()}}",
			"y-axis-key": "{{this.values[0].value}}",
			"tooltipsConfig": {
				"name": "{{this.dimensionValues[0].name}}"
			}
		}
	}
}

変換では、グラフの各軸に表示されるデータは、照会によって返されるデータと一致する必要があります。 この属性は、「データ・グループ」セクションで選択します。 返されるデータに対して計算を行うことができます。 この例では、照会が返すグループに orderLineChart が追加されます。

次のタスク

ダッシュボード・ビルダーを使用して、ダッシュボードにカードを追加します。