Anleitung: Wie kann ich aus einer Drittanwendung ein Dokument aus der IPA-Suite aufrufen

Anleitung: Wie kann ich aus einer Drittanwendung ein Dokument aus der IPA-Suite aufrufen

Kurzüberblick

IpaToEdge ist ein kleines, unsichtbar laufendes Brückenprogramm. Sein Zweck: Drittanwendungen können mit einem einfachen Prozessaufruf Dokumente aus der IPA-Suite für den Anwender anzeigen – ohne selbst eine Datenbank- oder API-Integration bauen zu müssen.

Die aufrufende Anwendung übergibt entweder eine Dokumenten-ID oder einen Suchbegriff. IpaToEdge lädt die passenden Datei(en), speichert sie temporär unter dem Originalnamen und öffnet sie sofort: PDFs und Bilder in Microsoft Edge (jeweils als eigene Tabs), alle anderen Dateitypen in der zugeordneten Standard-App. Bei mehreren Treffern werden alle Ergebnisse nacheinander geöffnet. Optional kann eine Logdatei zur Nachvollziehbarkeit geschrieben werden.

Voraussetzungen & Installation

Die IPA-Suite stellt mit IpaToEdge.exe ein Zusatzprogramm bereit, mit dem Drittanwendungen Dokumente direkt anzeigen können.

  • Die Drittanwendung muss die lokale IpaToEdge.exe im Verzeichnis
    C:\it-scom\ipa-suite\ mit Parametern starten können.

  • Die Ausführung erfolgt ohne sichtbares Fenster; die Ausgabe kann optional per /log in eine Datei geschrieben werden.

Voraussetzungen

  • Der IPA-DesktopClient ist auf dem PC installiert, von dem IpaToEdge.exe aufgerufen wird.

  • Der Benutzer hat den IPA-DesktopClient mindestens einmal gestartet und sich mit seinen persönlichen Anmeldedaten erfolgreich angemeldet.
    (Damit sind alle benötigten Anmeldeinformationen vorhanden.)

Aufruf & Parameter

Syntax

IpaToEdge.exe <Typ> <Wert> [/log]

Parameter

  • <Typ>

    • 0 = Dokument per DokumentenID

    • 1 = Dokument(e) per Suchbegriff

  • <Wert>

    • bei 0: die ID (z. B. 4711)

    • bei 1: der Suchbegriff (z. B. "rechnung 2025")

  • [/log] (optional)

    • aktiviert das Logging nach C:\it-scom\ipa-suite\logging\IpaToEdge.log

Beispiele

• Dokument per ID öffnen
  IpaToEdge.exe 0 100

• Dokumente per Suchbegriff (alle Treffer als Tabs in Edge)
  IpaToEdge.exe 1 "Kundenangebot 2025"

• Mit Logging
  IpaToEdge.exe 0 100 /log

Hinweis: Enthält der Suchbegriff Leerzeichen, bitte in Anführungszeichen setzen.

Öffnungsverhalten

  • In Microsoft Edge:
    .pdf, .jpg, .jpeg, .png, .gif, .bmp, .webp, .avif, .svg, .ico

  • In der Standard-App (Windows-Zuordnung):
    alle anderen Dateitypen (z. B. .docx, .xlsx, .txt, …)

  • Fallback: Ist Edge nicht vorhanden oder nicht startbar, werden auch PDFs/Bilder mit der Standard-App geöffnet.

Logging

  • Optional per Schalter /log.

  • Logdatei: C:\it-scom\ipa-suite\logging\IpaToEdge.log

  • Typische Inhalte: Start/Ende, Modus, Trefferanzahl, gespeicherte Dateinamen, Fehlerhinweise.

Fehlerbehebung (Kurzcheck)

  • Kein Fenster/keine Ausgabe: Das ist korrekt – das Tool läuft silent. Nutzen Sie /log für Einsicht.

  • Nichts wird geöffnet: Prüfen Sie, ob Treffer vorhanden sind und ob Edge/Standard-App installiert bzw. zugeordnet ist.

  • Anmeldung fehlschlägt: Anmeldedaten über den IPA-DesktopClient prüfen; ggf. Passwort neu eingeben.

  • Netzwerk/DB-Zugriff: Erreichbarkeit der IPA-Suite/Datenbank sowie Firewall-Regeln prüfen.

Support

  • Bitte die Logdatei beilegen: C:\it-scom\ipa-suite\logging\IpaToEdge.log

  • Nützliche Angaben: Windows-Version, .NET-Version, verwendeter Aufruf (ohne sensible Daten), Zeitpunkt des Problems.