CLIでのデータテーブルの管理

mabl CLI では、ワークスペースのデータテーブルをプログラムで一覧表示、クエリー、作成、更新、エクスポートできます。この記事では、データテーブルの管理に役立つ mabl CLI コマンドについて説明します。

データテーブルの表示

データテーブルに関する情報を取得するには、次のコマンドを使用してください。

# Get a list of DataTables and their IDs
$ mabl datatables list

# Get DataTable metadata
$ mabl datatables describe {datatable-id}

# List scenario names
$ mabl datatables scenarios {datatable-id}

# Review the DataTable contents locally
$ mabl datatables export {datatable-id}

データテーブルの作成

mabl datatables create を使用して、JSONまたはCSVファイルからデータテーブルを作成します。ファイル入力には、データテーブルの作成に使用するファイルへの相対パスを指定してください。

データテーブルを作成すると、mabl CLIはワークスペースID、データテーブル名、シナリオID、作成日時と作成者、最終更新日時と更新者など、新しいデータテーブルの詳細を返します。

例：

# Create a DataTable from a JSON file 
$ mabl datatables create login_check.json --name "Login check" 

# Create a DataTable from a CSV file and name it "Sample data" 
$ mabl datatables create samples.csv --name "Sample data"

サンプルファイル入力

ファイルの入力はJSONまたはCSV形式である必要があります。

[
    {
      "name": "English",
      "variables": [
        {
          "name": "login",
          "value": "Login"
        },
        {
          "name": "greeting",
          "value": "Welcome back"
        },
        {
          "name": "logout",
          "value": "Logout"
        }
      ]
    },
    {
      "name": "Spanish",
      "variables": [
        {
          "name": "login",
          "value": "Iniciar sesión"
        },
        {
          "name": "greeting",
          "value": "Qué bueno verte de nuevo"
        },
        {
          "name": "logout",
          "value": "Cerrar sesión"
        }
      ]
    }
  ]

Scenario name, login, greeting, logout
English, Login, Welcome back, Logout
Spanish, Iniciar sesión, Qué bueno verte de nuevo, Cerrar sesión

データテーブルの更新

CLIを使用してデータテーブルを更新するには、次のワークフローを使用してください。

1. mabl datatables export を実行して、データテーブルのコピーを取得します。
2. データテーブルのコピーを変更します。
3. 更新されたバージョンをアップロードするには、mabl datatables updateを実行してください。

例：

$ mabl datatables export {datatable-id} --fmt csv

# Modify the exported DataTable

$ mabl datatables update {datatable-id} {path-to-file} --fmt csv

編集ルール

エクスポートされたデータテーブルを変更する際は、以下のルールに注意してください。

• すべてのシナリオは同じ変数を持つ必要があります。 すべてのシナリオは、同じ順序で同じ変数名を列挙する必要があります。1つのシナリオだけに変数を追加または削除することはできません。変更はすべてのシナリオに適用する必要があります。
• 変数名は有効な識別子である必要があります。変数名は文字またはアンダースコアで始まり、文字、数字、アンダースコアのみを含む必要があります。user、web、mailは予約済みの名前であり、使用できません。
• シナリオIDはアップロード時の動作を制御します。 CLIはシナリオIDを使用して、作成、更新、または削除するシナリオを決定します。
  • 既存のIDを持つシナリオは更新されます。
  • IDのないシナリオ（JSONでは省略、またはCSVのシナリオIDセルが空の場合）は、新規として作成されます。
  • 元のデータテーブルに存在していたが、ファイルに含まれていないシナリオは削除されます。
• 削除は元に戻せません。ファイルからシナリオを削除してアップロードすると、即座に削除されます。確認プロンプトやロールバックはありません。

サンプルファイル入力

ファイルの入力はJSONまたはCSVである必要があります。次の例では、スペイン語のシナリオのgreeting値が更新され、新しいフランス語のシナリオが追加されています。

[
    {
      "id": "iOdx6S4kwCdhmQspP9m1dw-vr",
      "name": "English",
      "variables": [
        {
          "name": "login",
          "value": "Login"
        },
        {
          "name": "greeting",
          "value": "Welcome back"
        },
        {
          "name": "logout",
          "value": "Logout"
        }
      ]
    },
    {
      "id": "uEb1EkFEeqHyV5TXctUCRw-vr",
      "name": "Spanish",
      "variables": [
        {
          "name": "login",
          "value": "Iniciar sesión"
        },
        {
          "name": "greeting",
          "value": "Bienvenido de nuevo"
        },
        {
          "name": "logout",
          "value": "Cerrar sesión"
        }
      ]
    },
    {
      "name": "French",
      "variables": [
        {
          "name": "login",
          "value": "Connexion"
        },
        {
          "name": "greeting",
          "value": "Content de vous revoir"
        },
        {
          "name": "logout",
          "value": "Déconnexion"
        }
      ]
    }
  ]

Scenario ID,Scenario name,login,greeting,logout
iOdx6S4kwCdhmQspP9m1dw-vr,English,Login,Welcome back,Logout
uEb1EkFEeqHyV5TXctUCRw-vr,Spanish,Iniciar sesión,Bienvenido de nuevo,Cerrar sesión
,French,Connexion,Content de vous revoir,Déconnexion