Intrinsiches Objekt ctvNgen

Das sog. intrinsic Objekt ctvNgen stellt Eigenschaften und Methoden zur Verfügung, um von Steuerungsmodulen aus verschiedene Operationen der CTV Engine auszulösen. Außerdem können Eigenschaften der CTV Engine abgefragt oder gesetzt werden, die bestimmte Operationen der CTV Engine beinflussen.

Die hier beschriebenen Eigenschaften und Methoden stehen nur im Pseudocode innerhalb des CTV-Wizard zur Verfügung!

Anlegen von Schriftgut

Aus vordefinierten Komponenten

   ctvNgen.AddSchriftgut(<expr-1>, <expr-2>, <expr-3> [, <expr-4>]) 
   
   <expr-1>: Name der CTV Komponente
    <expr-2>: Bausteintyp der CTV Komponente
    <expr-3>: Anwendung, zu der die CTV Komponente gehört
    <expr-4>: Name des Bündels, zu dem das erzeugte Schriftgut gehören soll

Aus der angegebenen Schriftgutdefinition wird ein Schriftgutobjekt erzeugt. Optional kann der Name eines Bündels angegeben werden, zu dem das Schriftgutobjekt gehören soll.

Aus bestehenden Dokumenten

ctvNgen.AddDocument(<expr-1>, <expr-2> [, <expr-3> [, <expr-4>]]) 

<expr-1>: Vollständiger Pfadname des Dokumentes
 <expr-2>: Name, unter dem das Dokument angelegt werden soll
 <expr-3>: Name des Bündels, zu dem das erzeugte Schriftgut gehören soll
 <expr-4>: CTV-Variablenzuweisungen für dieses Dokument

Der Inhalt der durch <expr_1> angegebenen Datei wird als eigenständiges Dokument hinzugefügt, und steht als Schriftgutobjekt unter den Namen aus <expr-2> zur Verfügung. Optional kann der Name eines Bündels angegeben werden, zu dem das Schriftgutobjekt gehören soll. Wenn nötig, können CTV-Variablenzuweisungen übergeben werden.

Eigenschaften abfragen und/oder setzen

blnIsSet = ctvNgen.<prop-1>
 ctvNgen.<prop-1> = blnIsSet

<Prop-1>: Name der Eigenschaft.

Es stehen folgende Eigenschaften zur Verfügung:

EigenschaftBedeutung
PrintLocal
ExpertDialogDiese Eigenschaft sorgt dafür, dass der CTV Dialog im Expertenmodus (True) oder im sog. Lite-Modus (False) angezeigt wird.
SetupDialogSoll die Druckerauswahldialog bei jeder Druckanweisung angezeigt werden (True), oder nicht (False).
AllowPDFBundleWenn diese Eigenschaft auf True gesetzt wird, bietet der CTV Dialog im sog. Lite-Modus die Möglichkeit ,die selektierten Schriftstücke zusammen in einer PDF Datei abzulegen.
PDFBundleFileDiese Eigenschaft enthält den Pfadnamen der PDF Datei mit den gebündelten Schriftstücken. Diese Eigenschaft kann vor der Dialoganzeige (ShowDialog) auf einen von der Anwendung definierten Pfad, oder auf Leerstring gesetzt werden. Enthält sie einen Leerstring, so kann der Sachbearbeiter den Pfadnamen festlegen, und dieser ist nach der Dialoganzeige über diese Eigenschaft abfragbar.

Selektieren von Schriftgut

Alle Operationen des ctvNgen-Objektes werden auf die zu dem Zeitpunkt selektierten Schriftgutobjekte ausgeführt. Wenn Schriftgut hinzugefügt wurde, so ist das zuletzt hinzugefügte Schriftgutobjekt selektiert, und alle nachfolgenden Operation werden nur auf dieses Schriftgutobjekt ausgeführt.

Selektieren aller bekannten Schrifgutobjekte

 ctvNgen.SelectAll() 

Alle der CTV-Engine bekannten Schriftgutobjekte werden für die nachfolgende Operation selektiert.

Selektieren aller Schrifgutobjekte aus einem Bündel

ctvNgen.SelectBundle(<expr-1>)
   
<expr-1>: Name des Bündels, dessen zugehörige Schriftgutobjekte selektiert werden sollen

Alle Schriftgutobjekte, die zu dem übergebenen Bündel gehören, werden für die nachfolgende Operation selektiert.

Selektieren auf Basis von ZZCTV

 ctvNgen.SelectOm() 

Alle in dem globalen Objekt ZZCTV markierten Schriftgutobjekte werden für die nachfolgende Operation selektiert.

Schriftgut mit Daten versorgen

ctvNgen.Update(<expr-1>, <expr-2>, <expr-3> [, <expr-4> [, <expr-5>]])

<expr-1>: Bausteintyp der CTV Komponente
 <expr-2>: Name der CTV Komponente
 <expr-3>: Operation der CTV Komponte, die gesetzt werden soll
 <expr-4>: Argumentzuweisungen
 <expr-5>: CTV-Variablenzuweisungen

Für alle selektierten Schriftgutobjekte, die aus der Schriftgutdefinition mit den Namen <expr-1> und den Bausteintyp <expr-2> erzeugt worden sind, wird die Operation <expr-3> gesetzt. Optional können für diese Operation definierte Parameterobjekte (<expr-4>) bestückt, und/oder CTV-Variablenzuweisungen übergeben werden.

Schriftgut auswerten

ctvNgen.Reset() 
ctvNgen.Evaluate()

Die Methode Evaluate führt dazu, dass Entscheidungstabellen und Pseudocode der aktuell selektierten Schriftgutobjekte ausgewertet werden, und die Platzhalter in den Dokumenten bestückt werden. Ist das Schriftgut bereits ausgewertet worden, so werden nur die Platzhalter gefüllt, und eventuell neue Bausteine hinzugefügt. Wenn vorher die Methode Reset ausgelöst wird, so werden die selektierten Schriftgutobjekte zurückgesetzt, und die Auswertung findet statt, als hätte vorher noch keine Auswertung stattgefunden.

Schriftgut zu einem Schriftsatz zusammenfügen

ctvNgen.Combine(<expr-1>, [, <expr-2>])

<expr-1>: Name des Schriftsatzes
<expr-2>: Name des Bündels, zu dem der erzeugte Schriftsatz gehören soll

Die aktuell selektierten Schriftgutobjekte werden zu einem neuen Schriftsatz zusammengefügt. Optional kann der Name eines Bündels angegeben werden, zu dem das neu erzeugte Schriftgutobjekt gehören soll.

Schriftgut verwerfen

 ctvNgen.Remove()

Die aktuell selektierten Schriftgutobjekte werden unwiderruflich gelöscht und stehen nicht mehr zur Verfügung.

Schriftgut Drucken

 ctvNgen.Print()

Die aktuell selektierten Schriftgutobjekte werden unter Berücksichtigung der relevanten Eigenschaften ausgedruckt (und archiviert).

Schriftgut Archivieren

ctvNgen.Archive([<expr-1>])

<expr-1>: Soll das Schriftgut als XML archivert werden?

Die aktuell selektierten Schriftgutobjekte werden unter Berücksichtigung der relevanten Eigenschaften archiviert. Optional kann angeben werden, ob nur das XML archiviert werden soll. Ist dieser Parameter nicht angeben, so wird er als Wahr angenommen.

CTV Dialog anzeigen

 ctvNgen.ShowDialog()

Die aktuell selektierten Schriftgutobjekte werden unter Berücksichtigung der relevanten Eigenschaften in dem CTV Dialog angezeigt.

Schriftgut anzeigen

 ctvNgen.ShowPreview([<wordorpdf>])
 <wordorpdf>: Wenn als Argument "true" übergeben wird, erfolgt die Vorschau im PDF-Format, sonst ("false", default) mit dem Word-Viewer.

Von den aktuell selektierten Schriftgutobjekten werden die Ergebnisdokumente als PDF oder im Word-Viewer angezeigt.

ctv:pseudocode:ctvenv · Zuletzt geändert: 27.10.2014 13:56

Copyright © 1992-2024 TeamWiSE Gesellschaft für Softwaretechnik mbH         Adressen |  Kontakt |  AGB |  Datenschutzerklärung |  Impressum