連絡帳アドオン

既存の Raxel App (例: 顧客名簿、 取引先一覧) を、 メール共有から見える読み取り専用の連絡先ソースとして併用する仕組みです。 メイン連絡帳 (Raxel 標準アドオン) に加えて、 自社で運用しているアプリのレコードもメール宛先 サジェストや検索の候補に出せるようになります。

典型的なユースケース

• すでに Raxel に「顧客名簿アプリ」 を持っていて、 営業メールの宛先サジェストでも そのアプリのレコードを引きたい
• 経理が「請求先連絡先アプリ」 を運用していて、 請求書送付メールの宛先補完を そのアプリで行いたい
• メール共有はメインの連絡帳で広く管理しつつ、 部署別に細かい属性を持った専用 アプリも併用したい

アドオンの設定箇所

各メールボックスの設定画面 →「連絡帳アドオン」 タブに、 そのメール ボックスから参照するアドオン一覧があります。 タブ自体はオーナーのみ表示・編集できます (他ロールはこのタブにアクセスできません)。

• メイン連絡帳 (Raxel 自動シード) は最初から有効になっています。 ここを外すと メイン連絡帳のレコードも候補に出なくなります
• 設定タブからは「アドオンを追加」 ボタンと既存アドオンの並び替え / 削除ができます

アドオン追加時の設定項目

設定後にアドオンを追加すると、 そのアプリの全レコードがバックグラウンドで連絡先 インデックスに同期され、 数十秒〜数分でサジェスト候補に出るようになります。

「読み取り専用」 の意味

アドオン経由のレコードは、 メール共有からは表示するだけで、 連絡帳 画面から内容を書き換えることはありません。 編集はアプリ側で行います。

• 連絡帳一覧でアドオン由来のカードをクリックすると、 連絡帳の詳細ページが開きます (= アプリのレコード ID と連絡先データが対応付けされた仮想エントリ)
• 詳細ページに「アプリで編集」 ボタンが表示されます。 これを押すと 元のアプリのレコード詳細画面に遷移してフル編集できます
• メール送信時のサジェスト候補や、 検索の対象としてもアドオン由来レコードが対象に 含まれます

アドオンの追加 / 削除 / 並び替え

• 追加: タブ右上の「+ アドオンを追加」 ボタンから上記 4 項目を指定
• 削除: 行の右側にある「削除」 ボタンから。 確認 ダイアログでアプリ名が表示され、「このメールボックスの宛先補完・検索の候補に表示 されなくなります。App 自体やレコードは削除されません」 と案内される
• 並び替え: 各行のハンドルでドラッグ&ドロップ。 上に並んでいる アドオンほどサジェスト候補のスコアが優先されます

壊れたアドオン (警告バッジ)

アドオンに指定したフィールドが、 アプリ側で削除・rename されると、 アドオン行に 「このアドオンには問題があります」 という警告バッジが 表示されます。

• 想定される原因: 設定済みの email フィールドが App から消えた / 表示名フィールドが rename された / サブフィールドが見つからない、 等
• 警告バッジには「フィールド xxx が見つかりません」 等の具体的な原因が ヒントとして表示される
• 対処方法: アプリ側でフィールドを復旧する、 もしくはアドオンを削除して再 追加する。 壊れている間はそのアドオンのレコードはサジェスト候補に 出ません

削除時の影響

アドオン設定を削除しても、 元のアプリやレコードは削除されません。 メール共有側でアドオン経由のサジェストが行われなくなるだけです。

• 連絡帳一覧からそのアドオン由来のカードが消えます (= メイン連絡帳のカードは残る)
• サジェスト候補からも除外されます
• 後から再度アドオンを追加すれば、 同じアプリのレコードが再びサジェスト対象に戻ります (= フィールド設定をやり直す必要あり)
• アプリのレコード自体や、 アプリ側の権限設定には影響しません

関連ドキュメント

• メールボックス設定 — オーナーロールの権限とタブ構成
• 送信 — アドオン由来のレコードが宛先サジェストに表示される仕組み