Arch Schedule/it: Difference between revisions

From FreeCAD Documentation
No edit summary
No edit summary
 
(36 intermediate revisions by 4 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
{{Docnav/it|[[Arch_MultiMaterial/it|Multi-Materiale]]|[[Arch_CutLine/it|Taglia con una linea]]|[[Arch_Module/it|Arch]]|IconL=Arch_MultiMaterial.svg |IconC=Workbench_Arch.svg |IconR=Arch_CutLine.svg}}


{{Docnav/it
<div class="mw-translate-fuzzy">
|[[Arch_MultiMaterial/it|Multi-Materiale]]
{{GuiCommand/it|Name=Arch Schedule|Name/it=Scheda|Workbenches=[[Arch Module/it|Arch]]|MenuLocation=Arch → Scheda|SeeAlso=[[Arch Equipment/it|Arredo]]}}
|[[Arch_CompPipe/it|Strumenti di Tubo]]
</div>
|[[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.


<div class="mw-translate-fuzzy">
'''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.
</div>


For a more general solution, see the [https://github.com/furti/FreeCAD-Reporting/tree/master Reporting Workbench] in the list of [[external workbenches|external workbenches]]. This workbench uses SQL syntax to extract information from the document.
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.


<span id="Usage"></span>
<div class="mw-translate-fuzzy">
== Utilizzo ==
==Utilizzo==
</div>


# Aprire o creare un documento di FreeCAD con alcuni oggetti.
# Aprire o creare un documento di FreeCAD con alcuni oggetti.
# Premere il pulsante {{Button|[[Image:Arch Schedule.svg|16px]] [[Arch Schedule/it|Scheda]]}}.
# Premere il pulsante {{Button|[[Image:Arch_Schedule.svg|16px]] [[Arch_Schedule/it|Scheda]]}}
# Regolare le opzioni desiderate.
# Regolare le opzioni desiderate.
# Premere {{Button|OK}}.
# 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 essere 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 {{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.
<div class="mw-translate-fuzzy">
Poi premere il pulsante Scheda di Arch. Si ottiene un pannello delle Azioni come questo. È piuttosto ampio, quindi può essere necessario allargarlo.
</div>


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


<div class="mw-translate-fuzzy">
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:
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:
</div>


<div class="mw-translate-fuzzy">
* '''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".
* '''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 si può 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 i risultati vengono uniti. 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.
</div>
* '''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 {{Button|Importa}} permette di costruire questa lista in un altro foglio di calcolo, e importarla qui come file CSV.
<div class="mw-translate-fuzzy">
Il pulsante '''Import''' permette di costruire questa lista in un altro foglio di calcolo, e importarla qui come file CSV.
</div>


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


Dopo di che, premendo {{Button|OK}}, al documento viene aggiunto un nuovo oggetto Scheda che contiene un foglio di calcolo con i risultati:
<div class="mw-translate-fuzzy">
Dopo di che, premendo OK, al documento viene aggiunto un nuovo oggetto Scheda che contiene un foglio di calcolo con i risultati:
</div>


[[Image:Arch_schedule_example04.jpg]]
[[Image:Arch_schedule_example04.jpg]]
Line 70: 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:


<div class="mw-translate-fuzzy">
* '''name:something''': Mantiene solo gli oggetti che hanno "something" nel loro nome (case-insensitive)
* '''!name:something''': Mantiene solo gli oggetti che non hanno "something" nel loro nome
* '''label:something''': Mantiene solo gli oggetti che hanno "something" nella loro etichetta (case-insensitive)
* '''!label:something''': Mantiene solo gli oggetti che non hanno "something" nella loro etichetta
* '''type:something''': Mantiene solo gli oggetti in cui la funzione Draft.getType() restituisce "something"
* '''!type:something''': Mantiene solo gli oggetti in cui la funzione Draft.getType() non restituisce "something"
* '''role:something''': Mantiene solo gli oggetti che hanno una proprietà "Role" impostata su "something"
* '''!role:something''': Mantiene solo gli oggetti che non dispongono di una proprietà Role, o in cui la proprietà Role non è impostata su "something"
</div>


{{Docnav/it

|[[Arch_MultiMaterial/it|Multi-Materiale]]
<div class="mw-translate-fuzzy">
|[[Arch_CompPipe/it|Strumenti di Tubo]]
{{docnav/it|[[Arch_MultiMaterial/it|Multi-Materiale]]|[[Arch_CutPlane/it|Taglia con piano]]|[[Arch_Module/it|Arch]]|IconL=Arch_MultiMaterial.png |IconC=Workbench_Arch.svg |IconR=Arch_CutPlane.svg}}
|[[Arch_Workbench/it|Arch]]
</div>
|IconL=Arch_MultiMaterial.svg
|IconR=Arch_CompPipe.png
|IconC=Workbench_Arch.svg
}}


{{Arch Tools navi{{#translation:}}}}
{{Arch Tools navi{{#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.