Zum Hauptinhalt springen

Anpassen

Die iframe-URL akzeptiert mehrere Abfrageparameter, die das Verhalten und Aussehen steuern. Diese Seite ist die kanonische Referenz: Jeder Parameter, den die iframe unterstützt, ist unten aufgelistet und in den folgenden Abschnitten detailliert erläutert.

Nutzen Sie den Generator, um eine konfigurierte iframe-URL in der Vorschau anzusehen und zu kopieren.

#
#
Standard-Bezeichner ersetzen

Der Generator verwendet einen Beispiel-company-Bezeichner, damit die Vorschau funktioniert. Ersetzen Sie ihn vor der Bereitstellung durch Ihren eigenen Bezeichner.

Schnellreferenz​

  • company (erforderlich): kurzlebiger Unternehmensbezeichner (auch als App-Schlüssel bezeichnet), der aus Ihrem S2S-API-Token ausgegeben wird. Weitere Informationen zur Generierung finden Sie auf der Seite "Sicherheit".
  • companyCallbackUrl: überschreibt die Standard-Callback-URL, an die der Diagnosebericht übertragen wird. Siehe Abschnitt zum Überschreiben der Callback-URL.
  • isForPatient (Standard: 0): Bei 1 wird die Fragebogenlexik für nicht-klinische Benutzer vereinfacht.
  • enableResult (Standard: 1): Schaltet die Anzeige von Diagnoseergebnissen für den Benutzer um.
  • showQuestionnairesHeader (Standard: 1): Steuert die Sichtbarkeit des Fragebogens.
  • enableDiagnosisSupport (Standard: 1): Bei 0 wird der Schritt zur Diagnoseidentifikation übersprungen und nur die Schwere gemessen.
  • forcedScoringSystems: Komma-getrennte Liste von Bewertungssystem-Codes, die unabhängig vom diagnostischen Vertrauen berechnet werden müssen.
  • enableAnamnesis (Standard: 0): Bei 1 wird das Anamneseformular angezeigt.
  • macroscopicMedia (Standard: disabled): ob ein Kontextbild (makroskopisch) erforderlich ist. Zulässige Werte: disabled, optional, required.
  • enableExtendedInstructions (Standard: 0): Bei 1 werden alle Best Practices für die Fotografie angezeigt.
  • enableAlternativeCameraModule (Standard: 0): aktiviert das Camera-Modul in der iframe (Workaround für Frameworks, die Dateieingaben blockieren).
  • enableAlternativeCameraModuleAndroid (Standard: 0): wie das vorherige Flag, aber auf Android begrenzt.
  • primary: Hexadezimalfarbcode für die primäre UI-Farbe.
  • secondary: Hexadezimalfarbcode für die sekundäre UI-Farbe.
  • fontFamily: In der iframe verwendete Schriftart. Unterstützt: Roboto, Montserrat.
  • locale (Standard: en): Anwendungssprache. Unterstützt: en, es.
  • extraData: Base64-kodiertes JSON mit zusätzlichen Daten, die an den Bericht angehängt werden (z.B. Patientenkennung). Verborgen vor Endbenutzern.
  • enableExtraDataInPdf (Standard: 0): Bei 1 werden die extraData-Werte im generierten PDF-Bericht ausgedruckt.

Der Rest dieser Seite beschreibt jeden Parameter im Detail, gruppiert nach Zweck.

Patientenmodus​

Wenn die primären Nutzer der iframe Patienten sind, setzen Sie isForPatient=1. Dies formuliert die Fragebögen in einfacherer Sprache um. Zum Beispiel sieht der Patient statt des technischen Labels Itchiness die Frage Wie würden Sie beschreiben, wie juckend Sie sich fühlen?.

Sichtbarkeit der Ergebnisse​

Das Standardverhalten ist, die Ergebnisse dem Benutzer anzuzeigen, sobald sein Foto verarbeitet wurde. Geben Sie enableResult=0 an, um die Ergebnisse zu verbergen und nur eine Bestätigungsmeldung anzuzeigen.

Fragebogen-Titel​

showQuestionnairesHeader steuert die Sichtbarkeit des Titels über den Fragebögen (die Überschrift "Medizinischer Fragebogen"). Standard: 1.

Diagnose-Unterstützung​

Der Parameter enableDiagnosisSupport steuert, ob die KI-gestützte Diagnose-Unterstützungsfunktion ausgeführt wird.

Wenn deaktiviert (enableDiagnosisSupport=0), überspringt die iframe den Schritt der Diagnoseidentifikation vollständig. Dies ist nützlich, wenn die Diagnose des Patienten bereits bekannt ist und das Ziel nur darin besteht, die Schwere zu messen. Wenn ein Kliniker eine Diagnose bestätigt hat und beispielsweise PASI- oder SCORAD-Scores im Laufe der Zeit verfolgen möchte, ohne eine neue Diagnoseanalyse auszulösen.

Erzwungene Bewertungssysteme​

forcedScoringSystems ist eine Komma-getrennte Liste von Bewertungssystem-Codes, die unabhängig vom diagnostischen Vertrauen berechnet werden sollten:

https://iframe.legit.health/?company=XXX&forcedScoringSystems=aladinLocal,ascoradLocal

Verfügbare Bewertungssysteme​

  • aladinLocal: Acne Lesion estimation grading index (IGA acne).
  • agppgaLocal: Generalized Pustular Psoriasis Physician Global Assessment.
  • aihs4Local: International Hidradenitis Suppurativa severity score.
  • apasiLocal: Automatic Psoriasis Area and Severity Index.
  • asaltLocal: Automatic Severity of ALopecia Tool.
  • ascoradLocal: SCORAD for atopic dermatitis.
  • auasLocal: Urticaria Activity Score.
  • awosiLocal: Pressure ulcers assessment.
  • pure4: Psoriatic arthritis UnclutteRed screening Evaluation.
  • sevenPc (oder 7PC): 7-point checklist for pigmented lesions.
  • uct: Urticaria Control Test.
Standardverhalten ohne forcedScoringSystems

Wenn forcedScoringSystems nicht angegeben ist, berechnet die iframe automatisch das Bewertungssystem, wenn die vom Diagnose-Unterstützungsalgorithmus erkannte Erkrankung ein Vertrauensniveau über 40 Prozent und ein zugeordnetes Bewertungssystem hat. Dies hält den Workflow übersichtlich: Die wahrscheinlichsten Erkrankungen werden auf Schwere bewertet, ohne explizite Konfiguration zu erfordern.

Anamnesefragebogen​

Der Parameter enableAnamnesis zeigt oder verbirgt das Anamneseformular. Standard: 0. Geben Sie enableAnamnesis=1 an, um es anzuzeigen.

Es gibt zwei Arten von Fragen, die die iframe stellen kann:

Generische Fragen​

Wenn das Anamneseformular aktiviert ist, sieht der Benutzer fünf klinisch relevante Fragen, die nicht an eine bestimmte Erkrankung gebunden sind:

  1. Was ist der Grund für die Konsultation? Wie ist das Problem entstanden? Beschreiben Sie den Ursprung.
  2. Haben Sie Allergien, besonders gegen Medikamente? Wenn ja, listen Sie Allergien auf.
  3. Nehmen Sie Medikamente oder Behandlungen ein? Wenn ja, erklären Sie, welche Behandlung Sie einnehmen.
  4. Haben Sie ernsthafte Erkrankungen? Wurden Sie operiert?
  5. Gibt es eine Familiengeschichte ernstafter Erkrankungen?

Erkrankungsspezifische Fragen​

Wenn die KI eine Erkrankung mit ausreichendem Vertrauen erkennt, hängt die iframe automatisch den mit dieser Erkrankung verbundenen Fragebogen an. Wenn beispielsweise die Läsion mit hoher Wahrscheinlichkeit Psoriasis ist, wird der Patient gefragt, welche PASI-Fragen die KI nicht aus dem Bild ableiten kann.

Die erkrankungsspezifischen Fragen sind diejenigen, aus denen jedes Bewertungssystem besteht. Siehe Abschnitt "Fortgeschritten: Bewertungssysteme".

Bild-Upload​

In der iframe lädt der Benutzer Bilder hoch, indem er auf Hier klicken, um ein Bild hinzuzufügen klickt. Dies öffnet die Kamera oder den Dateimanager.

Benutzer können mehrere Bilder derselben Läsion hochladen:

Alle Bilder gehören zu demselben Bericht

In diesem Fall gehören alle Bilder zu demselben DiagnosticReport und stellen einen einzelnen Aufruf des Geräts dar.

Bildqualität​

Das Gerät führt eine Technologie namens DIQA aus, die die visuelle Qualität jedes hochgeladenen Bildes misst. Wenn der Score unter 60 liegt, fordert die iframe den Benutzer auf, das Bild nach Korrektur des Problems erneut hochzuladen.

Der Score ist in der von der iframe geposteten Nachricht enthalten:

"originalMedia": {
  "type": "Image",
  "modality": "Clinical",
  "diqaScore": 74, // 👈
  // ...
},

Makroskopisches Bild​

macroscopicMedia steuert, ob der Benutzer ein Kontextbild (makroskopisch) hochladen muss:

  • disabled (Standard): das Feld ist verborgen.
  • optional: der Benutzer kann ein makroskopisches Bild hochladen.
  • required: der Benutzer muss ein makroskopisches Bild hochladen, um fortzufahren.

Dies ist nützlich, wenn visueller Kontext wichtig ist, zum Beispiel bei klinischen Bewertungen, bei denen eine weitwinklige Aufnahme eine Nahaufnahme ergänzt.

Erweiterte Anweisungen​

enableExtendedInstructions=1 zeigt einen vollständigen Satz von Best Practices zum Fotografieren. Standard 0 zeigt einen minimalen Satz an.

Alternatives Camera-Modul​

Frameworks wie Ionic schränken oft den Hardwarezugriff (besonders die Kamera) ein, wenn Inhalte in einer iframe gerendert werden. Der Standard-<input type="file">-Flow, den die iframe standardmäßig nutzt, wird in diesen Umgebungen blockiert. Daher stellen wir ein alternatives Modul zur Verfügung, das den Kamerazugriff direkt von der iframe anfordert.

info

Dieses Problem betrifft hauptsächlich Android-Geräte, auf denen Ionic-basierte Anwendungen ausgeführt werden. Möglicherweise müssen Sie enableAlternativeCameraModuleAndroid speziell für diese aktivieren.

  • enableAlternativeCameraModule=1: aktiviert das alternative Modul auf jeder Plattform.
  • enableAlternativeCameraModuleAndroid=1: aktiviert es nur für Android.

Farben und Schriftart​

Primäre und sekundäre Farben werden über die Parameter primary und secondary (Hexadezimalcodes) angepasst.

Für Typografie unterstützt die iframe derzeit Roboto und Montserrat über den Parameter fontFamily. Wenden Sie sich an uns, wenn Sie eine zusätzliche Schriftart benötigen. Wir werden unser Bestes geben, um sie einzubeziehen.

Sprache​

Die Oberflächensprache wird mit dem Parameter locale (en, es) festgelegt. Wenn Sie eine andere Sprache benötigen, kontaktieren Sie uns bitte.

Extra-Daten​

extraData akzeptiert jeden String und wird an den Bericht angehängt. Es ist ein praktischer Ort, um Bezeichner weiterzugeben, die mit dem Bericht reisen sollten, aber für Benutzer verborgen bleiben, wie Patientenbezeichner, Versicherungsanbieter oder Episodenreferenzen:

const data = toBase64(JSON.stringify({ patient: "XXX", insuranceProvider: "YYY" }));

Standardmäßig wird extraData in den Bericht gespeichert, aber NICHT im generierten PDF ausgedruckt. Setzen Sie enableExtraDataInPdf=1, um es in das PDF einzubeziehen. Dies ist nützlich, wenn das PDF direkt an einen Kliniker oder Patienten geliefert wird und die Extra-Daten im Dokument sichtbar sein sollten.

Callback-URL-Überschreibung​

Bei der Konfiguration Ihres Unternehmens gibt der Integrator eine Standard-Callback-URL an, an die Legit.Health den Diagnosebericht übermittelt, sobald die Analyse beendet ist. Der Parameter companyCallbackUrl ermöglicht es Ihnen, diese Vorgabe auf iframe-Ebene zu überschreiben. Dies ist nützlich, wenn dieselbe company-Kennung über Umgebungen (Staging, Produktion) oder über Produkte hinweg wiederverwendet wird, die den Bericht an verschiedene Endpunkte geliefert benötigen:

https://iframe.legit.health/?company=XXX&companyCallbackUrl=https://your-server.example.com/legit-health-webhook

Die URL muss vom öffentlichen Internet erreichbar sein, POST-Anfragen akzeptieren und mit einem 2xx-Statuscode antworten. Das Payload, das Ihr Endpunkt erhält, entspricht dem im Abschnitt "Ausgabe: JSON-Formate" beschriebenen JSON-Schema.

Push vs. Pull

companyCallbackUrl aktiviert ein Push-Liefermodell: Legit.Health sendet den Bericht an Ihren Endpunkt, sobald er fertig ist. Wenn Sie den Bericht lieber Pull on demand mit der vom analysis_completed postMessage zurückgegebenen Bericht-id abrufen möchten, nutzen Sie stattdessen den API-Endpunkt. Beide Modelle können koexistieren.

Nächste Schritte​

  • Produktionszugang sichern? Siehe die Seite "Sicherheit".
  • Welcher plattformspezifische Code wird benötigt? Siehe den Abschnitt "Plattformen".
  • Müssen Callbacks von der iframe verarbeitet werden? Siehe den Abschnitt "Callbacks".