Outlook のカスタム プロパティに対する変更

ベスト プラクティス: プログラムでカスタム フィールドを追加する

さまざまな API を使用して、プログラムによって項目にカスタム フィールドを追加できます。 これを行うには、Outlook オブジェクト ライブラリ ("Outlook.Application") で UserProperties.Add メソッドを使用します。 次のコードは、このベスト プラクティスを示しています。

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

CDO オブジェクト ライブラリ ("MAPI" を使用することもできます。セッション") を使用してカスタム フィールドを追加します。 詳細については、次の MSDN Web サイトを参照してください。

http://msdn2.microsoft.com/en-us/library/ms527518.aspx C++ 開発者の場合、Extended MAPI を使用して名前付きプロパティを追加できます。 詳細については、次の MSDN Web サイトを参照してください。

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

ベスト プラクティス: ユーザー設定フィールドを含む発行済みのカスタム フォームを使用する

Outlook は、発行されたカスタム フォームを主に信頼します。 ただし、Outlook では、発行されていないフォームや 1 回限りのフォームは信頼されません。 これには、.oft ファイルが含まれます。 そのため、カスタム フォーム ソリューションを設計するときは、カスタム フォームを発行することを強くお勧めします。 フォームが 1 回限りのフォームにならないようにフォームを設計する必要があります。 フォームが発行されている限り、フォームは Outlook の変更の影響を受けなくなります。
 
.oft ファイルを別のストアに発行すると、既定のストアでそのストアにプロパティを作成できます。 さらに、カスタム プロパティを持つカスタム フォームを作成し、それを適切なフォーム ライブラリまたはフォルダーに発行すると、影響を受けるストアにカスタム プロパティが作成されます。

ベスト プラクティス: カスタム フォームをプログラムでデプロイする

他のユーザーが使用する Outlook カスタム フォームを開発している場合は、使用できるアプローチはほとんどありません。 使用する方法は、いくつかの要因によって異なります。 これらの要因には、フォームの種類、フォームを使用するユーザー、フォームが使用される場所などが含まれます。 通常、多くのユーザーがカスタム フォームを使用する場合は、組織フォーム ライブラリでフォームを発行することをお勧めします。 ただし、それが不可能な場合は、フォームを共有フォルダーまたは一部のユーザーの個人用フォーム ライブラリに発行できます。 Outlook オブジェクト ライブラリの CreateItemFromTemplate メソッドを使用して、プログラムによってカスタム フォームをインストールできます。 CreateItemFromTemplate メソッドを使用して .oft ファイルを開き、PublishForm メソッドを使用してフォームを発行します。 この場合、.oft ファイルはカスタム プロパティの変更の影響を受けません。

お勧めしません: ユーザーが開くための .oft ファイルをデプロイまたは送信する

Outlook のカスタム フォームを .oft ファイルとして保存できます。 これらのフォームには、フォームに機能を追加するためのカスタム フィールド、ユーザー インターフェイスの変更、およびカスタム Microsoft Visual Basic Scripting Edition (VBScript) コードを含めることができます。 Outlook には、.oft ファイルの VBScript コードの実行を妨げる機能が既に含まれていますが、.oft ファイルの使用も制限されるようになりました。 .oft ファイルにカスタム プロパティが含まれており、ユーザーがそれらのカスタム プロパティを以前に使用していない場合、カスタム プロパティはユーザーの既定のストアに含まれません。 ユーザーがファイルをダブルクリックしても、Outlook はカスタム フォームをレンダリングしません。 ただし、.oft ファイルとして保存されているカスタム フォームを Outlook で開くには、[ ファイル] をクリックし、[ 新規作成] をクリックし、[ フォームの選択] をクリックします。 その後、ファイル システムで場所を [ユーザー テンプレート] に変更し、[ 参照 ] をクリックして .oft ファイルを開くことができます。 フォームが開き、カスタム プロパティを既定のストアに保存できます。

推奨されません: AllowNamedProps レジストリ キーを使用する

組織によっては、organization全体で特定のカスタム プロパティを使用できる正当な理由がある場合があります。 複数のストアを使用する場合は、すべてのストアに一連のカスタム プロパティを確実に追加できます。 そのため、Outlook 2003 SP2 以降のバージョンでは、作成できるカスタム プロパティを指定するクライアント側レジストリ キーがサポートされています。 有効にするカスタム プロパティを指定するには、次のレジストリ キーの下にカスタム プロパティを定義します: HKEY_CURRENT_USER\Software\Microsoft\Office\<バージョン>\Outlook\AllowedNamedProps\

注 このレジストリ キーでは、<バージョン> は、使用している Outlook のバージョンのプレースホルダーです。 Outlook 2003 の場合、バージョン番号は 11.0 です。 Outlook 2007 の場合、バージョン番号は 12.0 です。 バージョン番号は、以降のバージョンの Outlook で増加します。

レジストリ内のエントリの全体的なレジストリ キー構造は次

のとおりです。 <GUID>

<プロパティ名 の>

"Kind" (dword)

"ID" (dword)
"Type" (dword) レジストリ キー構造では、次のプレースホルダーが使用されます。

• <GUID>: プロパティ セットを指定する GUID が含まれています。 Outlook カスタム フォームで使用する Outlook ユーザー設定フィールドまたはプロパティには、すべて GUID {00020329-0000-0000-C000-000000000046} があります。 MAPI では、GUID は PS_PULIC_STRINGS と呼ばれます。 ただし、カスタム MAPI プログラムには、カスタム プロパティ用の独自の GUID が含まれる場合があります。

• <プロパティ名>: プロパティの名前を指定します。 プロパティの名前が文字列の場合、<プロパティ名> はプロパティの実際の文字列名です。 プロパティの名前が ID の場合、このレジストリ キーの値は無視されます。 ただし、プロパティをレジストリに格納するには、プロパティに一意の名前を付ける必要があります。 Kind キーが 1 に設定されているか、 <> 0 の場合、レジストリ キー名によってプロパティの名前が決定されます。 Kind キーが 1 と等しくない場合、このレジストリ キー名は無視されます。

• "Kind" (dword): プロパティの名前を ID または文字列で指定します。 値が 0 の場合、プロパティには ID で名前が付けられます。 名前は、ID で指定された数値です。 値が 1 の場合、プロパティには文字列で名前が付けられます。 この設定は、"Kind" が存在しない場合の既定の設定です。

• "ID" (dword): ID によって名前が付けられたプロパティの ID 名が含まれます。 この情報は、Kind キーが 0 に設定されている場合に必要です。 Kind キーが 1 に設定されている場合、この情報は無視されます。

• "Type" (dword): プロパティの種類を指定します。

このレジストリ キーは必須ですが、レジストリ キーは現在使用されていません。 次の表に、MAPI の種類に基づいて、このレジストリ キーの使用可能な値を示します。

名前付き文字列によるプロパティを設定する方法の例を次に示します。

名前: "MyStringFieldName1"

型: PT_LONG

[HKEY_CURRENT_USER\Software\Microsoft\Office\11.0\Outlook\AllowedNamedProps\{00020329-0000-0000-C000-000000000046}\MyStringFieldName1] "Type"=dword:00000003
名前付き ID によるプロパティを設定する方法の例を次に示します。

ID: 0x0330

型: 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


これら 2 つの例では、レジストリはレジストリ エディター


で次のように表示されます。 {00020329-0000-0000-C000-000000000046}
 

MyStringFieldName1

型 = 3
MyStringFieldName2

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

MyMAPIProp1

Kind = 0
ID = 330

型 = 3
MyMAPIProp2

Kind = 0
ID = 331
型 = 3

推奨されません: プロパティを作成する機能を再度有効にする

3 つのレジストリ キーをクライアント コンピューターに展開して、カスタム プロパティのブロックを無効にし、Outlook を以前の動作に戻すことができます。 これらのレジストリ キーは、グループ ポリシーによってサポートされます。 次のレジストリ キーを使用すると、Outlook 2003 を以前の動作

に戻すことができます。 注 次のレジストリ キーは、Outlook 2007 を以前の動作に戻しません。

• AllowTNEFtoCreateProps (HKEY_CURRENT_USER\Software\Microsoft\Office\11.0\Outlook\Options\Mail] "AllowTNEFtoCreateProps"=dword:00000000): 値が 0 の場合、TNEF/MIME は Outlook 以外の新しいカスタム プロパティを作成できません。 この値が既定値です。 値が 1 の場合、TNEF/MIME は Outlook 以外の新しいカスタム プロパティを作成できます。

• AllowMSGFilestoCreateProps: 値が 0 の場合、.msg ファイルと .oft ファイルは、Outlook 以外の新しいカスタム プロパティを作成できません。 この値が既定値です。 値が 1 の場合、.msg ファイルと .oft ファイルは、Outlook 以外の新しいカスタム プロパティを作成できます。

• DisallowTNEFPreservation: この新しい動作への移行を容易にするために、カスタム プロパティが作成されない場合、Outlook は元の TNEF を保持します。 元の TNEF は、保存された項目のバイナリ ストリームに保存されます。 Outlook では、次のプロパティ タグを使用してストリームを保存します。

  PR_TNEF_UNPROCESSED_PROPS PROG_TAG(PT_BINARY、0x0e9C)。 HKEY_CURRENT_USER\Software\Microsoft\Office\11.0\Outlook\Options\Mail] "DisallowTNEFPreservation "=dword:000000000
  レジストリ設定は、Outlook が PR_TNEF_UNPROCESSED_PROPS プロパティを作成するかどうかを制御します。
  
  注 PR_TNEF_UNPROCESSED_PROPS プロパティは、メッセージを添付ファイルとして別のメッセージに埋め込むと、メッセージから削除されます。 PR_TNEF_UNPROCESSED_PROPS プロパティは、メッセージを転送したり、メッセージに返信したりするときにも削除されます。