Rapoarte PDF¶

Uneori, tabelele nu sunt recunoscute în mod corespunzător ca atare din cauza structurilor complexe. În aceste cazuri, le puteți modifica manual în raportul XML. De exemplu, cu o comandă de vânzare, puteți găsi următoarea structură în XML (simplificată în scopuri de documentare):

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

Pentru a modifica un tabel, trebuie să vă asigurați că fiecare rând are același număr de celule de date. De exemplu, în cazul de mai sus, trebuie să adăugați o celulă în secțiunea antet (cu, de exemplu, titlul coloanei) și o altă celulă în secțiunea de corp cu conținutul câmpului (de obicei, cu un t-out sau t directiva -field).

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

Notă

Celulele se pot întinde pe mai multe rânduri sau coloane. Pentru mai multe informații, accesați site-ul web Mozilla Developer Network.

De exemplu, puteți modifica raportul Cotație/Comandă pentru a adăuga o coloană pentru a afișa categoria de produse în tabelul principal:

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

Pentru a adăuga un tabel în XML, trebuie să cunoașteți numele câmpurilor și obiectelor pe care doriți să le accesați și să le afișați. De exemplu, să adăugăm un tabel care detaliază etichetele dintr-o comandă de vânzare:

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

Dacă doriți să afișați/ascundeți conținut pe baza unor condiții specifice, puteți adăuga manual instrucțiuni de control if/else în raportul XML.

De exemplu, dacă doriți să ascundeți un tabel de date personalizat dacă nu există etichete, puteți utiliza atributul t-if pentru a defini condiția, care este apoi evaluată ca True sau False. Tabelul nu va fi afișat dacă nu există etichete în oferta.

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

Dacă doriți să afișați un alt bloc în cazul în care instrucțiunea t-if este evaluată ca False, îl puteți specifica folosind instrucțiunea t-else. Blocul t-else trebuie să urmeze direct blocul t-if din structura documentului. Nu este nevoie să specificați nicio condiție în atributul t-else. De exemplu, să arătăm un mesaj rapid care explică că nu există etichete pe citat:

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

Folosind notația „t-if/t-else”, editorul de rapoarte recunoaște că aceste secțiuni se exclud reciproc și ar trebui să fie afișate ca blocuri condiționate:

Puteți schimba condițiile folosind editorul pentru a previzualiza rezultatele lor:

Dacă doriți să aveți mai multe opțiuni, puteți utiliza și directivele t-elif pentru a adăuga condiții intermediare. De exemplu, așa se modifică titlul rapoartelor comenzilor de vânzare în funcție de starea documentului de bază.

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

Titlul Factură Pro-Forma este folosit în funcție de unele condiții contextuale. Dacă aceste condiții nu sunt îndeplinite și starea documentului este fie „schiță” fie „trimis”, atunci se folosește Citat. Dacă niciuna dintre aceste condiții nu este îndeplinită, titlul raportului este Comandă.

Lucrul cu imagini dintr-un raport poate fi o provocare, deoarece controlul precis asupra dimensiunii și comportamentului imaginii nu este întotdeauna evident. Puteți insera câmpuri de imagine folosind editorul de rapoarte (folosind comanda /Field), dar inserându-le în XML folosind directiva t-field și ` însoțitoare. Atributele t-options oferă un control mai bun al dimensionării și al poziționării.

De exemplu, următorul cod scoate câmpul „image_128” al produsului liniei ca o imagine de 64 de pixeli (cu o înălțime automată bazată pe raportul de aspect al imaginii).

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

Următoarele opțiuni sunt disponibile pentru widget-urile de imagine:

• width: lățimea imaginii, de obicei în pixeli sau unități de lungime CSS (de exemplu, rem) (lăsați necompletat pentru lățime automată).

• height: înălțimea imaginii, de obicei în pixeli sau unități de lungime CSS (de exemplu, rem) (lăsați necompletat pentru auto-înălțime).

• class: clase CSS aplicate pe eticheta img; Clasele Bootstrap sunt disponibile.

• alt: text alternativ al imaginii

• style: atribut de stil; vă permite să suprascrieți stilurile mai liber decât cu Clasele Bootstrap.

Aceste atribute trebuie să conțină șiruri de caractere, adică text cuprins între ghilimele, de exemplu, t-options-width="'64px'" (sau, alternativ, o expresie Python validă).

De exemplu, să adăugăm o coloană cu imaginea produsului în tabelul de oferte:

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

Atributul t-options-width restricționează lățimea imaginii la 64 de pixeli, iar clasele Bootstrap utilizate în t-options-class creează un chenar asemănător unei miniaturi cu colțuri rotunjite și o umbră.