Struttura del file di configurazione
L'esempio seguente illustra la struttura del file di configurazione:
|
|
|---|
|
<?xml version="1.0" encoding="utf-8" ?> <PackageConfiguration xmlns="http://www.siemens.com/automation/Openness/AddIn/Publisher/Vxx"> <Author>Example Author</Author> <Description>This Add-In does X, Y, and Z.</Description> <AddInVersion>V1.1</AddInVersion> <Product> <Name>Siemens Example</Name> <Id>ExampleUniqueProductId987654321</Id> <Version>0.0.1.0</Version> </Product> <FeatureAssembly> <AssemblyInfo> <Assembly>..\..\Assembly.dll</Assembly> <Pdb>..\..\Assembly.pdb</Pdb> </AssemblyInfo> </FeatureAssembly> <DisplayInMultiuser /> <AdditionalAssemblies> <AssemblyInfo> <Assembly>..\AdditionalAssemblies\UserInterfaceUtilities.dll</Assembly> <Pdb>..\AdditionalAssemblies\UserInterfaceUtilities.pdb</Pdb> </AssemblyInfo> <AssemblyInfo> <Assembly>..\AdditionalAssemblies\BL.Utilities.dll</Assembly> <Pdb>..\AdditionalAssemblies\BL.Utilities.pdb</Pdb> </AssemblyInfo> </AdditionalAssemblies> <RequiredPermissions> <TIAPermissions> <TIA.ReadOnly /> </TIAPermissions> <SecurityPermissions> <System.Security.Permissions.UIPermission/> <System.Security.Permissions.FileIOPermission> </System.Security.Permissions.FileIOPermission> <System.Security.Permissions.FileDialogPermission> </System.Security.Permissions.FileDialogPermission> <System.Security.Permissions.EnvironmentPermission /> <Siemens.Engineering.AddIn.Permissions.ProcessStartPermission/> <System.Net.WebPermission /> </SecurityPermissions> </RequiredPermissions> <Certificates> <SigningCertificate>..\Certificates\SigningFile.p12</SigningCertificate> <AdditionalCertificates> <Certificate>..\Certificates\AdditionalCert.cer</Certificate> </AdditionalCertificates> </Certificates> </PackageConfiguration> |
Nell'elemento "RequiredPermissions", è possibile utilizzare anche l'elemento "UnrestrictedPermissions" come alternativa all'elemento "SecurityPermissions" per consentire l'accesso illimitato all'Add-In. L'esempio seguente illustra la parte rilevati del file di configurazione per questo caso:
|
|
|---|
|
... <RequiredPermissions> <TIAPermissions> <TIA.ReadOnly /> </TIAPermissions> <UnrestrictedPermissions> <System.UnrestrictedAccess> <JustificationComment>Needed for ... </JustificationComment> </System.UnrestrictedAccess> </UnrestrictedPermissions> </RequiredPermissions> ... |
|
Nota Namespace Specificare il namespace "http://www.siemens.com/Automation/Openness/AddIn/Publisher/Vxx" nel tag "PackageConfiguration". "Vxx" indica la versione di TIA Portal. |
E' possibile copiare questo modello ed adeguarlo alle proprie esigenze.
Attenersi alle spiegazioni della seguente tabella:
|
Elemento |
Descrizione |
Elemento obbligatorio oppure opzionale |
|---|---|---|
|
PackageConfiguration |
Inserire questa riga dell'esempio sopra descritto nel proprio file di configurazione e adeguare il numero di versione. |
Elemento obbligatorio |
|
Author |
Indicare eventualmente l'autore dell'Add-In. |
Opzionale |
|
Description |
Se necessario inserire una descrizione dell'Add-In. |
Opzionale |
|
AddInVersion |
Se necessario inserire un numero di versione dell'Add-In. |
Opzionale |
|
Product |
Indicazioni sull'Add-In |
Elemento obbligatorio |
|
Name |
Nome dell'Add-In |
Elemento obbligatorio |
|
Id |
ID univoco dell'Add-In |
Elemento obbligatorio |
|
Version |
Numero di versione dell'Add-In |
Elemento obbligatorio |
|
FeatureAssembly |
Indicazioni sul file DLL |
Elemento obbligatorio |
|
AdditionalAssemblies |
Indicazione di altri file DLL che devono formare insieme un pacchetto Add-In |
Opzionale |
|
AssemblyInfo |
Elemento tra parantesi per "Assembly" e "Pdb" |
L'elemento obbligatorio al di sotto di "FeatureAssembly", può apparire sotto a "AdditionalAssemblies" per un numero indefinito di volte. |
|
Assembly |
Percorso del file DLL |
Elemento obbligatorio al di sotto di "FeatureAssembly" |
|
Pdb |
Percorso del file pdb |
Opzionale |
|
DisplayInMultiuser |
Per visualizzare il proprio Add-In nella sessione locale di un progetto multiutente, utilizzare questo elemento. |
Opzionale |
|
RequiredPermissions |
Con l'ausilio di quest'elemento possono essere create diverse autorizzazioni. |
Elemento obbligatorio |
|
TIAPermissions |
Autorizzazioni concernenti direttamente TIA Portal. |
Elemento obbligatorio |
|
TIA.ReadOnly |
Consente l'accesso in lettura a TIA Portal. Non utilizzabile in combinazione con "TIA.ReadWrite". |
Opzionale |
|
TIA.ReadWrite |
Consente l'accesso in scrittura a TIA Portal. Non utilizzabile in combinazione con "TIA.ReadOnly". |
Opzionale |
|
SecurityPermissions |
Autorizzazioni inerenti alla sicurezza. Non utilizzabile in combinazione con "UnrestrictedPermissions. |
Opzionale |
|
System.Configuration.ConfigurationPermission |
Vedere la documentazione .NET |
Opzionale |
|
System.Data.Odbc.OdbcPermission |
Vedere la documentazione .NET |
Opzionale |
|
System.Data.OleDb.OleDbPermission |
Vedere la documentazione .NET |
Opzionale |
|
System.Data.SqlClient.SqlClientPermission |
Vedere la documentazione .NET |
Opzionale |
|
System.Diagnostics.EventLogPermission |
Vedere la documentazione .NET |
Opzionale |
|
System.Drawing.Printing.PrintingPermission |
Vedere la documentazione .NET |
Opzionale |
|
System.Net.Mail.SmtpPermission |
Vedere la documentazione .NET |
Opzionale |
|
System.Net.NetworkInformation. |
Vedere la documentazione .NET |
Opzionale |
|
System.Net.SocketPermission |
Vedere la documentazione .NET |
Opzionale |
|
System.Net.WebPermission |
Vedere la documentazione .NET |
Opzionale |
|
System.Security.Permissions.EnvironmentPermission |
Vedere la documentazione .NET |
Opzionale |
|
System.Security.Permissions.FileDialogPermission |
Vedere la documentazione .NET |
Opzionale |
|
System.Security.Permissions.FileIOPermission |
Vedere la documentazione .NET |
Opzionale |
|
System.Security.Permissions. |
Vedere la documentazione .NET |
Opzionale |
|
System.Security.Permissions.KeyContainerPermission |
Vedere la documentazione .NET |
Opzionale |
|
System.Security.Permissions.RegistryPermission |
Vedere la documentazione .NET |
Opzionale |
|
System.Security.Permissions.StorePermission |
Vedere la documentazione .NET |
Opzionale |
|
System.Security.Permissions.UIPermission |
Vedere la documentazione .NET |
Opzionale |
|
System.Security.Permissions.WebBrowserPermission |
Vedere la documentazione .NET |
Opzionale |
|
System.Security.Permissions.MediaPermission |
Vedere la documentazione .NET |
Opzionale |
|
System.Security.Permissions.SecurityPermission. |
Vedere la documentazione .NET |
Opzionale |
|
Siemens.Engineering.AddIn.Permissions. |
Vedere la documentazione .NET |
Opzionale |
|
UnrestrictedPermissions |
Fornisce a Add-In tutti i diritti disponibili nell’ambiente utente attuale. Non utilizzabile in combinazione con "SecurityPermissions. |
Opzionale |
|
System.UnrestrictedAccess |
Fornisce a Add-In tutti i diritti di cui dispone l'utente connesso. |
Elemento obbligatorio al di sotto di "UnrestrictedPermissions" |
|
JustificationComment |
Specifica perché è necessario l'accesso illimitato. Il contenuto dell'elemento "JustificationComment" deve contenere un numero compreso tra 10 e 120 caratteri. Se si utilizzano più di 120 o meno di 10 caratteri, durante la creazione del file addin dal DLL, verrà visualizzato un messaggio di errore. |
Elemento obbligatorio al di sotto di "System.UnrestrictedAccess" |
|
Certificates |
L'Add-In può essere protetto da certificati. |
Opzionale |
|
SigningCertificate |
Inserire il certificato necessario per l'Add-In. |
Elemento obbligatorio al di sotto di "Certificates" |
|
AdditionalCertificates |
Utilizzare quest'elemento se si intende impiegare ulteriori certificati. |
Opzionale |
|
Certificate |
Percorso di un altro certificato |
Opzionale, può essere presente al di sotto di "AdditionalCertificates" per un numero indefinito di volte |