Erstellen einer ODT-Dokumentvorlage: Difference between revisions

Wenn Sie wissen möchten, wie man eine PDF-Vorlage erstellt, sehen Sie sich die Seite [[Create a PDF document template]] an. Zum Erstellen einer PDF-Vorlage sind PHP-Entwicklungskenntnisse erforderlich, aber nicht zum Erstellen einer ODT-Vorlage.

*Erstellen Sie von Grund auf ein leeres OpenOffice-Dokument oder nehmen Sie ein bereitgestelltes Beispiel. Sie finden sie installiert in einem Unterverzeichnis von Verzeichnis '''documents/doctemplates''' *Bearbeiten Sie Ihr Dokument mit allen Funktionen Ihrer Office-Suite.

Fügen Sie die Tags in Ihr Dokument ein, die Sie sehen möchten. Tags werden während der Dokumentengenerierung automatisch von Dolibarr ersetzt. Eine Liste aller verfügbaren Tags wird im nächsten Kapitel bereitgestellt.

[[File:warning.png]] Warnung: Tags müssen mit {} oder [] für Arrays umschlossen werden (siehe später) und dürfen in der Office-Suite nicht gestoppt werden (kein Backspace und kein Copy-Paste). Wenn dies nicht geschieht, fügt die Office-Suite unsichtbare Informationen hinzu, die die Erkennung/Ersetzung unmöglich machen. Mit LibreOffice können Sie auch die Tastenkombination Ctrl+M verwenden, um die Direktformatierung von Tags zu entfernen.

Für das Tag {object_total..._x}, wenn es keinen Betrag für den Steuersatz x gibt, wird der Schlüssel nicht ersetzt. Sie können daher die Bedingungssyntax verwenden, um anstelle des Schlüssels die 0 anzuzeigen, wenn der Wert nicht definiert ist:

/** Function called to complete substitution array (before generating on ODT, or a personalized email)

  * functions xxx_completesubstitutionarray are called by make_substitutions() if file

   $substitutionarray['myowntag']=$myvalue;

}

La función será llamada antes de la generación del documento para completar la tabla de sustituciones que reemplazará el tag '''myowntag''' por el valor definido en '''$myvalue'''.

Creado un módulo (Ver la página [[Desarrollo de un módulo]]), puede emplazar el archivo de substititución en un directorio de su módulo llamado '''htdocs/mimodulo/core/substitutions'''. Sin embargo, la función sólo será llamada si el descriptor de módulo contiene una entrada  

$this->module_parts = array('substitutions' => 1)

y que el módulo haya sido activado.

==Guardar su documento==

Para ver su modelo de documento en la lista de modelos disponibles, guarde lo en el subdirectorio adecuado que se encuentra en el directorio '''documents/doctemplates'''