PowerShellからBizRobo!のシナリオをREST API経由で起動させる。
この記事について
当記事はPowerShellよりBizRobo!マネージメントコンソールにあるシナリオをREST API経由で起動させる方法を解説しています。
検証に使ったバージョン
- PowerShell:5.1.18362.628
- BizRobo!:10.3.0.4 260
動かすシナリオ
実行時パラメータがなく、値を返すだけのシンプルなシナリオです。値はタイプで宣言した変数を二度返却しています。
DesginStudio上でのデバッグの実行結果は以下の通りです。
REST APIの呼び出し
呼び出しURLの取得
シナリオをマネージメントコンソールにアップロードし、呼び出し用のURLを取得します。手順は以下の通りです。
- マネージメントコンソールにログインをする
- 「Repository」タグにアクセスする
- 「Robots」タブにアクセスする
- シナリオ一覧が出力されるので対象ロボットの「REST」列にある鎖をクリックする
- ウインドウが開くので、URL(赤い下線)をコピーする
ユーザ認証
最初にマネージメントコンソールにログインするためのユーザとパスワードを変数に保存します。
PowerShellを起動して、以下のコマンドを実行してください。
$User = "USER_ID"
$Pass = "PASSWORD"
$Secpswd = ConvertTo-SecureString $Pass -AsPlainText -Force
$Cred = New-Object System.Management.Automation.PSCredential($User, $Secpswd)
「USER_ID」と「PASSWORD」はお使いの環境に合わせて変更してください。
これで"Cred"という変数に認証情報が保存されました。
呼び出し
次にPowerShellからREST APIを叩き、シナリオを起動します。PowerShellで以下のコマンドを実行してREST APIを叩きます。
$Response = Invoke-WebRequest http://YOUR_URL -Credential $Cred
「YOUR_URL」の部分は上記でコピーしたURLをお使いください。
シナリオが実行されたので、REST APIから渡された結果を確認します。
$Response.Content
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<rest-result executionTime="1084">
<values>
<value typeName="Test_return_value">
<attribute type="text" name="Value2_String">aaaa</attribute>
<attribute type="integer" name="Value1_Int">33</attribute>
</value>
<value typeName="Test_return_value">
<attribute type="text" name="Value2_String">bbbb</attribute>
<attribute type="integer" name="Value1_Int">22</attribute>
</value>
</values>
</rest-result>
シナリオで返却した二つの値がXML形式で渡されているのが確認できます。
各メソッド
先ほどの方法だとGETメソッドでの呼び出しになるので、その他のメソッド試してみます。
POST
POSTメソッドで呼び出すために、PowerShellで以下のコマンドを実行します。「YOUR_URL」の部分は上記でコピーしたURLをお使いください。
$Body = "{`"parameters`":[]}"
$Response = Invoke-WebRequest http://YOUR_URL -Credential $Cred -Method 'POST' -ContentType "application/json" -Body $Body
$Response.Content
<rest-result executionTime="1040">
<values>
<value typeName="Test_return_value">
<attribute type="text" name="Value2_String">aaaa</attribute>
<attribute type="integer" name="Value1_Int">33</attribute>
</value>
<value typeName="Test_return_value">
<attribute type="text" name="Value2_String">bbbb</attribute>
<attribute type="integer" name="Value1_Int">22</attribute>
</value>
</values>
</rest-result>
GETと同様にXMLで値が渡されているのが確認できます。
PUT
PUTメソッドも試してみます。
$Response = Invoke-WebRequest http://YOUR_URL -Credential $Cred -Method 'PUT' -ContentType "application/json" -Body $Body
Invoke-WebRequest : Kapow
Version 10.3.0.4
An unexpected error occurred
The request could not be processed
Contact your administrator for further information.
発生場所 行:1 文字:13
+ $Response = Invoke-WebRequest http://YOUR_URL ...
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+ CategoryInfo : InvalidOperation: (System.Net.HttpWebRequest:HttpWebRequest) [Invoke-WebRequest]、WebExce
ption
+ FullyQualifiedErrorId : WebCmdletWebResponseException,Microsoft.PowerShell.Commands.InvokeWebRequestCommand
PUTメソッドは対応していないため、マネージメントコンソールよりエラーが帰ってくるのが確認できます。
最後に
PowerShellから簡単にシナリオを呼び出せることが確認できました。
PowerShellからシナリオが起動できると、ちょっとシナリオを動かしたい時や、パソコンが起動してる間だけ定期的にシナリオを実行することが出来るようになります。
Author And Source
この問題について(PowerShellからBizRobo!のシナリオをREST API経由で起動させる。), 我々は、より多くの情報をここで見つけました https://qiita.com/shuichiro/items/658be10e3cb1dc362f0f著者帰属:元の著者の情報は、元のURLに含まれています。著作権は原作者に属する。
Content is automatically searched and collected through network algorithms . If there is a violation . Please contact us . We will adjust (correct author information ,or delete content ) as soon as possible .