DataTableコマンド

mabl CLIでのDataTableの管理

mabl CLIでは、ワークスペースからDataTableのリスト表示、クエリ、作成、更新、エクスポートをプログラムで実行できます。

📘

mabl CLIのドキュメント

DataTableコマンドのCLIドキュメントを表示するには、mabl datatables -hまたはmabl datatables --helpを実行します。

mabl datatables list

ワークスペース内のDataTableをリスト表示します。

$ mabl datatables list <optional_arguments>

オプションの引数

オプション詳細
--workspace-id-wDataTableをリスト表示するワークスペースID。デフォルトでは、mabl CLIはmabl config listコマンドの出力に表示されるワークスペースを使用します。
--limit-l返すDataTableの数。デフォルトは10です。
--output-o出力形式を指定します。デフォルトはテーブルです。"yaml"または"json"のいずれかを指定できます。

出力

mabl datatables listコマンドは、DataTableのID、名前、作成日時から成るテーブルを返します。

┌──────────────────────────┬─────────────────────────────────┬─────────────────────────┐
│ ID                       │ Name                            │ Created time            │
├──────────────────────────┼─────────────────────────────────┼─────────────────────────┤
│ <datatable-id>           │ Localization                    │ Oct 29th 2019, 22:06:55 │
├──────────────────────────┼─────────────────────────────────┼─────────────────────────┤
│ <datatable-id>           │ Login check                     │ Mar 19th 2020, 14:15:01 │
├──────────────────────────┼─────────────────────────────────┼─────────────────────────┤
│ <datatable-id>           │ Sample data                     │ Mar 23rd 2020, 17:57:23 │
├──────────────────────────┼─────────────────────────────────┼─────────────────────────┤
│ <datatable-id>           │ Example scenarios               │ Jun 16th 2022, 01:28:37 │
└──────────────────────────┴─────────────────────────────────┴─────────────────────────┘

# List 20 DataTables in the workspace
$ `mabl datatables list --limit 20 `

# List DataTables in yaml format
$ `mabl datatables list --output yaml`

# List five DataTables in json format
$ `mabl datatables list --limit 5 --output json`

mabl datatables describe

DataTable IDで指定した特定のDataTableの詳細情報を表示します。

オプションの引数

オプション詳細
--output, -o出力形式を指定します。デフォルトはyamlです。"yaml"または"json"のいずれかを指定できます。

出力

mabl datatables describeコマンドは、特定のDataTableの詳細情報を返します。これには、ワークスペースID、DataTableの名前、シナリオID、作成日時と作成者、最終更新日時と更新者の情報が含まれます。

id: <datatable_id>
organization_id: <workspace_id>
name: <name of datatable>
scenario_ids:
  - <scenario_id>
  - <scenario_id>
  - <scenario_id>
created_time: 1668189822349
created_by_id: <user_id>
last_updated_time: 1673469977382
last_updated_by_id: <user_id>

# Describe DataTable in JSON format
$ mabl datatables describe <datatable-id> --format json

mabl datatables create

JSONまたはCSVファイルからDataTableを作成します。ファイル入力には、DataTableを作成するのに使用するファイルの相対パスを指定します。

$ mabl datatables create <file-input> <optional_arguments>

オプションの引数

オプション詳細
--workspace-id, -wDataTableを作成するワークスペースID。デフォルトでは、mabl CLIはmabl config listコマンドの出力に表示されるワークスペースを使用します。
--name, --table-name新しく作成するDataTableの名前。名前を指定しない場合、DataTableの名前は指定したファイルと同じ名前になります。
--format, --fmtファイル入力にファイル拡張子がない場合は、入力ファイルの形式として、"json" または "csv" を指定します。

ファイル入力

JSON形式

[
    {
      "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"
        }
      ]
    }
  ]

CSV形式

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

出力

DataTableを作成する場合、mabl CLIは、新しく作成されるDataTableの詳細情報を返します。これには、ワークスペースID、DataTableの名前、シナリオID、作成日時と作成者、および最終更新日時と更新者の情報が含まれます。

id: <datatable_id>
organization_id: <workspace_id>
name: <name of datatable>
scenario_ids:
  - <scenario_id>
  - <scenario_id>
  - <scenario_id>
created_time: 1668189822349
created_by_id: <user_id>
last_updated_time: 1673469977382
last_updated_by_id: <user_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"

mabl datatables update

JSONまたはCSVファイルを使ってmablのDataTableを更新します。ファイル入力には、DataTableを更新するのに使用するファイルの相対パスを指定します。

$ mabl datatables update <datatable-id> <file-input>

オプションの引数

オプション詳細
--workspace-id, -wDataTableを作成するワークスペースID。デフォルトでは、mabl CLIはmabl config listコマンドの出力に表示されるワークスペースを使用します。
--format, --fmtファイル入力にファイル拡張子がない場合は、入力ファイルの形式として、"json" または "csv" を指定します。

# Update a DataTable from a JSON file called test.json
$ mabl datatables update <datatable-id> test.json

# Update a DataTable from a CSV file called test.csv
$ mabl datatables update <datatable-id> test.csv

mabl datatables export

mablのDataTableを指定されたファイル形式でエクスポートします。

$ mabl datatables export <datatable-id> <optional_arguments>

オプションの引数

オプション詳細
--format, --fmtSpecify the format for the datatable export: "yaml", "json", or "csv"

出力

このコマンドを実行すると、DataTableのシナリオとシナリオの値を含むエクスポートされたファイルが出力されます。

# Export a DataTable in json format
$ mabl datatables export <datatable-id> --format json

# Export a DataTable in csv format
$ mabl datatables export <datatable-id> --format csv