PRINT+PLUS
  • Einleitung
  • Einrichtung
    • Installation
  • Aktualisierung
    • Aktualisierungseinführung
  • Lizenzierung
    • Lizenzierungseinführung
  • Funktionsweise von PRINT+PLUS
    • Einführung Funktionsweise
  • Gestalten von Vorlagen
    • Intro Vorlagen
    • Beispiel mit Rechnung
    • Formatierung
    • Spezielle Platzhalter für Datum, Ja/Nein-Felder, Bilder und HTML
    • Platzhalter für die Benutzerattribute von cobra CRM
    • Eigene Platzhalter
  • Einrichtung von Ausgabeformaten
    • Intro
    • Alle Einstellungen eines Ausgabeformats im Detail
    • Register "Allgemeine Konfiguration"
    • Register "Ausgangstabelle (Current)"
    • Register "Ausgangs-Vorlage"
    • Register "Übergeordnete Tabellen (Parent)"
    • Register "Untergeordnete Tabellen (Children)"
    • Register "Dokumente speichern"
    • Register "Filter-Dialog"
    • Register "Ergebnis-Verhalten"
    • Register "Skripte"
  • Ausgabe ausführen
    • Intro Ausgabe ausführen
  • AUSGABEN PER TASK AUSFÜHREN
    • Aufgaben dem Task zuweisen
    • Windows Aufgabenplanung für den Task einrichten
    • Besonderheiten in Skripten
  • Eingabemasken Steuerelement
  • Intro Eingabemasken Steuerelement
    • Steuerelement hinzufügen
  • Einbindung von Print+Plus in cobra Kampagnen
  • Intro Einbindung von Print+Plus in cobra Kampagnen
  • Grundlagen Skripting
    • C#
    • Skript-Events
    • Kontexte
    • Geladene Daten verwenden
    • Geladene Daten verändern
    • Datensätze anlegen
    • Eingabemaske öffnen
    • Eigene Werte ergänzen (Custom Values)
  • Beispielskripte
    • Nummer vergeben
    • PDF-Formulare füllen
    • PDF-Dokumente zusammenfügen
    • Generiertes Dokument via SMTP versenden
    • Weitere Ausgabe starten
    • Vorlage aus DMS-Feld holen
    • Felder für CRYPTO+PLUS verschlüsseln
    • Benutzerabhängige Drucker verwenden
    • Bilder in E-Mails einbinden
    • Zahlen in Worten ausschreiben
    • Datensatz-Bilder aus cobra einbetten
    • Ergebnisdokumente kopieren
    • Regionsspezifische Ausgabeformate
    • Andere Datenquelle-Objekte nutzen
    • DocuSign Integration
  • FAQs
    • Fehlermeldung Template konnte nicht geöffnet werden
    • DevExpress-Word-Exporter
      • Bilder in Vorlage
      • Bekannte Einschränkungen
      • Hinweise für Entwickler
  • Zusätzliches Tool im Zusammenhang mit PRINT+PLUS
    • Intro Zusätzliches Tool
Powered by GitBook
On this page
  1. Einrichtung von Ausgabeformaten

Register "Skripte"

PreviousRegister "Ergebnis-Verhalten"NextIntro Ausgabe ausführen

Last updated 10 months ago

Das Einbinden von Skripten in den Exportvorgang ist optional und kann übersprungen werden.

Mit Skripten können Sie dem Export zusätzliches Verhalten hinzufügen, das an von Ihnen ausgewählten Schritten im Export ausgeführt wird. PRINT+PLUS füllt beim Erstellen der Skripte diese mit der Grundstruktur eines PRINT+PLUS-Skripts. Neu erstellte Skripte haben noch kein Verhalten und werden Ihre Ausgabe nicht beeinflussen. Skripte werden mit der Sprache C# geschrieben.

Um ein Skript zu bearbeiten oder zu erweitern, werden Kenntnisse in C# vorausgesetzt. Skripte können auch von Ihrem cobra Partner oder von uns individuell für Sie angefertigt werden – bitte fragen Sie nach.

Um ein neues Skript hinzuzufügen klicken Sie auf „Hinzufügen“.

Geben Sie im Eingabefeld von „Dateiname“ entweder einen einfachen Dateinamen (z. B. „BelegPrefill“) oder einen relativen Pfad (z. B. „MeineBelege/Skripte/BelegPrefill“) an, oder suchen Sie über den „Durchsuchen“-Button nach bereits vorhanden Skripten. Die Dateiendung kann bei neuen Skripten weggelassen werden. PRINT+PLUS fügt in diesem Fall eine Dateiendung an. Neue Skripte werden wie Vorlagen im Vorlagenorder abgelegt.

Über „Typ“ legen Sie fest, wann genau während des Exportvorganges das Skript ausgeführt werden soll.

Die Eigenschaften des Skripts können im Code-Editor bearbeitet werden. Im linken Feld befinden sich die Felder der konfigurierten Tabelle dieser PRINT+PLUS-Aufgabe.

Man kann links die Feldnamen anklicken – beim Rechtsklick geht ein Kontextmenü mit zusätzlichen Funktionen auf. Diese werden automatisch in den Skriptbereich eingefügt.

Es besteht ebenfalls die Möglichkeit dem Skript Referenzen hinzuzufügen. Damit können Funktionen von externen Programmbibliotheken verwendet werden.

Typ von Skripten

Hier finden Sie eine Auflistung der Typen. Diese werden von allen Exporter-Typen, bis auf Skript-Exporter, verwendet. Der Skript-Exporter bildet hier eine Ausnahme und verwendet nur die markierten Typen.

mehr Details siehe: Skript-Events

Typ

Ausführung des Skriptes erfolgt:

Skript-Exporter

BeforeFirstDocument

Wird als erstes ausgeführt. Es sind weder Daten geladen noch Dokumente erstellt.

X

AfterCurrentRowsLoaded

Nachdem die Datensätze der konfigurierten Haupttabelle geladen wurden.

X

BeforeLoadData

Vor jedem vollständigen Laden eines Datensatzes.

X

AfterLoadData

Nach dem vollständigen Laden eines Datensatzes, inklusive konfigurierter über- und untergeordneter Tabellen.

X

BeforeOpenTemplate

Bevor die definierte Vorlage zum Ersetzen der Platzhalter geöffnet wird.

AfterOpenTemplate

Nachdem die definierte Vorlage zum Ersetzen der Platzhalter geöffnet wurde.

BeforeOpenChildTemplate

Vor dem Öffnen einer Vorlage einer untergeordneten Tabelle.

AfterOpenChildTemplate

Nachdem eine Vorlage für eine untergeordnete Tabelle geöffnet wurde.

BeforeFillChildDocument

Bevor die Platzhalter einer Vorlage für eine untergeordnete Tabelle ersetzt werden.

AfterFillChildDocument

Nach dem die Platzhalter in einer Vorlage einer untergeordneten Tabelle ersetzt wurden.

BeforeFillDocument

Nachdem die Dokumente für die untergeordneten Tabellen erstellt wurden, aber bevor die Hauptvorlage mit Daten befüllt wird.

AfterFillDocument

Nachdem die Hauptvorlage mit Daten befüllt wurde, das Dokument fertig erstellt.

BeforeSavingDocument

Bevor das erzeugte Dokument gespeichert wird.

AfterSavingDocument

Nachdem das erzeugte Dokument gespeichert wurde.

AfterClosingDocument

Nachdem das Dokument ggf. im DMS oder erzeugtem Kontakt abgelegt wurde und das Dokument geschlossen wurde.

AfterLastDocument

Nachdem das letzte Dokument erstellt wurde.

X

BeforeCreateMasterDocument

Bevor alle Dokumente im Listendokument zusammengefasst werden.

AfterCreateMasterDocument

Nachdem alle Dokumente im Listendokument zusammengefasst wurden.

In Kapitel 6.5 finden Sie den Hinweis, mit einer eigenen Skriptlogik eigene Platzhalter zu erstellen. Eigene Platzhalter werden durch im Skript angegebene Logik ersetzt. Das nachstehende Beispiel verdeutlicht die Ersetzung eines eigenen Platzhalters für den Fall des verwendeten Exportertyps „WordInterop“.

// Version 4 namespace Ruthardt.PrintPlus.Skripting { using Ruthardt.PrintPlus.Export.WordInteropExporter; using Ruthardt.CobraFramework.Ado; using CobraBase.Functions.Access.Ado; using System; using Ruthardt.PrintPlus.Export.WordInteropExporter; using Microsoft.Office.Interop.Word; using Ruthardt.PrintPlus.Model.Interfaces; /// <summary> /// AfterFillDokument /// </summary> public class DatumSetzen : IScriptAction { public void Execute(IPrintContext printContext, ICurrentContext currentContext, IChildContext childContext) { // Jetzt im Dokument Platzhalter ersetzen in Form [#text#] var wm = ((WordInteropModul)printContext.ExportApplication); wm.ReplacePlaceholders(ReplacePlaceholder, null,

(Document)currentContext.ExportDocument, "[#", "#]"); }

/// <summary> /// Die Logik um die Platzhalter zu ersetzen /// </summary> private string ReplacePlaceholder(string wordPlaceholder, object placeholderRange, object tag) { if (wordPlaceholder.Equals("Datum", StringComparison.OrdinalIgnoreCase)) { return DateTime.Now.ToString("dd.MM.yyyy"); } return null; } } }

Weitere Beispiel-Skripte finden Sie unter https://www.plustools.eu/printplus/skriptvorlagen/