追加されたテーブルについて

今回追加されたテーブルは「Staff」と「StaffStores」の2つです。

基本的なスタッフの管理は「Staff」テーブルで行い、そのスタッフの所属しているお店を「StaffStores」で閲覧できます。

なお、「StaffStores」は読み取り専用のビューとなっていますが、更新は「Staff」テーブルを通じて実施できます。

Staff テーブル

f:id:sugimomoto:20200522120359p:plain

StaffStores ビュー

f:id:sugimomoto:20200522120405p:plain

Staffテーブルの使い方

それでは実際の使い方を見ていきましょう。

CData Smaregi Excel Add-inをインストールすると、Excelのタブに以下のようにボタンが追加されます。

取得元Smaregiをクリックすると、最初接続設定が表示されるので、認証情報を設定しておきましょう。詳しい設定方法はこちらを参考にしてみてください。

f:id:sugimomoto:20200522120411p:plain

データ選択画面で「Staff」テーブルを選択して、「OK」をクリックすると

f:id:sugimomoto:20200522120416p:plain

以下のようにスマレジ上からスタッフの一覧を取得できます。

f:id:sugimomoto:20200522120422p:plain

Smaregi Excel Add-inのいいところは、この画面から直接スタッフの追加・更新・削除が行えることです。

以下のように最終行にデータを入力していくと、赤文字で表示されるので、必要な値を入力したら「行の挿入」アクションを実行します。これでスタッフの一括登録が可能です。

f:id:sugimomoto:20200522120429p:plain

また、更新可能なカラムを直接書き換えて「行の更新」をクリックすれば、スタッフ情報の一括更新も可能です。ロールやランクを更新する時に便利ですね。同じような形で削除も実施可能です。

f:id:sugimomoto:20200522120436p:plain

StaffStores の使い方

続いてStaffStoresの使い方です。同じようにデータ選択画面から「StaffStoresビュー」を選択することで一覧が取得できます。

f:id:sugimomoto:20200522120442p:plain

StaffStoresビューはIDベースで構成されているので、実際にデータをうまく表示したい場合は、StaffやStoreテーブルと結合して見ると良いでしょう。

f:id:sugimomoto:20200522120448p:plain

なお、StaffStoresはビューなので直接編集することができません。もしデータを更新・追加したい場合は、Staffテーブルに含まれる「StoresAggregate」のカラムに対して実施します。

APIの仕様上、以下のようなJSONを構成して入力する必要があります。StaffIDとStoreIdをそれぞれ任意のIDに書き換えて使用してください。

{
    "table_name": "StaffStore",
    "rows": [
        {
            "staffId": "9",
            "storeId": "1",
            "controlDivision": "0"
        },
        {
            "staffId": "9",
            "storeId": "2",
            "controlDivision": "0"
        },
        {
            "staffId": "9",
            "storeId": "3",
            "controlDivision": "0"
        }
    ]
}

f:id:sugimomoto:20200522120456p:plain