Blöcke

Verarbeitung

Funktionsweise

Das Blocktoken wird durch Verwendung der folgenden Syntax in eine HTML-Seite eingefügt:

<table>
<!adx="MyBlock">
    <tr>
        <td adx="aBLKELMTRANK"></td>
        <td adx="ITEMREF"></td>
    </tr>
<!adx="MyBlock">
</table>

Die XTEND-Engine geht bei der Verarbeitung der Blöcke wie folgt vor:

Parsing-Phase der HTML-Seite

Diese Etappe wird nur einmal beim Laden der HTML-Seite durchgeführt:

• Erstellung des Blockobjekts und Hinzufügen zur Baumstruktur
• Berechnung der Abhängigkeiten zwischen den Blöcken, wenn die Auswahl eines Blocks von einem anderen Block abhängt.
  Das Ergebnis dieser Berechnung ergibt die Initialisierungsreihenfolge der Blöcke.

Generierungsphase der HTML-Seite

Diese Etappe wird bei jeder Anzeige der HTML-Seite durchgeführt:

1. 1. Initialisierung der Blöcke

• Berechnung der Auswahlkriterien in Abhängigkeit vom Auswahltyp,
• Aufruf des Webservices "Datenzugriff" mit den Auswahlkriterien als Parameter
• Erstellung und Speicherung der zurückgegebenen Entitäten

2. 2. Iteration über alle zurückgegebenen Entitäten

• Positionierung der Entität in den Datenkontext
• Aufruf des Verfahrens zur HTML-Generierung nachgeordneter Tokens
• Löschen der Entität im Datenkontext

Würde die Auswahl im vorhergehenden Beispiel 3 Artikel mit den Codes PUZ001, PUZ002 und PUZ003 zurückgeben, ergäbe sich daraus eine Tabelle mit drei Zeilen:

 Folgendes HTML wird in diesem Fall generiert:

Das HTML des Blocktokens wurde dreimal wiederholt und jedes Mal neu berechnet, wobei der neue Datenkontext (aktuelle Zeile) berücksichtigt wurde.

<table>
    <tr>
        <td>1</td>
        <td>PUZ001</td>
    </tr>
    <tr>
        <td>2</td>
        <td>PUZ002</td>
    </tr>
    <tr>
        <td>3</td>
        <td>PUZ003</td>
    </tr>
</table>

Auswahl und Sortierung

Über die Anzeige von Datentabellen hinausgehend, verwaltet das Blocktoken die dynamische Änderung von Änderungs- und Sortierkriterien.

Die Standardkriterien werden durch die Parametrierung des Blocks definiert, und es kann festgelegt werden, ob die Änderung dieser Kriterien durch einen dynamischen Link erlaubt ist.

Das Token dynamischer Link, für das auch Auswahl- und Sortierungsparameter gewählt werden können, kann die Kriterien des Blocks verändern.

Nur die Auswahl- und Sortierkriterien des Hauptblocks der Seite (alias AMAIN) können durch die Auswahl- und Sortierkriterien der dynamischen Links verändert werden.

Es ist möglich, mehrere Blöcke für eine Seite festzulegen, aber nur ein Block (der Hauptblock) kann Auswahl- und Sortierkriterien enthalten, die durch den Benutzer geändert werden können.

Es existieren drei Arten der Änderung der Kriterien eines Blocks durch einen dynamischen Link:

• Die Kriterien des dynamischen Links "Ersetzt die Auswahl des Hauptblocks":
• Auswahl des Blocks = Auswahlkriterien des Links.

• Die Kriterien des dynamischen Links "Ergänzt die Auswahl des Hauptblocks":
• Die Suche im Block wird mit den Kriterien des Links verfeinert.
• Auswahl des Blocks = Auswahlkriterien des Blocks + Auswahlkriterien des Links

• Die Kriterien des dynamischen Links "Werden zur Auswahl des Hauptblocks hinzugefügt":
• Die Suche im Block wird verfeinert, indem die Auswahl des dynamischen Links zur aktuellen Suche des Blocks hinzugefügt wird (logisches UND).
• Diese Option wird verwendet, wenn sich die Auswahl des Blocks aus der Zusammenfassung mehrerer dynamischer Links ergibt.
• Auswahl des Blocks = Auswahlkriterien des Blocks + Summe der Kriterien aller angeklickten Links

Mit diesen drei Optionen können die meisten Situationen verwaltet werden, die in den Webseiten auftreten.

Im Datenblatt des Blocktokens können die Auswahl- und Sortierkriterien des Blocks parametriert werden.

Bei der ersten Anzeige der den Block enthaltenden Seite werden die Standardkriterien angewendet.

Das Token Block enthält die beiden Parameter "Auswahl änderbar" und "Sortierung änderbar". Diese Parameter legen fest, ob die Auswahl- und/oder Sortierkriterien durch einen dynamischen Link geändert werden können.

Sie werden nur angewendet, wenn der Block im Datenblatt der Webseite, auf der er angezeigt wird, als Hauptblock definiert wurde.

Block mit mehreren Zellen pro Zeile

Soll ein Block mit mehreren Zellen pro Zeile angezeigt werden, wird das Sondertoken ASTAMP verwendet, um die Zelle abzugrenzen.

Der HTML-Code zwischen den beiden ASTAMP-Tags wird vom XTEND-Server so oft dupliziert, wie es Zellen in der Zeile gibt.

<table>
<!-Iteration über Blockzeilen-->
<!adx="MYBLOCK">
    <tr>
        <!-Code so oft wiederholen, wie es Zellen pro Zeile gibt-->
        <!adx="ASTAMP">
                <!--Zur Veränderung der Zellenfarben-->                           
                <td adx="ALINESTYLE:xattr=Class">
                   <!--HTML-Code einer Zelle-->
                   <b>Name</b><p adx="NAME"></p>
                   <b>Vorname</b><p adx="FIRSTNAME"></p>
                </td>
        <!adx="ASTAMP">
    </tr>
<!adx="MYBLOCK">
</table>

Ausfüllen leerer Zellen

Im nachfolgenden Beispiel wird dargestellt, wie leere Zellen ausgefüllt werden müssen, wenn die Anzahl der Datensätze nicht ein Vielfaches der Zellenanzahl pro Zeile ist.

Zur Abgrenzung des HTML für die leeren Zellen wird der bedingte BlockADISPSTAMPEMPTY verwendet.

<table>
<!-Iteration über Blockzeilen-->
<!adx="MYBLOCK">
    <tr>
        <!adx="ASTAMP">                        
                <td adx="ALINESTYLE:xattr=Class">
                    <!adx="ADISPSTAMPEMPTY">
                        <!--Leere Zellen werden mit einem Leerzeichen gefüllt-->      
                        &nbsp;
                    <!adx="ADISPSTAMPEMPTY">
                    <!adx="ADISPSTAMPEMPTY:xnot">
                        <!--HTML-Code einer nichtleeren Zelle-->
                        <b>Name</b><p adx="NAME"></p>
                        <b>Vorname</b><p adx="FIRSTNAME"></p>   
                    <!adx="ADISPSTAMPEMPTY">
                </td>
        <!adx="ASTAMP">
    </tr>
<!adx="MYBLOCK">
</table>

Aktionen mit Einfluss auf die Blöcke

Seitennummerierung

Mithilfe der Aktionen ABLKFIRSTPAGE, ABLKNEXTPAGE, ABLKPREVPAGE, ABLKLASTPAGE kann die Seitennummerierung in den Blöcken verwaltet werden.

Die Tokens ADLKFIRSTPAGE, ADLKNEXTPAGE, ADLKPREVPAGE, ADLKLASTPAGE können für den Hauptblock der Seite verwendet werden.

Die Felder aBLKNBELMTS und APAGEPOS zeigen die Gesamtanzahl der Datensätze sowie die Position der Seite im Verhältnis zur Gesamtanzahl der Seiten an.

Die bedingten Blöcke AHIDEMAINFIRSTPAGE und AHIDEMAINLASTPAGE steuern das Einblenden / Ausblenden der Buttons für die Seitennummerierung auf der ersten und der letzten Seite.

Syntax

MonBloc.ADLK*

Beispiel:

Seitennummerierung mit Verwaltung der Anzeige der ersten und letzten Seitennummern

<table width="100%">
    <tr>
        <td align="left" width="20%">
        <!--Hide FirstPage and Previous actions if current page is the first page-->           
            <!adx="aHideMainFirstPage">
                <!---->
                <a href="" adx="AMAIN.aDlkFirstPage">Première</a>
                <a href="" adx="AMAIN.aDlkPrevPage">Précedente</a>
            <!adx="aHideMainFirstPage">
        </td>
        <!--Displays page information-->
        <td align="center" width="60%">
            Seite: <span adx="AMAIN.aPagePos"></span> -
            Anzahl Elemente: <span adx="AMAIN.aBlkNbElmts"></span>
        </td>
        <td align="right" width="20%">                         
        <!--Hide LastPage and Next actions if current page is the last page--> 
            <!adx="aHideMainLastPage">
                <a href="" adx="AMAIN.aDlkNextPage">Suivante</a>
                <a href="" adx="AMAIN.aDlkLastPage">Dernière</a>
            <!adx="aHideMainLastPage">
        </td>
    </tr>
</table>

Auswahl einer Zeile

Mithilfe der dynamischen Links ADLKSELECT und ADLKUNSELECT (Aktion ABLKSELECT und ABLKUNSELECT) kann eine Blockzeile ausgewählt bzw. die Auswahl dieser Zeile aufgehoben werden.

Verwendung

Die Tokens ADLKSELECT und ADLKUNSELECT werden in eine Zelle der Zeile eingefügt, entweder in ein Tag <a> oder in ein Tag <input type='button'>.

Das Feld ABLKSELECTEDLINE enthält den Rang (1 bis N) der ausgewählten Zeile.

Beispiel:

Der Block ABLKCOUNTRIES zeigt die Länder des Standorts ASAMPLE an. Es besteht die Möglichkeit zur Auswahl der Zeile, um die Auskunft Währung / Sprache des Landes anzuzeigen.

Durch Klick auf die erste Zelle (CRY) wird die Zeile ausgewählt.

<!adx="ABLKCOUNTRIES:xselect=false"> 
    <tr>
        <td><a adx="ADLKSELECT"><span adx="CRY"></span></a></td>
        <td adx="CRYDES"></td>    
        <td adx="CUR"></td>
        <td adx="LAN"></td>                
    </tr> 
<!adx="ABLKCOUNTRIES"> 
<!--Anzeige der gewählten Zeilennummer-->
<span adx='ABLKCOUNTRIES.ABLKSELECTEDLINE'></span>

Der HTML-Parameter 'xSelect=true' ermöglicht die standardmäßige Auswahl der ersten Zeile.

Existiert dieser Parameter nicht oder steht sein Wert auf "false", enthält der Block keine standardmäßig ausgewählte Zeile.

Enthält ein Block eine ausgewählte Zeile, können die Felder dieser Zeile durch die Syntax MonBloc.MonChamp aufgerufen werden.

Die Feldwerte der ausgewählten Zeile können angezeigt oder als Kriterien in einem Block, einem dynamischen Link oder einem bedingten Block verwendet werden.

Der bedingte Block AHIDEMAINSELECT verwaltet das Einblenden / Ausblenden einer HTML-Zone in Abhängigkeit davon, ob der Hauptblock eine ausgewählte Zeile besitzt (siehe auch die Seite der Länder des Standorts ASAMPLE).

Rückkehr Auskunft zu Liste

Mithilfe der Aktion ABLKRESTOREMAINCTX kann von einer Seite Auskunft zu einer Seite Liste zurückgekehrt werden, ohne dass die Seitennummerierung und die ausgewählte Zeile des Hauptblocks verloren gehen.

Über den folgenden dynamischen Link kann zur Seite FORMQUERYRES zurückgekehrt werden, wobei der Kontext des Hauptblocks wiederhergestellt wird.

<input type="button" value="Retour liste" adx="DlkFrmQueryBack" class="xtendButton" >

Direkter Zugriff auf die Zeilendaten

Mithilfe der folgenden Syntax können die Zeilendaten eines Blocks direkt aufgerufen werden:

<!--Erste Zeile-->
<span adx="MYBLOCK(first).MYFIELD"></span>]<br>
<!--Letzte Zeile-->
<span adx="MYBLOCK(last).MYFIELD"></span>]<br>
<!-N. Zeile-->
<span adx="MYBLOCK(N).MYFIELD"></span>]<br>

Zugriff auf die Daten eines Blocks in JavaScript (JSON)

Mithilfe der folgenden Syntax kann eine JavaScript-Variable mit JSON-Darstellung aus einem Block oder der Zeile eines Blocks bewertet werden:

<script>
    //JSON-Daten eines Blocks
    var wMyBlock_JSON=<!adx="MYBLOCK(*)"><!adx="MYBLOCK(*)">;
    var wMyBlock_JSON=<!adx="MYBLOCK(*)"><!adx="MYBLOCK(*):xinclude=FIELD1,FIELD2">;
    var wMyBlock_JSON=<!adx="MYBLOCK(*)"><!adx="MYBLOCK(*):xexclude=FIELD1,FIELD2">;
    //JSON-Daten einer Zeile
    var wMyLine_JSON=<!adx="MYBLOCK(2)"><!adx="MYBLOCK(2)">;
    var wMyLine_JSON=<!adx="MYBLOCK(2):xinclude=FIELD1,FIELD2"><!adx="MYBLOCK(2)">;
    var wMyLine_JSON=<!adx="MYBLOCK(2):xexclude=FIELD1,FIELD2"><!adx="MYBLOCK(2)">;
</script>

Die JSON-Variable eines Blocks ist eine Zeilentabelle (Array):

<script>
    var wMyBlock = [{ligne 1},{ligne 2},...];
   var wMyBlock = [{"STATUT":1,"STATUT_DESCR":"A traiter","PRIX":81.35,"COD2":"30-112"},
    {"STATUT":2,"STATUT_DESCR":"Traité","PRIX":117.9,"COD2":"31-02"},
    {"STATUT":1,"STATUT_DESCR":"A traiter","PRIX":606.15,"COD2":"32-034"}];
</script>

Die JSON-Variable einer Zeile ist ein Objekt mit Feldern:

<script>
    var wMyLine ={"CHAMP1":"Valeur1","CHAMP2":"Valeur2"...};
   var wMyLine = {"STATUT":1,"STATUT_DESCR":"A traiter","PRIX":606.15,"COD2":"32-034"}
</script>

Der Parameter xjson erzeugt für ein Feld ein JSON-Objekt {"NomChamp:"Valeur"}. Ohne den Parameter xjson, wird die JavaScript-Variable mit dem Feldwert bewertet.

<script>
    //JSON-Daten eines Feldes
    var wMyField_JSON=<!adx="MYFIELD:xjson"><!adx="MYFIELD">;
    //XTEND generiert
    var wMyField_JSON={"MYFIELD":"Valeur"};
   //Wert eines Feldes
    var wMyField_JSON=<!adx="MYFIELD"><!adx="MYFIELD">;
    //XTEND generiert
    var wMyField_JSON="Valeur";
</script>

HTML-Parameter

Blockfelder

Vordefinierte Blöcke

Vordefinierte Blöcke

Vorbedingungen

Siehe Dokumentation Umsetzung

Maskenverwaltung

Kopfzeile

Register Allgemeine Angaben

Register Auswahl

Register Sortierung

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 / Freigabe mit Prüfung

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

Fehlermeldungen

Nur generische Fehlermeldungen.

Verwendete Tabellen

Siehe Dokumentation Umsetzung