この記事では、 iSAMSデータをSchoolsBuddyにインポートするための包括的な手順を段階的に解説します。右側の索引を使用して、ご自身のニーズに合ったセクションにすばやく移動してください。
1. 概要
SchoolsBuddyバッチAPIキーを使用して、生徒、連絡先、職員などの重要なデータをiSAMSから直接インポートします。システムは夜間にデータ更新を実行するため、情報が常に正確かつ最新の状態に保たれます。
iSAMS管理コントロールパネルの「APIキー」セクションから、7つのバッチAPIキー（医療用キーは任意）を設定してください。
これらのキーを個別に作成することで、 SchoolsBuddyさまざまな種類のデータを独立して取得できるようになり、負荷処理が改善され、データインポートがスムーズかつ正しい順序で実行されることが保証されます。
2. バッチAPIキーの作成方法
APIキーを設定するには、以下の手順に従ってください。ISAMSのインスタンスがクラウドホスト型かセルフホスト型かによって、手順が若干異なる場合があります。
- ISAMSに管理者としてログインし、 「コントロールパネル」をクリックしてください。
-
APIサービスマネージャーを選択します
-
「バッチAPIキーの管理」を選択してください。
- 「バッチAPIキーの作成」 （または、表示されている場合は「バッチAPIキーのリクエスト」）をクリックします。
まずISAMSに6つまたは7つの新しいキーを申請する必要があります（医療情報を共有するかどうかによって異なります）。 - キーには、その用途に基づいて明確な名前を付けてください（例： SchoolsBuddy – 生徒、 SchoolsBuddy – 連絡先）。そうすることで、後で簡単に識別できます。
-
以下のキー設定を行ってください。
状態：アクティブ
モード：生産
-
キャッシュ有効期限： 2～4時間（デフォルトの24時間ではなく）
- 「バッチ処理方法」タブを選択してください。
-
以下の表に示す設定を確認して、各キーを設定してください。これは連絡先キーの例です。
各バッチAPIキーの種類に対応する正しい設定については、以下の表を参照してください。
-
APIキー1 グループ - スクールマネージャー - アカデミックハウス
- SchoolManager - フォーム
- スクールマネージャー - 年数
APIキー2 スタッフ - 人事部長 - 現スタッフ
APIキー3 学生 - PupilManager - 現在の生徒
APIキー4 連絡先 - PupilManager -連絡先 (フィルタリング済み) 。
- 連絡先またはカスタムフィールドのオプションはチェックしないでください - スクリーンショットを参照してください
- SchoolsBuddy連絡先インポートルールに関する重要な注意事項を以下でご確認ください。
APIキー5 医学 - このキーはオプションです
- PupilManager - 在学生 - 健康
- カスタムフィールドオプションはチェックしないでください（スクリーンショットを参照）。
APIキー6 対象者 - TeacherManager - 部門、指導フォーム、セットリストとセット（保護者会／保護者面談および連絡用）
APIキー7 卒業生（同窓生） - 学生マネージャー - 卒業生担当
⚠️重要:
以下の各キーに対応するメソッドのみを選択してください。
追加の設定やカスタムフィールドは選択しないでください。選択すると、 SchoolsBuddyデータを正しく処理できなくなる可能性があります。
-
- 「インテグレーター」タブに移動してください。
- インテグレーターとして「 Faria 」、製品名として「 SchoolsBuddy 」を入力してください。
- 「保存して閉じる」をクリックしてください。
- 認証サーバーの認証情報を入力するポップアップウィンドウが表示されます。
このウィンドウはまだ閉じないでください。SchoolsBuddy SchoolsBuddy連携を完了するには、これらの情報が必要になります。
3. SchoolsBuddy設定
iSAMSでAPIキーを作成したら、この記事の手順に従ってSchoolsBuddyとの統合を開始してください。iSAMS iSAMS統合：パート2
4. よくある質問
Q：生徒、保護者、または職員の詳細情報を更新する必要がある場合はどうすればよいですか？
A：通常通り、 iSAMSで直接詳細を更新してください。これらの変更は毎晩SchoolsBuddyにインポートされます。ただし、 iSAMS APIフィードを更新するのに少し時間がかかる場合があり、生徒のメールアドレスが完全に更新される前に生徒の記録が表示されることがあります。すべての新しい生徒の詳細が完全に同期されるまで、最大48時間お待ちいただくことをお勧めします。
質問：学生が退学した場合、自動的に登録解除されますか？
A：はい。iSAMS iSAMS退学者または卒業生として登録されている学生は、自動的に削除されます。
質問：生徒が退学した場合、保護者の情報は自動的に削除されますか？
A：生徒に、現在学校に通学していて有効なSchoolsBuddyアカウントを持っている兄弟姉妹がいない限り、保護者のアカウントは無効化されます。
質問：従業員が退職すると、自動的にリストから削除されますか？
A：いいえ。内部スタッフも外部スタッフも、手動で削除されるまでSchoolsBuddyアカウントを保持します。組織のスーパー管理者ユーザーがSchoolsBuddyでアカウントを削除する必要があります。これはiSAMS APIの制限によるものです。
Q: キャッシュの有効期限を調整する理由は何ですか？
A: SchoolsBuddy夜間に24時間ごとに1回iSAMS問い合わせを行います。
キャッシュの有効期限を2～4時間に短縮することで、以下のことが保証されます。
必要に応じて、データをより早く更新することも可能です。
手動でデータ同期を実行できます（例：日中に新しい生徒が追加された場合）。
システムは、結果を数時間キャッシュすることで、 iSAMSデータベースへの負荷を最小限に抑えます。
キャッシュの設定がデフォルトの24時間になっている場合、新規データや更新されたデータは、翌日の同期スケジュールまで利用できません。
Q: SchoolsBuddy 、 iSAMSの「学校外」出席データを毎日インポートできますか？
A：いいえ、現時点では対応していません。将来的には、 iSAMSこのデータを公開APIに含める可能性があり、 SchoolsBuddyそれをインポートできるようになるかもしれません。
Q: SchoolsBuddy医療情報をインポートできますか？
A：はい。医療バッチ処理APIキーをご提供いただければ、生徒の病状をインポートできます。
Q: 教師の授業データはSchoolsBuddyに直接インポートされますか？
A：はい、ただし、保護者面談や連絡をサポートするためにインポートされるのは、セットベースのクラスのみです。フォームベースのクラスはインポートされません。
Q: SchoolsBuddyに寄宿舎を追加できますか？
A：現在、弊社の連携機能は学生寮のみに対応しています。しかしながら、一部の学校から学生記録に寄宿舎情報を追加することへの関心が寄せられています。この機能のご要望については、弊社の製品ポータルサイトから投票をお願いいたします。
Q: 生徒の写真をSchoolsBuddyに同期できますか？
A：現在、 iSAMS API を介して学生の写真を同期することはできません。ただし、ご興味がおありでしたら、サポートチームまでお問い合わせください。代替のワークフローをご提案できる可能性があります。
質問：以下のように年度を割り当てることで、1つのiSAMSアカウントを複数のキャンパスで使用しています。これは問題でしょうか？
キャンパス1：1年生～10年生
キャンパス2：20～30年目
A: SchoolsBuddy学年の表示名を同期するため、10年生と20年生が同じ名前（例：「5年生」）を使用している場合、それらは1つの学年グループとしてインポートされます。SchoolsBuddyで学年SchoolsBuddyを区別するために、学年グループ名にキャンパス識別子を追加することをお勧めします。たとえば、「5年生キャンパス1」と「5年生キャンパス2」のようにです。