アポデントとルーレットの連携(PDF不要・担当の自動反映)
衛生士ルーレットとアポデント(ApoDent v3)を、Chrome の拡張機能 Tampermonkey に入れたスクリプトでつなぎます。アポデントには外部連携APIがないため、スクリプトが画面を人の代わりに読み書きします。
- アポデント → ルーレット: 表示中の日の予約をそのままルーレットに渡す(PDFの印刷・読み込みは不要)
- ルーレット → アポデント: ルーレットで決まった担当衛生士を、予約入力画面を開いて「更新」する
初回セットアップ(アポデントを使うPCごとに1回)
- Chrome ウェブストアから Tampermonkey をインストールする
- Chrome の
chrome://extensions を開き、Tampermonkey の「詳細」で次のどちらかを有効にする(Chrome の仕様で、これを有効にしないとユーザースクリプトは一切動きません)
- 「ユーザースクリプトを許可する」のスイッチがある場合はそれを ON
- ない場合は、拡張機能ページ右上の「デベロッパーモード」を ON
- Chrome で https://eisei-roulette.pages.dev/apodent-roulette-sync.user.js を開くとTampermonkey のインストール画面が出るので「インストール」を押す(出ない場合は、Tampermonkey のダッシュボード →「+」で新規スクリプトを開き、apodent-roulette-sync.user.js の内容を貼り付けて保存する)
- アポデントの予約表(
https://v3.apodent.jp/app/apoint/)を再読み込みすると、画面左下に「🎯 ルーレット反映」 ボタンが出る
「ルーレット反映」ボタンが出ないとき
上から順に確認してください。
- アポデントの画面が 予約表(URL が
/app/apoint/) になっているか。ログイン画面やトップ画面では出ません
- スクリプトを入れた後に、予約表を 再読み込み(F5) したか
chrome://extensions で Tampermonkey が有効で、手順2のスイッチが ON になっているか
- Tampermonkey のアイコン → ダッシュボードに「衛生士ルーレット → アポデント反映」があり、左のスイッチが ON(有効)になっているか
- Tampermonkey を入れた Chrome と、アポデントを開いている Chrome(プロファイル)が同じか。アカウントごとに Chrome が分かれている場合は、アポデントを使う側に入れる必要があります
- それでも出ない場合は、予約表で F12 → Console に
[ルーレット反映] で始まる警告が出ていないか確認する
毎日の使い方
- アポデントで当日の予約表を表示し、左下の「ルーレット反映」→ 「📤 ルーレットを開く」 を押す
- その日の予約(カルテ番号・ユニット・時間・診療区分・固定担当)がルーレットに渡り、新しいタブで開く
- 新しいタブが開かない(ポップアップブロック)場合は、ルーレットを自分で開いて「📥 アポデントから貼り付け」を押す(内容はクリップボードにも入っている)
- ルーレットで出勤者を確認し、いつも通りルーレットを実行する
- 「割り当て結果」の 「アポデント用にコピー」 を押す
- アポデントのタブに戻り、「ルーレット反映」→ 「📋 クリップボードから読み込む」 を押す
- 一覧を確認する
- 「変更なし」= 既に同じ担当なので何もしない
- 「スキップ」= 予約表に見つからない等。理由を見て手動で対応する
- チェックを外した行は反映しない
- 初めて使うときは 「テスト実行(保存しない)」 を押し、予約入力画面が順に開いて閉じることを確認する
- 「反映実行(保存する)」 を押す。1件ずつ予約入力画面を開いて保存し、表の担当が書き換わったことを確認してから次へ進む
- アポデントが確認ダイアログを出した場合は、そのダイアログに答えると続きが進む
- エラーが出た行で自動的に止まる。画面を確認してからもう一度「反映実行」を押せば続きから再開する
PDF の読み込み欄はそのまま残してあるので、万一のときは従来どおり PDF でも使えます。
アポデントから読み込んだ予約の扱い
ルーレット側では、アポデントの予約を PDF と同じ形(30分刻みの行 × ユニット)に組み立ててから、これまでと同じ判定(患者の有無、SRP、固定担当、複数予約、1時間枠の継続)を行います。
- 行の範囲は午前 10:00〜12:30、午後 14:00〜18:30(土曜は 16:30 まで)。範囲外の予約(9:30 の訪問など)があれば広げる
- 1時間以上の予約(60分・90分)は、次の行が「↑ 継続」になる
- :15 / :45 開始の予約は直前の :00 / :30 の行に入れる。同じ枠に別の患者がいれば次の行へ
- 「石埜 AM有給」「往診」のような予約不可ブロックは表示するが患者なしとして扱う
- 備考に「キャンセル」と書かれていても、アポデントの表に残っている予約は有効な予約として扱う(キャンセル済みの予約はアポデントの表から消えるため)
- カルテ番号のない新患は、名前と「初診」の診療区分で患者ありと判定する。アポデントから取り込んだ予約には予約ごとの固有IDが付くので、新患も担当の自動反映ができる(反映時は予約入力画面の患者名で本人確認する)。 PDFから読んだ場合は固有IDがないため、新患だけ手動で反映する
安全のための仕組み(反映側)
- ルーレットの日付とアポデントの表示日が違うと実行できない
- 保存前に件数の確認ダイアログを出す
- 1件ごとに「予約入力画面のカルテ番号が一致しているか」を確認してから書き換える
- 保存後に予約表の担当が変わったことを確認し、変わらなければ「要確認」として表示する
- ルーレット側では、その日のルーレットを実行済みのときにアポデントから再読み込みすると、上書き前に確認する
アポデントの画面が変わって動かなくなったとき
スクリプト冒頭の SEL(画面部品のセレクタ)と UNIT_KEY_BY_NAME(ユニット名)を見直してください。現在の前提は次のとおりです。
| 役割 | セレクタ |
予約セル(カルテ番号 kno、担当 dh・dr 属性、rowspan = 15分単位の長さ) | #tableDiv td[kno] |
| セル内の患者名 / 診療区分 / 備考 / 複数予約の印 | dt.pBtn / span.st / p.b / a.nn |
| セル内の「予」ボタン | a.e |
| 予約入力ポップアップ | #entryDiv |
| 予約入力のカルテ番号表示 | #SKaruteNo |
| 歯科衛生士プルダウン | #DrpDh |
| 更新ボタン | #BApoSave |
| 閉じるボタン | #closeEntry |
| ユニット / 時間枠 / 担当医師の一覧 | #DrpUnit / #DrpTime / #DrpDr |
衛生士の名前は、アポデントの歯科衛生士プルダウンの表示名と一致している必要があります(ルーレット側の名前とアポデント側の名前が違う場合は「スキップ」になります)。
スクリプトは https://eisei-roulette.pages.dev/apodent-roulette-sync.user.js から配信しており、 Tampermonkey が定期的に新しい版を自動で取り込みます(deploy.cmd で index.html と一緒に配信される)。