TC-Shellコマンドを使用する

このトピックでは、 Tosca Commander のコマンド ライン制御するである TC-Shell で使用できるコマンドの一覧を示します。

開始コマンド

TC-Shellにアクセスする方法、ワークスペースの開始、サインインに関する情報は、 " TC-Shellを起動する" を確認してください。

標準コマンド

TC-Shell - デフォルトコマンド

help or ?

可能なコマンドのリストを提供します。

exit

現在の TC-Shellセッションを閉じます。これは対話型モードにのみ該当します。未保存の変更がある場合、 Tosca Commander は変更を保存するか破棄するかを尋ねます。

save

すべての変更を保存します。

saveAndUnloadAll

この時点までに行われたすべての変更を保存し、使用されていたメモリを解放します。

adminModusOn

管理者モードを有効にします。

adminModusOff

管理者モードを無効にします。

print

現在のオブジェクトに関するすべての既知情報（直接関係のある属性とオブジェクト）を表示します。

set

set <attributeName> = <Value>

属性が変更可能な場合、現在のオブジェクトの属性に指定された値を設定します（つまり、その属性は読み取り専用ではありません。）

代入記号としての「 = 」記号は省略可能です。

get

<attributeName>

現在のオブジェクトの属性値を取得します。

getAllOptions

TC-Shell の設定可能なオプション (see chapter " TC-Shellを起動する") 内の現在の値をすべて表示します。

getBranches

共通レポジトリ内で利用可能なすべてのブランチを表示します。

getOption

<optionName>

指定したオプションの値を表示します。

setOption

<optionName> ["="] <optionValue>

指定されたオプションに指定された値を設定します。この変更は、現在のセッションにのみ適用されます。

代入記号としての「 = 」記号は省略可能です。

saveOptions

オプションの値を永続的に使用するために保存します。（つまり、現在のセッションだけではありません）

setproperty

SetProperty <PropertyName> ["="] <Value>

現在のオブジェクトに個別のカスタマイズされたプロパティを作成します。同じ名前のプロパティが既に存在する場合、システムは値のみを転送します。

代入記号としての「 = 」記号は省略可能です。

settcparam

settcparam <Name of test configuration param> = <Value>

現在のオブジェクトに指定された値でテストコンフィギュレーションパラメータを作成します。

代入記号としての「 = 」記号は省略可能です。

compactworkspace

ワークスペースのローカルレポジトリの未使用ストレージを解放し、これによりパフォーマンスを改善します。

パフォーマンスの改善が見られるのは、ワークスペースに広範なデータベースファイルがある場合だけです。

createdbbackup

createdbbackup "no" <backup directory>

指定したディレクトリにレポジトリのバックアップを作成します。ファイルパスの構成要素間のセパレータとして、ダブルバックスラッシュ「 \\」記号を使用します。例: C:\\Tricentis\\backup\\ backup_repository

スクリプトモードでは、 <backup directory> の後に、バージョン管理履歴をバックアップに含めるかどうかに応じて「はい」または 「いいえ」を追加します。

対話型モードでは、後続のダイアログでバージョン管理履歴をバックアップに含めるかどうかを決めます。

backupFolder

backupFolder "no" <path to the backup directory>

このコマンドは、現在のオブジェクトが ComponentFolder の場合にのみ動作します。

指定したディレクトリに「 ComponentFolderのバックアップ」を作成します。ファイルパスの構成要素間のセパレータとして、ダブルバックスラッシュ「 \\」記号を使用します。例: C:\\Tricentis\\backup\\ backup_folder

スクリプトモードでは、 <path to the backup directory> の前に「はい」または「いいえ」を追加して、 Tricentis Tosca がComponentFolder内のオブジェクトの外部参照を検索するかどうかを決定します。「はい」を追加した場合、つまり外部参照チェックを開始する場合は、外部参照がある場合にバックアッププロセスをキャンセルするかどうかを決定するために、「はい」または「いいえ」を第二のパラメータとして追加してください。

  • 例：外部参照をチェックし、外部参照が見つかった場合はバックアッププロセスをキャンセルします。

    backupFolder "yes" "yes" "C:\\Tricentis\\backup\\backup_folder"

  • 例: 外部参照をチェックし、外部参照が見つかった場合でもバックアッププロセスを続行する。

    backupFolder "yes" "no" "C:\\Tricentis\\backup\\backup_folder"

  • 例: 外部参照をチェックしない

    backupFolder "no" "C:\\Tricentis\\backup\\backup_folder"

インタラクティブモードで、 Tricentis Tosca に、ComponentFolder内のオブジェクトの外部参照を検索させるかどうかを決めます。外部参照がある場合、後続のダイアログで、バックアッププロセスをキャンセルするかどうかを決定します。最後に、後続のダイアログに、バックアップを作成するディレクトリへのパスを指定します。

deleteOldExecutionLogs

deleteOldExecutionLogs

Tricentis File Service (see chapter "Tricentis File Service からファイルを削除します。") から実行ログデータをクリアします。

「 deleteOldExecutionLogs 」タスクでは、以下のいずれかのアクションを実行できます。

  • Tricentis File Service からすべての実行ログデータを削除します。これにより、ログとそのスクリーンショットが削除される。

  • 指定した日数より古い実行ログデータをすべて削除する。

  • ログに添付されているスクリーンショットのみを削除する。すべてのログのスクリーンショット、または指定した日数より古いログのスクリーンショットのみを削除できる。

対話型モードで操作する場合は、以下の手順に従います。

  1. コマンドを入力します。

  2. 次の行で日数を指定します。すべて削除するには、「 -1 」を入力します。

  3. 次の行に、以下のコマンドのいずれかを入力します。

    • True: ログのスクリーンショットを削除します。

    • False ：ログとログのスクリーンショットを削除します。

  4. 次の行に、以下のコマンドのいずれかを入力してください。

    • TRUE ：このワークスペースから除外されているログデータもクリアします。

    • False: このワークスペースに含まれるログデータのみを消去します。

スクリプトモードで作業する場合は、 deleteOldExecutionLogs <number of days OR -1 to delete all> <True/False for screenshots> <True/False for log data that's included in the workspace>

例:

「deleteOldExecutionLogs 100 False True 」は、100日超経過したすべてのログとログのスクリーンショットを削除します。このコマンドは、このワークスペースから除外されたログデータも削除します。

「deleteOldExecutionLogs-1TRUEFalse 」は、ワークスペースに含まれるすべてのログのスクリーンショットを削除します。

disablefileservice

Tricentis File Service を無効にする

Tricentis File Service の無効化時の以下に関する詳細は、こちらをクリックしてください。

  • Tricentis File Service の無効時に起こることを理解してください。

  • ワークスペースを準備する方法

ご注意： Tricentis File Service を無効にした後、すべてをチェックインする必要があります。

migrateFromFileService

Tricentis File Service を無効にした後、欠落しているファイルを移行してください。

Tricentis File Service を無効にし、Toscaがすべてのファイルを移行しない場合でも、後から紛失ファイルを移行することができます。これは、 Tricentis File Service がすでに無効になっている場合でも可能です。

以下の点に留意してください。

modifyコマンドを使用する

TC-Shell オブジェクトのプロパティの値は、modify コマンドで変更できます。「変更」コマンドは Tosca Commander のコンテキストメニューで利用できます。正規表現を使用（UseRegularExpression）することもできます。

Modify Name

説明

オブジェクト名を変更します。

例

[23]='Modify Name'

[24]='Modify Description'

[25]='Modify SynchronizationPolicy'

[26]='Export Subset'

Select Task to execute by number # [1-26,0=none] or by name > 23

Use Regular Expression (yes/no) > n

置換: > <new name>

TCフォルダ:test> <new name>

説明を変更

説明

オブジェクトの説明を変更します。

例

通常式 を使用(yo)> y

次を検索する:> <name>

置換: > <new name>

現在のオブジェクトに関連するコマンドを使用する

TC-Shellには常に現在のオブジェクトがあります。ワークスペースを開いたり、オブジェクトを削除したりすると、プロジェクトオブジェクトが自動的に現在のオブジェクトになります。

他のオブジェクトにジャンプするには、以下のコマンドを使用します。

オブジェクト間を移動するためのTC-Shellコマンド

JumpToProject

プロジェクトオブジェクトが新しい現在のオブジェクトになります。

JumpToNode <NodePath>

各オブジェクトには、オブジェクト名と階層位置を含む NodePath があります。

既定のNodePathによって指定されたオブジェクトにジャンプするには、このコマンドを使用します。

例:

> JumpToNode "/TestCaseFolder/SampleTestCases/

Automated TestCases"

これにより、フォルダが選択され、次の現在のオブジェクトに変換されます。

JumpTo<uniqueQueryString>

<uniqueQueryString> は、正確に 1 つのオブジェクトを返す任意の TQLクエリ文字列です。

特定の名前のテストケースをプロジェクトから検索するために、以下のコマンドを利用してください。

"=>Items:TestCase[Name==\"TC1\"]"

テストステップの値から親のテストステップに切り替える場合：

"->Test Step"

このコマンドを使用すると、検索結果が新しい現在のオブジェクトになります。

ChangeNode <NodePath>

または

cn <NodePath>

JumpToNode とは対照的に、これは相対パスをサポートします。

例：

> cn "TestCases"

> cn "Folder"

プロジェクトルート要素に基づき、 > cn "TestCases" は "/TestCases" フォルダーを現在のオブジェクトに変換し、 > cn "Folder"は​ "/ TestCases /Folder" フォルダーを現在のオブジェクトに変換します。

さらに、「 cn 」を使って上位オブジェクトにアクセスすることもできます。

cn

<queryString> <resultNum> 検索

返された検索結果の間を移動します。

<queryString> は 、TQLクエリ文字列です。

は、結果リスト内のオブジェクトのインデックスです。<resultNum>システムは、 <resultNum> の値で指定されたオブジェクトにジャンプします。現在のオブジェクトを変更したくない場合は、「 0 」を使用します。

オブジェクトをマークし、タスクをドラッグ＆ドロップする

特定の操作（ドロップタスクなど）では、任意の数のオブジェクトを引数として使用できます（たとえば、一連のテストケースを別のフォルダに移動する場合など）。Tosca Commander でこのようなアクションを実行するには、ドラッグ＆ドロップを使用します。

TC-Shellでは、以下のコマンドを使用して、オブジェクトに印を付け、ドロップタスクをアクティブにします。

オブジェクトをマークし、タスクをドロップ

Mark

マークされたオブジェクトのリストに現在のオブジェクトを追加します。

ClearMarked

マークされたオブジェクトのリストを消去します。

DropMarked

現在のオブジェクトとすべてのマークされたオブジェクトの文脈に基づいて、ドロップタスクを実行し、マークされたオブジェクトのリストを消去します。

例:

既存の3つのモジュールに基づいてテストステップを作成します。

> JumpToNode "/ModuleFolder/T car tariff calculator"
> Mark
> JumpToNode "/ModuleFolder/T vehicle data"
> Mark
> JumpToNode "/ModuleFolder/T person data"
> Mark
> JumpToNode "/TestCaseFolder/Tutorial/Automated TestCases/MyTestCase"
> DropMarked

DropMarkedWithCtrl

「 Ctrl 」キーを押しながら「 DropMarked 」アクションを実行します（copy==True）。

タスクを実行する

Tosca Commander で、操作する環境に応じてアクションを呼び出して実行します。選択された要素は、利用可能なオプションを定義します。

TC-Shellでは、こうした文脈に基づく操作をタスクと呼びます。このようなアクションを実行するには、「 task 」コマンドの変数を使用します。

TC-Shellのタスク

コマンド

説明

task

利用可能なすべてのアクションの番号付きリストを表示します。アクションの名前は、 Tosca Commander のコンテキストメニューのエントリに対応しています。

task <taskNum>

番号を使用してアクションを呼び出します。「 task 」コマンドを実行すると、有効な番号のリストが表示されます。

task <taskName>

名前を使用してアクションを呼び出します。「 task 」コマンドを実行すると、有効な名前のリストが表示されます。

例:

>task "Delete"

>task "Create TemplateInstance"

>task「ファイルサービスの自動削除から除外する」

>task 「ファイルサービスの自動削除に含める」

タスクは流れに従って、追加入力（ファイルやディレクトリのパス、文字列の入力、アクションの確認など）を求めます。

インタラクティブモードでは、「プロンプト」（コマンドライン）に必要な情報を入力します。スクリプトモードでは、スクリプトファイルに対応する情報を示してください。

例 1

チェックアウトして、 Modules フォルダからModule ExampleModule を削除してください。

jumpToNode "/Modules"
task "CheckOut"
cn "ExampleModule"
task "CheckOut"
task "Delete"

例2

TestCaseTemplate に TemplateInstance を作成します。

jumpToNode "/TestCaseFolder/SampleTestCases/Generated
TestCases/CheckCarInsur"
task "Create TemplateInstance"
// *** Input to "Create TemplateInstance"-Task
// DataSourcePath including Sheet =
"C:\\Projects\\ToscaTutorial\\BO_TC\\TC_catalog_web.xls\\TC_RS"
// Instantiation Selector =
"The first 10 hits"   
// *** End of Input to "Create TemplateInstance" Task

その他のスクリプトを呼び出す

インタラクティブモードおよびスクリプトモードでは、「 Call 」コマンドを使用してスクリプトファイルにアクセスできます。

TC-Shell呼び出し

呼び出し <scriptPath>

スクリプトファイルへのパスを絶対的に、または要求されたスクリプトに対して相対的に指定することができます。

現在のオブジェクトは、呼び出し時の現在のオブジェクトと変わりません。

オブジェクトを反復処理する

多数のオブジェクトに対して操作を行うには、以下のコマンドを使用します。

TC-Shellのイテレーション

<queryString> CallOnEach <scriptPath> の場合

TQLクエリの結果リストにあるすべてのオブジェクトに対してスクリプトを呼び出します。

この場合、それぞれのオブジェクトがスクリプト呼び出しのための現在のオブジェクトとなります。

<queryString> MarkAllの場合

結果リストのすべてのオブジェクトをマークされたオブジェクトのリストに追加します。

<queryString> TaskOnEach <taskName> の場合

結果リストの各オブジェクトに対してタスクを呼び出します。

この場合、それぞれのオブジェクトがスクリプト呼び出しの現在のオブジェクトとなります。

<queryString> TaskOnAll <taskName> では、

結果リストのすべてのオブジェクトに対して、タスクを一度呼び出してください。これは複数選択可能なタスクだけで可能です。

例:

複数のテストステップを無効にして、その理由を 1 回だけ提供します。

> For "=>Items:Test Step[Name==\"calculatePremium \"]" TaskOnAll "Disable"

> // Disable-Reason for all

> "Module is going to be reorganized"

マルチユーザー環境でTC-Shellを使用する

マルチユーザー環境では、オブジェクトを変更する前にオブジェクトをチェックアウトする必要があります。これを行うには、特定のオブジェクトで「チェックアウト」タスクをアクティブにします。

すべての変更を共通レポジトリにチェックインする場合、レポジトリの最新の状態をローカルワークスペースに転送する場合は、以下のコマンドを使用します。

TC-Shellのマルチユーザー環境

checkinall

ワークスペースからチェックアウトしたすべてのオブジェクトを共通レポジトリにチェックインします。

updateall

ローカルのワークスペースを共通レポジトリの現在の状態に更新します。