Eigene Werte ergänzen (Custom Values)

Dieser Abschnitt beschreibt, wie man der Ausgabe weitere Werte hinzufügen kann, die nicht als Feld in cobra existieren.

Auf CurrentContext und ChildContext gibt es eine Eigenschaft CustomValues. Diese ist ein Dictionary mit einem Namen als Key und einem beliebigen Wert als Value. Werte die hier hinzufügt werden können im Dokument mit der normalen Platzhalter-Syntax abgerufen werden. Hierbei ist wie üblich die Verwendung von Formatierungen möglich.

Wird ein Wert mit dem selben Namen eingefügt, wie ein cobra-Feld benannt ist, dann wird zuerst der CustomValue ausgewertet. Der cobra Feldwert wird in diesem Fall nicht ausgegeben.

Skript Ausschnitt

// So wird ein CustomValue zugewiesen
currentContext.CustomValues["Aktuelles Datum"] = DateTime.Now;

// So wird ein CustomValue im Dokument abgerufen
{MyPrefix.AktuellesDatum}

// Falls gewünscht könnten Formatierungen genutzt werden
{MyPrefix.AktuellesDatum#dd.MM.yy}

Beispiel Bilder einfügen

Mit den CustomValues lassen sich sehr leicht Bilder einfügen die nicht im cobraDms liegen oder nicht ohne Weiteres mit den Standard Bild-Platzhaltern eingefügt werden können.

// Pfad ermitteln - hier könnte ihre komplexe Pfad-Ermittlungslogik implementiert werden
string meinBildPfad = "C:\Users\vm\Desktop\MeinBild.png";

// Pfad dem CustomValue zuweisen
currentContext.CustomValues["MeinBild"] = meinBildPfad;

// So wird das Bild im Dokument abgerufen
{MyPrefix.MeinBild#BildAbsolut}