Microsoft Teams EHR 커넥터 설정 및 구성 문제 해결
이 문서에서는 Microsoft Teams EHR(전자 상태 기록) 커넥터의 일반적인 설정 및 구성 문제를 해결하는 방법에 대한 지침을 제공합니다. 이를 사용하여 Oracle Health EHR 또는 Epic EHR 시스템과 통합하도록 EHR 커넥터를 설정하고 구성할 때 발생할 수 있는 차단기를 resolve 데 도움이 됩니다.
FHIR URL이 작동하지 않음
EHR 커넥터를 구성하려고 할 때 "FHIR URL이 잘못되었습니다." 오류가 발생합니다.
이 문제는 다음 시나리오에서 발생할 수 있습니다.
- FHIR 기본 URL에 DSTU2 확장이 누락되었으며 Teams 버전 1.1 또는 1.2를 사용하고 있습니다.
- FHIR 기본 URL에 R4 확장이 누락되었으며 Teams 버전 1.3을 사용하고 있습니다.
전체 FHIR 기본 URL을 제공하려면 Epic 기술 전문가에게 문의하세요.
에픽 분석가이고 FHIR URL을 승인하려고 할 때 Epic에서 "OAUTH2" 오류가 발생합니다.
이 문제는 에픽 instance 키가 설정되지 않았거나 에픽에서 OAuth 구성을 완료하지 않은 경우에 발생할 수 있습니다. Epic 기술 전문가에게 문의하세요.
저는 Epic 분석가이며 EHR 커넥터 구성 포털에서 FHIR URL을 승인하려고 하면 Epic 자격 증명을 사용하여 Epic에 로그인할 수 없습니다.
에픽에서 사용 권한을 변경해야 합니다. 사용 권한을 검사 업데이트하려면 Epic 기술 전문가에게 문의하세요.
가상 약속을 시작할 수 없습니다.
처음으로 EHR 커넥터를 설정했는데 환자가 환자 포털에서 가상 약속을 시작할 수 없습니다.
이 문제가 발생할 수 있는 몇 가지 일반적인 이유와 이 문제를 resolve 방법은 다음과 같습니다.
Epic의 FDI 레코드가 EHR 커넥터 구성 포털의 값과 일치하지 않음
시작 URL 및 컨텍스트 토큰은 EHR 커넥터 구성 포털 에서 Epic의 FDI 레코드로 복사해야 합니다. organization Epic 분석가에게 문의하여 값이 올바르게 복사되었는지 확인합니다. 경우에 따라 EHR 커넥터 구성 포털에서 복사한 후 FDI 레코드를 조작할 수 있습니다.
FDI 레코드가 올바른 Epic 환경에서 업데이트되지 않음
Epic의 테스트 및 프로덕션 환경에 대한 FHIR 기본 URL은 다릅니다. FDI 레코드가 올바른 환경에 대한 값을 반영하는지 확인합니다.
프로덕션 환경을 사용하고 있으며 프로덕션 라이선스가 없습니다.
organization Microsoft Cloud for Healthcare, Microsoft Teams EHR 커넥터 추가 기능 또는 Microsoft Teams EMR 커넥터 추가 기능에 대해 하나 이상의 활성 라이선스가 있어야 합니다. Oracle Health 고객의 경우 테스트에도 라이선스가 필요합니다.
모든 FHIR 기본 URL이 올바르게 구성되어 있더라도 가상 약속을 시작할 때 사용자에게 "테넌트 구성을 찾을 수 없음" 오류가 발생합니다.
이 문제는 사용자가 테스트 FHIR 기본 URL을 사용하거나 그 반대로 EHR 프로덕션 환경에서 실수로 가상 약속을 시작하는 경우에 발생할 수 있습니다.
이 문제를 해결하려면 다음을 수행하십시오.
- 프로덕션 FHIR 기본 URL은 프로덕션 환경에서 가상 약속을 시작하는 데만 사용되는지 확인합니다.
- 테스트 FHIR 기본 URL이 테스트 환경에서 가상 약속을 시작하는 데만 사용되도록 합니다.
그룹 방문
그룹 방문이 내 organization 작동하지 않음
현재 그룹 방문은 Epic에서만 지원됩니다.
다음은 Epic과 통합할 때 이 문제가 발생할 수 있는 몇 가지 일반적인 이유와 resolve 방법입니다.
- 잘못된 버전의 Teams를 사용하고 있습니다. 그룹 방문에는 최소 Teams 버전 1.2가 필요하며 에픽 연결 허브에서 업그레이드를 요청해야 합니다.
- 새 FDI 레코드를 추가해야 합니다. Epic 분석가는 공급자 및 환자 참여 환경을 지원하기 위해 그룹 방문을 위한 새 FDI 레코드를 만들어야 합니다. 또한 FDI 레코드를 방문하는 그룹의 컨텍스트 토큰을 에서
sessionId=%CSN%sessionId=%CONFERENCEID%로 변경해야 합니다. 에픽 기술 전문가에게 문의하여 도움을 받으세요. - 이 목록의 이전 단계를 시도한 후에도 이 문제가 계속 발생하는 경우 테넌트 설정을 변경해야 할 수 있습니다. Microsoft 지원 문의하여 Teams EHR 커넥터에 대한 지원 티켓을 엽니다. 티켓에서 그룹 설정을 사용하도록 설정해야 함을 나타냅니다.
공급자 환경
환자가 가상 약속에 참여할 때 공급자가 Teams 알림을 받지 못 함
학습을 통해 이 문제를 해결할 수 있는 경우가 많습니다. 공급자가 가상 약속을 시작하면 환자를 인정하도록 공급자에게 임시 알림이 표시됩니다. 이 알림은 간략하게만 표시됩니다.
또한 공급자는 화면 상단의 모임 컨트롤에서 사람 선택하여 참가자 목록을 확인하고 대기 중인 로비에서 참가자 이름 옆에 있는 녹색 검사 표시를 선택하여 허용합니다.
환자 환경
환자에게 웹 브라우저에서 가입하는 대신 Teams 앱을 다운로드하라는 메시지가 표시됩니다. Teams를 설치하지 않고도 환자가 웹 브라우저에서 참가하기를 원합니다.
Microsoft 지원 문의하고 Teams EHR 커넥터에 대한 지원 티켓을 엽니다. 티켓에서 웹 브라우저 조인 설정을 켜야 함을 나타냅니다. 이 변경은 Teams EHR 커넥터 팀에서 수행해야 합니다.
웹 브라우저 조인 설정이 켜져 있으면 환자는 Teams를 설치하지 않고도 브라우저에서 가상 약속에 참가할 수 있습니다.
가상 약속이 약속 내에서 종료된 후 환자는 Teams의 공급자에게 채팅 메시지를 보낼 수 있습니다. 이를 어떻게 차단할 수 있나요?
이 시나리오는 여러 가지 이유로 인해 발생할 수 있습니다.
공급자가 약속을 떠나지만 끝내지 않았습니다.
공급자가 약속을 떠나지만 끝내지 않았고 환자가 약속에 남아 있는 경우 둘 다 채팅을 계속할 수 있습니다. 환자가 채팅 메시지를 보내지 못하도록 하려면 공급자가 Teams에서 모임 종료 를 선택하여 약속을 끝내야 합니다.
웹 브라우저 조인 설정이 꺼져 있고 organization 직원이기도 한 환자가 회사 자격 증명을 사용하여 Teams 앱에 참가합니다.
환자가 organization 직원이며 회사 자격 증명을 사용하여 Teams 앱을 통해 약속에 참여하는 경우 게스트가 아닌 organization 구성원으로 약속에 참여합니다. 즉, 약속이 끝난 후에도 채팅 메시지를 보낼 수 있습니다.
이 시나리오를 방지하려면 다음 작업 중 하나를 수행할 수 있습니다.
- Microsoft 지원 문의하고 Teams EHR 커넥터에 대한 지원 티켓을 엽니다. 티켓에서 웹 브라우저 조인 설정을 켜야 함을 나타냅니다. 이 변경은 Teams EHR 커넥터 팀에서 수행해야 합니다.
- 직원이 환자로 약속에 참석할 때 회사 자격 증명을 사용하여 Teams에 로그인하지 않도록 교육합니다.
관리 환경
EHR 커넥터 구성 포털에 액세스할 수 없거나 기존 구성만 볼 수 있고 새 구성을 추가할 수 없습니다.
EHR 커넥터 구성 포털에 대한 관리자 액세스 권한이 없습니다. 빠른 검사 Teams 관리 센터에 액세스할 수 있는지 확인합니다. Teams 관리 센터에 액세스할 수 없는 경우 관리자 권한이 없습니다.
organization 관리자에게 문의하여 관리자 액세스 권한을 부여하거나 포털에서 통합을 설정합니다.
내 organization 네트워크의 다른 조직과 EHR 커넥터 통합을 공유하려고 합니다.
FHIR 기본 URL을 공유하려면 TeamsForHealthcare 에서 다음 정보를 공유하려는 FHIR 기본 URL로 이메일을 보내주세요.
- 공유할 FHIR 기본 URL
- EHR 커넥터를 호스팅하는 부모/초기 Microsoft 테넌트(예: EHR을 호스트하는 기본 병원)의 테넌트 ID
- EHR 커넥터(예: 지역 지점, 관련 의료 사무실 또는 클리닉)를 공유할 새 테넌트의 테넌트 ID
VDI(Virtual Desktop 인프라) 지원
내 organization Citrix 환경을 사용합니다. EHR 커넥터를 사용하도록 구성할 어떻게 할까요? 있나요?
특정 URL을 로컬 머신으로 다시 라우팅하고 가상 머신에서 시작하지 않도록 Citrix 환경을 구성할 수 있습니다. 예를 들어 Teams에서 가상 약속을 시작하려면 로컬 머신에 대한 "*.teams.microsoft.com"에 대한 모든 트래픽을 구성합니다.
자세한 내용은 다음 Citrix 설명서를 참조하세요.