findIQ einbetten (Standalone)

Erfahre, wie du findIQ über die Standalone-Ansicht in externe Anwendungen einbetten oder verlinken kannst.

Geschrieben von Tommy Giesbrecht

Zuletzt aktualisiert Vor etwa 1 Monat

Dieser Artikel erklärt, wie du findIQ in eine externe Anwendung einbetten oder verlinken kannst. Über die Standalone-Ansicht können Nutzer direkt auf Fehlersuche und Routinen zugreifen — ohne die vollständige findIQ-Oberfläche.

Für die Einrichtung benötigst du Zugriff auf die findIQ-App sowie auf die Anwendung, in die findIQ eingebettet werden soll.

Artikelziel: Nach dem Lesen dieses Artikels weißt du, wie du die Standalone-URLs für Fehlersuche und Routinen aufbaust und findIQ per Link oder iframe in eine andere Anwendung einbindest.

Was ist die Standalone-Ansicht?

Die Standalone-Ansicht ist eine reduzierte Version von findIQ, die ohne Navigation und Seitenleiste dargestellt wird. Dadurch eignet sie sich ideal zum Einbetten in andere Anwendungen per iframe oder zum direkten Verlinken.

Es gibt zwei Standalone-Ansichten:

  • Fehlersuche — Führt den Nutzer durch die Fehlerdiagnose einer bestimmten Maschine.

  • Routine — Startet eine bestimmte Routine für eine Maschine.

URL-Struktur

Fehlersuche

https://app.findiq.de/standalone/{organisation}/{machine_uid}/diagnose/

Routine

https://app.findiq.de/standalone/{organisation}/{machine_uid}/routine-run/{routine_uid}

Parameter

Parameter

Beschreibung

Wo zu finden

{organisation}

Der Organisationsname

In der URL der findIQ-App sichtbar

{machine_uid}

Die eindeutige ID der Maschine

In der URL der findIQ-App sichtbar

{routine_uid}

Die eindeutige ID der Routine

In der URL der findIQ-App sichtbar

Du findest die Parameter in der URL-Leiste deines Browsers, wenn du die entsprechende Maschine oder Routine in der findIQ-App öffnest.

Sprache setzen

Über den Query-Parameter locale kannst du die Sprache der Standalone-Ansicht festlegen:

https://app.findiq.de/standalone/{organisation}/{machine_uid}/diagnose/?locale=de

Unterstützte Werte sind z. B. de, en, fr. Die Sprache muss vorher für die Organisation aktiviert werden. Wenn der Parameter nicht gesetzt wird oder invalide ist, wird die Standardsprache der Organisation verwendet.

Authentifizierung

Nutzer müssen authentifiziert sein, um die Standalone-Ansicht verwenden zu können — idealerweise per SSO.

Wenn die Nutzer keinen eigenen findIQ-Account haben, kannst du stattdessen Sharelinks verwenden. Sharelinks ermöglichen den Zugriff auf eine Maschine ohne Anmeldung.

→ So erstellst du einen Sharelink

Sicherheitshinweis:

  • Auch wenn nur die Standalone-Ansicht geöffnet wird, gewährt der Token Zugriff auf die gesamte Maschine — einschließlich aller Dokumente, der Heatmap, Routinen und des gesamten Logbuchs.

  • Sharelinks sollten daher nicht statisch verwendet werden, sondern regelmäßig rotiert werden. Setze ein Ablaufdatum (expires_at) und erstelle regelmäßig neue Sharelinks über die API.

  • Wir arbeiten daran, die Berechtigungen für Sharelinks in Zukunft feingranularer zu gestalten.

Sharelink-URL-Struktur

Sharelinks nutzen eine eigene URL-Struktur mit einem Token:

Normale Ansicht:

https://app.findiq.de/share?token={token}

Standalone Fehlersuche:

https://app.findiq.de/share/diagnose/?token={token}

Standalone Routine:

https://app.findiq.de/share/routine-run/?token={token}

Den {token} erhältst du beim Erstellen eines Sharelinks in der findIQ-App oder über die API.

Sharelink per API erstellen

Du kannst Sharelinks auch programmatisch über die findIQ API erstellen. Das ist besonders nützlich, um Sharelinks regelmäßig zu rotieren.

Endpoint:

POST /api/auth/{organisation}/ressources/{ressource_id}/sharelinks

Request Body:

{
   "resource_type": "machines",
   "expires_at": "2026-04-01T00:00:00Z",
   "enabled": true,
   "title": {
      "type": "plain_text",
      "de": { 
         "value": "Sharelink für Maschine XY",
         "is_auto_translated": false 
      }, 
      "en": { 
         "value": "",
         "is_auto_translated": true 
      }
   } 
}

Parameter:

Feld

Typ

Beschreibung

resource_type

string

Immer "machines"

expires_at

datetime / null

Ablaufdatum des Sharelinks (ISO 8601). null für unbegrenzte Gültigkeit.

enabled

boolean

Ob der Sharelink aktiv ist

title

object

Mehrsprachiger Titel des Sharelinks

Response:

{ 
   "id": "...", 
   "public_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
   "owner_name": "meine-firma", 
   "resource_id": "...", 
   "resource_type": "machines", 
   "expires_at": "2026-04-01T00:00:00Z", 
   "enabled": true, 
   "title": { ... } 
}

Die vollständige Sharelink-URL ergibt sich dann aus:

https://app.findiq.de/share/diagnose/?token=a1b2c3d4-e5f6-7890-abcd-ef1234567890

findIQ per Link einbinden

Die einfachste Methode ist, die Standalone-URL direkt als Link in deiner Anwendung zu hinterlegen. Der Nutzer wird dann in einem neuen Tab zur findIQ Standalone-Ansicht weitergeleitet.

Beispiel:

https://app.findiq.de/standalone/meine-firma/abc123/diagnose/

findIQ per iframe einbetten

Wenn du findIQ direkt in deiner Anwendung anzeigen möchtest, kannst du die Standalone-URL in einem iframe einbetten.

<iframe
  src="https://app.findiq.de/standalone/meine-firma/abc123/diagnose/"
  width="100%"
  height="800"
  frameborder="0"
  allow="clipboard-write"
></iframe>

Die Standalone-Ansicht ist speziell für die Einbettung optimiert — sie enthält keine Navigation oder Seitenleiste, sodass nur der relevante Inhalt angezeigt wird.

Häufige Fragen