Zugriff auf OneOffixx-Felder

In OneOffixx stehen zahlreiche Felder zur Verfügung. OneOffixx-Felder sind Text-Container, die eine Id besitzen. Der Inhalt dieser Felder wird beim Generieren durch die Dokumentfunktionen und/oder durch einen Connect-Aufruf bestimmt. Einige typischen Beispiele für OneOffixx-Felder:

Id	Möglicher Inhalt	Dokumentfunktion
DocParam.Subject	Kann den Betreff enthalten, der im Dokument-Parameter-Dialog vom Benutzer eingegeben wurde	DocumentParameter
Profile.User.Email	Kann die E-Mail-Adresse der Person enthalten, die das Dokument generiert	ProfileData
Contact.Recipient.Selected.Person.FirstName	Kann den Vornamen des im Empfängerdialog ausgewählten Empfängers enthalten	RecipientAddresses
CustomElements.SenderAddressBlock	Kann den nach bestimmten Skript-Regeln erstellten Adressblock des Absenders enthalten	Skripte
MyExampleApplication.ProjectNo	Kann die Projektnummer aus dem Connect-Aufruf einer Fachapplikation enthalten	CustomInterfaceConnector

Auf diese Felder kann aus den Dokumentfunktionen Skripte und Bibliothek für erweitertes Binding zugegriffen werden. Sie werden generierten Dokument im CustomXMLPart mit Namen OneOffixxDocumentPart abgelegt.

Schlussendlich müssen die Inhalte der Felder in den Vorlagen wiedergegeben werden können. Nachfolgend wird aufgeführt, wie dieser Inhalt in verschiedenen Szenarien in die Dokumente übernommen wird.

Word

In Word werden OneOffixx-Felder mit "Nur-Text-Inhaltssteuerelementen" (Englisch: "Plain Text Content Controls") eingefügt. Dafür muss das OneOffixx-Word-AddIn wie folgt verwendet werden:

Word-Felder

Word bietet selber ebenfalls Felder an. Das kann zum Beispiel die Seitenzahl, der Dokumentname oder das Druckdatum sein. Diese existierten bereits vor Word 2007 und können mit Ctrl+F9 oder über Einfügen → Schnellbausteine → Feld... eingefügt werden. Es gibt Szenarien, in denen gewünscht wird, dass diese Felder aktualisiert werden.

In den folgenden Situationen werden die Word-Felder automatisch aktualisiert:

• Beim Klick auf einen dieser Buttons im OneOffixx-Ribbon in der Gruppe "Fertigstellung": Drucken, Senden, Vorschau, PDF speichern
  Die Aktualisierung findet auch statt, wenn bei einem allfälligen Folgedialog "Abbrechen" gewählt wird.
• Beim Öffnen des Dokumentes, wenn die benutzerdefinierte Dokumenteigenschaft "OORefreshFieldsOnOpen" vom Typ Boolean (Ja oder Nein) und true (Ja) ist
• Beim Speichern des Dokumentes, wenn die benutzerdefinierte Dokumenteigenschaft OORefreshFieldsOnSave vom Typ Boolean (Ja oder Nein) und true (Ja) ist

Die genannten benutzerdefinierten Dokumenteigenschaften ("Custom Document Properties") können über die Dokumentfunktion Metadaten gesetzt werden.

Outlook

Inhalt:

• HTML: mit "Nur-Text-Inhaltssteuerelementen", analog Word
• RichText: mit RichText-Bindings; {IdDesOneOffixxElements}
• Text: mit Text-Bindings; {IdDesOneOffixxElements}

Diese drei Typen können über das OneOffixx-Outlook-AddIn folgendermassen eingefügt werden:

An-, Cc-, Bcc- und Betreff-Feld:

In E-Mailvorlagen werden die Felder "An", "Cc", "Bcc" und "Betreff" mit Bindings eingefügt: {IdDesOneOffixxElements}. Dabei können OneOffixx-Felder auch mit anderem Text zusammengesetzt werden.
Beispiele:

• {DocParam.Subject} wird zu Anfrage
• Nr.: {DocParam.ProjectNo} wird zu Nr.: 110475
• {CustomElements.SmsPhoneNumber}@smsservice.mycompany.com wird zu 41123456789@smsservice.mycompany.com