Register "Skripte"

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.

 

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/