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
Ein Feld in Forms erstellen.
Die Word-Vorlage in primedocs öffnen.
Den Cursor im Dokument an die richtige Stelle platzieren.
Auf “Feld binden” klicken.
Im “Feld auswählen”-Dialog in der Dropdown-Liste das Forms-Feld auswählen.
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 |
---|---|---|
| Kann den Betreff enthalten, der im Dokument-Parameter-Dialog vom Benutzer eingegeben wurde. | |
| Kann die E-Mail-Adresse der Person enthalten, die das Dokument generiert. | |
| Kann den Vornamen des im Empfängerdialog ausgewählten Empfängers enthalten. | |
| Kann den nach bestimmten Skript-Regeln erstellten Adressblock des Absenders enthalten. | |
| Kann die Projektnummer aus dem Connect-Aufruf einer Fachapplikation enthalten. |
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:
Klick auf “Inhalt verknüpfen”
Cursor im Dokument an die richtige Stelle setzen
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 zuAnfrage
Nr.: {DocParam.ProjectNo}
wird zuNr.: 110475
{CustomElements.SmsPhoneNumber}@smsservice.mycompany.com
wird zu41123456789@smsservice.mycompany.com
PrimeSoft AG, Bahnhofstrasse 4, 8360 Eschlikon, Switzerland