PDF-skýrslur

Stundum eru töflur ekki rétt greindar sem slíkar vegna flókinna uppbygginga. Í slíkum tilvikum geturðu samt breytt þeim handvirkt í XML-skilgreiningu skýrslunnar. Til dæmis má í sölupöntun finna eftirfarandi uppbyggingu í XML (einfölduð í skýringarskyni):

   
   

       
       

           
           

               
               
Name
               
Price
           
       
       
       

           
           

               
               

               

           
       
   

To modify a table, you must ensure that each row has the same number of data cells. For example,
in the case above, you need to add a cell in the header section (with e.g., the column title)
and another one in the body section with the field content (usually, with a `t-out` or
`t-field` directive).

.. code-block:: xml
   :emphasize-lines: 6,13

   
 
       
 
           
 
               
Name
 
               
Price
               
Category
           
       
       
  
           
  
               
  
               

               

           
       
   

.. note::
   Cells can span multiple rows or columns. For more information, go to the
   `Mozilla Developer Network website `_.

For example, you can modify the **Quotation/Order** report to add a column to display the
product category in the main table:

  .. code-block:: xml
     :emphasize-lines: 6,13

     
     [...]
                 
                         

         
         

             

                 
Description
                 
Product Category
                 
Quantity
                 
Unit Price

                     
Bacon Burger
                         

                         

                             3
                             units
                             

.. image:: pdf_reports/XML-SO-product-category.png
   :alt: Add a Product Category column in a SO.


Bæta við gagnatöflu
Til að bæta við töflu í XML þarftu að þekkja heiti þeirra reita og hluta sem þú vilt sækja og birta. Sem dæmi bætum við töflu sem sýnir merki á sölupöntun:
   
   

       
       

           
           

               
               
ID
               
Name
           
       
       
       

           
           

               
               

               

           
       
   

.. image:: pdf_reports/XML-data-table.png
   :alt: Add a data table in XML

.. note::
   When adding tables manually, style them using `Bootstrap classes
   `_, like the `table` class included in the
   example above.


Skilyrtir kaflar
Ef þú vilt sýna/fela efni eftir ákveðnum skilyrðum geturðu sett inn if/else-stýringar handvirkt í XML-skilgreiningu skýrslunnar.
T.d. ef þú vilt fela sérsniðna gagnatöflu ef engin merki eru til staðar, geturðu notað eigindið t-if til að skilgreina skilyrðið, sem síðan er metið sem True eða False. Taflan birtist ekki ef engin merki eru á tilboðinu.
   :emphasize-lines: 2

   
   

       
       

           
           

               
               
ID
               
Name
           
       
       
       

           
           

               
               

               

           
       
   

If you want to display another block in case the `t-if` statement is evaluated as `False`, you
can specify it using the `t-else` statement. The `t-else` block must directly follow the `t-if`
block in the document structure. There is no need to specify any condition in the `t-else`
attribute. As an example, let's show a quick message explaining that there are no tags on the
quotation:

.. code-block:: xml
   :emphasize-lines: 22

   
   

       
       

           
           

               
               
ID
               
Name
           
       
       
       

           
           

               
               

               

           
       
   
   
No tag present on this document.

By using the `t-if/t-else` notation, the report editor recognizes that these sections are
mutually exclusive and should be displayed as conditional blocks:

.. image:: pdf_reports/XML-condition-if.png
   :alt: Output preview if there are tags.

You can switch conditions using the editor to preview their output:

.. image:: pdf_reports/XML-condition-else.png
   :alt: Output preview if there are no tags.

If you wish to have multiple options, you can also use `t-elif` directives to add intermediary
conditions. For example, this is how the title of sales order reports changes based on the
condition of the underlying document.

.. code-block:: xml

   

       Pro-Forma Invoice # 
       Quotation # 
       Order # 
       SO0000
   

The title *Pro-Forma Invoice* is used depending on some contextual conditions. If these
conditions are not met and the state of the document is either `draft` or `sent`, then
*Quotation* is used. If none of those conditions are met, the report's title is *Order*.


Myndir
Vinna með myndir í skýrslu getur verið áskorun; nákvæm stjórn á stærð og hegðun er ekki alltaf augljós. Þú getur sett inn myndareiti í skýrsluritlinum (með /Field-skipuninni), en að setja þá inn í XML með fyrirmælinu t-field og viðeigandi t-options eigindum veitir betri stjórn á stærð og staðsetningu.
T.d. birtir eftirfarandi kóði reitinn image_128 fyrir vöruna í línunni sem 64px breiða mynd (með sjálfvirkri hæð út frá myndahlutfalli).
   

The following options are available for image widgets:

- `width`: width of the image, usually in pixels or CSS length units (e.g., `rem`) (leave empty
  for auto-width).
- `height`: height of the image, usually in pixels or CSS length units (e.g., `rem`) (leave empty
  for auto-height).
- `class`: CSS classes applied on the `img` tag; `Bootstrap classes
  `_ are available.
- `alt`: alternative text of the image
- `style`: style attribute; it allows you to override styles more freely than with
  `Bootstrap classes `_.

These attributes must contain strings, i.e., text enclosed within quotes within quotes, e.g.,
`t-options-width="'64px'"` (or, alternatively, a valid Python expression).

.. note::
   The image widget cannot be used on an `img` tag. Instead, set the `t-field` directive on a
   `span` (for inline content) or `div` (for block content) node.

For example, let's add a column with the product image in the quotation table:

.. code-block:: xml
   :emphasize-lines: 4,14-20

   
   [...]
           
               
               
                      

       

           

               
Image
               
Description
               
Product Category
               
Quantity
               
Unit Price

                   

                          
                      
                       
Bacon Burger
                       


The `t-options-width` attribute restricts the image width to 64 pixels, and the Bootstrap classes
used in `t-options-class` create a thumbnail-like border with rounded corners and a shadow.

.. image:: pdf_reports/XML-images.png
   :alt: Add a column with the product image in the quotation table.





            
                            
                        
                        
                    
                    
                
            
        

                
                
        

            

                

                    

                        
                        

                            

                                

                                    

                                        

                                            Við notum vafrakökur til að bæta upplifun á þessari vefsíðu.
                                            Vafrakökustefna
                                        
                                    
                                    

                                        Aðeins nauðsynlegar
                                        Ég er sammála