CLIツールを使用して保存した発行物をダウンロードする
CLIツールを使用して、Varicent Incentivesデータベースに保存されている発行物をダウンロードします。
リリースに付属の圧縮フォルダーから、IBM ICMコマンドライン・ツールを抽出する必要があります。
コマンド・プロンプトを開きます。
インポート・ツールが保存されているディレクトリに移動します。
コマンドラインで、次のコマンドを入力します。
"IBM Incentives Command Line Tool.exe" --host "<ICM address>" --username "<ICM login name>" --password "<ICM login password>" --model "<name of model>" --function "downloadpublication" --filename "<file path>"
ここで、
filename
は、発行物の保存先です。ファイル名がすでに存在する場合は、新しくダウンロードしたファイルによって上書きされます。これらのオプションパラメーターを使用して、ダウンロードする発行物のタイプを変更できます。
パラメーター
説明
limit
ダウンロードするファイルの最大数。デフォルトでは、すべてのファイルがダウンロードされます。この例では、制限を1に設定して、最新の発行物をダウンロードします。
"IBM Incentives Command Line Tool.exe" --host "https://spm.ibmcloud.com" --username user1@varicent.com --password "aStr0ngP@ssw0rd" --model "mymodel" --function "downloadpublication" --filename "C:\publish.zip" --limit 1
startdate
この日付以降に発行されたすべてのファイルをダウンロードします。
yyyy-mm-dd
形式にする必要があります"IBM Incentives Command Line Tool.exe" --host "https://spm.ibmcloud.com" --username "user1@varicent.com" --password "aStr0ngP@ssw0rd" --model "mymodel" --function "downloadpublication" --filename "C:\publish.zip" --startdate "2016-07-26"
starttime
この時点で発行されているすべてのファイルをダウンロードします。
startdate
パラメーターとともに使用する必要があります。hh:mm:ss.zzz
形式にする必要があります"IBM Incentives Command Line Tool.exe" --host "https://spm.ibmcloud.com" --username "user1@varicent.com" --password "aStr0ngP@ssw0rd" --model "mymodel" --function "downloadpublication" --filename "C:\publish.zip" --startdate "2016-07-26" --starttime "14:54:33.934"
prefix
この文字列で始まるすべてのファイルをダウンロードします。プレフィックスは、管理者クライアントで保存した発行物を作成するときに追加されます。この例は、ファイル名が「calc1」で始まる最新の発行物をダウンロードします。
"IBM Incentives Command Line Tool.exe" --host "https://spm.ibmcloud.com" --username "user1@varicent.com" --password "aStr0ngP@ssw0rd" --model "mymodel" --function "downloadpublication" --filename "C:\publish.zip" --limit 1 --prefix "calc1"
sortasc
最も古いファイルを最初にダウンロードします。デフォルトでは、発行物は最新のものから順に並べ替えられます。この例は、制限を1に設定し昇順に並べ替えることで、最も古い保存済み発行物をダウンロードします。
"IBM Incentives Command Line Tool.exe" --host "https://spm.ibmcloud.com" --username "user1@varicent.com" --password "aStr0ngP@ssw0rd" --model "mymodel" --function "downloadpublication" --filename "C:\publish.zip" --limit 1 --sortasc
重要
名前のスペースに関連するエラーを防ぐために、パラメーター
"<name>"
を引用符で囲んでください。管理者クライアントのパスワードを更新するたびに、コマンドでパスワードを更新する必要があります。
ツールが正常に実行されると、終了コード0が返されます。失敗した場合、ツールはゼロ以外の終了コードを返します。エラーが発生した場合は、ダウンロード・コマンドを再実行し、ファイル名が存在する場合は新しいダウンロード・ファイルに置き換えることができます。