이 문서에서는 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 재학생 - 학생 관리자 - 재학생
API 키 4 콘택트 렌즈 - PupilManager - 연락처(필터링됨)
- 연락처 또는 사용자 지정 필드 옵션을 선택하지 마십시오. (스크린샷 참조)
- SchoolsBuddy 연락처 가져오기 규칙에 대한 중요 사항은 아래를 확인해 주세요.
API 키 5 의료 - 이 키는 선택 사항입니다.
- 학생 관리 - 재학생 - 건강
- 사용자 정의 필드 옵션을 선택하지 마세요(스크린샷 참조).
API 키 6 주제 - TeacherManager - 부서, 수업 양식, 수업 목록 및 세트 (학부모 상담/학부모-교사 면담 및 소통용)
API 키 7 졸업생 (동문) - 학생 관리자 - 졸업생
⚠️ 중요:
아래 각 키에 대해 나열된 방법만 선택하십시오.
SchoolsBuddy 데이터를 올바르게 처리하지 못할 수 있으므로 추가 설정 이나 사용자 지정 필드를 선택하지 마십시오 .
-
- 통합자 탭으로 이동하세요.
- 통합업체는 " Faria "로, 제품명은 " SchoolsBuddy "로 입력하십시오.
- 저장 후 닫기를 클릭하세요.
- 인증 서버 자격 증명을 제공하는 팝업 창이 나타납니다.
아직 이 창을 닫지 마세요. SchoolsBuddy 연동을 완료하려면 이 정보가 필요합니다.
3. SchoolsBuddy 설정
iSAMS 에서 API 키를 생성한 후에는 이 문서( iSAMS 데이터 통합: 2부) 의 단계를 따라 SchoolsBuddy 와의 통합을 시작하십시오.
4. 자주 묻는 질문(FAQ)
질문: 학생, 학부모 또는 교직원 정보를 업데이트해야 하는 경우는 어떻게 해야 하나요?
A: 평소처럼 iSAMS 에서 직접 세부 정보를 업데이트해 주세요. 변경 사항은 매일 밤 SchoolsBuddy 로 자동 반영됩니다. 다만, iSAMS 의 API 피드 업데이트에 다소 시간이 걸릴 수 있으며, 학생 정보가 이메일 주소 업데이트보다 먼저 표시될 수도 있습니다. 모든 신규 학생 정보가 완전히 동기화되는 데 최대 48시간이 소요될 수 있으니 참고하시기 바랍니다.
질문: 학생들이 퇴학하면 자동으로 제적되나요?
A: 네. iSAMS 에서 퇴학자 또는 졸업생으로 표시된 학생은 자동으로 삭제됩니다.
질문: 학생이 학교를 떠나면 학부모 목록에서 자동으로 삭제되나요?
A: 해당 학생에게 현재 학교에 재학 중이며 SchoolsBuddy 계정을 활성화한 형제자매가 없는 경우, 학부모 계정은 비활성화됩니다.
질문: 직원이 퇴사하면 자동으로 계정이 삭제되나요?
A: 아니요. 내부 및 외부 직원 모두 수동으로 삭제할 때까지 SchoolsBuddy 계정을 유지합니다. 조직의 최고 관리자(Super Admin)만 SchoolsBuddy 에서 계정을 직접 삭제할 수 있습니다. 이는 iSAMS API의 제한 사항 때문입니다.
큐: 캐시 만료 시간을 조정해야 하는 이유는 무엇인가요?
A: SchoolsBuddy 야간에 24시간마다 한 번씩 iSAMS 쿼리를 보냅니다.
캐시 만료 시간을 2~4시간으로 줄이면 다음과 같은 이점이 있습니다.
필요한 경우 데이터를 더 빨리 새로 고칠 수 있습니다.
수동으로 데이터 동기화를 실행할 수 있습니다(예: 당일 새 학생이 추가된 경우).
이 시스템은 결과를 몇 시간 동안 캐싱하여 iSAMS 데이터베이스의 부하를 최소화합니다.
캐시가 기본값인 24시간 으로 설정된 경우, 새롭거나 업데이트된 데이터는 다음 날 예정된 동기화 시간까지 사용할 수 없습니다.
질문: SchoolsBuddy iSAMS '학교 밖' 출석 데이터를 매일 가져올 수 있나요?
A: 아니요, 현재는 지원하지 않습니다. 향후 iSAMS 해당 데이터를 공개 API에 포함시켜 SchoolsBuddy 가져올 수 있도록 할 예정입니다.
질문: SchoolsBuddy 의료 정보를 가져올 수 있나요?
A: 네. Medical Batch Method API 키를 제공해 주시면 학생들의 의료 정보를 가져올 수 있습니다.
질문: 교사의 수업 정보가 SchoolsBuddy 에 바로 불러와지나요?
A: 네, 하지만 학부모-교사 면담 및 소통을 지원하기 위해 세트 기반 수업만 가져올 수 있습니다. 양식 기반 수업은 가져오지 않습니다.
질문: SchoolsBuddy 에 기숙사를 추가할 수 있나요?
A: 현재 저희 연동 기능은 학과 기숙사만 지원합니다. 하지만 일부 학교에서 학생 기록에 기숙사 정보를 추가하는 데 관심을 보였습니다. 제품 포털을 방문하여 해당 기능에 투표해 주세요.
질문: 학생 사진을 SchoolsBuddy 와 동기화할 수 있나요?
A: 현재 iSAMS API를 통해 학생 사진을 동기화하는 것은 불가능합니다. 하지만 관심 있으신 경우 지원팀에 문의해 주시면 다른 방법을 안내해 드릴 수 있습니다.
질문: 저희는 아래와 같이 연도를 지정하여 여러 캠퍼스에서 하나의 iSAMS 계정을 사용하고 있습니다. 이렇게 하는 데 문제가 없을까요?
캠퍼스 1: 1학년 ~ 10학년
캠퍼스 2: 20~30년차
A: SchoolsBuddy 학년의 표시 이름을 동기화하므로, 10학년과 20학년이 같은 이름(예: "5학년")을 사용하는 경우 하나의 학년 그룹으로 가져와집니다. SchoolsBuddy 에서 학년 그룹을 구분하려면 학년 그룹 이름에 캠퍼스 식별자를 추가하는 것이 좋습니다. 예를 들어 "5학년 캠퍼스 1" 및 "5학년 캠퍼스 2"와 같이 사용할 수 있습니다.