Progetti

Cos’è un progetto

Un progetto è un contenitore di elementi con i quali si realizza un’applicazione Q Application. Include i seguenti elementi:

  • oggetti, tipi oggetto, variabili, tipi di variabili, metodi

  • risorse grafiche e multimediali

  • NetLogic (vedere NetLogic), per implementare logiche applicative personalizzate scritte in C#.

Formati binario e testuale

È possibile creare progetti in formato binario o testuale (formato aperto leggibile/modificabile da editor di codice). Il formato testuale è utile quando si progetta in ambiente collaborativo con controllo di versione per consultare e collaborare sul progetto al di fuori dei Q Studio(vedere Progetti in formato testuale). Quando si crea un nuovo progetto, il formato testuale è il formato predefinto.

Progetti a design time e a runtime

La fase di sviluppo di un progetto è definita design time. In questa fase, il progetto sorgente include anche un progetto Visual Studio per gestire logiche applicative personalizzate scritte in C# (vedere NetLogic).

La fase di esecuzione di un progetto su un target è definita runtime. Per progetti in formato binario, il progetto in una Q Application è compilato, ovvero costituito da un insieme di file binari, in particolare da un sottoinsieme degli elementi del progetto sorgente e da altri file binari inclusi automaticamente. In questo progetto compilato, i file C# diventano un assembly .NET.

Compatibilità dei progetti

I progetti creati con versioni precedenti di Q Studio possono essere aperti e lavorati anche con versioni successive. Per fare ciò è sufficiente aprire il progetto: Q Studio può aggiornare automaticamente il progetto e tutti i moduli funzionali alla versione corrente. Durante l’aggiornamento viene creata una copia di backup del progetto in versione originale.

Avvertimento

Una volta che un progetto è stato aggiornato alla versione più recente di Q Studio, non è più possibile aprirlo con versioni precedenti.

Progetti su file system

Ogni progetto è contenuto in una cartella su file system con lo stesso nome. Di seguito un esempio di un progetto in formato binario denominato Project:

../_images/f70478e0e741c7fa9ae06c65580866967155aea3.png

Ogni progetto sorgente ha la seguente struttura di file e cartelle:

Progetto

Contenuto

Formato binario

  • Il file di progetto, con estensione .uniqo.

  • Un file con estensione .uniqo.design. Contiene elementi accessori necessari solo a design time, ad esempio importatori di tag,

  • Cartella ProjectFiles. Contiene tutti i file in uso nel progetto, tra cui immagini, font e documenti. Contiene le seguenti sottocartelle:

    • NetSolution. Contiene tutti i file C# per realizzare logiche applicative personalizzate (vedere NetLogic).

    • PKI. Contiene i certificati privati, pubblici e rifiutati per realizzare autenticazioni OPC UA.

Formato testuale

  • Il file di progetto, con estensione .uniqo. Contiene informazioni generali sul progetto e i riferimenti ai moduli Q Platform in uso.

  • Un file con estensione .uniqo.design. Contiene informazioni generali sul progetto e i riferimenti ad altri moduli Q Platform necessari per elementi accessori necessari solo a design time.

  • Cartella Nodes. Contiene i seguenti file:

    • un file di testo in formato YAML ProjectName.yaml per il nodo radice del progetto, in cui sono riportate le relative proprietà e i riferimenti agli altri nodi principali del progetto.

    • una cartella per ogni nodo cartella del progetto (UI, Model, ecc…), contenente un file YAML che ne descrive il relativo modello informativo (UI.yaml, Model.yaml, eccetera).

  • Cartella ProjectFiles. Contiene tutti i file in uso nel progetto, tra cui immagini, font e documenti. Contiene le seguenti sottocartelle:

    • NetSolution. Contiene tutti i file C# per realizzare logiche applicative personalizzate (vedere NetLogic).

    • PKI. Contiene i certificati privati, pubblici e rifiutati per realizzare autenticazioni OPC UA.

Backup di progetto

Q Studio esegue automaticamente un backup di progetto nei seguenti casi:

  • ogni volta che si salva il progetto

  • ogni volta che si aggiorna il progetto per renderlo compatibile con una versione più recente di Q Studio

  • ogni volta che si aggiorna il progetto per tentare di riparare un progetto corrotto (vedere Ripristinare un progetto)

Cartelle di backup

La cartella dei backup si trova nel percorso seguente e contiene una cartella per ogni progetto:

%localappdata%\ASEM\UNIQO\QStudio\Backups\[ProjectName]

../_images/d70b833589b651b3f0869496b3334818baf72457.png

Ognuna di queste cartelle contiene altre sottocartelle con diversi tipi di backup:

../_images/dfab1750057f1ed476d946fbe2e43268cc631cac.png

Di seguito la descrizione di queste cartelle:

  • Automatic: tre backup a rotazione, eseguiti quando si salva il progetto

  • Recovery: backup eseguiti quando si apre e si tenta di riparare in Q Studio un progetto corrotto (vedere Ripristinare un progetto)

  • Upgrade: backup eseguiti quando si aggiorna il progetto per renderlo compatibile con una versione più recente di Q Studio

Vedi anche

Procedure correlate

Gestire i progetti