Organizzazione e posizione degli script Python

Le macro di Collabora Office sono raggruppate in file di moduli, i moduli di solito sono memorizzati in cartelle di librerie e le librerie sono raccolte in contenitori di librerie, anche se i contenitori possono comprendere anche moduli.

Una libreria viene usata come raggruppamento principale per un'intera categoria di macro, o per un'intera applicazione. I moduli di solito suddividono le funzionalità, come le interazioni con gli utenti ed i calcoli. Le singole macro sono costituite da subroutine e funzioni. La figura sottostante illustra un esempio di struttura gerarchica delle librerie di macro di Collabora Office.

Figura: Gerarchia della libreria di macro

Attraverso l'interfaccia utente potete accedere ai contenitori da tutti programmi di Collabora Office. Scegliete Strumenti > Macro > Organizza macro > Python, per aprire la finestra di dialogo Macro Python.

Nell'elenco Macro compaiono tre contenitori di librerie:

1. Macro personali: le macro personali a disposizione dell'utente di Collabora Office

2. Macro dell'applicazione: macro di sistema distribuite con Collabora Office per tutti gli utenti del computer

3. Macro del documento: ogni documento può contenere delle librerie di macro disponibili in quel documento per tutti gli utenti

Posizione degli script Python

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

Macro dell'applicazione

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 Collabora Office nel filesystem dipende dal sistema operativo:

• Per Windows: {Installazione}\share\Scripts\python.

• Per Linux e macOS: {Installazione}/share/Scripts/python.

Macro personali

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

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

• Per Windows,
  %APPDATA%\LibreOffice\4\user\Scripts\python.

• Per Linux e macOS,
  $HOME/.config/libreoffice/4/user/Scripts/python.

Macro dei documenti

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

Librerie, moduli e macro

Potete organizzare le macro di Python in librerie, moduli e macro. Usate la gerarchia della libreria di macro come linea guida per la creazione o l'installazione di nuove macro nei file dei moduli, di nuovi file di modulo nelle cartelle delle librerie, o di nuove librerie nei contenitori.