PDF-Berichte¶

Manchmal werden Tabellen aufgrund ihrer komplexen Struktur nicht richtig als solche erkannt. In diesen Fällen können Sie sie trotzdem manuell in der XML-Datei des Berichts ändern. Bei einem Verkaufsauftrag zum Beispiel finden Sie im XML die folgende Struktur (zu Dokumentationszwecken vereinfacht):

<!-- table root element -->
<table>
    <!-- thead = table header, the row with column titles -->
    <thead>
        <!-- table row element -->
        <tr>
            <!-- table header element -->
            <th>Name</th>
            <th>Price</th>
        </tr>
    </thead>
    <!-- table body, the main content -->
    <tbody>
        <!-- we create a row for each subrecord with t-foreach -->
        <tr t-foreach="record.some_relation_ids" t-as="line">
            <!-- for each line, we output the name and price as table cells -->
            <td t-out="line.name"/>
            <td t-out="line.price"/>
        </tr>
    </tbody>
</table>

Um eine Tabelle zu ändern, müssen Sie sicherstellen, dass jede Zeile die gleiche Anzahl von Datenzellen hat. Im obigen Fall müssen Sie beispielsweise eine Zelle in der Kopfzeile (z. B. mit dem Spaltentitel) und eine weitere Zelle im Hauptteil mit dem Feldinhalt hinzufügen (normalerweise mit einer t-out- oder t-field-Anweisung).

<table> <!-- table root element -->
    <thead> <!-- thead = table header, the row with column titles -->
        <tr> <!-- table row element -->
            <th>Name</th> <!-- table header element -->
            <th>Price</th>
            <th>Category</th>
        </tr>
    </thead>
    <tbody>  <!-- table body, the main content -->
        <tr t-foreach="record.some_relation_ids" t-as="line">  <!-- we create a row for each subrecord with t-foreach -->
            <td t-out="line.name"/>  <!-- for each line, we output the name and price as table cells -->
            <td t-out="line.price"/>
            <td t-out="line.category_id.display_name"/>
        </tr>
    </tbody>
</table>

Bemerkung

Zellen können mehrere Spalten oder Zeilen spammen. Weitere Informationen finden Sie auf der Website von Mozilla Developer Network.

Sie können zum Beispiel den Angebots-/Auftragsbericht bearbeiten, um eine Spalte hinzuzufügen, um die Produktkategrie in der Haupttabelle anzuzeigen.

<table class="table table-sm o_main_table table-borderless mt-4">
    <!-- In case we want to repeat the header, remove "display: table-row-group" -->
    <thead style="display: table-row-group">
        <tr>
            <th name="th_description" class="text-start">Description</th>
            <th>Product Category</th>
            <th name="th_quantity" class="text-end">Quantity</th>
            <th name="th_priceunit" class="text-end">Unit Price</th>
[...]
            <tr t-att-class="'bg-200 fw-bold o_line_section' if line.display_type == 'line_section' else 'fst-italic o_line_note' if line.display_type == 'line_note' else ''">
                <t t-if="not line.display_type">
                    <td name="td_name"><span t-field="line.name">Bacon Burger</span></td>
                    <td t-out="line.product_id.categ_id.display_name"/>
                    <td name="td_quantity" class="text-end">
                        <span t-field="line.product_uom_qty">3</span>
                        <span t-field="line.product_uom">units</span>
                        <span t-if="line.product_packaging_id">

Um eine Tabelle in XML hinzuzufügen, müssen Sie die Namen der Felder und Objekte kennen, auf die Sie zugreifen und die Sie anzeigen möchten. Fügen wir zum Beispiel eine Tabelle hinzu, in der die Stichwörter eines Verkaufsauftrags aufgeführt sind:

<!-- table root element -->
<table class="table">
    <!-- thead = table header, the row with column titles -->
    <thead>
        <!-- table row element -->
        <tr>
            <!-- table header element -->
            <th>ID</th>
            <th>Name</th>
        </tr>
    </thead>
    <!-- table body, the main content -->
    <tbody>
        <!-- we create a row for each subrecord with t-foreach -->
        <tr t-foreach="doc.tag_ids" t-as="tag">
            <!-- for each line, we output the name and price as table cells -->
            <td t-out="tag.id"/>
            <td t-out="tag.name"/>
        </tr>
    </tbody>
</table>

Wenn Sie Inhalte auf der Grundlage bestimmter Bedingungen ein- oder ausblenden möchten, können Sie manuell „if/else“-Kontrollanweisungen in die Berichts-XML einfügen.

Wenn Sie zum Beispiel eine benutzerdefinierte Datentabelle ausblenden möchten, wenn keine Tags vorhanden sind, können Sie das Attribut t-if verwenden, um die Bedingung zu definieren, die dann als True oder False ausgewertet wird. Die Tabelle wird nicht angezeigt, wenn keine Tags im Zitat vorhanden sind.

<!-- table root element -->
<table class="table" t-if="len(doc.tag_ids) > 0">
    <!-- thead = table header, the row with column titles -->
    <thead>
        <!-- table row element -->
        <tr>
            <!-- table header element -->
            <th>ID</th>
            <th>Name</th>
        </tr>
    </thead>
    <!-- table body, the main content -->
    <tbody>
        <!-- we create a row for each subrecord with t-foreach -->
        <tr t-foreach="doc.tag_ids" t-as="tag">
            <!-- for each line, we output the name and price as table cells -->
            <td t-out="tag.id"/>
            <td t-out="tag.name"/>
        </tr>
    </tbody>
</table>

Wenn Sie einen weiteren Block anzeigen möchten, falls die t-if-Anweisung als False ausgewertet wird, können Sie diesen mit der t-else-Anweisung angeben. Der t-else-Block muss in der Dokumentstruktur direkt auf den t-if-Block folgen. Es ist nicht notwendig, eine Bedingung im Attribut t-else anzugeben. Lassen Sie uns als Beispiel eine kurze Meldung anzeigen, die erklärt, dass es keine Tags im Zitat gibt:

<!-- table root element -->
<table class="table" t-if="len(doc.tag_ids) > 0">
    <!-- thead = table header, the row with column titles -->
    <thead>
        <!-- table row element -->
        <tr>
            <!-- table header element -->
            <th>ID</th>
            <th>Name</th>
        </tr>
    </thead>
    <!-- table body, the main content -->
    <tbody>
        <!-- we create a row for each subrecord with t-foreach -->
        <tr t-foreach="doc.tag_ids" t-as="tag">
            <!-- for each line, we output the name and price as table cells -->
            <td t-out="tag.id"/>
            <td t-out="tag.name"/>
        </tr>
    </tbody>
</table>
<div class="text-muted" t-else="">No tag present on this document.</div>

Durch die Verwendung der Notation t-if/t-else erkennt der Berichtseditor, dass sich diese Abschnitte gegenseitig ausschließen und als bedingte Blöcke angezeigt werden sollten:

Sie können die Bedingungen mit dem Editor umschalten, um eine Vorschau ihres Resultat zu erhalten:

Wenn Sie mehrere Optionen haben möchten, können Sie auch t-elif-Anweisungen verwenden, um Zwischenbedingungen hinzuzufügen. So ändert sich z. B. der Titel von Verkaufsauftragsberichten in Abhängigkeit von der Bedingung des zugrunde liegenden Dokuments.

<h2 class="mt-4">
    <span t-if="env.context.get('proforma', False) or is_pro_forma">Pro-Forma Invoice # </span>
    <span t-elif="doc.state in ['draft','sent']">Quotation # </span>
    <span t-else="">Order # </span>
    <span t-field="doc.name">SO0000</span>
</h2>

Der Titel Pro-Forma-Rechnung wird abhängig von einigen kontextuellen Bedingungen verwendet. Wenn diese Bedingungen nicht erfüllt sind und der Status des Dokuments entweder Entwurf oder Gesendet ist, wird Angebot verwendet. Wenn keine dieser Bedingungen erfüllt ist, lautet der Titel des Berichts Auftrag.

Die Arbeit mit Bildern in einem Bericht kann eine Herausforderung sein, da die genaue Steuerung von Bildgröße und -verhalten nicht immer offensichtlich ist. Sie können Bildfelder mit dem Berichtseditor einfügen (mit dem Befehl /Feld), aber das Einfügen in XML mit der t-field-Anweisung und den dazugehörigen Attributen t-options bietet eine bessere Kontrolle über Größe und Positionierung.

Der folgende Code gibt zum Beispiel das Feld Bild_128 des Produkts der Zeile als 64px breites Bild aus (mit einer automatischen Höhe, die auf dem Seitenverhältnis des Bildes basiert).

<span t-field="line.product_id.image_128" t-options-widget="image" t-options-width="64px"/>

Die folgenden Optionen sind für Bildwidgets verfügbar:

• width: Breite des Bildes, normalerweise in Pixeln oder CSS-Längeneinheiten (z. B. rem) (für automatische Breite leer lassen).

• height: Höhe des Bildes, in der Regel in Pixeln oder CSS-Längeneinheiten (z. B. rem) (für automatische Höhe leer lassen).

• class: CSS-Klassen, die auf den img-Tag angewendet werden; Bootstrap-Klassen sind verfügbar.

• alt: alternativer Text des Bilds text of the image

• style: Stilattribut; ermöglicht Ihnen, Stile einfacher als mit Bootstrap-Klassen zu überschreiben.

Diese Attribute müssen Strings enthalten, d. h. Text, der in Anführungszeichen eingeschlossen ist, z. B. t-options-width="'64px'" (oder alternativ einen gültigen Python-Ausdruck).

Fügen wir zum Beispiel eine Spalte mit dem Produktbild in die Angebotstabelle ein:

<table class="table table-sm o_main_table table-borderless mt-4">
    <thead style="display: table-row-group">
        <tr>
            <th>Image</th>
            <th name="th_description" class="text-start">Description</th>
            <th>Product Category</th>
            <th name="th_quantity" class="text-end">Quantity</th>
            <th name="th_priceunit" class="text-end">Unit Price</th>
[...]
        <t t-foreach="lines_to_report" t-as="line">
            <t t-set="current_subtotal" t-value="current_subtotal + line.price_subtotal"/>
            <tr t-att-class="'bg-200 fw-bold o_line_section' if line.display_type == 'line_section' else 'fst-italic o_line_note' if line.display_type == 'line_note' else ''">
                <t t-if="not line.display_type">
                   <td>
                       <span t-field="line.product_template_id.image_128"
                             t-options-widget="'image'"
                             t-options-width="'64px'"
                             t-options-class="'rounded-3 shadow img-thumbnail'"
                           />
                   </td>
                    <td name="td_name"><span t-field="line.name">Bacon Burger</span></td>
                    <td t-out="line.product_id.categ_id.display_name"/>

Das Attribut t-options-width schränkt die Bildbreite auf 64 Pixel ein und die in t-options-class verwendeten Bootstrap-Klassen erzeugen einen Rahmen, der Miniaturbildern ähnelt, mit abgerundeten Ecken und einem Schatten.