ダウンロードマクロでログインパスワードを使う (マクロの書き方) - PROSERPINE(プロセルピナ)

				プロセルピナ
Top	Internet Mail	Private Proxy	Capture Device		Download	Config and Words	Online Help	Online Home

[BACK]

☞ Top > FileDownload > ID & Password

ダウンロードマクロの書き方
ダウンロードマクロでログインパスワードを使う (PROSERPINE Download Macro)

ダウンロードマクロでサーバにアクセスするとき、アクセス先のサーバのログインＩＤとパスワードが必要になることがありますが、それらの値を『プロセルピナ』に記憶させておくことができます。
このページでは、そのようなダウンロードマクロを記述する手順を説明します。

『プロセルピナ』にログインＩＤとパスワードを記憶させる必要がない場合は Ex:InputFormコマンドやマクロパラメータなどの方法で、ユーザーから毎回、値を入力してもらいます。

パラメータでパスワードを指定する方法について

マクロを記述する方にとって楽なのは、マクロ起動時のパラメータで、マクロ内部で使用するＩＤとパスワードを指定してもらう方法です。
ただしこの方法では、マクロのパラメータに何が必要か、ユーザーが覚えていなければなりません。
マクロはパラメータ無しで起動できるようにしておき、ＩＤやパスワードは必要になった時点で Ex:InputFormコマンドのダイアログフォームで対話的に取得するようにしておくと、ユーザーにとって使いやすいマクロになります。

ですがユーザーは、マクロに使い慣れてくると、パラメータでＩＤとパスワードを指定する方がダイアログより使いやすいと感じるようになるかもしれません。
そのためマクロを書くときは、ＩＤとパスワードをダイアログで対話的に取得するように記述している場合でも、マクロパラメータでそれらが指定されていた場合にはそちらを優先し、 Ex:InputFormコマンドなどによる対話的取得はスキップするようにするといいでしょう。

更にマクロを使いやすくするには、次に説明するように、『プロセルピナ』にＩＤとパスワードを暗号化して登録しておく方法を使用します。
登録は、 Ex:SetPasswコマンドや、 Ex:SetPasswDialogコマンドによってマクロから行うことができるほか、ユーザーがView部メインフォームのメニューから「Macro」→「パスワード設定」の操作で行うことができます。

ダウンロードフォームから起動するマクロでのマクロパラメータ

ダウンロードフォームから起動されることを前提に書かれたダウンロードマクロは、最初のマクロパラメータ(input[0])で、ダウンロード対象のURLを受け取ります。
このため、ＩＤとパスワードが必要な場合は、 input[1] 以降で受け取るように、マクロを記述します。

例えば、ダウンロードフォームの「オプション」欄に
USER_NAME;;USER_PASSWORD
と指定した場合、マクロパラメータinput[1]で USER_NAME 、 input[2]で USER_PASSWORD を受け取ります。

マクロ先頭に登録キーを記述する

ログインＩＤとパスワードのペアを『プロセルピナ』に登録するには、まず、 登録キー を決めます。これはどのような文字列でもかまいません。

この登録キーを、マクロの中で #UsePassw:行で指定します。
例えば、登録キーを
test.LoginPassword
とするなら、マクロの先頭に
#UsePassw: test.LoginPassword
のような行を記述します。

マクロで、ログインＩＤとパスワードのペアを２つ使用する場合は、登録キーは２つです。
#UsePassw:行は２行記述します。
例えば、登録キーを
test.Password.01
test.Password.02
とするなら、マクロファイルは次のような内容になります。

UTF-8
#UsePassw: test.Password.01
#UsePassw: test.Password.02

:Sample {
 // 
 // ログインＩＤとパスワードを使うマクロ
 // 
 end:
 }

この例のように、 #UsePassw:行があるマクロは、ユーザーが View部メインフォームのメニューから「Macro → パスワード設定」と選択してＩＤとパスワードを登録(または変更)することができるようになります。
逆に言えば、ユーザーは、「Macro→パスワード設定」のメニューからは、 #UsePassw:行の無いマクロを指定して、ＩＤとパスワードを登録(または変更)することはできません。

このユーザー操作によるＩＤとパスワードの登録・変更については「ダウンロードマクロで使うパスワードの登録・変更」を参照してください。

この例の test.Password.01 のような登録キーは、マクロ間で共有できます。
たとえば、マクロ login001.txt が、サーバ aaa.example.com にログインするＩＤとパスワードを Login.aaa の登録キーで使用しているときに、同じ aaa.example.com に同じＩＤでログインするマクロ login002.txt も、 Login.aaa の登録キーを使用することができます。
ユーザーは、どちらかのマクロでＩＤとパスワードを登録すれば、その登録がもう一方のマクロでも使えるので、再度登録する手間が省けます。

Ex:SetPasswコマンドで登録する

登録キーとそれに関連付けるＩＤとパスワードが既知の場合、 Ex:SetPasswコマンドを使用します。

Ex:SetPassw: key="test.Password.01" id="user_id_xxx" passw="this_is_password";

key= で登録キーを、 id= にＩＤ、 passw= にパスワードを指定します。
Ex:InputFormコマンドで対話的にＩＤとパスワード値を取得し、この Ex:SetPasswコマンドで設定するといった使い方をします。

Ex:SetPasswDialogコマンドで登録する

この Ex:SetPasswDialogコマンドは、 Ex:InputFormコマンドと Ex:SetPasswコマンドを組み合わせたようなものです。

Ex:InputForm.Waitコマンドにより、ダイアログでユーザーがＩＤとパスワードを設定するのを待ち合わせることが出来ます。
Ex:InputForm.Waitコマンド終了後に、 Ex:ReadPasswコマンドでＩＤとパスワードを読み出します。

次の例は、nicovideo.jp の登録キーで登録されているＩＤとパスワードを Ex:SetPasswDialogコマンドで設定する例です。
マクロパラメータ input[1] に何も設定されていないときに、 nicovideo.jp の登録キーで登録されているＩＤとパスワードを読み出します (Ex:ReadPasswコマンド)。
登録が無かった場合、 Ex:SetPasswDialogコマンドでユーザーにダイアログを開き、 Ex:InputForm.Waitコマンドで入力を待ちます (waitSec=120 により120秒待ちます)。

if (input[1].Length < 1) {
   Ex:ReadPassw: key="nicovideo.jp" O:id=input[1] O:passw=input[2];
   if (input[1].Length < 1) {
     //Ex:Popup: "このマクロの実行には「ニコニコ動画」にログインする メールアドレスとパスワードの設定 が必要です.";
     //sleep: 4000;
     str["help"]="{{GTMAIL_HOME}}\\Help\\fileDownloadRegPassw.html";
     Ex:SetPasswDialog: O:waitId=strl["waitId"] key="nicovideo.jp" message="「ニコニコ動画」にloginするメールアドレスとパスワードを設定します。" ms1="メールアドレス" helpPage=str["help"];
     Ex:InputForm.Wait: waitId=strl["waitId"] waitSec=120 O:result=strl["rslt"];
     if (strl["rslt"].StartsWith{"NG:"} == "true") {
       put: value="タイムアウトしました。";
       end:
       }
     }
   Ex:ReadPassw: key="nicovideo.jp" O:id=input[1] O:passw=input[2];
   if (input[1].Length < 1) {
     put: value="パスワードを設定してください。";
     end:
     }
   }

Ex:SetPasswDialogコマンドで開いたダイアログに、ユーザーが値を設定して OK ボタン で閉じると、ＩＤとパスワードは『プロセルピナ』に登録されるので、それ以降の Ex:ReadPasswコマンドで読み出すことができます。

ＩＤとパスワードの読み出し (Ex:ReadPasswコマンド)

登録したＩＤとパスワードの読み出しは、 Ex:ReadPasswコマンドで行います。

Ex:ReadPassw: key="test.Password.01" O:id=str["id"]; O:passw=str["passw"];

取得できたかどうかは、文字列の長さから判定します。 key= に登録の無い登録キーが指定された場合、ＩＤとパスワードの文字列長は０になります。

[BACK]

プロセルピナ