Modifiche alle proprietà personalizzate in Outlook

Procedura consigliata: Aggiungere campi personalizzati a livello di programmazione

È possibile usare varie API per aggiungere campi personalizzati agli elementi a livello di programmazione. A questo scopo, usare il metodo UserProperties.Add nella libreria di oggetti di Outlook ("Outlook.Application"). Il codice seguente illustra questa procedura consigliata.

Set myProp = myItem.UserProperties.Add("MyPropName", olText)

È anche possibile usare la libreria di oggetti CDO ("MAPI. sessione") per aggiungere campi personalizzati. Per ulteriori informazioni, visitare il seguente sito Web MSDN:

http://msdn2.microsoft.com/en-us/library/ms527518.aspx Per gli sviluppatori C++ è possibile usare MAPI estesa per aggiungere proprietà denominate. Per ulteriori informazioni, visitare il seguente sito Web MSDN:

http://msdn2.microsoft.com/en-us/library/ms529684.aspx

Procedura consigliata: Usare moduli personalizzati pubblicati che contengono campi personalizzati

Outlook considera in gran parte attendibili i moduli personalizzati pubblicati. Tuttavia, Outlook non considera attendibili i moduli non pubblicati o i moduli una tantum. Sono inclusi i file con estensione oft. Pertanto, quando si progetta una soluzione per moduli personalizzati, è consigliabile pubblicare il modulo personalizzato. È consigliabile progettare la maschera in modo che non diventi una maschera una tantum. Finché un modulo viene pubblicato, il modulo non sarà interessato dalla modifica in Outlook.
 
Quando si pubblica un file oft in un altro archivio, l'archivio predefinito consente di creare proprietà in tale archivio. Inoltre, quando si crea un modulo personalizzato con proprietà personalizzate e lo si pubblica nella raccolta moduli o nella cartella appropriata, le proprietà personalizzate vengono create negli archivi interessati.

Procedura consigliata: Distribuzione a livello di programmazione di moduli personalizzati

Se si sviluppa un modulo personalizzato di Outlook che verrà usato da altri utenti, è possibile usare alcuni approcci. L'approccio usato dipende da diversi fattori. Questi fattori includono il tipo di maschera, chi userà la maschera, dove verrà usata la maschera e così via. In genere, se un modulo personalizzato verrà usato da molti utenti, è consigliabile pubblicarlo nella Libreria moduli organizzazione. Tuttavia, se non è possibile, è consigliabile pubblicare il modulo in una cartella condivisa o nella raccolta moduli personali di alcuni utenti. È possibile installare a livello di programmazione un modulo personalizzato usando il metodo CreateItemFromTemplate nella libreria di oggetti di Outlook. Utilizzare il metodo CreateItemFromTemplate per aprire un file con estensione oft e quindi pubblicare il modulo usando il metodo PublishForm. In questo caso, le modifiche alle proprietà personalizzate non influiscono su un file oft.

Non consigliato: distribuire o inviare file oft agli utenti per l'apertura

È possibile salvare i moduli personalizzati di Outlook come file oft. Questi moduli possono contenere campi personalizzati, modifiche dell'interfaccia utente e codice Microsoft Visual Basic Scripting Edition (VBScript) personalizzato per aggiungere funzionalità al modulo. Anche se Outlook contiene già funzionalità che impediscono l'esecuzione del codice VBScript nei file oft, Outlook ora limita anche l'uso dei file oft. Se un file oft contiene proprietà personalizzate e l'utente non le ha usate in precedenza, le proprietà personalizzate non sono presenti nell'archivio predefinito dell'utente. Outlook non esegue il rendering del modulo personalizzato quando l'utente fa doppio clic sul file. Tuttavia, per fare in modo che Outlook apra un modulo personalizzato archiviato come file oft, fare clic su File, su Nuovo e quindi su Scegli modulo. È quindi possibile cambiare il percorso in Modelli utente nel file system e quindi fare clic su Sfoglia per aprire il file oft. Verrà aperta la maschera ed è possibile salvare le proprietà personalizzate nell'archivio predefinito.

Non consigliato: usare la chiave del Registro di sistema AllowNamedProps

Alcune organizzazioni potrebbero avere motivi validi per avere alcune proprietà personalizzate disponibili nell'intera organizzazione. Se vengono usati più negozi, è consigliabile verificare che sia possibile aggiungere un set di proprietà personalizzate a tutti gli store. Di conseguenza, Outlook 2003 SP2 e versioni successive supportano chiavi del Registro di sistema lato client che specificano quali proprietà personalizzate possono essere create. Per specificare quali proprietà personalizzate devono essere abilitate, le proprietà personalizzate sono definite nella chiave del Registro di sistema seguente: HKEY_CURRENT_USER\Software\Microsoft\Office\<versione>\Outlook\AllowedNamedProps\

Nota In questa chiave del Registro di sistema <versione> è un segnaposto per la versione di Outlook in uso. Per Outlook 2003, il numero di versione è 11.0. Per Outlook 2007, il numero di versione è 12.0. Il numero di versione aumenterà nelle versioni più recenti di Outlook.

La struttura generale della chiave del Registro di sistema per una voce nel Registro di sistema è:

> GUID di <

> Nome proprietà <

"Kind" (dword)

"ID" (dword)
"Type" (dword) Nella struttura della chiave del Registro di sistema vengono utilizzati i segnaposto seguenti:

• <> GUID : contiene il GUID che specifica il set di proprietà. I campi personalizzati di Outlook, o proprietà, usati in un modulo personalizzato di Outlook hanno tutti il GUID {00020329-0000-0000-C000-000000000046}. In MAPI il GUID viene definito PS_PULIC_STRINGS. Tuttavia, i programmi MAPI personalizzati possono avere guidi personalizzati per le proprietà personalizzate.

• <> Nome proprietà : specifica il nome della proprietà. Se la proprietà è denominata da una stringa, il <Nome proprietà> è il nome stringa effettivo della proprietà. Se la proprietà è denominata da un ID, il valore di questa chiave del Registro di sistema viene ignorato. È tuttavia necessario assegnare alla proprietà un nome univoco in modo che la proprietà possa essere archiviata nel Registro di sistema. Se la chiave Kind è impostata su 1 o è <> 0, il nome della chiave del Registro di sistema determinerà il nome della proprietà. Se la chiave Kind non è uguale a 1, il nome della chiave del Registro di sistema verrà ignorato.

• "Kind" (dword): specifica se la proprietà è denominata da un ID o da una stringa. Se il valore è 0, la proprietà verrà denominata da un ID. Il nome è un valore numerico specificato da un ID. Se il valore è 1, alla proprietà verrà assegnato un nome da una stringa. Questa è l'impostazione predefinita quando "Kind" non è presente.

• "ID" (dword): contiene il nome ID di una proprietà denominata da un ID. Queste informazioni sono necessarie se la chiave Kind è impostata su 0. Se la chiave Kind è impostata su 1, queste informazioni vengono ignorate.

• "Tipo" (dword): specifica il tipo di proprietà.

Questa chiave del Registro di sistema è obbligatoria, ma la chiave del Registro di sistema non è attualmente in uso. La tabella seguente elenca i valori possibili di questa chiave del Registro di sistema in base al tipo MAPI.

Di seguito è riportato un esempio di come impostare una proprietà denominata per stringa:

Nome: "NomeCampoStringa1"

Tipo: PT_LONG

[HKEY_CURRENT_USER\Software\Microsoft\Office\11.0\Outlook\AllowedNamedProps\{00020329-0000-0000-C000-000000000046}\MyStringFieldName1] "Type"=dword:00000003
Di seguito è riportato un esempio di come impostare una proprietà named-by-ID:

ID: 0x0330

Tipo: PT_LONG

[HKEY_CURRENT_USER\Software\Microsoft\Office\11.0\Outlook\AllowedNamedProps\{00020329-0000-0000-C000-000000000046}\MyMAPIProp1] "Kind"=dword:00000000 "ID"=dword:00000330 "Type"=dword:00000003


Per questi due esempi, il Registro di sistema è simile al seguente nell'editor del Registro di sistema:


{00020329-0000-0000-C000-000000000046}
 

NomeCampoStringa1

Tipo = 3
NomeCampoStringa2

Tipo = 3
{00020329-0000-0000-C000-000000000046}

MyMAPIProp1

Tipo = 0
ID = 330

Tipo = 3
MyMAPIProp2

Tipo = 0
ID = 331
Tipo = 3

Non consigliato: abilitare nuovamente la possibilità di creare proprietà

È possibile distribuire tre chiavi del Registro di sistema nei computer client per disabilitare il blocco delle proprietà personalizzate e ripristinare il comportamento precedente di Outlook. Queste chiavi del Registro di sistema sono supportate dai criteri di gruppo. Le chiavi del Registro di sistema seguenti possono ripristinare il comportamento precedente di Outlook 2003:

Nota Le chiavi del Registro di sistema seguenti non ripristinano il comportamento precedente di Outlook 2007.

• AllowTNEFtoCreateProps (HKEY_CURRENT_USER\Software\Microsoft\Office\11.0\Outlook\Options\Mail] "AllowTNEFtoCreateProps"=dword:00000000): se il valore è 0, TNEF/MIME non può creare nuove proprietà personalizzate non di Outlook. Questo valore è il valore predefinito. Se il valore è 1, TNEF/MIME può creare nuove proprietà personalizzate non Di Outlook.

• AllowMSGFilestoCreateProps: se il valore è 0, i file con estensione msg e oft non possono creare nuove proprietà personalizzate non di Outlook. Questo valore è il valore predefinito. Se il valore è 1, i file con estensione msg e oft possono creare nuove proprietà personalizzate non di Outlook.

• DisallowTNEFPreservation: per semplificare la migrazione a questo nuovo comportamento, Outlook mantiene il TNEF originale quando non vengono create proprietà personalizzate. Il TNEF originale viene salvato in un flusso binario sull'elemento che viene salvato. Outlook usa il tag di proprietà seguente per salvare il flusso:

  PR_TNEF_UNPROCESSED_PROPS PROG_TAG(PT_BINARY, 0x0e9C). The HKEY_CURRENT_USER\Software\Microsoft\Office\11.0\Outlook\Options\Mail] "DisallowTNEFPreservation "=dword:00000000
  controlla se Outlook crea la proprietà PR_TNEF_UNPROCESSED_PROPS.
  
  Nota La proprietà PR_TNEF_UNPROCESSED_PROPS viene rimossa da un messaggio quando si incorpora un messaggio in un altro messaggio come allegato. La proprietà PR_TNEF_UNPROCESSED_PROPS viene rimossa anche quando si inoltra un messaggio o si risponde a un messaggio.