ワンタッチでSalesforceの打刻(定時出社)をしてくれるアプリ - chrome
Update History
-
2019/9/25 (v2.3)
- ボタン要素を待つロジックを変更
- タイムアウト秒数を変更
-
2019/3/27 (v2.2.1)
- README.mdを修正
-
2019/3/27 (v2.1 & v2.2)
- ドメインをユーザー名から直接入力する仕様に変更
- パスワード暗号化のリトライ機能を廃止 (失敗したときは再入力でお願いいたします)
-
2019/3/19 (v2.0)
- ログ機能を実装
- パスワードを暗号化する機能を実装
-
2019/3/6 (v1.0)
- 初版公開
Contents
- encrypt.rb (ユーザー名・パスワードの初期設定スクリプト)
- autologin_salesforce.rb (打刻を行うRubyスクリプト)
- is_morning_then_autologin.sh (朝の時間帯にのみRubyスクリプトを実行するよう制御するスクリプト)
Develop Environment
-
Ruby
$ ruby -v ruby 2.5.3p105 (2018-10-18 revision 65156) [x64-mingw32]
必要なもの
- Ruby (and selenium-driver)
- Google Chrome
- ChromeDriver
事前準備 (わかりにくいかもしれない，要修正)
- Prepare Ruby
- Prepare ChromeDriver
- Config Username and Password
- Copy Scripts to Startup
1. Prepare Ruby
-
Rubyのダウンロード
-
Rubyのインストールとちょっとした環境構築
-
selenium-driverのインストール
gem install selenium-webdriver
2. Prepare ChromeDriver
-
ChromeDriverのインストール
-
Rubyのbinフォルダ配下に置くか，またはお好きな場所に配置してPATHを通す
3. Config Username and Password
-
encrypt.rbを実行
ruby encrypt.rb
-
ユーザ名・パスワードを入力
User Name: foo_bar@hoge.co.jp Password: ******** Password again: ******** -
入力内容を確認し，問題なければ
Y，再入力はRをタイプ -
コンフィグファイル保存場所を選択
- 現在はカレントディレクトリ・親ディレクトリのみサポートされています
-
パスワードの暗号化等を行い，ファイルに出力します
- 暗号化の段階でかなりの頻度で失敗する現象が発生中 (もし失敗しても優しい目で再実行してあげてください...)
4. Copy Scripts to Startup
- is_morning_then_autologin.sh.template を編集してスタートアップフォルダに配置
autologin_salesforce.rbの手動実行方法について
-
実行コマンド
ruby autologin_salesforce.rb [option]
-
オプションには打刻の種類を記載します(省略すると退社モードで実行します)
- 出社: arrival
- 退社: leaving
- 定時出社: regular_arrival
- 定時退社: regular_leaving
-
実行するとブラウザが画面最大化で開き，salesforceにログイン →打刻ボタンを押下→「勤務表」タブを表示(打刻されていることを確認できる) →ログアウト→ブラウザを閉じる
ソースコードをいじれば，ヘッドレスモードで実行することも可能です
- ログファイルがlog/execute_logsに出力されています (役に立つかどうかわからない)
Others
- 他言語での実装歓迎
- 将来的にはC++で実装してexe化したい...