SchoolsBuddy 에 키 추가하기
iSAMS 에서 배치 API 키와 자격 증명을 생성했으면 SchoolsBuddy 로 이동하여 통합을 시작하세요.
최고 관리자이시라면 다음 페이지로 이동해 주세요.
- 설정
- 시작하기 > 데이터 통합
가져오기 활성화 토글을 켜짐 (녹색)으로 설정합니다.
제공된 입력란에 학교의 iSAMS 호스팅 URL (예:
[https://yourschool.isams.cloud])을 입력하십시오.API 키 섹션에서 각 API 유형에 대해 ' 포함' 필드를 ' 예' 로 설정하세요. 의료 관련 필드는 학교 정책에 따라 선택 사항입니다.
iSAMS 에서 발급받은 해당 클라이언트 ID 와 클라이언트 시크릿을 입력하십시오.
- 학생 이메일 가져오기: 기본값은 '아니요'입니다. 학생이 SchoolsBuddy 에 로그인해야 하는 경우에만 '예'로 설정하세요.
- 연락처/학부모: SchoolsBuddy 로 가져올 연락처 유형(예: 어머니, 아버지, 보호자)을 지정하세요. 모든 연락처 유형을 가져오려면 해당 필드에 별표(
*)를 입력하세요.
iSAMS 에서 연락처 유형을 확인하려면 학생 관리 > 연락처로 이동하세요.
⚠️ 중요: 가져온 모든 연락처는 학생 활동 업데이트를 자동으로 수신하고 SchoolsBuddy 에 로그인할 수 있는 권한을 얻게 됩니다. 필수 연락처 유형만 선택해 주세요. 상위 가져오기 필터:
아래 필터를 사용하여 8단계에서 정의한 연락처 유형 중에서 SchoolsBuddy 로 가져올 연락처 기록을 세분화하세요."모든 병합" 또는 "연락" 연락처만 가져오기: 이 토글을 활성화하면 선택한 연락처 유형과 일치 하고 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시간)