Report view/it: Difference between revisions

From FreeCAD Documentation
(Created page with "Finestra dei rapporti")
 
No edit summary
 
(29 intermediate revisions by 3 users not shown)
Line 1: Line 1:
<languages/>
<languages/>


== Introduction ==
<span id="Introduction"></span>
== Introduzione ==


La [[Report view/it|Vista report]] è un pannello che mostra i messaggi di testo dei processi e degli strumenti di FreeCAD. È disponibile nel menu {{MenuCommand|{{StdMenu|[[Std View Menu/it|Visualizza]]}} → Pannelli → Vista report}}.
The [[Report view|Report view]] is a panel that shows text messages from FreeCAD processes.


Alcune proprietà di questo pannello, come il colore del testo e se visualizzarlo automaticamente in caso di avvisi o di errori, possono essere configurate nella scheda {{MenuCommand|Generale → Report}} nell'[[Preferences_Editor/it#Report/it|editor delle preferenze]].
Certain properties of the view, like color of the text, can be configured in the [[Preferences_Editor|Preferences editor]].


[[File:FreeCAD_Report_view.png|800px]]
[[File:FreeCAD_Report_view.png|800px]]


{{Caption|The report view showing messages when FreeCAD has just started.}}
{{Caption|Vista report che mostra i messaggi quando FreeCAD è appena stato avviato.}}


== Messages ==
<span id="Messages"></span>
== Messagi ==


{{Emphasis|See also:}} [[Console API|Console API]], and [[FreeCAD Scripting Basics|FreeCAD Scripting Basics]].
{{Emphasis|Vedere anche:}} [[TechDraw API/it|API TechDraw]] e [[FreeCAD Scripting Basics/it|Nozioni di base sugli script di FreeCAD]].


The report view displays messages from the internal FreeCAD {{incode|Console}} class.
La vista report mostra i messaggi della classe interna {{incode|Console}} di FreeCAD.
* {{incode|FreeCAD.Console.PrintMessage("text")}}, print any sort of informative message, that doesn't imply any misbehavior; for example, print the coordinates of points, the result of a distance calculation, the number of vertices in a shape, etc. By default, in black color.
* {{incode|FreeCAD.Console.PrintMessage("text")}}, stampa qualsiasi tipo di messaggio informativo, che non implica alcun comportamento scorretto; ad esempio, stampa le coordinate dei punti, il risultato di un calcolo della distanza, il numero di vertici in una forma, ecc. Per impostazione predefinita, in colore nero.
* {{incode|FreeCAD.Console.PrintWarning("text")}}, print messages that are intended to warn the user about strange behavior in the application. Warnings should be shown when some functionality is missing but the software still works acceptably. By default, in yellow color.
* {{incode|FreeCAD.Console.PrintWarning("text")}}, stampa i messaggi che hanno lo scopo di avvisare l'utente di comportamenti strani nell'applicazione. Gli avvisi sono mostrati quando mancano alcune funzionalità ma il software funziona ancora in modo accettabile. Di default, in colore giallo.
* {{incode|FreeCAD.Console.PrintError("text")}}, print messages that are intended to be error messages, that is, when a critical component is missing that makes a certain operation fail. By default, in red color.
* {{incode|FreeCAD.Console.PrintError("text")}}, stampa i messaggi di errore, vale a dire quando manca un componente critico che fa fallire una determinata operazione. Di default, in colore rosso.
* {{incode|FreeCAD.Console.PrintLog("text")}}, print messages that are going into the logs. These messages could be anything that is valuable to troubleshoot a problem in the future by reading the logs, for example, starting or closing a workbench. By default, in blue color.
* {{incode|FreeCAD.Console.PrintLog("text")}}, stampa i messaggi che vanno anche nei registri. Questi messaggi possono essere utili in seguito per risolvere un problema leggendo i registri, ad esempio quando si avvia o si chiude un ambiente. Di default, in colore blu.


These functions can be used from the [[Python console|Python console]] directly, or from [[Macros|macros]] and custom workbenches.
Queste funzioni possono essere utilizzate direttamente dalla [[Python console/it|console Python]], o tramite le [[Macros/it|macro]] e gli ambienti personalizzati.


[[File:FreeCAD_Report_view_example.png|800px]]
[[File:FreeCAD_Report_view_example.png|800px]]


{{Caption|Example messages in the report view: a general message, a warning, an error, and a logged message.}}
{{Caption|Esempio di messaggi nella vista report: un messaggio generale, un avviso, un errore e un messaggio registrato.}}


== Actions ==
<span id="Actions"></span>
==Azioni ==


Facendo clic con il pulsante destro del mouse sulla vista del report si apre un menu contestuale con i seguenti comandi:
Right click on the report view shows some commands:
* {{MenuCommand|Opzioni}}:
* {{MenuCommand|Options}}: logging, warning, error, redirect Python output, redirect Python errors, go to end.
** {{MenuCommand|Visualizza tipi di messaggi}}: vedere [[Preferences_Editor/it#Finestra di output|Editor Preferenze]].
* {{MenuCommand|Copy}}: stores the selected text in the clipboard for later pasting; it is disabled if nothing is selected.
* {{MenuCommand|Select all}}: selects all text in the report view.
** {{MenuCommand|Mostra la Vista Report in caso di}}: idem.
** {{MenuCommand|Reindirizza l'output di Python}}: idem.
* {{MenuCommand|Clear}}: erases all messages in the report view. This is useful if you want to troubleshoot a tool that prints messages to the report view, and want to be sure there are no old messages from previous tools.
* {{MenuCommand|Save as}}: save the messages in the report view to a text file.
** {{MenuCommand|Reindirizza gli errori di Python}}: idem.
** {{MenuCommand|Vai alla fine}}: se selezionato, la visualizzazione del rapporto scorrerà verso il basso quando viene aggiunto un nuovo messaggio.
* {{MenuCommand|Copia}}: memorizza il testo selezionato negli appunti per un successivo incollaggio; è disabilitato se non è selezionato nulla.
* {{MenuCommand|Seleziona tutto}}: seleziona tutto il testo della vista report.
* {{MenuCommand|Pulisci}}: cancella tutti i messaggi nella vista report. Ciò è utile se si desidera risolvere uno problema che stampa i messaggi nella vista report e si desidera assicurarsi che non vi siano vecchi messaggi di problemi precedenti.
* {{MenuCommand|Salva con nome}}: salva i messaggi della vista report in un file di testo.



{{Interface}}
{{Interface navi{{#translation:}}}}
{{Userdocnavi}}
{{Std Base navi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}

Latest revision as of 20:17, 21 August 2023

Introduzione

La Vista report è un pannello che mostra i messaggi di testo dei processi e degli strumenti di FreeCAD. È disponibile nel menu Visualizza → Pannelli → Vista report.

Alcune proprietà di questo pannello, come il colore del testo e se visualizzarlo automaticamente in caso di avvisi o di errori, possono essere configurate nella scheda Generale → Report nell'editor delle preferenze.

Vista report che mostra i messaggi quando FreeCAD è appena stato avviato.

Messagi

Vedere anche: API TechDraw e Nozioni di base sugli script di FreeCAD.

La vista report mostra i messaggi della classe interna Console di FreeCAD.

  • FreeCAD.Console.PrintMessage("text"), stampa qualsiasi tipo di messaggio informativo, che non implica alcun comportamento scorretto; ad esempio, stampa le coordinate dei punti, il risultato di un calcolo della distanza, il numero di vertici in una forma, ecc. Per impostazione predefinita, in colore nero.
  • FreeCAD.Console.PrintWarning("text"), stampa i messaggi che hanno lo scopo di avvisare l'utente di comportamenti strani nell'applicazione. Gli avvisi sono mostrati quando mancano alcune funzionalità ma il software funziona ancora in modo accettabile. Di default, in colore giallo.
  • FreeCAD.Console.PrintError("text"), stampa i messaggi di errore, vale a dire quando manca un componente critico che fa fallire una determinata operazione. Di default, in colore rosso.
  • FreeCAD.Console.PrintLog("text"), stampa i messaggi che vanno anche nei registri. Questi messaggi possono essere utili in seguito per risolvere un problema leggendo i registri, ad esempio quando si avvia o si chiude un ambiente. Di default, in colore blu.

Queste funzioni possono essere utilizzate direttamente dalla console Python, o tramite le macro e gli ambienti personalizzati.

Esempio di messaggi nella vista report: un messaggio generale, un avviso, un errore e un messaggio registrato.

Azioni

Facendo clic con il pulsante destro del mouse sulla vista del report si apre un menu contestuale con i seguenti comandi:

  • Opzioni:
    • Visualizza tipi di messaggi: vedere Editor Preferenze.
    • Mostra la Vista Report in caso di: idem.
    • Reindirizza l'output di Python: idem.
    • Reindirizza gli errori di Python: idem.
    • Vai alla fine: se selezionato, la visualizzazione del rapporto scorrerà verso il basso quando viene aggiunto un nuovo messaggio.
  • Copia: memorizza il testo selezionato negli appunti per un successivo incollaggio; è disabilitato se non è selezionato nulla.
  • Seleziona tutto: seleziona tutto il testo della vista report.
  • Pulisci: cancella tutti i messaggi nella vista report. Ciò è utile se si desidera risolvere uno problema che stampa i messaggi nella vista report e si desidera assicurarsi che non vi siano vecchi messaggi di problemi precedenti.
  • Salva con nome: salva i messaggi della vista report in un file di testo.