SuggestionArea
Um dem enaio® Outlook Add-In zusätzliche Bereiche als Ablagestandortvorschläge zu übergeben, müssen zuerst entsprechende Objekte erstellt werden.
Objekterzeugung VBScript
1 |
|
Objekterzeugung JScript
1 |
|
Eigenschaften
Eine erstellte SuggestionArea besitzt verschiedene Eigenschaften. Die Erzeugung des Objektes selbst, als auch die Manipulation von Eigenschaften führt automatisch zum Speichern des Objekts. Es ist also nicht nötig, nach der Änderung einer Eigenschaft manuell eine Methode zum Speichern des neuen Wertes aufzurufen.
Name der Eigenschaft | Typ | Default | Beschreibung | Beispiel |
---|---|---|---|---|
Name | String | " " | Der Name des anzuzeigenden Bereiches innerhalb der Vorschlagsliste. Wenn mehrere Bereiche den gleichen Namen haben, werden diese auch skriptübergreifend zusammengefügt |
|
Priority | Integer | 0 | Die Priorität für einen Bereich. Höhere Zahlen bedeuten, dass ein Skript weiter oben angezeigt wird. Die Standardwerte für dauerhaft gezeigte Bereiche sind:
|
|
MailItem | null | Beschreibt das aktuell ausgewählte Element. Anhand der Eigenschaften dieses Objekts können Vorschläge generiert werden. |
|
Methoden
Name der Methode | Rückgabetyp | Parameter | Beschreibung | Beispiel |
---|---|---|---|---|
Add | Void | String 'target' | Diese Methode fügt einem Bereich einen neuen Standort hinzu. Dazu müssen Objekt-ID und Objekttyp-ID, separiert durch ein Komma, als Parameter übergeben werden. Ähnlich wie bei der Änderung einer Eigenschaft, wird der Bereich automatisch gespeichert. Sollte ein Standort übergeben werden, der dem System nicht bekannt ist, wird er später NICHT in der Liste angezeigt. |
|
Beispielskript
Dieses Beispiel zeigt das Zusammenspiel der vorgestellten Eigenschaften und Methoden. Es wird ein neuer Bereich erstellt, der aufgrund der Priorität über den Standardbereichen liegt. Der Name des Bereiches soll in Abhängigkeit der ausgewählten E-Mail geändert werden.
Innerhalb des Bereiches sollen zwei Standorte vorgeschlagen werden. In dem System, mit dem dieses Beispiel erzeugt wird, gibt es jedoch nur den zweiten der hinzugefügten Standorte. Daher wird als Ergebnis nur ein Ablagestandortvorschlag angezeigt.
Beispielskript
<job>
<script language="VBScript">
set area = CreateObject("OptimalSystems.Integration.Shared.Blue.Models.Scripting.SuggestionArea")
area.Name = "Beispielskript der Mail '" & area.MailItem.Subject & "'"
area.Priority = 3
area.Add("123,456")
area.Add("44770,4")
</script>
</job>