Arch Schedule/it: Difference between revisions

From FreeCAD Documentation
(Created page with "Filtri attualmente disponibili:")
No edit summary
 
(59 intermediate revisions by 4 users not shown)
Line 1: Line 1:
<languages/>
{{GuiCommand/it|Name=Arch Schedule|Name/it=Scheda|Workbenches=[[Arch Module/it|Arch]]|MenuLocation=Arch → Crea scheda...|Shortcut=}}

{{Docnav/it
|[[Arch_MultiMaterial/it|Multi-Materiale]]
|[[Arch_CompPipe/it|Strumenti di Tubo]]
|[[Arch_Workbench/it|Arch]]
|IconL=Arch_MultiMaterial.svg
|IconR=Arch_CompPipe.png
|IconC=Workbench_Arch.svg
}}


{{GuiCommand/it|Name=Arch Schedule|Name/it=Scheda|Workbenches=[[Arch_Workbench/it|Arch]]|MenuLocation=Arch → Scheda|SeeAlso=[[Arch Equipment/it|Arredo]]}}


<span id="Description"></span>
==Descrizione==
==Descrizione==


Lo strumento Scheda consente di creare e compilare automaticamente un [[Spreadsheet Module/it|foglio di calcolo]] con contenuti prelevati dal modello.
Lo strumento Scheda consente di creare e compilare automaticamente un [[Spreadsheet_Workbench/it|foglio di calcolo]] con contenuti prelevati dal modello.


'''Nota''': Questo strumento è stato riscritto in FreeCAD 0.17 e differisce dalle versioni precedenti.
'''Nota''': Questo strumento è stato riscritto in FreeCAD 0.17 e differisce dalle versioni precedenti.


Per una soluzione più generale, consultare il [https://github.com/furti/FreeCAD-Reporting/tree/master Reporting Workbench] nell'elenco degli [[External_workbenches/it|ambienti esterni]]. Questo ambiente utilizza la sintassi SQL per estrarre informazioni dal documento.
== Utilizzo ==


<span id="Usage"></span>
# Aprire o creare un documento di FreeCAD con alcuni oggetti
==Utilizzo==
# Premere il pulsante {{KEY|[[Image:Arch Schedule.png|16px]] [[Arch Schedule/it|Scheda]]}}
# Regolare le opzioni desiderate
# Premere '''OK'''


# Aprire o creare un documento di FreeCAD con alcuni oggetti.
# Premere il pulsante {{Button|[[Image:Arch_Schedule.svg|16px]] [[Arch_Schedule/it|Scheda]]}}
# Regolare le opzioni desiderate.
# Premere {{Button|OK}}.

<span id="Workflow"></span>
==Flusso di lavoro==
==Flusso di lavoro==


In primo luogo è necessario disporre di un modello. Ad esempio, qui c'è un documento con una coppia di oggetti. Non è necessario che siano oggetti Arch, possono di qualsiasi tipo.
In primo luogo è necessario disporre di un modello. Ad esempio, ecco un documento con un paio di oggetti Arch, ma sono supportati anche altri oggetti.


[[Image:Arch_schedule_example01.jpg]]
[[Image:Arch_schedule_example01.jpg]]


Poi premere il pulsante Scheda di Arch. Si ottiene un pannello delle Azioni come questo. È piuttosto ampio, quindi può essere necessario allargarlo.
Poi premere il pulsante {{Button|[[Image:Arch_Schedule.svg|16px]] [[Arch_Schedule/it|Scheda]]}}. Si ottiene un pannello delle Azioni come questo. È piuttosto ampio, quindi può essere necessario allargarlo.


[[Image:Arch_schedule_example02.jpg]]
[[Image:Arch_schedule_example02.jpg]]


Poi si può riempire riga per riga. Ogni riga è un "query" e restituisce una riga nel foglio di calcolo. Premere il pulsante '''Aggiungi''' per aggiungere una nuova riga e fare doppio clic su ciascuna cella di quella riga per inserire i valori. Il pulsante '''Del''' cancella la riga che contiene una cella selezionata, e '''Clear''' elimina tutte le righe. I valori che è possibile mettere nelle colonne sono:
Poi si può riempire riga per riga. Ogni riga è una "query" e restituisce una riga nel foglio di calcolo. Premere il pulsante '''Aggiungi''' per aggiungere una nuova riga e fare doppio clic su ciascuna cella di quella riga per inserire i valori. Il pulsante '''Del''' cancella la riga che contiene una cella selezionata, e '''Clear''' elimina tutte le righe. I valori che è possibile mettere nelle colonne sono:


* '''Description''': Una descrizione per questa query. La colonna Descrizione è la prima colonna del foglio di calcolo risultante. Nella descrizione è obbligatorio avere una query rappresentata. Se si lascia la cella descrizione vuota, l'intera riga viene saltata e lasciata vuota nel foglio di calcolo. Ciò consente di aggiungere linee "separatrici".
* '''Description''': Una descrizione per questa query. La colonna Descrizione è la prima colonna del foglio di calcolo risultante. Nella descrizione è obbligatorio avere una query rappresentata. Se si lascia la cella descrizione vuota, l'intera riga viene saltata e lasciata vuota nel foglio di calcolo. Ciò consente di aggiungere delle righe "separatrici".
* '''Property''': Questa è la query reale che si desidera eseguire su tutti gli oggetti selezionati. Possono esserci due termini: la parola {{incode|count}} o una proprietà dell'oggetto:
* '''Value''': Questa è la vera query che si desidera eseguire su tutti gli oggetti selezionati da questa query. Può essere di due tipi di cose: o la parola '' 'count' '' (o Count o COUNT, è case-insensitive), che si limita a contare gli oggetti, oppure recuperare e sommare una proprietà, ad esempio '''object.Shape.Volume''' o '''object.Length''' o anche '''object.Label'''. Il nome utilizzato prima del primo punto (object) può essere qualsiasi cosa, si potrebbe anche scrivere x.Shape.Volume. La regola è: quello che viene dopo il primo punto verrà recuperato da ogni oggetto selezionato da questa query, se possibile (gli oggetti che non hanno la proprietà richiesta sono saltati), e il risultato viene unito. Ad esempio, se si utilizza object.Shape.Volume, si ottiene la somma di tutti i volumi di tutti gli oggetti selezionati da questa query.
** Se si inserisce {{incode|count}} (o {{incode|Count}} o {{incode|COUNT}}, non si fa distinzione tra maiuscole e minuscole) gli oggetti selezionati verranno semplicemente conteggiati.
* '''Unit''': Un'unità opzionale per esprimere i risultati. Spetta all'utente dare una unità che corrisponda alla query che si sta facendo, ad esempio, se si stanno recuperando i volumi, è necessario utilizzare una unità di volume, ad esempio m^3. Se si utilizza una unità sbagliata, per es. cm, si ottengono risultati errati.
** Se si immette una proprietà di un oggetto, verrà recuperato e sommato il valore di questa proprietà per ciascuno degli oggetti selezionati. Gli oggetti che non hanno tale proprietà verranno ignorati. Utilizza la notazione punto per riferirti al caso delle proprietà: {{incode|PropertyOfObject.PropertyOfProperty1.PropertyOfProperty2}}. Se la proprietà prima del primo punto inizia con una lettera minuscola verrà considerata un riferimento all'oggetto stesso e verrà ignorata. Inserire ad esempio {{incode|object.Shape.Volume}} equivale a inserire {{incode|Shape.Volume}}.
* '''Objects''': È possibile lasciare questo campo vuoto, in questo caso tutti gli oggetti del documento sono considerati da questa query, o dare un elenco di nomi di oggetti (non le etichette) separato da punto e virgola (;). Se uno qualsiasi degli oggetti in questo elenco è un gruppo, sono selezionati pure i suoi figli. Quindi il modo più semplice per utilizzare questa funzione è quella di raggruppare gli oggetti del documento per significato, e qui dare solo il nome del gruppo. È inoltre possibile utilizzare il pulsante '''selezione''' per aggiungere gli oggetti attualmente selezionati nel documento.
* '''Unit''': un'unità opzionale in cui esprimere i risultati. Sta all'utente fornire un'unità che corrisponda alla query che si sta facendo, ad esempio, se si stanno recuperando volumi, si dovrebbe utilizzare un'unità di volume, come {{incode|m^3}}. Se si usa un'unità sbagliata, ad es. cm, si otterranno risultati errati.
* '''Filter''': Qui è possibile aggiungere un elenco dei filtri separati da punto e virgola (;). Ogni filtro è scritto nella forma: Filtro: valore, dove il filtro può essere (è anche case-insensitive): Name, Label, Type, o Role (vedere sotto l'elenco completo). Per esempio: name:door;type:window filtra gli oggetti ottenuti dal passaggio precedente, e mantiene solo quelli il cui nome contiene "door" E del tipo (restituito da Draft.getType) "wall". Tutto è case-insensitive. I filtri che inizia con ! sono invertiti. Per esempio, !name:wall mantiene solo gli oggetti che non hanno "wall" nel loro nome. "Role" è una proprietà che hanno tutti gli oggetti Arch.
* '''Objects''': si può lasciare vuoto, quindi verranno considerati da questa query tutti gli oggetti del documento, oppure si può fornire un elenco di nomi di oggetti (non etichette) separati da punto e virgola (;). Se uno qualsiasi degli oggetti in questo elenco è un gruppo, verranno selezionati anche i suoi figli. Quindi il modo più semplice per utilizzare questa funzionalità è raggruppare gli oggetti in modo significativo nel documento e fornire qui semplicemente un nome al gruppo. Si può anche utilizzare il pulsante {{Button|Aggiungi la selezione}} per aggiungere oggetti attualmente selezionati nel documento. È necessario utilizzare nomi interni in questa posizione. Per selezionare gli oggetti in base alla loro etichetta, lasciare questa colonna vuota e utilizzare invece la colonna Filtro.
* '''Filter''': Qui è possibile aggiungere un elenco di filtri separati da punti e virgola {{incode|;}}. Ogni filtro è scritto nella forma: {{incode|property:value}}. È possibile utilizzare solo proprietà che contengono un valore stringa. Sia la proprietà che il valore non fanno distinzione tra maiuscole e minuscole. L'{{incode|value}} può essere tralasciato ma non l'{{incode|:}}. Per gestire correttamente le schede create con versioni precedenti di Scheda la proprietà {{incode|type}} verrà tradotta nella proprietà {{incode|ifctype}}. È consigliabile non utilizzare {{incode|type}} nelle nuove pianificazioni.
: Per esempio:
:: {{incode|label:floor1;ifctype:window}} manterrà solo gli oggetti che hanno "floor1" nel loro {{PropertyData|Label}} e "window" nel loro {{PropertyData|IFC Type}}. Verrà inclusa una finestra con {{PropertyData|Label}} "Floor1-AA" e {{PropertyData|IFC Type}} "Window Standard Case".
:: {{incode|label:door}} Manterrà solo gli oggetti che hanno "door" nella loro {{PropertyData|Label}}.
:: {{incode|!label:door}} Manterrà solo gli oggetti che non hanno "door" nella loro {{PropertyData|Label}}.
:: {{incode|ifctype:structural}} Manterrà solo gli oggetti che hanno "structural" nel loro {{PropertyData|IFC Type}}.
:: {{incode|!ifctype:something}} Manterrà solo gli oggetti che non hanno "structural" nel loro {{PropertyData|IFC Type}} o che non hanno la proprietà {{PropertyData|IFC Type}}.
:: {{incode|!ifctype:}} Manterrà solo gli oggetti che non hanno la proprietà {{PropertyData|IFC Type}}.


Il pulsante '''Import''' permette di costruire questa lista in un altro foglio di calcolo, e importarla qui come file CSV.
Il pulsante {{Button|Importa}} permette di costruire questa lista in un altro foglio di calcolo, e importarla qui come file CSV.


Quindi si può costruire una lista di query di questo tipo:
Quindi si può costruire una lista di query di questo tipo:
Line 39: Line 63:
[[Image:Arch_schedule_example03.jpg]]
[[Image:Arch_schedule_example03.jpg]]


Dopo di che, premendo OK, al documento viene aggiunto un nuovo oggetto Scheda che contiene un foglio di calcolo con i risultati:
Dopo di che, premendo {{Button|OK}}, al documento viene aggiunto un nuovo oggetto Scheda che contiene un foglio di calcolo con i risultati:


[[Image:Arch_schedule_example04.jpg]]
[[Image:Arch_schedule_example04.jpg]]
Line 49: Line 73:
Dall'ambiente Spreadsheet il foglio di calcolo può quindi essere esportato normalmente in formato CSV.
Dall'ambiente Spreadsheet il foglio di calcolo può quindi essere esportato normalmente in formato CSV.


<span id="Dynamic_properties"></span>
==Filtri==
==Proprietà dinamiche==


È possibile aggiungere le proprie proprietà agli oggetti. Queste sono chiamate [[Property_editor/it#Azioni|Proprietà dinamiche]]. Se sono stati aggiunti con l'opzione {{MenuCommand|Prefisso nome gruppo}} selezionata, i loro nomi inizieranno effettivamente con il nome del gruppo, ma questo prefisso non verrà visualizzato nell'[[Property_editor/it|Editor delle proprietà]]. I loro nomi hanno questa forma: {{incode|NameOfGroup_NameOfProperty}}. Per farvi riferimento in una pianificazione è necessario utilizzare questo nome completo.
Filtri attualmente disponibili:


* '''name:something''': Will retain only objects that have "something" in their name (case-insensitive)
* '''!name:something''': Will retain only objects that don't have "something" in their name
* '''label:something''': Will retain only objects that have "something" in their label (case-insensitive)
* '''!label:something''': Will retain only objects that don't have "something" in their label
* '''type:something''': Will retain only objects where the Draft.getType() function returns "something"
* '''!type:something''': Will retain only objects where the Draft.getType() function does not return "something"
* '''role:something''': Will retain only objects that have a Role property set to "something"
* '''!role:something''': Will retain only objects that don't have a Role property, or where the Role property is not set to "something"


{{Docnav/it
{{clear}}
|[[Arch_MultiMaterial/it|Multi-Materiale]]
<languages/>
|[[Arch_CompPipe/it|Strumenti di Tubo]]
|[[Arch_Workbench/it|Arch]]
|IconL=Arch_MultiMaterial.svg
|IconR=Arch_CompPipe.png
|IconC=Workbench_Arch.svg
}}

{{Arch Tools navi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}

Latest revision as of 07:05, 12 May 2024

Scheda

Posizione nel menu
Arch → Scheda
Ambiente
Arch
Avvio veloce
Nessuno
Introdotto nella versione
-
Vedere anche
Arredo

Descrizione

Lo strumento Scheda consente di creare e compilare automaticamente un foglio di calcolo con contenuti prelevati dal modello.

Nota: Questo strumento è stato riscritto in FreeCAD 0.17 e differisce dalle versioni precedenti.

Per una soluzione più generale, consultare il Reporting Workbench nell'elenco degli ambienti esterni. Questo ambiente utilizza la sintassi SQL per estrarre informazioni dal documento.

Utilizzo

  1. Aprire o creare un documento di FreeCAD con alcuni oggetti.
  2. Premere il pulsante Scheda
  3. Regolare le opzioni desiderate.
  4. Premere OK.

Flusso di lavoro

In primo luogo è necessario disporre di un modello. Ad esempio, ecco un documento con un paio di oggetti Arch, ma sono supportati anche altri oggetti.

Poi premere il pulsante Scheda. Si ottiene un pannello delle Azioni come questo. È piuttosto ampio, quindi può essere necessario allargarlo.

Poi si può riempire riga per riga. Ogni riga è una "query" e restituisce una riga nel foglio di calcolo. Premere il pulsante Aggiungi per aggiungere una nuova riga e fare doppio clic su ciascuna cella di quella riga per inserire i valori. Il pulsante Del cancella la riga che contiene una cella selezionata, e Clear elimina tutte le righe. I valori che è possibile mettere nelle colonne sono:

  • Description: Una descrizione per questa query. La colonna Descrizione è la prima colonna del foglio di calcolo risultante. Nella descrizione è obbligatorio avere una query rappresentata. Se si lascia la cella descrizione vuota, l'intera riga viene saltata e lasciata vuota nel foglio di calcolo. Ciò consente di aggiungere delle righe "separatrici".
  • Property: Questa è la query reale che si desidera eseguire su tutti gli oggetti selezionati. Possono esserci due termini: la parola count o una proprietà dell'oggetto:
    • Se si inserisce count (o Count o COUNT, non si fa distinzione tra maiuscole e minuscole) gli oggetti selezionati verranno semplicemente conteggiati.
    • Se si immette una proprietà di un oggetto, verrà recuperato e sommato il valore di questa proprietà per ciascuno degli oggetti selezionati. Gli oggetti che non hanno tale proprietà verranno ignorati. Utilizza la notazione punto per riferirti al caso delle proprietà: PropertyOfObject.PropertyOfProperty1.PropertyOfProperty2. Se la proprietà prima del primo punto inizia con una lettera minuscola verrà considerata un riferimento all'oggetto stesso e verrà ignorata. Inserire ad esempio object.Shape.Volume equivale a inserire Shape.Volume.
  • Unit: un'unità opzionale in cui esprimere i risultati. Sta all'utente fornire un'unità che corrisponda alla query che si sta facendo, ad esempio, se si stanno recuperando volumi, si dovrebbe utilizzare un'unità di volume, come m^3. Se si usa un'unità sbagliata, ad es. cm, si otterranno risultati errati.
  • Objects: si può lasciare vuoto, quindi verranno considerati da questa query tutti gli oggetti del documento, oppure si può fornire un elenco di nomi di oggetti (non etichette) separati da punto e virgola (;). Se uno qualsiasi degli oggetti in questo elenco è un gruppo, verranno selezionati anche i suoi figli. Quindi il modo più semplice per utilizzare questa funzionalità è raggruppare gli oggetti in modo significativo nel documento e fornire qui semplicemente un nome al gruppo. Si può anche utilizzare il pulsante Aggiungi la selezione per aggiungere oggetti attualmente selezionati nel documento. È necessario utilizzare nomi interni in questa posizione. Per selezionare gli oggetti in base alla loro etichetta, lasciare questa colonna vuota e utilizzare invece la colonna Filtro.
  • Filter: Qui è possibile aggiungere un elenco di filtri separati da punti e virgola ;. Ogni filtro è scritto nella forma: property:value. È possibile utilizzare solo proprietà che contengono un valore stringa. Sia la proprietà che il valore non fanno distinzione tra maiuscole e minuscole. L'value può essere tralasciato ma non l':. Per gestire correttamente le schede create con versioni precedenti di Scheda la proprietà type verrà tradotta nella proprietà ifctype. È consigliabile non utilizzare type nelle nuove pianificazioni.
Per esempio:
label:floor1;ifctype:window manterrà solo gli oggetti che hanno "floor1" nel loro DatiLabel e "window" nel loro DatiIFC Type. Verrà inclusa una finestra con DatiLabel "Floor1-AA" e DatiIFC Type "Window Standard Case".
label:door Manterrà solo gli oggetti che hanno "door" nella loro DatiLabel.
!label:door Manterrà solo gli oggetti che non hanno "door" nella loro DatiLabel.
ifctype:structural Manterrà solo gli oggetti che hanno "structural" nel loro DatiIFC Type.
!ifctype:something Manterrà solo gli oggetti che non hanno "structural" nel loro DatiIFC Type o che non hanno la proprietà DatiIFC Type.
!ifctype: Manterrà solo gli oggetti che non hanno la proprietà DatiIFC Type.

Il pulsante Importa permette di costruire questa lista in un altro foglio di calcolo, e importarla qui come file CSV.

Quindi si può costruire una lista di query di questo tipo:

Dopo di che, premendo OK, al documento viene aggiunto un nuovo oggetto Scheda che contiene un foglio di calcolo con i risultati:

Facendo doppio clic sull'oggetto Scheda, si ritorna al pannello delle Azioni e si può modificare i valori. Facendo doppio clic sul Foglio di calcolo, si ottengono i risultati nelle 3 colonne: la descrizione, il valore e l'unità (se applicabile):

Dall'ambiente Spreadsheet il foglio di calcolo può quindi essere esportato normalmente in formato CSV.

Proprietà dinamiche

È possibile aggiungere le proprie proprietà agli oggetti. Queste sono chiamate Proprietà dinamiche. Se sono stati aggiunti con l'opzione Prefisso nome gruppo selezionata, i loro nomi inizieranno effettivamente con il nome del gruppo, ma questo prefisso non verrà visualizzato nell'Editor delle proprietà. I loro nomi hanno questa forma: NameOfGroup_NameOfProperty. Per farvi riferimento in una pianificazione è necessario utilizzare questo nome completo.