Organizzazione e posizione degli script Python

LibreOffice macros are grouped in module files, modules are usually grouped in library folders, and libraries are grouped in library containers although containers can contain modules too.

A library is used as a major grouping for either an entire category of macros, or for an entire application. Modules usually split functionality, such as user interaction and calculations. Individual macros are subroutines and functions. The Figure below shows an example of the hierarchical structure of macro libraries in LibreOffice.

Library Container diagram

Figure: Macro Library hierarchy

The containers are accessible in all LibreOffice programs through the user interface. Go to Tools > Macros > Organize Macros > Python, to open the Python Macros dialog.

Three library containers are shown in the Macro From list:

  1. My Macros: personal macros available for the LibreOffice user

  2. LibreOffice Macros: system macros distributed with LibreOffice for every computer user

  3. Document macros: every document can contain macro libraries available in that document for all users

Posizione degli script Python

Per ottenere accesso programmatico alle posizioni degli script Python, fate riferimento al capitolo Ottenere informazioni sulla sessione.

LibreOffice Macros

Le macro esistenti in questa posizione (contenitore) vengono copiate dal programma di installazione e sono disponibili a tutti gli utenti del computer e a qualsiasi documento aperto che può accedere alle macro memorizzate nel contenitore. È necessario possedere i diritti amministrativi per memorizzare o modificare qui le macro.

La posizione del contenitore di macro LibreOffice nel filesystem dipende dal sistema operativo:

Macro personali

Questo contenitore è accessibile solo dall'utente LibreOffice. Alle macro contenute nel contenitore possono accedere tutti i documenti aperti. Le macro in questa posizione sono memorizzate nel profilo utente di LibreOffice.

La posizione del contenitore Macro personali si trova nello spazio utente e dipende dal sistema operativo:

Macro dei documenti

Le macro dei documenti sono incorporate nel documento e sono accessibili solo quando il documento è aperto.

Librerie, moduli e macro

Python macros can be organized in libraries, modules and macros. Use the Macro Library hierarchy as a guide when creating or installing new macros in module files, new module files in library folders or new library folders in containers.