Der Application Server stellt Variablen (manchmal auch als Tokens bezeichnet) zur Verfügung, um InterAction-Informationen an andere Anwendungen zu übergeben. Dies wird typischerweise verwendet, wenn Links von Web Client-Seiten zu Seiten außerhalb von InterAction erstellt werden. Zum Beispiel möchten Sie vielleicht einen Link in einem Web Client-Profil einfügen, der die Google™-Suchmaschine öffnet und automatisch nach dem Namen des aktuellen Kontakts im Internet sucht. Dies erreichen Sie, indem Sie eine Variable im Linkziel einfügen.
Diese Variablen werden in der Regel verwendet, wenn Sie Web Client-Profile konfigurieren. Sie können Variablen in Überschriften, Links und statischem Text verwenden. Ebenso können Sie Variablen beim Konfigurieren von benutzerdefinierten Seiten und Nugget-Listen oder beim Hinzufügen von Elementen zur Web Client-Startseite nutzen.
Syntax für Application Server-Variablen
Sie geben Application Server-Variablen mit folgender Syntax ein:
$(VariableName)
Eine häufig verwendete Variable ist $(contactName). Wenn Sie diese in einen Link oder eine Überschrift einfügen, wird sie durch den tatsächlichen Namen des Kontakts ersetzt.
Zum Beispiel könnten Sie einen Link in einem Profil mit folgender URL erstellen:
http://www.google.com/search?hl=en&ie=UTF-8&oe=UTF-8&q=$(contactName)&btnG=Google+Search
Wenn der Web Client das Profil anzeigt, wird das Linkziel für den Kontakt „TeleNorth“ wie folgt umgewandelt:
http://www.google.com/search?hl=en&ie=UTF-8&oe=UTF-8&q=TeleNorth&btnG=Google+Search
In diesem Beispiel wird die Syntax der URL von der jeweiligen Seite (Google) bestimmt. Links zu anderen Suchseiten sehen anders aus, aber das Grundprinzip der Übergabe von InterAction-Daten bleibt gleich.
Verfügbare Application Server-Variablen
Die folgende Tabelle listet die Variablen auf, mit denen Sie InterAction-Informationen übergeben können.
Application Server-Variablen
| Variable | Übergebene InterAction-Informationen |
|---|---|
| Informationen zu einem bestimmten Kontakt | |
| contactEmployerId | Die ID des Arbeitgebers des Kontakts. Dies gilt nur, wenn der Kontakt eine Person ist; für Unternehmen ist der Wert leer. |
| contactEmployerName | Der Name des Arbeitgebers des Kontakts. Dies gilt nur, wenn der aktuelle Kontakt eine Person ist. Dies gilt nur, wenn der Kontakt eine Person ist; für Unternehmen ist der Wert leer. |
| contactFirstName | Der Vorname eines Personenkontakts. Dies gilt nur, wenn der Kontakt eine Person ist; für Unternehmen ist der Wert leer. |
| contactId | Die ID eines Firmenkontakts. Dies wird typischerweise verwendet, wenn Links zu anderen Web Client-Seiten erstellt werden. |
| contactLastName | Der Nachname eines Personenkontakts. Dies gilt nur, wenn der Kontakt eine Person ist; für Unternehmen ist der Wert leer. |
| contactName | Der Name des Kontakts. Bei einer Person wird der Rufname verwendet, falls dieser vom Vornamen abweicht. |
| contactType | Alle Kontaktarten, die diesem Kontakt zugewiesen sind. |
| IAContactId | Kontakt-ID für einen Benutzerkontakt. |
| searchField_sourceID/additionalFieldID |
Der Wert des angegebenen Zusatzfelds. In dieser Syntax ist sourceId die Zusatzfeld-Quellen-ID und additionalFieldId die Zusatzfeld-ID. Diese ID-Werte hängen von Ihrer Seite ab. Um zum Beispiel den Wert des standardmäßigen Felds „Büro“ (aus dem Ordner „Personalinformationen“) zu übergeben, würden Sie folgende Variable verwenden: searchField_2/-10002 Beachten Sie, dass globale Felder immer eine Quellen-ID von 0 haben. Das standardmäßige Feld „Ticker-Symbol“ würde zum Beispiel so referenziert: searchField_0/2 |
| Informationen zum angemeldeten Benutzer | |
| userName | Der Name des Benutzers. Wenn dem Benutzer ein Kontakt zugeordnet ist, wird der Name dieses Kontakts verwendet; andernfalls der Name, der bei der Erstellung des Benutzers im Administrator definiert wurde. |
| employerId | Kontakt-ID des Arbeitgebers des Benutzers. Dies ist normalerweise Ihre Organisation. |
| employerName | Name des Arbeitgebers des Benutzers. Dies ist normalerweise Ihre Organisation. |
| Informationen zu Ihrer Organisation und dem Application Server | |
| ourOrganizationId | Kontakt-ID für den Kontakt, der in InterAction Administrator als „Unsere Organisation“ definiert ist. |
| ourOrganizationName | Name des Kontakts, der in InterAction Administrator als „Unsere Organisation“ definiert ist. |
| PAGE_SERVER |
Die Basis-URL Ihres Application Servers. Wenn Ihr Application Server zum Beispiel „IAAppServer“ heißt, wäre diese Variable wie folgt: http://IAAppServer/InterAction/ Dies kann als Abkürzung nützlich sein, wenn Sie einen Link zu einer anderen Web Client-Seite in einem Profil oder auf der Startseite einfügen möchten. |