将密钥添加到SchoolsBuddy
在iSAMS中生成 Batch API 密钥和凭据后，请导航至SchoolsBuddy开始集成。
作为超级管理员，请前往
- 设置
- 入门 > 数据集成
将导入功能切换为开启（绿色）。
请在提供的输入框中输入您学校的iSAMS托管 URL （例如，
[https://yourschool.isams.cloud]）。在“API密钥”部分，将每种API类型的“包含”字段切换为“是” 。“医疗”字段为可选字段，具体取决于您学校的政策。
填写从iSAMS获取的相应客户端 ID和客户端密钥。
- 学生导入邮箱：默认设置为“否”。仅当您的学生需要登录SchoolsBuddy时，才将其切换为“是”。
- 联系人/家长：请指定您希望导入SchoolsBuddy联系人类型（例如，母亲、父亲、监护人）。要导入所有联系人类型，请在该字段中输入星号 (
*)。
您可以通过导航至“学生管理系统”>“联系人”在iSAMS中验证联系人类型。
⚠️ 重要提示：所有导入的联系人将自动接收学生动态更新并获得SchoolsBuddy的登录权限。请确保仅选择必要的联系人类型。 父级导入筛选条件：
使用以下筛选条件，可以筛选出要导入到SchoolsBuddy中的联系人记录（来自步骤 8 中定义的联系人类型）：仅限“所有合并”或“通信”联系人：启用此开关，仅导入与您选择的联系人类型匹配且在iSAMS中启用了“所有合并”或“通信”标志的联系人。
仅限“所有合并”或“计费”联系人：启用此开关，仅导入与您选择的联系人类型匹配且在iSAMS中启用了“所有合并”或“计费”标志的联系人。
仅限家长责任：启用此开关，仅导入在iSAMS中标记为家长责任的联系人。
📍 在iSAMS中哪里可以找到：联系人合并类型和责任标志可以在iSAMS > 学生管理器 > 联系人下找到。
⚠️ 重要提示：所有导入的联系人将收到学生动态更新，并获得SchoolsBuddy的登录权限。请确保仅选择必要的联系人类型和筛选设置。
允许使用的教职工邮箱域名：请输入您学校的官方邮箱域名（例如，
crownill.edu）。这将确保仅导入已验证的教职工邮箱地址。跳过年终处理部分，然后点击右下角的“保存更改”。
点击“立即运行导入”以启动数据导入。
（注：手动导入操作可以每 5 分钟触发一次；否则，数据将在夜间自动刷新。）
手动触发iSAMS导入
SchoolsBuddy会定期自动从iSAMS导入数据，您也可以随时直接从设置中手动触发按需数据导入。
如何手动导入：
以超级管理员身份登录SchoolsBuddy 。
导航至“设置” > “入门” > “数据集成” 。
点击“运行导入”按钮。（见上文步骤 12）
⏱️ 关于手动导入的重要说明：
速率限制：运行导入按钮每5 分钟只能触发一次。
处理时间：根据学校规模和数据集的大小，导入过程可能需要10 到 20 分钟才能完成。
iSAMS数据源刷新延迟：为了使更新内容显示在SchoolsBuddy中，更改必须首先同步到iSAMS API 数据源。直接在您的iSAMS实例中更新数据并不意味着SchoolsBuddy的数据源会立即更新。请等待iSAMS刷新其数据源后再触发导入操作。
专业提示：您可以通过缩短 API 密钥缓存过期时间来缩短iSAMS数据源的更新频率。（默认值：24 小时）