Felder

Ablauf

Feldtypen

Einfach Typen

Dabei handelt es sich um Felder des Typs: Text, Integer, Decimal, Währung, Date.

URL-Typen

Dabei handelt es sich um Felder, die im Tag <img> oder <a> zur Generierung von URL verwendet werden, die Zugriff auf Ressourcen vom Typ Bild oder Datei (text, pdf, doc etc.) bieten.

'Zugriff Bild'

Felder vom Typ 'Zugriff Bild' werden im HTML-Tag <img> verwendet.

Solche Felder werden mit einem 'Mapping' (bei einer Aktion oder einem 'Datenzugriff') angelegt, wobei ein Webservice-Parameter mit folgendem Inhalt verwendet wird:

• entweder ein Datum vom Typ Text
• oder ein Datum vom Typ BLOB

Mapping mit einem Parameter vom Typ X3-BLOB

Für das Mapping führt der Server folgende Bearbeitung durch:

• Lesen des Mime-Types des X3-BLOB-Parameters, welcher vom X3-Webservice-Server berechnet wird
• Handelt es sich um den Mime-Typ 'image', wird das binäre Datum im Cache der X3-Daten gespeichert.
• Handelt es sich um den Mime-Type 'text', siehe Mapping mit Parameter vom Typ 'Char'.
• Es wird dann eine URL berechnet, mit der das Bild im Speicher wiedergefunden und an den Browser zurückgesendet werden kann.
• Dem Feld wird der Wert dieser URL (text) zugewiesen.

Beispiel:

Nachstehende URL wird bei der Bearbeitung des Ergebnisses eines 'Datenzugriff'-Webservice-Aufrufs generiert, mit dem eine Tabelle mit einem BLOB-Feld gelesen werden soll.

<img src="http://host:port/xtend/x3rsrc/X3SOLUTION/X3FOLDER/XTENDSITE/FRA/ITEMPCT30-112.gif">

Der Name der Ressource, mit der das Datum im Speicher wiedergefunden werden kann, setzt sich wie folgt zusammen:

• CodeEntität + CodeFeld + WertSchlüselfeld + Erweiterung,
• wobei es sich bei WertSchlüsselfeld um den Wert des in der XTEND-Einheit definierten Schlüsselfelds (Auswahlfeld) handelt.

In unserem Beispiel wurde für die Entität ITEM ein Schlüsselfeld ITMREF definiert.

Als Ergebnis wird die URL eines Artikels (Entität ITEM) zurückgegeben. Die URL stammt aus dem BLOB-Parameter (PCT) mit Schlüssel (Schlüsselfeld ITMREF) 30-112.

Die Erweiterung ist vorgegeben:

• entweder durch die Felddaten
• oder (standardmäßig) durch die Site-Daten

Die Parameter 'Wurzelverzeichnis' und 'Relativer Pfad' werden bei dieser Art von Mapping nicht berücksichtigt.

Berücksichtigt wird lediglich der Parameter Erweiterung.

Mapping mit einem Parameter vom Typ Char oder CLOB

Muss vom XTEND-Server ein Feld 'Zugriff Bild' auf Basis eines Webservice-Parameters vom Typ Text angelegt werden, so wird angenommen, dass der entsprechende Text den Ressourcennamen enthält.

Vom Server wird also eine URL dieser Ressource generiert, wobei in die Berechnung des Zugriffspfads die Parameter 'Wurzelverzeichnis', 'Relativer Pfad' sowie 'Erweiterung' eingehen.

XTEND-Verzeichnisse

Zur Speicherung von XTEND-Dateien sind vier Wurzelverzeichnisse definiert. Auf die Ressourcen (Dateien, Bilder etc.) dieser Verzeichnisse kann im Browser über die Tokens 'Bild' und 'Anlagen' zugegriffen werden.

• HTML-Design : Verzeichnis des HTML-Projekts der jeweiligen Benutzersprache

• X_FILES : X3-Ordnerverzeichnis, das sich in X3_PUB/X3FOLDER/X_TEND/X_FILES befindet

• X_FILEAPP : X3-Ordnerverzeichnis, das sich in
  X3_PUB/X3FOLDER/X_TEND/X_FILAPP befindet.
  Dieses Verzeichnis wird dafür verwendet, die aus der Batchverarbeitung stammenden Dateien wie z. B. die vom Druckserver generierten Berichte zu speichern.

• X_TEND : Verzeichnis, in dem gemeinsame Dateien aller Ordner gespeichert werden.
  Dabei kann es sich z. B. um erzeugte Bilder, Vertriebsdokumente etc. handeln.
  Dieses Verzeichnis befindet sich unter X3_PUB/X_TEND/.

HTML-Design und X-FILES können sich auf dem X3-Server (Standard) oder auf dem Webservice-Server befinden.

X_FILEAPP und X_TEND befinden sich immer auf dem X3-Server.

'Zugriff Anlage'

Analog zu Typ 'Zugriff Bild', wobei Ressourcen aller Typen verwendet werden können (gif-, jpg-, pdf-, doc-, xls-Dateien etc.).

Die Tokens vom Typ 'Zugriff Anhang' werden generell mit den HTML-Tags <a></a> verwendet, um dem Benutzer das Öffnen der Datei per Klick auf den sensitiven Bereich zu ermöglichen.

<a src="http://host:port/xtend/data/remote/SOL/FLDR/X_TEND/X_HTML/SITE/FRA/FA.pdf">get Pdf</a>

Wie beim Typ 'Zugriff Bild' wird das Mapping zwischen dem X3-Parameter und dem XTEND-Feld in Abhängigkeit vom Typ des X3-Parameters durchgeführt.

Mapping mit einem Parameter vom Typ X3-BLOB

Der Server speichert das binäre Datum und berechnet die URL auf dieselbe Weise wie für das Token 'Zugriff Bild'.

Mapping mit einem Parameter vom Typ Char oder CLOB

Der Server geht davon aus, dass das Feld den Ressourcennamen enthält und berechnet die URL auf dieselbe Weise wie für das Token 'Zugriff Bild'.

Typ Lokales Menü

Felder vom Typ Lokales Menü enthalten einen Integer-Wert.

Typ Flash

Felder vom Typ Flash werden zum Einfügen von X3-Flash-Komponenten in HTML-Seiten mit dem Tag <object>verwendet.

Zur Kommunikation mit dem X3-Server greift die Flash-Komponente auf eine 'Ajax'-XTEND-Abfrage zurück.

Diese Abfrage ruft das Unterprogramm SUBAPSMON/MONITEUR mit den von der Flash-Komponente gelieferten Parametern auf.

 Um Flash-Komponenten mit XTEND verwenden zu können, muss das Unterprogramm SUBAPSMON/MONITEUR zuvor:

• als Webservice veröffentlicht worden sein
• in XTEND durch eine Schnittstellenbeschreibung deklariert sein

Fall Feldtyp Flash

Prüfen Sie, ob die Verarbeitung SUBAPSMON/MONITEUR als Webservice veröffentlicht ist und der Veröffentlichungsname AXTDFLASH lautet.

Ist das Unterprogramm nicht veröffentlicht:

• Legen Sie unter Beachtung der Parameternamen und Veröffentlichungsgruppen die Unterprogrammdaten an
• Veröffentlichen Sie das Unterprogramm mit dem Alias AXTDFLASH

Das Unterprogramm SUBAPSMON/MONITEUR verwendet die X3-Variable GUSER, die korrekt positioniert sein muss.

Im Webservice-Modus enthält die globale X3-Variable GUSER den X3-Benutzercode, der beim Aufruf des Webservices als Parameter übergeben wurde.

XTEND weist den X3-Benutzercode in Abhängigkeit davon zu, ob der Benutzer eine Signatur besitzt:

• Ein XTEND-Benutzer ohne Signatur verwendet den standardmäßig im Webservice-Pool definierten X3-Benutzercode.
• Ein XTEND-Benutzer mit Signatur verwendet den X3-Benutzercode, der von der Anmeldefunktion zurückgegeben wird.

Anlegen der Schnittstelle

Ist keine AXTDFLASH-Schnittstelle vorhanden, legen Sie eine Datei vom Typ 'Aktion Unterprogramm' mit AXTDFLASH als Veröffentlichungsname an.

Zeigt die Flash-Komponente Daten einer anderen X3-Lösung an, 

• prüfen Sie, ob der Webservice SUBAPSMON/MONITEUR/AXTDFLASH in dieser Lösung veröffentlicht ist,
• und verwenden Sie einen speziellen Webservice-Pool (bzw. legen Sie diesen an), der mit dieser Lösung verbunden ist.

Anlegen von Flash-Feldern

• Legen Sie per Auswahl der AXTDFLASH-Schnittstelle ein Feld vom Typ Flash pro 'Portalview' an.
• Fügen Sie das Field-Token in das HTML-Tag <object> ein.

 Zur Bedeutung der Parameter siehe technischen Adobe-Hinweis TN-12701.

<div>
    <object adx="MYFLASHFIELD" width="400" height="300">
        <!--Parameter des Tags Object -->
        <param name="quality" value="high">
        <param name="scale" value="noscale">
        <param name="salign" value="lt">
        <param name="bgcolor" value="#FF0000">
    </object>
</div>

Das adx-Token den HTML-Parameter xcache (<object adx="MYFLASHFIELD:xcache">). Dies dient dazu, die xml-Antwort des Webservices im Browserspeicher zu speichern, sofern gewünscht.

Link Auskunft

Der dem Flash-Feld zugeordnete dynamische Link dient dazu, den Klick in das Kontextmenü Auskunft der Flash-Komponente zu einer XTEND-Seite umzuleiten.

Die Linkparameter entsprechen den von der Flash-Komponente gelieferten:

Verwendung Field-Token

Außerhalb von HTML-Tags

Verwenden Sie zur Anzeige des Wertes eines Field-Tokens ohne Verwendung von HTML-Tags folgende Syntax,
die auch zur Belegung von JavaScript-Variablen dient:

<body>
<script>
    //Auswertung einer JavaScript-Variable
    var myGlobal=<!adx="MyField"><!adx="MyField">;
</script>
<form>
    <!adx="MyField">xxxx<!adx="MyField"><br>
=
    <p adx="MyField">xxxx</p>
<form>
</body>

Tag div,span,td,th,p,b,small,big,i,label,li,pre,tt

Durch das Field-Token in diesen HTML-Tags wird der Inhalt zwischen <tag> und </tag> durch den Feldwert ersetzt.

Durch das eingefügte adx-Token werden die vorhandenen Attribute erhalten.

<div adx="MyField"></div>
<td adx="MyFieldDate:xempty=20090101&xfomat=Dz:DD[ ]MMMMMMMMMM[ ]YYYY></td>
<b adx="MyField"></b>

HTML-Parameter

<select>-Tag

Mit dem <select>-Tag wird einer von N Werten erfasst. Das Verhalten des Tags hängt vom Typ des Tokens ab.
Ist das Attribut 'Name' nicht vorhanden, wird es von XTEND generiert, wobei als Name der Tokenname verwendet wird,

Token Lokales Menü oder XTEND-Werteliste:

• fügt eine Option pro Element des Lokalen Menüs hinzu
• und wählt die dem Feldwert entsprechende Option aus

Hinweis: Als Feld 'XTEND-Werteliste' werden Felder vom Typ Text bezeichnet, zu denen eine Werteliste erfasst wurde.

Beispiel 1:

SELECTMENULOC zeigt auf das Menü 7803 und besitzt den Wert 4:

<select adx="SELECTMENULOC" class="smallTxt">
        <option value="">Keines</option>
</select>

Generierter HTML-Code:

<select name="SELECTMENULOC"class="smallTxt">
<option selectedvalue="">Keines</option>
<option value="1">Prozess-Id</option>
 ...
<option selected="selected" value="4">Verbindungsdatum</option>
...
<option value="13">Phys IO</option></select>Standard-Token

Beispiel 2:

<select adx="SELECTMENULOC:xonchange=ADLKPOSTPAGE" class="smallTxt">
        <option value="">Keines</option>
</select>

Generierter HTML-Code:

XTEND wählt die dem Feldwert entsprechende Option aus.
Im nachstehenden Beispiel wird 'Deutschland' ausgewählt, wenn der Wert von MYOKENFIELD "DE" beträgt.

<select name="MYTOKENFIELD">
    <option value="">Keines</option>
    <option value="AT">&Oumlsterreich</option>
    <option selected="selected" value="DE">Deutschland</option>
    <option value="ES">D&aumlnemakr</option>
</select>

HTML-Parameter

Das ausgewählte Tag akzeptiert folgende Parameter:

<select adx="MYFIELDMAIN:xonchange=MYDYNLINK&xfill=MYFIELDFILL&xrc">
</select>

Tag 'input text' oder 'hidden'

Mit dem <input>-Tag kann ein Wert erfasst werden.
Das Field-Token aktualisiert den beim Laden der Seite gesetzten Standardwert (attribute value) mit dem Feldwert.

Ist das Attribut 'Name' nicht vorhanden, wird es von XTEND generiert, wobei als Name der Tokenname verwendet wird,

<input type="text" SIZE="100" adx="MAICOD:xrc">

HTML-Parameter

<textarea>-Tag

Mit dem <textarea>-Tag kann ein Kommentar erfasst werden.

<textarea cols="100" rows="5" adx="CMT:xrc">Kommentar...</textarea>

HTML-Parameter

Analog zum <input>

-Tag Bezeichnung

Felder, die eine Werteliste oder ein Lokales Menü enthalten, können in HTML-Seiten als Bezeichnungen verwendet werden.
Als Bezeichnungen können auch Felder vom Typ Text ohne Werteliste verwendet werden. Hierfür muss der Parameterwert erfasst werden.

Wird in der HTML-Seite anstatt eines Textes ein Bezeichnungs-Tag verwendet, kann der Webmaster die Bezeichnungen in X3 ändern, ohne den HTML-Code verändern zu müssen.

Die Bezeichnungen können auch dazu verwendet werden, dieselbe HTML-Seite in mehreren Sprachen zu generieren.

Wertauswahl

Wenn ein Lokales Menü oder eine Werteliste verwendet werden, können demselben Feld mehrere Werte zugewiesen werden; dadurch werden die Anzahl von angelegten Tokens minimiert und die Bezeichnungsverwaltung vereinfacht.

Die Auswahl des Wertes im Token erfolgt über den HTML-Parameter 'xcaption'.

Die Klassifizierung eines Feldes als Bezeichnung gibt dem XTEND-Server an, dass es sich um einen statischen Wert handelt. So kann die Generierung der HTML-Seite optimiert werden.

Bezeichnung Lokales Menü

<span adx="LIBMENULOCAL:xcaption=1" style="color:#FF0099"></span><br>
<span adx="LIBMENULOCAL:xcaption=2" style="color:#FF0099"></span><br>

Bezeichnung mit Werteliste

<span adx="LIBMENUXTD:xcaption=DOC" style="color:#FF0099"></span><br>
<span adx="LIBMENUXTD:xcaption=NEW" style="color:#FF0099"></span><br>

Wiederherstellung der Bezeichnung eines Lokalen Menüs

Fall: Das Feld ORDSTA ist dem Lokalen Menü 1 zugeordnet (Ja / Nein). Der Wert des Felds ORDSTA beträgt 2.

<td align="right" adx="ORDSTA_DESC">XXX</td>

Generierter HTML-Code:

<td align="right">Ja</td>

Zuweisung eines Attributwerts

Mit nachstehender Syntax kann dem Attribut meinAttribut der Wert des Field-Tokens zugewiesen werden:

<div adx="MyField:xattr=meinAttribut"></div>
Beispiel: Der Wert von Myfield beträgt 'MyBeautifulClass'
<div adx="MyField:xattr=class"><div>Generiere<div class="MyBeautifulClass"><div>
Den Ids kein ein Suffix hinzugefügt werden.
<div adx="MyField:xattr=id&xnotempty=article"><div> Generiere <div id="PUZ001article"><div>

Stilwechsel bei den Tabellenzeilen

Das Sonderfeld ALINESTYLE enthält die Klassen der geraden und ungeraden Zeilen, wie sie im Blockparameter 'Stil nach Zeile' definiert sind.

Mit nachstehendem Code kann zwischen dem Stil für gerade und dem Stil für ungerade Zeilen gewechselt werden.

<table>
<!adx="MeinBlock">
    <tr adx="aLineStyle:xattr=Class"></tr>
<!adx="MeinBlock">
</table>
Generiere
<table>
    <tr Class="KlasseGeradeZeile">...</tr>
    <tr Class="KlasseUngeradeZeile">...</tr>
    <tr Class="KlasseGeradeZeile">...</tr>
</table>

Automatische Generierung eines Id-Attributs

Zur Entwicklung von komplexen Benutzerschnittstellen müssen die DOM-HTML-Element-Ids direkt adressiert werden (Attribut-Id).

In XTEND steht eine Syntax zur Generierung der Attribut-Id zur Verfügung, die insbesondere in den Blöcken nützlich ist.

Mit dem Sondertoken Feld AAUTOID

können Ids vom Typ AAUTOID_X generiert werden.
Wenn sich das Tag in einem XTEND-Block befindet, steht X hierbei für den Index der aktuellen Zeile.

AAUTOID kann mit mehreren verschachtelten Blöcken AAUTOID_X_Y_Z arbeiten.

HTML-Parameter xautoid

Wenn Sie zur Belegung des HTML-Tags bereits ein Field-Token verwenden, kann auch der HTML-Parameter verwendet werden.

• Verfügt das HTML-Tag über eine nicht leere Attribut-Id, wird der entsprechende Wert als Präfix der Id verwendet.
• Sonst wählt XTEND den Tokenname als Präfix.

Beispiel:

<table>
<!adx="MeinBlock">
    <tr adx="AUTOID">
        <td adx="ITMREF&xautoid"></td>
    </tr>
<!adx="MeinBlock">
</table>
Generiere
<table>
    <tr id="AAUTOID_1">
        <td id="ITMREF_1">PUZOO1</td>
    </tr>
    <tr id="AAUTOID_2">
        <td id="ITMREF_2">PUZOO2</td>
    </tr>
</table>

Vordefinierte Field-Tokens

In nachstehender Tabelle ist die Liste der von XTEND berechneten Field-Tokens zu entnehmen:

Vorbedingungen

Siehe Dokumentation Umsetzung

Maskenverwaltung

Kopfzeile

Register Allgemeine Angaben

Register Erweitert...

Berichte

Standardmäßig sind der Funktion folgende Reports zugeordnet :

 PRTSCR : Druck Maske

Dies kann durch geeignete Parameter geändert werden.

Spezielle Buttons

Menüleiste

Tools / Anlageassistent

Funktion

Diese Funktion steht im Werkzeugmenü der Parameterdaten zur Verfügung.

Aktion

Mit ihr werden Field-Tokens angelegt:

• auf Basis der Feldliste einer X3-Tabelle
• auf Basis der Feldliste eines X3-Views
• auf Basis der einer Schnittstelle zugeordneten Webservice-Parameter

 Damit der XTEND-Server die Felder berücksichtigt, müssen diese nach der Generierung freigegeben werden.

Bei Freigabe wird ein neues XML-Dictionary der XTEND-Parameter angelegt.

Wenn die Option 'Technik\Aktualisierung\ Prüfen\Web-Dictionary'der Site

aktiviert ist, wird das neue Dictionary bei Aktualisierung / F5 der HTML-Seite im Browser nicht automatisch berücksichtigt.
Sonst muss die Dictionary-Aktualisierung mithilfe folgender URL erzwungen werden: 'http://hostname:port/xtend/svc/SolutionX3/DossierX3/SiteXtend/admin/reposit/reload'

Tools / Freigabe mit Prüfung

Freigabe mit Kohärenzprüfung der XTEND-Dictionary-Daten 

Fehlermeldungen

Nur generische Fehlermeldungen.

Verwendete Tabellen

Siehe Dokumentation Umsetzung