PDF-rapporter¶

Ibland identifieras inte tabeller som sådana på grund av komplexa strukturer. I dessa fall kan du fortfarande ändra dem manuellt i rapportens XML. Med en försäljningsorder kan du till exempel hitta följande struktur i XML (förenklad för dokumentationsändamål):

<!-- 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>

För att modifiera en tabell måste du se till att varje rad har samma antal dataceller. I fallet ovan måste du t.ex. lägga till en cell i rubrikavsnittet (med t.ex. kolumntiteln) och en annan i brödtextavsnittet med fältinnehållet (vanligtvis med ett t-out- eller t-field-direktiv).

<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>

Observera

Celler kan sträcka sig över flera rader eller kolumner. Mer information finns på webbplatsen för Mozilla Developer Network.

Du kan t.ex. modifiera rapporten Anbud/Order och lägga till en kolumn som visar produktkategorin i huvudtabellen:

<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">

För att lägga till en tabell i XML behöver du veta namnen på de fält och objekt som du vill komma åt och visa. Som ett exempel kan vi lägga till en tabell som beskriver taggarna på en försäljningsorder:

<!-- 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>

Om du vill visa/dölja innehåll baserat på specifika villkor, kan du manuellt lägga till if/else kontrollsatser i rapportens XML.

Om du t.ex. vill dölja en anpassad datatabell om det inte finns några taggar kan du använda attributet t-if för att definiera villkoret, som sedan utvärderas som True eller False. Tabellen visas inte om det inte finns några taggar i citatet.

<!-- 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>

Om du vill visa ett annat block om t-if-satsen utvärderas som False, kan du ange det med hjälp av t-else-satsen. t-else-blocket måste följa direkt efter t-if-blocket i dokumentstrukturen. Det finns ingen anledning att ange något villkor i t-else-attributet. Som exempel kan vi visa ett snabbt meddelande som förklarar att det inte finns några taggar i citatet:

<!-- 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>

Genom att använda notationen t-if/t-else visar rapportredigeraren att dessa avsnitt är ömsesidigt uteslutande och bör visas som villkorliga block:

Du kan byta villkor med hjälp av editorn för att förhandsgranska deras resultat:

Om du vill ha flera alternativ kan du också använda t-elif-direktiv för att lägga till mellanliggande villkor. Så här ändras t.ex. titeln på försäljningsorderrapporter baserat på villkoret för det underliggande dokumentet.

<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>

Titeln Pro-Forma Invoice används beroende på vissa kontextuella villkor. Om dessa villkor inte är uppfyllda och dokumentets status är antingen draft eller sent, då används Quotation. Om inget av dessa villkor är uppfyllda är rapportens titel Order.

Att arbeta med bilder i en rapport kan vara en utmaning, eftersom exakt kontroll över bildstorlek och beteende inte alltid är uppenbart. Du kan infoga bildfält med hjälp av rapportredigeraren (med kommandot /Field), men att infoga dem i XML med direktivet t-field och tillhörande t-options attribut ger bättre kontroll över storlek och positionering.

Följande kod matar t.ex. ut fältet image_128 för radens produkt som en 64px bred bild (med en automatisk höjd baserad på bildens bildförhållande).

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

Följande alternativ är tillgängliga för bildwidgets:

• width: bildens bredd, vanligtvis i pixlar eller CSS-längdenheter (t.ex. rem) (lämna tomt för automatisk bredd).

• height: bildens höjd, vanligtvis i pixlar eller CSS-längdenheter (t.ex. rem) (lämna tomt för automatisk höjd).

• class: CSS-klasser som tillämpas på img-taggen; Bootstrap-klasser är tillgängliga.

• alt: alternativ text för bilden

• style: stilattribut; det gör att du kan åsidosätta stilar mer fritt än med Bootstrap classes.

Dessa attribut måste innehålla strängar, dvs. text omsluten av citattecken inom citattecken, t.ex. t-options-width="'64px'" (eller, alternativt, ett giltigt Python-uttryck).

Låt oss till exempel lägga till en kolumn med produktbilden i offert-tabellen:

<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"/>

Attributet t-options-width begränsar bildbredden till 64 pixlar, och Bootstrap-klasserna som används i t-options-class skapar en miniatyrliknande ram med rundade hörn och en skugga.