📄 09 Shortcuts, QA & Troubleshooting

Shortcuts, QA & Troubleshooting

A production reference for efficient editing, release checks and problem diagnosis.

12. Keyboard and mouse reference

ActionShortcut
Copy selectionCtrl/Cmd + C
Cut selectionCtrl/Cmd + X
PasteCtrl/Cmd + V
UndoCtrl/Cmd + Z
RedoCtrl/Cmd + Shift + Z, or Ctrl/Cmd + Y
Delete selected element or guideBackspace or Delete
Edit selected Text/Text PathEnter
Close an open picker/menu or cancel linkingEscape
Constrain selected-item drag to one axisShift + drag
Multi-selectCtrl/Cmd + click
Select geometry linked to a Text PathAlt + click
Pan the workspaceMiddle-button drag

13. Production quality checklist

  • Correct target model, report group, paper size and company scope.
  • Header/Footer heights match the real design and do not overlap the Body.
  • All content stays inside printable margins.
  • Long customer names, addresses, product descriptions and empty values have been tested.
  • Amounts, dates, percentages and currencies use the intended formatting.
  • Binary images retain their proportions and print at sufficient resolution.
  • Barcode type and source values are valid; scan at least one physical sample.
  • One2many tables paginate correctly and repeat headers.
  • No helper element is accidentally enabled for printing.
  • Watermark opacity is readable but does not obscure content.
  • PDF text is selectable and bold/italic cuts render as intended.
  • The final PDF is checked at 100% and on the intended printer/media.
  • The report action is available only in the intended companies.
  • Export the final JSON or include the report in a Report Hub backup.

14. Troubleshooting

SymptomLikely causeResolution
Designer does not loadStale backend assets or module update not applied.Restart Odoo, upgrade the module and rebuild/clear web assets and browser cache.
Blank PDFMissing target model, paper size, printable elements or invalid report action.Verify the template record, save the layout and recreate/update the print action.
Field is emptyWrong path, empty source value or relation/widget mismatch.Select a representative sample record, confirm the technical path and test the related field/widget.
Computed field failsExpression error or an empty relation.Preview the expression and use safe fallbacks such as or '' or or 0.
Image is missingWrong binary field, missing access or unsuitable file.Check field permissions, sample data and source type; re-upload fixed images.
Barcode is missing or malformedInvalid value for the selected symbology.Use Code128 for general text or supply the exact numeric length required by EAN.
Table crosses a page boundaryHeader/row dimensions or available Body area are inconsistent.Reduce row/header height, confirm region sizes and test multi-page records.
Copied fields show wrong dataLayout was pasted into a different target model.Review every field path, expression and line column in the target template.
Report missing from Print menuNo report action, wrong company or stale model binding.Run Add Print Button to Model and verify the Companies field.
Print server does not receive a jobOutput, host, printer/profile or integration module is not configured.Verify template output settings and the print server connection before retrying.