データマネジャー

データマネジャーは強力なデータエンジンであり、サーバー側に要求を送信して、取得したデータをテーブルシートに連結します。

データマネジャーはデータベースから取得したデータを管理（ソート、フィルター、グループ、集計）し、GC.Data.DataManagerクラスを使用してデータをデータベースに同期します。また、addTableメソッドとaddRelationshipメソッドを使用してテーブルやリレーションをマップします。同様に、DataManagerクラスのメソッドを使用することで、テーブルやリレーションを削除することもできます。

データシートに連結するデータソースで、データマネジャーで作成できるデータソースの種類としてはREST API、OData、GraphQL などのリモートソースと、JSON のオブジェクト配列、CSV、XML などのローカルソースがサポートされています。

データソースのスキーマ

データソースを追加してデータテーブルを定義するときにスキーマを指定できます。スキーマには、次のプロパティがあります。

プロパティ	説明
type string	使用するデータ型。'JSON'、'CSV'、'XML'、'columnJson'の一つ。デフォルトは ’JSON’ です。
countPath string	データソースコレクションの長さを取得するために使用されます。
dataPath string	解析後のデータソースコレクションを取得するために使用されます。
columns GC.Data.IColumnCollection	データソーステーブルの列定義。キーは列名で、値はデータ型、dataPattern、およびdataMapを含む列情報です。データ型は"string"、"number"、"boolean"、"null"、"object"、"array"や"date"のいずれかです。これは元の値の実際のデータ型です。日付は JSON データでは文字列であり、変換する必要があるため、とくに便利です。 dataPattern は、文字列を値に変換するための文字列であり、例えば、日付文字列のフォーマッタ "dd/MM/yyyy"、ブール文字列の "truthy" と "falsy" の値ペア "Yes\|No" 、数値文字列の小数点記号 "," などです。 dataMapは、元の値をより意味のある形で表示するためのシンプルなマップです。キーは数値または文字列で、値は数値、文字列、または日付です。

プロパティ

説明

type

string

使用するデータ型。'JSON'、'CSV'、'XML'、'columnJson'の一つ。

デフォルトは ’JSON’ です。

countPath

string

データソースコレクションの長さを取得するために使用されます。

dataPath

string

解析後のデータソースコレクションを取得するために使用されます。

columns

GC.Data.IColumnCollection

データソーステーブルの列定義。

キーは列名で、値はデータ型、dataPattern、およびdataMapを含む列情報です。

データ型は"string"、"number"、"boolean"、"null"、"object"、"array"や"date"のいずれかです。これは元の値の実際のデータ型です。日付は JSON データでは文字列であり、変換する必要があるため、とくに便利です。
dataPattern は、文字列を値に変換するための文字列であり、例えば、日付文字列のフォーマッタ "dd/MM/yyyy"、ブール文字列の "truthy" と "falsy" の値ペア "Yes|No" 、数値文字列の小数点記号 "," などです。
dataMapは、元の値をより意味のある形で表示するためのシンプルなマップです。キーは数値または文字列で、値は数値、文字列、または日付です。

次のサンプルコードは、テーブルシートのデータスキーマを設定する方法を示します。

JavaScript	コードのコピー
var dataManager = spread.dataManager(); var customerTable = dataManager.addTable("customerTable", { remote: { read: { url: apiUrl } }, // データソーススキーマ-ここでは、dataType、dataPattern、dataMapなどを設定します。 schema: { columns: { validFrom: { dataType: "date" }, billToCustomer: { dataMap: { "Tailspin Toys (Head Office)": "Tailspin Toys(HO)", "Wingtip Toys (Head Office)": "Wingtip Toys(HO)" } }, buyingGroup: { dataMap: { "Tailspin Toys": "TT", "Wingtip Toys": "WT" } }, postalCode: { dataType: "number" } } } });

JavaScript

コードのコピー

var dataManager = spread.dataManager();
var customerTable = dataManager.addTable("customerTable", {
    remote: {
        read: {
            url: apiUrl
        }
    },
    // データソーススキーマ-ここでは、dataType、dataPattern、dataMapなどを設定します。
    schema: {
        columns: {
            validFrom: { dataType: "date" },
            billToCustomer: { dataMap: { "Tailspin Toys (Head Office)": "Tailspin Toys(HO)", "Wingtip Toys (Head Office)": "Wingtip Toys(HO)" } },
            buyingGroup: { dataMap: { "Tailspin Toys": "TT", "Wingtip Toys": "WT" } },
            postalCode: { dataType: "number" }
        }
    }
});