Zugriff auf primedocs-Felder



In primedocs stehen zahlreiche Felder zur Verfügung. Diese Felder sind Text-Container, die eine Id besitzen und deren Inhalt beim Generieren durch die Dokumentfunktionen und/oder durch einen Connect-Aufruf bestimmt wird.


Webfähige Vorlagen

In den webfähigen Vorlagen können Sie automatisch auf alle Profildaten des aktuellen Benutzers zugreifen. Um Benutzereingaben zu ermöglichen, gibt es die Forms Dokumentfunktion. Falls Daten zusammengeführt oder umgewandelt werden sollen, kann die Felder (Fields) Dokumentfunktion verwendet werden.

Einfügen eines Forms-Feld in die Vorlage

  1. Ein Feld in Forms erstellen.

  2. Die Word-Vorlage in primedocs öffnen.

  3. Den Cursor im Dokument an die richtige Stelle platzieren.

  4. Auf “Feld binden” klicken.

  5. Im “Feld auswählen”-Dialog in der Dropdown-Liste das Forms-Feld auswählen.

  6. Mit Klick auf “Einfügen” die Auswahl bestätigen.


“classic”-Vorlagen

Einige typischen Beispiele für primedocs-Felder - in der “classic” Vorlagenwelt:

Id

Möglicher Inhalt

Dokumentfunktion

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.

Scripts

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 im 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.

“Classic” Word

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

  1. Klick auf “Inhalt verknüpfen”

  2. Cursor im Dokument an die richtige Stelle setzen

  3. In der Inhaltssteuerelement Verknüpfung das richtige Feld suchen und per Doppelklick einfügen.

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 primedocs-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

Die neue, webfähige Outlook-Version ist hiervon ausgeschlossen.

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 primedocs-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: {IdDesprimedocsElements}. Dabei können primedocs-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

 

PrimeSoft AG, Bahnhofstrasse 4, 8360 Eschlikon, Switzerland