Wijzigingen in aangepaste eigenschappen in Outlook

Best practice: Aangepaste velden programmatisch toevoegen

Verschillende API's kunnen worden gebruikt om programmatisch aangepaste velden toe te voegen aan items. Gebruik hiervoor de methode UserProperties.Add in de Outlook-objectbibliotheek ('Outlook.Application'). De volgende code illustreert deze best practice.

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

U kunt ook de CDO-objectbibliotheek (MAPI. Sessie") om aangepaste velden toe te voegen. Ga voor meer informatie naar de volgende MSDN-website:

http://msdn2.microsoft.com/en-us/library/ms527518.aspx Voor C++-ontwikkelaars kan Uitgebreide MAPI worden gebruikt om benoemde eigenschappen toe te voegen. Ga voor meer informatie naar de volgende MSDN-website:

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

Aanbevolen procedure: Gepubliceerde aangepaste formulieren gebruiken die aangepaste velden bevatten

Outlook vertrouwt gepubliceerde aangepaste formulieren grotendeels. Outlook vertrouwt echter geen niet-gepubliceerde formulieren of eenmalige formulieren. Dit omvat .oft-bestanden. Wanneer u een aangepaste formulieroplossing ontwerpt, wordt u daarom ten zeerste aangeraden het aangepaste formulier te publiceren. U moet het formulier zo ontwerpen dat het formulier geen eenmalig formulier wordt. Zolang een formulier wordt gepubliceerd, wordt het formulier niet beïnvloed door de wijziging in Outlook.
 
Wanneer u een .oft-bestand naar een ander archief publiceert, kunt u met het standaardarchief eigenschappen in dat archief maken. Wanneer u bovendien een aangepast formulier maakt met aangepaste eigenschappen en u dit publiceert naar de juiste formulierbibliotheek of map, worden de aangepaste eigenschappen gemaakt in de betrokken winkels.

Best practice: Programmatisch aangepaste formulieren implementeren

Als u een aangepast Outlook-formulier ontwikkelt dat door anderen wordt gebruikt, zijn er enkele benaderingen die u kunt gebruiken. De benadering die u gebruikt, is afhankelijk van verschillende factoren. Deze factoren omvatten het type formulier, wie het formulier gaat gebruiken, waar het formulier wordt gebruikt, enzovoort. Als een aangepast formulier door veel mensen wordt gebruikt, raden we u meestal aan het formulier te publiceren in de bibliotheek organisatieformulieren. Als dat echter niet mogelijk is, kunt u het formulier publiceren in een gedeelde map of in de persoonlijke formulierenbibliotheek van sommige gebruikers. U kunt een aangepast formulier programmatisch installeren met behulp van de methode CreateItemFromTemplate in de Outlook-objectbibliotheek. U gebruikt de methode CreateItemFromTemplate om een .oft-bestand te openen en vervolgens het formulier te publiceren met behulp van de methode PublishForm. In dit geval wordt een .oft-bestand niet beïnvloed door de wijzigingen in de aangepaste eigenschappen.

Niet aanbevolen: .oft-bestanden implementeren of verzenden die gebruikers kunnen openen

U kunt aangepaste Outlook-formulieren opslaan als .oft-bestanden. Deze formulieren kunnen aangepaste velden, wijzigingen in de gebruikersinterface en aangepaste VBScript-code (Microsoft Visual Basic Scripting Edition) bevatten om functionaliteit aan het formulier toe te voegen. Hoewel Outlook al functies bevat die voorkomen dat de VBScript-code in .oft-bestanden wordt uitgevoerd, beperkt Outlook nu ook het gebruik van .oft-bestanden. Als een .oft-bestand aangepaste eigenschappen bevat en de gebruiker deze aangepaste eigenschappen nog niet eerder heeft gebruikt, bevinden de aangepaste eigenschappen zich niet in het standaardarchief van de gebruiker. Het aangepaste formulier wordt niet weergegeven wanneer de gebruiker dubbelklikt op het bestand. Als u echter wilt dat Outlook een aangepast formulier opent dat is opgeslagen als een .oft-bestand, klikt u op Bestand, klikt u op Nieuw en klikt u vervolgens op Formulier kiezen. U kunt vervolgens de locatie wijzigen in Gebruikerssjablonen in bestandssysteem en vervolgens op Bladeren klikken om het .oft-bestand te openen. Het formulier wordt geopend en u kunt de aangepaste eigenschappen opslaan in het standaardarchief.

Niet aanbevolen: gebruik de registersleutel AllowNamedProps

Sommige organisaties kunnen geldige redenen hebben om bepaalde aangepaste eigenschappen beschikbaar te hebben in de hele organisatie. Als er meerdere winkels worden gebruikt, kunt u ervoor zorgen dat een set aangepaste eigenschappen kan worden toegevoegd aan alle winkels. Daarom ondersteunen Outlook 2003 SP2 en latere versies registersleutels aan de clientzijde die aangeven welke aangepaste eigenschappen kunnen worden gemaakt. Als u wilt opgeven welke aangepaste eigenschappen moeten worden ingeschakeld, worden aangepaste eigenschappen gedefinieerd onder de volgende registersleutel: HKEY_CURRENT_USER\Software\Microsoft\Office\<versie>\Outlook\AllowedNamedProps\

Opmerking In deze registersleutel is <versie> een tijdelijke aanduiding voor de versie van Outlook die u gebruikt. Voor Outlook 2003 is het versienummer 11.0. Voor Outlook 2007 is het versienummer 12.0. Het versienummer wordt verhoogd in latere versies van Outlook.

De algemene registersleutelstructuur voor een vermelding in het register is:

<GUID ->

<>

"Soort" (dword)

"ID" (dword)
"Type" (dword) De volgende tijdelijke aanduidingen worden gebruikt in de registersleutelstructuur:

• <GUID>: bevat de GUID die de eigenschappenset aangeeft. Aangepaste Outlook-velden of -eigenschappen die u in een aangepast Outlook-formulier gebruikt, hebben allemaal de GUID {00020329-0000-0000-C000-00000000046}. In MAPI wordt de GUID PS_PULIC_STRINGS genoemd. Aangepaste MAPI-programma's kunnen echter hun eigen GUID's hebben voor aangepaste eigenschappen.

• <eigenschapsnaam>: hiermee geeft u de naam van de eigenschap op. Als de eigenschap een naam heeft met een tekenreeks, is de <Eigenschapsnaam> de werkelijke tekenreeksnaam van de eigenschap. Als de eigenschap een naam heeft met een id, wordt de waarde van deze registersleutel genegeerd. U moet de eigenschap echter een unieke naam geven, zodat de eigenschap kan worden opgeslagen in het register. Als de sleutel Soort is ingesteld op 1 of is <> 0, bepaalt de naam van de registersleutel de naam van de eigenschap. Als de sleutel Kind niet gelijk is aan 1, wordt deze registersleutelnaam genegeerd.

• 'Soort' (dword): hiermee geeft u op of de eigenschap een naam heeft met een id of een tekenreeks. Als de waarde 0 is, krijgt de eigenschap een naam met een id. De naam is een numerieke waarde die wordt opgegeven door een id. Als de waarde 1 is, krijgt de eigenschap een naam met een tekenreeks. Deze instelling is de standaardinstelling wanneer 'Soort' niet aanwezig is.

• 'ID' (dword): bevat de id-naam van een eigenschap met de naam van een id. Deze informatie is vereist als de sleutel Soort is ingesteld op 0. Als de sleutel Soort is ingesteld op 1, wordt deze informatie genegeerd.

• 'Type' (dword): hiermee geeft u het type eigenschap op.

Deze registersleutel is vereist, maar de registersleutel wordt momenteel niet gebruikt. De volgende tabel bevat de mogelijke waarden van deze registersleutel op basis van het MAPI-type.

Hier volgt een voorbeeld van het instellen van een eigenschap named-by-string:

Naam: "MyStringFieldName1"

Type: PT_LONG

[HKEY_CURRENT_USER\Software\Microsoft\Office\11.0\Outlook\AllowedNamedProps\{00020329-0000-0000-C000-000000000046}\MyStringFieldName1] "Type"=dword:00000003
Hier volgt een voorbeeld van het instellen van een eigenschap named-by-ID:

Id: 0x0330

Type: PT_LONG

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


Voor deze twee voorbeelden ziet het register er ongeveer als volgt uit in register-editor:


{00020329-0000-0000-C000-0000000000046}
 

MyStringFieldName1

Type = 3
MyStringFieldName2

Type = 3
{00020329-0000-0000-C000-0000000000046}

MyMAPIProp1

Soort = 0
ID = 330

Type = 3
MyMAPIProp2

Soort = 0
ID = 331
Type = 3

Niet aanbevolen: De mogelijkheid om eigenschappen te maken opnieuw inschakelen

Er kunnen drie registersleutels worden geïmplementeerd op clientcomputers om de blokkering van aangepaste eigenschappen uit te schakelen en outlook terug te keren naar het vorige gedrag. Deze registersleutels worden ondersteund door groepsbeleid. De volgende registersleutels kunnen outlook 2003 herstellen naar het vorige gedrag:

Opmerking Met de volgende registersleutels wordt Outlook 2007 niet teruggezet naar het vorige gedrag.

• AllowTNEFtoCreateProps (HKEY_CURRENT_USER\Software\Microsoft\Office\11.0\Outlook\Options\Mail] "AllowTNEFtoCreateProps"=dword:00000000): als de waarde 0 is, kan TNEF/MIME geen nieuwe aangepaste eigenschappen van niet-Outlook maken. Deze waarde is de standaardwaarde. Als de waarde 1 is, kan TNEF/MIME nieuwe aangepaste eigenschappen van niet-Outlook maken.

• AllowMSGFilestoCreateProps: als de waarde 0 is, kunnen .msg-bestanden en .oft-bestanden geen nieuwe aangepaste eigenschappen maken die niet van Outlook zijn. Deze waarde is de standaardwaarde. Als de waarde 1 is, kunnen .msg-bestanden en .oft-bestanden nieuwe aangepaste eigenschappen van niet-Outlook maken.

• Niet toestaanTNEFReservering: Om de migratie naar dit nieuwe gedrag te vergemakkelijken, behoudt Outlook de oorspronkelijke TNEF wanneer er geen aangepaste eigenschappen worden gemaakt. De oorspronkelijke TNEF wordt opgeslagen in een binaire stroom op het item dat wordt opgeslagen. Outlook gebruikt de volgende eigenschapstag om de stream op te slaan:

  PR_TNEF_UNPROCESSED_PROPS PROG_TAG(PT_BINARY; 0x0e9C). De HKEY_CURRENT_USER\Software\Microsoft\Office\11.0\Outlook\Options\Mail] "DisallowTNEFPreservation "=dword:000000000
  registerinstelling bepaalt of outlook de eigenschap PR_TNEF_UNPROCESSED_PROPS maakt.
  
  Opmerking De eigenschap PR_TNEF_UNPROCESSED_PROPS wordt verwijderd uit een bericht wanneer u een bericht als bijlage insluit in een ander bericht. De eigenschap PR_TNEF_UNPROCESSED_PROPS wordt ook verwijderd wanneer u een bericht doorstuurt of een bericht beantwoordt.