Arch Schedule/it: Difference between revisions

From FreeCAD Documentation
No edit summary
No edit summary
(47 intermediate revisions by 2 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_CutLine/it|Taglia con una linea]]|[[Arch_Module/it|Arch]]|IconL=Arch_MultiMaterial.svg |IconC=Workbench_Arch.svg |IconR=Arch_CutLine.svg}}

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




Line 8: Line 11:
'''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 ==


==Utilizzo==
# Aprire o creare un documento di FreeCAD con alcuni oggetti
# 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.
==Workflow==
# Premere il pulsante {{Button|[[Image:Arch Schedule.svg|16px]] [[Arch Schedule/it|Scheda]]}}.
# Regolare le opzioni desiderate.
# Premere {{Button|OK}}.


==Flusso di lavoro==
First you need to have a model. For example, here is a document with a couple of objects. I did Arch stuff here, but it doesn't need to be Arch, it can be anything.

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.


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


Poi premere il pulsante [[Image:Arch Schedule.svg|16px]] Scheda di Arch. Si ottiene un pannello delle Azioni come questo. È piuttosto ampio, quindi può essere necessario allargarlo.
Then you press the Arch Schedule button. You get a task panel like this. It is pretty wide, so you'll need to widen the task panel to be comfortable.


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


Then you can fill line by line. Each line is a "query" and will render one line in the spreadsheet. Press the '''Add''' button to add a new line, and double-click each cell from that line to fill in the values. The '''Del''' button will delete the line which contains a currently selected cell, and '''Clear''' will delete all the lines. Possible values to put in columns are:
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''': A description for this query. The Description column will be the first column of the resulting spreadsheet. The description is mandatory to have a query performed. If you leave the description cell empty, the whole line will be skipped and left blank in the spreadsheet. This allows you to add "separator" lines.
* '''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".
* '''Value''': This is the real query that you want to perform on all the objects selected by this query. It can be two kinds of things: either the word '''count''' (or Count or COUNT, it's case-insensitive), which will simply count objects, or retrieve ans sum a property, for example '''object.Shape.Volume''' or '''object.Length''' or even '''object.Label'''. The name you use before the first dot (object) can be anything, you could also write x.Shape.Volume. The rule is: what comes after the first dot will be retrieved from each object selected by this query, if possible (object that don't have the required property will be skipped), and the result will be added together. For example, if you use object.Shape.Volume, you will get the sum of all volumes of all objects selected by this query.
* '''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 {{incode|object.Shape.Volume}} o {{incode|object.Length}} o anche {{incode|object.Label}}. Il nome utilizzato prima del primo punto (object) può essere qualsiasi cosa, si potrebbe anche scrivere {{incode|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 {{incode|object.Shape.Volume}}, si ottiene la somma di tutti i volumi di tutti gli oggetti selezionati da questa query.
* '''Unit''': An optional unit to express the results in. It's up to you to give a unit that matches the query you are doing, for example, if you are retrieving volumes, you should use a volume unit, such as m^3. If you use a wrong unit, for ex. cm, you'll get wrong results.
* '''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 {{incode|m^3}}. Se si utilizza una unità sbagliata, per es. cm, si ottengono risultati errati.
* '''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.
* '''Objects''': You can leave this empty, then all the objects of the document will be considered by this query, or give a semicolon (;)-separated list of object names (not labels). If any of the objects in this list is a group, its children will be selected as well. So the easiest way to use this feature is to group your objects meaningfully in the document, and just give a group name here. You can also use the '''Selection''' button to add objects currently selected in the document.
* '''Filter''': Here you can add a semicolon(;)-separated list of filters. Each filter is written in the form: filter:value, where filter can be (it's case-insensitive too): Name, Label, Type, or Role (see full list below). For example: name:door;type:window will filter the objects we got from the step above, and retain only those whose name contains "door" AND the type (returned by Draft.getType) is "wall". Everything is case-insensitive. Filters that begins with ! are inverted. For example, !name:wall will retain only objects that DON'T have "wall" in their name. "Role" is a property that all Arch objects have.
* '''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.


Il pulsante {{Button|Importa}} permette di costruire questa lista in un altro foglio di calcolo, e importarla qui come file CSV.
The '''Import''' button allows you to build this list in another spreadsheet application, and import that as a csv file here.


Quindi si può costruire una lista di query di questo tipo:
So we can build a list of queries like this:


[[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:
After that, press OK and a new Schedule object is added to the document, which contains a result spreadsheet:


[[Image:Arch_schedule_example04.jpg]]
[[Image:Arch_schedule_example04.jpg]]


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):
By double-clicking the Schedule object, you get back to the task panel and change the values. By double-clicking the spreadsheet itself, you get the results in 3 columns: description, value, unit (if applicable):


[[Image:Arch_schedule_example05.jpg]]
[[Image:Arch_schedule_example05.jpg]]


Dall'ambiente Spreadsheet il foglio di calcolo può quindi essere esportato normalmente in formato CSV.
The spreadsheet can then be exported to csv normally, from the Spreadsheet workbench.


==Filters==
==Filtri==


Filtri attualmente disponibili:
Currently available filters:


* '''name:something''': Will retain only objects that have "something" in their name (case-insensitive)
: {{incode|name:something}}: Mantiene solo gli oggetti che hanno "something" nel loro nome (case-insensitive)
* '''!name:something''': Will retain only objects that don't have "something" in their name
: {{incode|!name:something}}: Mantiene solo gli oggetti che non hanno "something" nel loro nome
* '''label:something''': Will retain only objects that have "something" in their label (case-insensitive)
: {{incode|label:something}}: Mantiene solo gli oggetti che hanno "something" nella loro etichetta (case-insensitive)
* '''!label:something''': Will retain only objects that don't have "something" in their label
: {{incode|!label:something}}: Mantiene solo gli oggetti che non hanno "something" nella loro etichetta
* '''type:something''': Will retain only objects where the Draft.getType() function returns "something"
: {{incode|type:something}}: Mantiene solo gli oggetti in cui la funzione {{incode|Draft.getType()}} restituisce "something"
* '''!type:something''': Will retain only objects where the Draft.getType() function does not return "something"
: {{incode|!type:something}}: Mantiene solo gli oggetti in cui la funzione {{incode|Draft.getType()}} non restituisce "something"
* '''role:something''': Will retain only objects that have a Role property set to "something"
: {{incode|role:something}}: Mantiene solo gli oggetti che hanno una proprietà "Role" impostata su "something"
* '''!role:something''': Will retain only objects that don't have a Role property, or where the Role property is not set to "something"
: {{incode|!role:something}}: Mantiene solo gli oggetti che non dispongono di una proprietà Role, o in cui la proprietà Role non è impostata su "something"



{{clear}}
{{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}}
<languages/>

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

Revision as of 20:27, 17 May 2020

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, qui c'è un documento con una coppia di oggetti. Non è necessario che siano oggetti Arch, possono essere di qualsiasi tipo.

Poi premere il pulsante Scheda di Arch. 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".
  • 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.
  • 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.
  • 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.
  • 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.

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.

Filtri

Filtri attualmente disponibili:

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"