Oggetto 'Gestore della biblioteca'Permalink

Simbolo: _cds_icon_library_manager

Il Gestore delle librerie elenca tutte le librerie integrate nel progetto per la creazione di applicazioni. Fornisce informazioni sul tipo di libreria, sulle sue proprietà e sul suo contenuto.

È possibile espandere o ridurre l'elenco delle librerie integrate e modificare le proprietà delle librerie non dipendenti.

Il Gestore della biblioteca è composto da tre viste:

  • Vista superiore: Elenco delle biblioteche integrate

  • Vista in basso a sinistra: Struttura ad albero con tutti i moduli della libreria selezionati nella vista superiore

  • Vista in basso a destra: Documentazione del modulo selezionato nella struttura ad albero

Elenco delle biblioteche integrate

Elenco di tutte le librerie integrate nel progetto. Se una libreria dipende da altre librerie, queste vengono integrate automaticamente.

Visualizzati in caratteri grigi

La libreria è stata aggiunta automaticamente al progetto tramite un plug-in.

Visualizzati in caratteri neri

La libreria è stata aggiunta automaticamente al progetto mediante il comando «Add Library».

«Nome»

Visualizzazione della libreria integrata nella seguente sintassi:

«<nome del titolare> = <nome della biblioteca>, <versione> (<azienda>)»:

«<nome del segnaposto>»: Se si tratta di un segnaposto per una libreria, il nome del segnaposto è preceduto da un « = ».

«<nome della biblioteca>»: Nome della libreria utilizzata per la gestione nel repository della libreria.

«<versione>»: Versione a cui si è fatto riferimento la prima volta che è stato integrato.

«(<azienda>)»: Fornitore (facoltativo)

«Spazio dei nomi»

Namespace per l'accesso univoco ai contenuti della libreria.

A questo scopo, viene anteposto all'identificatore del modulo:

<namespace>.<identificatore del modulo della libreria>.

Lo spazio dei nomi di solito coincide con il nome della libreria.

Nota: Se la libreria ha la proprietà ‎LanguageModelAttribute "qualified-access-only"‎, allora dovete accedere al modulo della libreria nel codice dell'applicazione tramite lo spazio dei nomi. L'accesso qualificato (unico) viene imposto.

È possibile modificare lo spazio dei nomi standard per l'uso locale (all'interno del progetto) nella finestra di dialogo «Properties».

«Versione efficace»

Versione della libreria dopo la risoluzione. Questa versione è utilizzata nel progetto.

Requisito: Il Library Manager esiste nella vista «Devices» ed è selezionata una libreria segnaposto.

Esempio: ‎3.5.10.0‎

Una libreria di segnaposto integrata in un'applicazione viene risolta assegnando una risoluzione speciale alla libreria di segnaposto nella finestra di dialogo «Segnaposto». Quindi viene caricata la libreria selezionata. Le altre risoluzioni vengono ignorate. Se non viene indicata alcuna risoluzione speciale, viene verificato se nella descrizione del dispositivo e nel profilo di libreria dell'applicazione è specificata una risoluzione. Viene applicato il primo risultato della ricerca.

_cds_icon_info

Simbolo con tooltip per notificare la risoluzione corrente della libreria selezionata, dipendente dal dispositivo.

Esempio quando il Library Manager si trova nella vista «Devices»: «Questo segnaposto viene esplicitamente reindirizzato a questa versione (vedere la finestra di dialogo Segnaposto).»

Esempio quando il Library Manager si trova nella vista «POUs»: «Nel dispositivo 'Device_1', il segnaposto è risolto in 'VisuElemsAlarms, 1.0.0.0 (System)»

Una libreria segnaposto integrata nella vista «POUs» viene risolta controllando, a seconda dell'applicazione, se nella descrizione del dispositivo è specificata o meno una risoluzione. Successivamente, viene controllato il profilo della biblioteca. Viene utilizzata la prima risoluzione rilevata. Se si è assegnata una risoluzione speciale alla libreria dei segnaposto nella finestra di dialogo «Segnaposto», questa sarà sempre ignorata. Il risultato viene visualizzato nel tooltip del simbolo _cds_icon_info.

_cds_icon_libman_signed_lib

Libreria firmata con un certificato attendibile (compatibile con CODESYS >= V3 SP15)

_cds_icon_libman_signed_lib_with_deps

Libreria firmata con un certificato attendibile, ma che fa riferimento ad almeno una libreria non firmata.

_cds_icon_libman_signed_legacy_lib

Libreria firmata con una chiave privata e un token (compatibile con CODESYS < V3 SP15)

_cds_icon_libman_legacy_lib

Libreria non firmata o firmata con un certificato non attendibile o scaduto. Nel caso di un certificato non attendibile, il comando «Trust Certificate» è disponibile nel menu contestuale.

_cds_icon_libman_unavailable_opt_lib

Biblioteca definita come opzionale e non disponibile al momento

_cds_icon_libman_try_to_reload

Biblioteca il cui status è in corso di definizione

_cds_icon_libman_unlicensed_lib

Libreria con licenza per la quale non è attualmente disponibile una licenza valida

_cds_icon_tampered_library

Simbolo di libreria per una libreria che non può essere caricata perché non è stato possibile verificarne la firma (crittografia)

Tab. 585: Comandi nel Gestore di libreria

_cds_icon_libman_add_library «Aggiungi biblioteca»

Apre la finestra di dialogo per la selezione di una libreria. Vengono offerte tutte le librerie installate nel repository delle librerie.

_icon_delete_library «Cancellare la biblioteca»

Rimuove la libreria attualmente selezionata dal progetto.

_cds_icon_properties_library «Proprietà»

Apre la finestra di dialogo per la visualizzazione e la modifica delle proprietà della libreria attualmente selezionata.

_cds_icon_details «Dettagli»

Apre una finestra di dialogo con i dettagli della libreria attualmente selezionata (informazioni generali, contenuti, proprietà, informazioni sulla licenza).

_cds_icon_libman_try_to_reload «Prova a ricaricare la libreria»

Se si seleziona una libreria contrassegnata come non trovata, si può tentare di caricarla nuovamente nel progetto usando questo comando.

_cds_icon_libman_download «Scaricare Biblioteche mancanti»

CODESYS cerca le librerie mancanti nei server di download specificati nelle opzioni del progetto.

Successivamente è possibile scaricare e installare la libreria.

_cds_icon_placeholders «Segnaposto»

Si apre la finestra di dialogo «Segnaposto». La risoluzione corrente viene visualizzata e può essere modificata.

_icon_library_repository «Repository della biblioteca»

Apre la finestra di dialogo «Library Repository» per installare e disinstallare le librerie e per definire le posizioni delle librerie.

_cds_icon_libman_icon_legend «Legenda delle icone»

Apre la finestra di dialogo «Information» con una legenda delle icone che visualizzano lo stato attuale di una biblioteca nell'elenco delle biblioteche integrate (vedere sopra).

_cds_icon_summary «Sintesi»

Apre la finestra di dialogo «Library Summary». Tutte le librerie a cui si fa riferimento nel progetto sono visualizzate in una struttura ad albero nella finestra di dialogo, così come le librerie che fanno riferimento a tali librerie.

  • Comando «Visualizza tutte le occorrenze nella gerarchia della libreria e chiude la finestra di dialogo»: Nell'editor del Gestore delle librerie, sono contrassegnate le librerie nella struttura ad albero aperta che fanno riferimento o utilizzano questa libreria. Requisiti: Viene selezionata una biblioteca. La finestra di dialogo «Information» viene chiusa.

    Questo comando viene eseguito anche quando si fa doppio clic su una libreria.

Visualizzazione delle biblioteche

  • «Biblioteca gestita»: Nome e versione della libreria

  • «Numero di occorrenze»: Numero di posizioni in cui questa biblioteca è referenziata da altre biblioteche.

Quando si fa clic su «+» per una libreria, le librerie che fanno riferimento a questa libreria vengono visualizzate nel livello successivo.

_cds_icon_libman_trust_cert «Certificato di fiducia»

Solo nel menu contestuale di una libreria selezionata nel Gestore delle librerie, in cui la libreria è stata firmata con un certificato non attendibile. Il comando trasforma il certificato non attendibile in un certificato attendibile e l'icona anteposta cambia da _cds_icon_libman_legacy_lib a _cds_icon_libman_signed_lib.

«Libreria di esportazione»

Solo nel menu contestuale di una libreria selezionata nel Gestore delle librerie: Apre la finestra di dialogo predefinita per il salvataggio del file di libreria nel file system.

Struttura ad albero di tutti i moduli di una libreria selezionata

Tutti i moduli della libreria che sono stati integrati con la libreria sono elencati nella struttura ad albero.

Requisito: Nella vista superiore viene selezionata una libreria.

Le consuete funzioni di ordinamento e ricerca sono disponibili nella barra dei menu.

Documentazione per il modulo della biblioteca selezionato nella vista in basso a sinistra

Scheda «Ingressi/uscite»

Interfaccia (ingressi/uscite) del modulo di libreria

Scheda «Grafico»

Visualizzazione grafica del modulo

Scheda «Documentazione»

Documentazione per il modulo della libreria.

Nota: Come sviluppatore di una biblioteca, dovete seguire le regole per l'inclusione della documentazione nelle "Linee guida per lo sviluppo di una biblioteca".

Scheda «Elenco dei parametri»

Requisito: Il progetto della libreria contiene un elenco di parametri.

È possibile modificare i valori di questi parametri nella colonna «Valore (modificabile)».