Versions Compared

Old Version 7

changes.mady.by.user Dinah Bolli

Saved on

compared with

New Version 8

changes.mady.by.user Dinah Bolli

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Skriptbeispiele verbessert

...

Code Block
languagexml
<CustomDataNode id="ExampleFirstLastNameAndTitle">
  <Line>
    <Element id="Profile.User.Salutation" separator=" " />
    <Element id="Profile.User.FirstName" separator=" " />
    <Element id="Profile.User.LastName" />
  </Line>
  <Line>
  	<Element id="Profile.Org.Title" />
  </Line>
</CustomDataNode>

...

Code Block
languagexml
<CustomDataNode id="ExampleConditionBeispiel">
  <Line>
    <Element id="Profile.User.Salutation" separator=" " />
    <!-- Condition direkt auf dem Element               Und/ UND-Verknüpfung ↓ -->    
    <Condition<Element  when="CustomElements.ShowFirstName = 'true' + CustomElements.DontShowFirstName = 'false'">
  id="Profile.User.FirstName" />
    <Element id="Profile.User.FirstNameLastName" />
    </Condition>
  </Line>
  <Condition notwhen="CustomElements.ShowTitle = 'false'">
    <Line>
      <Element id="Profile.Org.Title" />
    </Line>
  </Condition>
</CustomDataNode>

...

Code Block
languagexml
<CustomDataNode id="BeispielSnippetSkriptSnippetSkript" update="true">
  <Condition<Snippet when="RedCircle = 'true'">     <Snippet id="05da9095-de60-4b78-bcd8-692639e8d377" />
  </Condition>>
  <Condition<Snippet notwhen="RedCircle = 'true' | BlueCircle = 'false'">
    <Snippet id="5bc2d759-431f-41e0-a18c-d577b240e612" />
  </Condition>
</CustomDataNode>

...

Verschiedene Skript-Arten

...

Code Block
languagexml
<?xml version="1.0" encoding="utf-8"?>
<Configuration>
  <Script engine="XSL" version="2" depth="{[Config.Depth]}">
    <CustomDataNode id="Scripts.Beispiel">
        [...]
    </CustomDataNode>   
  </Script>
</Configuration>

...

Code Block
languagexml
<CustomDataNode id="Scripts.BeispielLineBeispiel">
  <Line>
    [...]
  </Line>
</CustomDataNode>

...

Code Block
languagexml
<CustomDataNode id="Scripts.TextBeispiel">
  <Line>
    <Text>Das ist ein Fixtext.<Text>
  </Line>
</CustomDataNode>

Attribut

Beschreibung

when

siehe Condition

notwhen

siehe Condition

...

Code Block
languagexml
<CustomDataNode id="Scripts.BeispielElementBeispiel">
  <Line>
    <Element id="Profile.User.Postal.City" separator=", " fCase="lower" />
    <Element id="DocParam.Date" fFormattingDate="dddd, d. MMMM yyyy" />
  </Line>
</CustomDataNode>

Attribut

Beschreibung

id

Id des Feldes, das eingefügt werden soll

checkBoxActivatedSymbol

Definition des Zeichens, das bei einer angewählten Checkbox ausgegeben werden soll

checkBoxDeactivatedSymbol

Definition des Zeichens, das bei einer nicht angewählten Checkbox ausgegeben werden soll

linePrefix

Präfix-Zeichen für jede Zeile einer Liste bzw. eines mehrzeiligen Text-Elements

separator

Trenntext zum nächsten Element oder Text, der nur angezeigt wird, wenn das nachfolgende Element einen Inhalt liefert.

showEmptyEndLines

Übernimmt alle vorhandenen nachgestellten Leerzeilen: true/false (false ist Standard)

showEmptyStartLines

Übernimmt alle vorhandenen vorangestellten Leerzeilen: true/false (false ist Standard)

textafter

Fixtext, der immer hinter dem Element erscheint. z. B. textafter=" Uhr"

textbefore

Fixtext, der immer vor dem Element erscheint. z. B. textbefore="MwSt: "

when

siehe Condition

notwhen

siehe Condition

Funktionen

fCase*

Definiert, ob der einkommende Text gross (upper) oder klein (lower) geschrieben werden soll: fCase="[upper/lower]". Für Unicode-Zeichen gibt es eine Erweiterung, die ähnlich funktioniert: upperUnicode/lowerUnicode

fFormattingDate*

Definiert ein explizites Format für ein DateTime-Element. Generell wird immer mit den in den Globalen Übersetzungen vorhandenen Formaten verknüpft:
fFormattingDate="{D[Configuration.DateFormat.WrittenOut]}, ergibt z. B. fFormattingDate="d. MMMM yyyy.

fFormattingNumber*

Definiert ein explizites Format für Telefonnummern in einem Textfeld (z. B. im Feld "Profile.User.Phone"). z. B.
fFormattingNumber="{D[Configuration.PhoneNumberFormat]}, ergibt z. B. fFormattingNumber="+00 00 000 00 00,41 Literale (siehe auch http://openbook.galileocomputing.de/csharp/kap30.htm ):
# → Stellenplatzhalter
0 → Stellenplatzhalter (identisch mit # jedoch wird hier das Zeichen '0' ausgegeben wenn keine Zahl an dieser Stelle vorhanden ist)
' → Text-Maskierung (Text, der in einfachen Anführungszeichen eingegeben wird, wird nicht interpretiert und als Text ausgegeben)
\ → Zeichen-Maskierung (Das nächste Zeichen wird nicht interpretiert und als Zeichen ausgegeben)

fFormattingNumeric*

Definiert ein explizites Format für Nummern.
z. B. fFormattingNumeric="C3" (C=Währung, 3=Nummer der Dezimalstellen)

fReplace*

Definiert, ob ein Teil des Textes ersetzt werden soll.
z. B. fReplace="[bestehende Zeichenkette],[neue Zeichenkette]"

fSelectLine*

Definiert, ob aus einem mehrzeiligen Text eine oder mehrere Zeilen selektiert werden sollen.
z. B. fSelectLine="[Startzeile],[Endzeile]"

fSubstring*

Definiert, ob nur ein Teil des Textes ausgegeben werden soll.
z. B. fSubstring"[Startzeichen],[Anzahl Zeichen]"

fSubstringAfter*

Definiert, ob nur das Ende (nach einer bestimmten Zeichekette) des Textes ausgegeben werden soll. Ist das Trennzeichen nicht vorhanden wird der ganze Text ausgegeben.
z. B. fSubstringAfter="[Zeichenkette]"

fSubstringAfterOrEmpty*

Definiert, ob nur das Ende (nach einer bestimmten Zeichenkette) des Textes ausgegeben werden soll. Ist das Trennzeichen nicht vorhanden wird kein Text ausgegeben.
z. B. fSubstringAfterOrEmpty="[Zeichenkette]"

fSubstringBefore*

Definiert, ob nur der Anfang (vor einer bestimmten Zeichenkette) des Textes ausgegeben werden soll. Ist das Trennzeichen nicht vorhanden wird der ganze Text ausgegeben.
z. B. fSubstringBefore="[Zeichenkette]"

fSubstringBeforeOrEmpty*

Definiert, ob nur der Anfang (vor einer bestimmten Zeichenkette) des Textes ausgegeben werden soll. Ist das Trennzeichen nicht vorhanden wird kein Text ausgegeben.
z. B. fSubstringBeforeOrEmpty="[Zeichenkette]"

fTrim*

Definiert, ob nur eine maximale Anzahl an Zeichen ausgegeben werden soll.
z. B. fTrim="[maximale Anzahl Zeichen],[Modus],[Platzhalter]".
[Modus] → Ort, an welchem bei Überlänge der Text abgeschnitten werden soll. Erlaubte Werte: left, right und middle
[Platzhalter] → Platzhaltertext, der eingefügt wird, sofern eine Überlänge erreicht ist (z. B. "...")

fTrimURL*

Definiert, ob nur ein Teil einer URL oder eines Dateipfades ausgegeben werden soll (siehe auch fTrim). z. B. fTrimURL="[Art],[Modus],[Anzahl Ordner]"
[Art] → File oder Folder, wobei File den Dateinamenselektiert und Folder den Pfad ohne Dateinamen. Aus diesem Grund stehen die nachfolgenden Optionen "Modus" und "Anzahl Ordner" nur bei Folder zur Verfügung.
[Modus] → Ort, von welchem aus die Anzahl gewünschter Ordner angezeigt werden soll. Erlaubte Werte left und right
[Anzahl Ordner] → Anzahl der Ordner, die angezeigt werden soll.

...

Code Block
languagexml
<CustomDataNode id="Scripts.ConditionsBeispielCityDate">
  <Condition when="DocParam.CheckBox1DateIsBelowCity">
    <Line>
      <Element id="Profile.User.Postal.City" separator=", " fCase="lower" />
   /> </Line>
    <Line>
      <Element id="DocParam.Date" fFormattingDate="dddd, d. MMMM yyyy" />
    </Line>
  </Condition>
  <Condition notwhen="DocParam.CheckBox1DateIsBelowCity">
    <Line>
      <Element id="Profile.Org.Postal.City" separator=", " fCase="lower" />
      <Element id="DocParam.Date" fFormattingDate="d. MMMM yyyy" />
    </Line>
  </Condition>
</CustomDataNode>

...

In einem when- oder notwhen-Attribut können auch Vergleichsoperatoren verwendet werden, wobei Fixtexte in einfachen Anführungszeichen (') stehen müssen:

Code Block
languagexml
<CustomDataNode id="Scripts.ConditionsBeispiel"CityDate">
  <Condition when="Signer_0.Org.Unit contains 'direktion'">
    <Line>
      <Element id="Signer_0.Org.Unit" />
  <Condition when="DocParam.CheckBox1 contains 'direktion'"> </Line>
    <Line>
      <Element id="Profile.User.Postal.City" separator=", " fCase="lower" />
      <Element id="DocParam.Date" fFormattingDate="dddd, d. MMMM yyyy" />
    </Line>
  </Condition>
  <Condition notwhen="DocParam.CheckBox1Signer_0.Org.Unit contains 'direktion'">
    <Line>
      <Element id="Profile.Org.Postal.City" separator=", " fCase="lower" />
      <Element id="DocParam.Date" fFormattingDate="d. MMMM yyyy" />
 
  </Line>
  </Condition>
</CustomDataNode>

...

Code Block
languagexml
<CustomDataNode id="Scripts.SnippetScript">
  <Snippet id="b353eb86-ac5a-4db4-99bc-1847e31793bb" />
</CustomDataNode>

Attribut

Beschreibung

id

Id des Feldes, das eingefügt werden soll

type

"Text" oder "Html" für einen fixen Inhalt, wobei der Inhalt innerhalb eines CDATA-Tags innerhalb des Snippet-Tags folgt: <Snippet><![CDATA[Beispieltext]]></Snippet>

when

siehe Condition

notwhen

siehe Condition

Warning

WARNUNGACHTUNG
Bei der Verwendung von Snippet handelt es sich um ein Snippetskript. Dieses kann nicht mit Texten (z. B. mit Element) oder Bildern (Image) gemischt werden. Siehe “Verschiedene Skript-Arten”.
Zudem sollte bei der Anwendung von Snippetskripts unbedingt folgende Seite aus den Best Practices beachtet werden: Einfügen von Snippetskripts in Inhaltsvorlagen.

...

Mittels List kann eine dynamische Liste von Elementen ausgegeben werden. Meistens wird das Element für die Anzeige einer Empfängerliste (z. B. in einem Protokoll) zur Anwendung. Innerhalb einer Liste können wieder die Attribute Line, Element und Condition verwendet werden. Die Adressierung der Ids wird nun relativ gemacht, das heisst, dass nun anstelle von Contact.Recipient.Selected.Person.FirstName nur noch Person.FirstName verwendet wird.

Code Block
languagexml
<CustomDataNode id="Scripts.RecipientAnList">
  <List type="Recipient" filter="An">
    <Line>
      <Element id="Person.SalutationShort" separator=" " />
      <Element id="Person.Title" separator=" " />
      <Element id="Person.FirstName" separator=" " />
      <Element id="Person.LastName" separator=", " />
      <Element id="Company.NameLine1" />
    </Line>
  </List>
</CustomDataNode>

...

Code Block
languagexml
<CustomDataNode id="Scripts.ImageBeispiel">
  <Line>
 
  <Image id="Profile.User.ProfilePicture" />
  </Line>
</CustomDataNode>

Attribut

Beschreibung

id

Id des Feldes, das eingefügt werden soll

when

siehe Condition

notwhen

siehe Condition

Warning

WARNUNGACHTUNG
Bei der Verwendung von Image handelt es sich um ein Image-Skript. Dieses kann nicht mit Texten (z. B. mit Element) oder Textbausteinen (Snippet) gemischt werden. Siehe “Verschiedene Skript-Arten”.