Funktion
Der RemoteQuery Userexit bietet zahlreiche Funktionen um verschiedenste Datenbestände einfach in Scan, Verify oder Office Anwendungen zu integrieren. Der Userexit greift dabei auf die am Server konfigurierten Verbindungen (Connections) zu. Die Daten können dabei aus einer Datenbank, SharePoint, SAP, EASY Enterprise.x, EASY Documents oder einer gescripteten Quelle stammen.
Über den Button Test Connection kann ein Verbindungstest zum Server durchgeführt werden.
Grundkonfiguration
In der Grundkonfiguration muss eine RemoteQuery Server Url, eine Connection, ein User sowie ein Passwort konfiguriert werden. Die Server Url sollte ein FQDN Namen beinhalten - Achtung: kein "localhost" verwenden, auch wenn die Verbindungsprüfung damit funktioniert. Der Benutzer ist ein entsprechend im c4 gepflegter Benutzer mit System-Rechten.
Max. hits steuert die max. übergebene Datenmenge an den Client. 0 entspricht einer unbeschränkten Anzahl an Sätzen. Hierbei bitte beachten, dass beispielsweise bei einer Datenbankabfrage die Treffermenge idealerweise schon in der Query beschränkt wird (Bsp. MSSQL "SELECT TOP 100 ...").
Resize to content und Resize to fieldnames regeln die Trefferdarstellung bzw. die Spaltenbreite.
Über Always show results kann im Falle von nur einem Treffer geregelt werden, dass auch hier die Trefferliste angezeigt wird.
Queries definieren
Eine Abfrage (Query) kann je Indexfeld (Calling field) definiert werden. Das bedeuted, dass je nach Feld von dem aus der Userexit aufgerufen wird, eine andere Query verwendet werden kann.
Als Platzhalter für einen Indexwert kann jedes Feld aus der aufrufenden Indexmaske verwendet werden. Die Platzhalter werden in folgendem Format in der Query eingefügt: $[Feldname]$.
Beispiel
SELECT TOP 1000 * FROM crmAccount
WHERE crmCompany like '%$Name$%'
ORDER BY crmCompany
Zur einfacheren Pflege kann dazu in der Toolbar temporär ein Feldschema bzw. dessen Felder geladen werden. Diese stehen dann owohl im Calling field, als auch in der Query via Rechtsklick zur Verfügung.
Referenz
Alle Infos zur Definition von Queries finden Sie im Referenz-Bereich unter Queries.
Ergebniszuordnung
Die Ergebnisse einer Abfrage können über das Assignment geregelt werden. Hierbei wird einem Target field (Feld in der Maske) ein External field (Spalte aus der Treffermenge) zugeordnet. Die Zuordnung der Ergebnisse erfolgt unabhängig von welchem Feld aus die Query aufgerufen wurde.
Zur einfacheren Pflege kann auch hier in der Toolbar temporär ein Feldschema bzw. dessen Felder geladen werden. Diese stehen dann im target field zur Auswahl.
Konfigurationsoptionen
Die Konfigurationsmöglichkeiten eines REMOTEQUERY Userexits im Detail:
| Option | Beschreibung |
|---|
Basics |
| Server url | Adresse des RemoteQuery-Servers (z.B. http://MyServer:4430). |
| Connection | Auswahl der Verbindung über Drop-Down. Die Auswahl wird vom Server bereitgestellt. |
| User | C4 Benutzer zur Authentifizierung. |
| Password | C4 Benutzer-Passwort zur Authentifizierung gegen den ASE Service. |
| Max. hits | Maximale Trefferanzahl (0 entspricht keiner Beschränkung). |
| Resize to content | Die Trefferlistenspalten werden auf die Größe des Inhalts angepasst. |
| Resize to fieldnames | Die Trefferlistenspalten werden auf die Größe des Feldnamens angepasst. |
| Always show result | Bei aktiver Option wird auch bei nur einem Treffer die Trefferliste angezeigt. |
Query |
| Calling field | Aufrufendes Feld (das Feld in dem der Cursor sich befindet bzw. hinter dem der Userexit hinterlegt wurde). |
| Query | Abfragetext mit Platzhaltern (s.o.). |
Assignment |
| Target field | Feld im Feldschema (technischer Bezeichner) |
| External field | Feldname aus der Datenquelle. |
Technische Bezeichnung
ccremotequeryuserexit.dll