SchoolsBuddyにキーを追加する
iSAMSでバッチAPIキーと認証情報を生成したら、 SchoolsBuddyに移動して統合を開始してください。
スーパー管理者として、
- 設定
- はじめに > データ統合
インポートを有効にするには、オン（緑色）に切り替えてください。
指定された入力ボックスに、学校のiSAMSホスティングURL （例：
[https://yourschool.isams.cloud]）を入力してください。APIキーのセクションで、各APIタイプの「 INCLUDE」フィールドを「はい」に切り替えてください。医療情報は、学校の方針によってはオプションの項目です。
iSAMSから取得したそれぞれのクライアントIDとクライアントシークレットを入力してください。
- 生徒によるメールのインポート：デフォルトでは「いいえ」に設定されています。生徒がSchoolsBuddyへのログインアクセスを必要とする場合にのみ、「はい」に切り替えてください。
- 連絡先／保護者： SchoolsBuddyにインポートする連絡先の種類（例：母親、父親、保護者）を指定してください。すべての連絡先をインポートするには、フィールドにアスタリスク（
*）を入力してください。
iSAMSで連絡先の種類を確認するには、[学生マネージャー] > [連絡先] に移動してください。
⚠️重要：インポートされた連絡先はすべて、生徒の活動状況に関する最新情報を自動的に受信し、 SchoolsBuddyへのログインアクセス権を取得します。必要な連絡先のみを選択してください。 親インポートフィルター:
以下のフィルターを使用して、 SchoolsBuddyにインポートする連絡先レコード（ステップ8で定義した連絡先タイプから）を絞り込みます。「すべてのマージ」または「通信」の連絡先のみ:このトグルを有効にすると、選択した連絡先タイプに一致し、 iSAMSで「すべてのマージ」または「通信」フラグが有効になっている連絡先のみがインポートされます。
「すべてのマージ」または「請求」連絡先のみ:このトグルを有効にすると、選択した連絡先タイプに一致し、 iSAMSで「すべてのマージ」または「請求」フラグが有効になっている連絡先のみがインポートされます。
親権者のみ:このトグルを有効にすると、 iSAMSに親権者としてマークされた連絡先のみがインポートされます。
📍 iSAMSでの確認場所: 連絡先のマージタイプと責任フラグは、 iSAMS > 学生マネージャー > 連絡先で確認できます。
⚠️重要：インポートされた連絡先には、生徒の活動状況に関する最新情報が送信され、 SchoolsBuddyへのログインアクセス権が付与されます。必要な連絡先タイプとフィルター設定のみを選択してください。
許可されている職員用メールアドレスのドメイン：学校の公式メールアドレスのドメイン（例：
crownill.edu）を入力してください。これにより、認証済みの職員用メールアドレスのみがインポートされます。年末処理のセクションはスキップして、右下隅の「変更を保存」をクリックしてください。
データインポートを開始するには、 「今すぐインポートを実行」をクリックしてください。
（注：手動インポートは5分ごとに1回実行できます。それ以外の場合は、データは夜間に自動的に更新されます。）
手動トリガーiSAMSインポート
SchoolsBuddy定期的にiSAMSからデータを自動的にインポートしますが、設定画面からいつでも手動でオンデマンドのデータインポートを実行することもできます。
手動インポートの実行方法：
SchoolsBuddyにスーパー管理者としてログインしてください。
設定>はじめに>データ統合に移動します。
「インポートを実行」ボタンをクリックします。（上記手順12）
⏱️ 手動インポートに関する重要な注意事項：
レート制限：インポート実行ボタンは5分に1回しか押すことができません。
処理時間：学校の規模やデータセットによって異なりますが、インポートには10分から20分かかる場合があります。
iSAMSフィードの更新遅延： SchoolsBuddyに更新内容が反映されるには、まずiSAMS APIフィードに変更が反映される必要があります。iSAMS iSAMSでデータを直接更新しても、 SchoolsBuddyが取得できるフィードに即座に反映されるわけではありません。インポートを実行する前に、 iSAMSフィードを更新するまでしばらくお待ちください。
プロのヒント： APIキーキャッシュの有効期限を短くすることで、 iSAMSフィードの更新頻度を短縮できます。（デフォルト：24時間）