Einen Suchbefehl per PowerShell von einer anderen Applikation an den geöffneten IPA-DesktopClient senden

Einen Suchbefehl per PowerShell von einer anderen Applikation an den geöffneten IPA-DesktopClient senden

Der IPA-DesktopClient (ab Version 9.3.x) unterstützt das Empfangen von Suchbefehlen über ein internes IPC-System (Inter-Prozess-Kommunikation).
Andere Anwendungen können so eine Suche im bereits geöffneten Client auslösen, ohne dass dieser neu gestartet werden muss.

Damit dies funktioniert, müssen zwei Dinge passieren:

  1. Die Suchphrase in die Datei
    %TEMP%\SingleInstanceMessage.txt
    geschrieben werden.

  2. Das Event IPA-DesktopClient-Search ausgelöst werden, damit der Client die Nachricht einliest.

🔎 Beispiel: Suche nach „IT-SCom GmbH“ aus einer PowerShell-Applikation

Starten Sie eine Windows PowerShell und kopiere den Inhalt des Beispiels in die PowerShell. Du musst natürlich vorher die Suchphrase anpassen.

Alert
Wichtig: Mehrere Wörter müssen in "Anführungszeichen" stehen, damit der DesktopClient sie als einen Suchbegriff behandelt.

  1. # ---------------------------
  2. # Nachricht an IPA-DesktopClient senden
  3. # ---------------------------
  4. 

  5. # Nachricht definieren (Beispiel: Suche starten)
  6. $message = '--s="IT-SCom GmbH"'     # <-- hier deine Suchphrase eintragen
  7. 

  8. # Pfad zur Message-Datei im TEMP-Ordner
  9. $file = "$env:TEMP\SingleInstanceMessage.txt"


  10. 

  11. # Nachricht in die Datei schreiben
  12. Set-Content -Path $file -Value $message -Encoding UTF8


  13. 

  14. # Benötigtes EventWaitHandle öffnen
  15. $event = [System.Threading.EventWaitHandle]::OpenExisting("IPA-DesktopClient-Search")


  16. 

  17. # Event auslösen → die laufende Instanz liest die Nachricht und führt Aktion aus
  18. $event.Set()


  19. 

  20. Write-Host "Nachricht gesendet an laufende IPA-DesktopClient Instanz."

✔ Was passiert danach?

  • Die laufende IPA-DesktopClient-Instanz erkennt das Event

  • Sie liest die Nachricht aus der Datei %TEMP%\SingleInstanceMessage.txt

  • Der Suchstring wird automatisch in das Suchfeld übernommen

  • Die Suche startet sofort, ohne den Client neu zu öffnen

💡 Vorteile

  • Ideal für Scanner-Software, externe Tools oder Automatisierungen

  • Sehr schlanke und robuste Schnittstelle

  • Keine zusätzlichen APIs oder Add-Ins notwendig

Alert
Wichtig:
Der IPA-DesktopClient muss auf dem PC gestartet sein um Suchanfragen auf diese Weise zu erhalten.