ShopDingDong - コマンドラインマニュアル

ShopDingDongは起動時にオプションを指定することにより、様々な動作モードを行うことが出来ます。

　ここでは、ShopDingDongで使用可能なコマンドラインオプション(スイッチ)を公開します。

　通常使用では必要ないので、ここは読み飛ばしても構いません。

　コマンドラインオプションとは、起動時にコマンドラインに付加することで、動作を制御するモノで、

　スタートメニューから、ファイル名を指定して実行(R)で入力したり、ショートカットを右クリックして、

ショートカットタブ内のリンク先(T)に入力することでも使用できます。

/Auto

自動監視開始

起動と同時に監視を開始する。

例) ShopDingDong.exe /Auto

* "スタートメニュー->プログラム(P)->Moaisoft->ShopDingDong->ShopDingDong オートスタート"を実行するのと同じ。

/Debug

デバッグ

デバッグモードで起動する(通常モードとの違いは、ログを最後に表示するかしないかのみです)。

例) ShopDingDong.exe /Debug

*サポート掲示板のバグ報告の仕方も参照して下さい。

* "スタートメニュー->プログラム(P)->Moaisoft->ShopDingDong->ShopDingDong デバッグ版"を実行するのと同じ。

/Url

URL指定

対応ショッピングサイトのURLを引数として渡すと、起動時にそのページを表示します。

例) ShopDingDong.exe /Url http://www.7netshopping.jp/game/detail/-/accd/2101739453/subno/1

　これらのコマンドラインオプションを付加して起動するショートカットがスタートメニューに登録されているので、必要であればご利用下さい。

　ShopDingDongは、コマンドラインモードを実装しており、自作ツールの外部モジュールとして使用することも出来ます。

　また、注文処理のみを行う事の出来るコマンドとして利用できるようになりました。

　つまり、自作のツールやスクリプトに簡単に注文機能を追加できるようになると言うことです。

　使い方は、以下のコマンドラインオプションを参考に、"/Order"オプションと、いくつかのオプションを設定して呼び出すだけです。

　この機能を利用すれば、ユーザー側で構築した独自のシステムに簡単に注文機能を追加することができます。

　例えば、監視タイミングは現在ほとんどのショップで10秒となっていますが、これを自分の環境に合わせて変更し、在庫が確認できたら外部コマンドでShopDingDongを呼び出す等の手法が考えられます。

　という、一般的な外部ツールと同様の手順で簡単に使用できます。

　コマンドラインから呼び出す場合は、"Start"コマンドを"/wait"オプションと共に使用して下さい。

　例：start /wait shopdingdong.exe /start /url=http://www.netshopurl.co.jp/xxxxxxxxxx /id=xxxxx /pw=xxxxx

　バッチファイルのサンプルを提示しますので、参考にして下さい。

　以下のサンプルでは、ShopDingDongを起動し、対象商品注文した後、結果を"TestBatti.txt"に出力し、その結果を表示し、さらにログを"type"コマンドで表示しています。

　このように、"start"コマンドを"/wait"オプションと共に使用するのには、ShopDingDongの終了を待つようにする意味があります。

　勿論、結果を問わずに投げっぱなしにすることも出来ます。

　ここでは、ShopDingDongをコマンドラインから注文モジュールとして使用する場合のオプション(スイッチ)を公開します。

*オプションのパラメータは"="で設定して下さい。例)/Log=C:\Temp\Log.txt

*パラメータ内にスペースを含む場合は、パラメータ全体を""(ダブルクォーテーション)で括って下さい。例)/Log="C:\Temp Folder\Log.txt"
*ここで設定できる以外の、パラメータ(タイムアウト時間等)は環境設定での設定値に準じますので、変更したい場合は予め設定しておいて下さい。

/Order	自動注文	自動注文します。このオプションが設定された場合、上記の前述のコマンドラインオプションは無視されます。コマンドラインモードで使用する場合はこのオプションが必ず必要になります。例) /Order
/Url	URL指定	オークションIDを含むヤフオク!・楽天オークションのURLを引数として渡すと、その商品を注文します。例) /Url=http://www.netshop.co.jp/xxxxxxxx/
/Quant	注文個数	注文個数を指定します。省略すると、1個になります。例) /Quant=1
/Choice	選択オプション	楽天・Yahoo!ショッピングなどで選択オプションのある商品を注文する場合に指定する必要があります。例) /Choice=1(種類)/2(色) パラメータ部分は[選択番号]([ラベル名])をパラメータの個数分"/"(スラッシュ)で連結させます。具体的には、選択オプションで設定する際にタスク登録ウィンドウに表示されている選択オプションと同じ文字列を指定します。
/Id	ログインID	注文するアカウント(メールアドレス)を指定します。省略すると、ShopDingDongの環境設定で設定されているデフォルトが使用されます。それも設定していないと、エラー終了します。例) /Id=xxxxxx
/Pw	パスワード	注文する際のパスワードを指定します。省略すると、ShopDingDongの環境設定で設定されているデフォルトが使用されます。それも設定していないと、エラー終了します。例) /Pw=xxxxxxx
/Log	ログファイル	デバッグ情報などを出力するログファイルを指定します。ログファイルのパスに" " スペースが含まれている場合はパラメータを""(ダブルクォーテーション)で括る必要があります。フォルダが存在しない場合は、自動的に作成します。例) /Log=c:\Debug.txt 例) /Log="c:\My Log\Debug.txt"
/Test	テストモード	指定すると、実際に注文せずに注文確定直前までの動作テストを行います。 *本番では指定しないで下さい。注文できません。例) /Test

　また、これらのコマンドラインオプションを付加して起動するショートカットがスタートメニューに登録されているので、

　コマンドプロンプトの知識がある方には、釈迦に説法ですが、ShopDingDong.exe 終了後に%errorlevel%変数で確認できます。

　また、"/Log"オプションで指定したログファイルに結果ログを出力するので、それを解析することによって注文過程と結果を知ることが出来ます。

0	成功	注文に成功しました。*これ以外は全て失敗です。
-100	失敗	何らかの理由で失敗しました。
-512	パラメータエラー：注文個数	注文個数の指定がおかしいです。
-513	商品特定不可能	"/Url"が設定されているものの、商品情報を取得できませんでした。
-1000	ログインID未設定	"/Id"オプションが指定されておらず、環境設定のアカウント(メアド)も設定されていません。
-1001	パスワード未設定	"/Pw"オプションが指定されておらず、環境設定のパスワードも設定されていません。
-1002	URL未設定	"/Url"やパラメータがありません。商品を特定する為に必須です。