- スクリプトの文法
- テキストコマンド
- マウスクリック
- 遅延実行
- 送信マーカー
- テキスト欄クリア
- アクティブWindowへ切り替え
- スクリプトの例
- 移動用URLと一致用URL
- 移動用URLでアプリケーションを起動
ロボフォームの動作をきめ細かく制御するにはカスタムスクリプトを使います。ここでは、ターミナルやPuTTYなどのツール、非標準的な記入欄など、通常のロボフォームでは対応できない、アプリ用のログイン を想定しています。
注意: ロボフォームでカスタムスクリプトを使用するには、Windows用ロボフォームデスクトップアプリ のインストールとフィールド追加が必要です。
ログインにスクリプト用フィールドを追加した後に、そこに実際のスクリプトを記載します。キーボードのキー押下やマウスのクリックなどを "記入" や "記入と送信" / "ログイン" のコマンドにより実現します (以下参照)。
例:
$u
ENTER
$p
SUBMIT:
ENTER
スクリプトの文法
スクリプトはコマンドが連続したものです。各コマンドはスペース文字で区切られます(空白、タブ、改行):
<command1> <command2> <command3>
‘#’ はコメント行で、'#'以降、行末までは無視されます。
テキストコマンド
テキストコマンドは文字をアプリケーションウィンドウに送信します。キーボードからの入力を模しています。
1) 文字ストリング
"<text_string>"
引用符で囲まれた文字列で、ANSI または UNICODE でアプリケーションウィンドウに送付されます。
\n, \r, \t 等のエスケープコード はサポートされません。
2) パスワードとユーザID欄
$p – パスワード欄からの文字列
$u – ユーザID欄の値
3) TOTP欄
$t – ログインの確認コード(TOTPキー)欄に生成されている現在のTOTP (ワンタイムコード)を印字
4) 他のログイン欄
%<field_name>%
<field_name> は部分的に指定可能 例:コントロールIDやキャプション
5) 角ブラケット
[<text_string>]
角ブラケット内の文字はそのままの形で出力されます。つまり引用符自体を出力することが可能です。 ["hello world"] としても ["]"hello world"["] としても出力は "hello world" となります。
6) 特殊キー
利用可能な特殊キー:
SPACE, TAB, ENTER, ESC,
UP, DOWN, LEFT, RIGHT,
HOME, END, PGUP, PGDOWN,
INS, DEL, BACK, F1- F12
SHIFT CTRL ALT
<key_name>
キーを押して離す
<key_name>+
キーを押す
<key_name>-
キーを離す
マウスクリック
*<x>,<y>
ウィンドウの左上からの座標でますㇲをクリック
遅延実行
DELAY <seconds>
<seconds> – 秒数。秒数には、小数部分を含めることができます。小数部分はピリオドで区切る必要があります。コマンドと数値の間には、スペースを置かなければなりません。
送信マーカー
SUBMIT:
このラベルは、スクリプトにおける「入力」部分と「送信」部分を区別するものです。ラベル以降の部分は、記入と送信コマンドによってのみ実行され、フォーム記入コマンドでは実行されません。
テキスト欄クリア
CLEAR
このコマンドは、以下のスクリプトコマンドの連続実行に対するショートカットです。
HOME SHIFT+ END SHIFT- DELETE
アクティブWindowへ切り替え
POPUP
非公開情報や機密情報が誤ったウィンドウに入力されるのを防ぐため、ロボフォームは、フォーム記入または記入と送信コマンドの対象として選択されたウィンドウ以外のウィンドウに対して、キー入力やマウス操作が行われないように制限します。「POPUP」コマンドを実行すると、この対象ウィンドウが現在アクティブなウィンドウへと切り替わります。
スクリプトの例
*100,200 # (100,200)の座標をマウスでクリック
"uoydellortI" TAB # 文字列を印字してTABキーを押す
$u TAB # ユーザID欄の値を印字してTABキーを押す
$p TAB # パスワード欄の値をタイプしてTABキーを押す
DELAY 1.5 # 1.5 秒の遅延
SUBMIT: # 次の行が送信される
SHIFT+ ENTER SHIFT- # SHIFTを押しながらENTERを押した後SHIFTを離す
角ブラケットを使った印字 (テキストコマンド 参照):
["hello world"] # 角ブラケット内を文字通り印字
["]"hello world"["] # 角ブラケットを使って引用符を印字
移動用URLと一致用URL
移動用URL
はアプリケーションを起動し、コマンドライン引数を指定するために使用されます。
形式:
exe://"<実行ファイルのパス>" <コマンドライン引数>
「exe://」というプレフィックスは、このログイン情報がWebブラウザではなく、Windowsアプリケーションへのデータ入力に使用されることを示します。
<実行ファイルのパス> アプリケーションの実行ファイルへのフルパスです。ロボフォームはこのパスを使用してアプリケーションを起動します。例: C:\WINDOWS\explorer.exe
<コマンドライン引数> アプリケーションに渡すコマンドライン引数です。
注: セキュリティ上の理由から、移動用URLから直接アプリケーションを起動する機能(exe://を使用したログイン動作)は、アプリケーションログインにおいてデフォルトで無効になっています。これにより、ログイン情報が悪用されて、コンピュータ上の任意の実行ファイルやスクリプトが起動されることを防ぎます。信頼できるアプリケーションに対してこの機能が必要な場合は、ロボフォームの設定から、移動用URL経由での実行ファイルの起動を有効にすることができます。
一致用URL
はログイン対象となる特定のウィンドウを特定するために使用されます。
形式:
exe://<実行ファイル名>/<ウィンドウタイトル>
<実行ファイル名> ? 拡張子を除いた、アプリケーションの実行ファイル名。(例: explorer)
<ウィンドウタイトル> ? ウィンドウタイトルのテキスト。先頭または末尾にワイルドカードとして「*」を含めることができます。
例:
exe://<実行ファイル名>/<ウィンドウタイトル> ? 完全一致
exe://<実行ファイル名> ? 任意のタイトル
exe://<実行ファイル名>/* ? 任意のタイトル
exe://<実行ファイル名>/*<部分文字列>*
exe://<実行ファイル名>/<部分文字列>*
exe://<実行ファイル名>/*<部分文字列>
ヒント: 1つの「アプリケーションログイン」設定を、名前が異なる複数の実行ファイル(例: 2種類の異なるPowerShell実行ファイルなど)に一致させたい場合は、「等価ドメイン」を使用して、それらのアプリケーション名を同一のものとして扱うことができます。設定例: WindowsTerminal=PowerShell.
移動用URLでアプリケーションを起動
前述の通り、セキュリティ上の理由から、移動用URL(exe:// を使用した直接ログイン動作)からアプリケーションを起動する機能は、デフォルトで無効になっています。信頼できるアプリケーションであり、ロボフォームのログイン項目からそのアプリケーションを起動したい場合は、この機能を有効にすることができます。
- ロボフォームのメインメニューを開き、「オプション」または「設定」を選択します。
- 「アプリケーション」タブを選択します。
- 「アプリケーションのログイン項目から実行ファイルを起動することを許可する」を有効にします。
-
「完了」をクリックして、変更を適用します。
この設定は、ログイン項目から信頼できるアプリケーションを起動する場合にのみ有効にしてください。この機能が無効であっても、ロボフォームはすでに開いているアプリケーションウィンドウに対してデータの入力や送信を行うことは可能です。制限されるのは、実行ファイルの自動起動のみです。
コメント
0件のコメント
記事コメントは受け付けていません。