Изменения пользовательских свойств в Outlook

Рекомендация. Добавление настраиваемых полей программными средствами

Для программного добавления настраиваемых полей в элементы можно использовать различные API. Для этого используйте метод UserProperties.Add в библиотеке объектов Outlook ("Outlook.Application"). Следующий код иллюстрирует эту рекомендацию.

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

Вы также можете использовать библиотеку объектов CDO ("MAPI. Сеанс") для добавления настраиваемых полей. Дополнительные сведения см. на следующей странице веб-узла MSDN:

http://msdn2.microsoft.com/en-us/library/ms527518.aspx Для разработчиков C++ расширенный MAPI может использоваться для добавления именованных свойств. Дополнительные сведения см. на следующей странице веб-узла MSDN:

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

Рекомендация. Используйте опубликованные настраиваемые формы, содержащие настраиваемые поля

Outlook в значительной степени доверяет опубликованным пользовательским формам. Однако Outlook не доверяет неопубликованным или одноразовым формам. Сюда входят OFT-файлы. Поэтому при разработке настраиваемой формы настоятельно рекомендуется опубликовать настраиваемую форму. Следует разработать форму таким образом, чтобы она не стала разовой. До тех пор, пока форма опубликована, изменение в Outlook не повлияет на нее.
 
При публикации OFT-файла в другом хранилище хранилище по умолчанию позволяет создавать свойства в этом хранилище. Кроме того, при создании настраиваемой формы с настраиваемыми свойствами и публикации ее в соответствующей библиотеке форм или папке пользовательские свойства создаются в затронутых хранилищах.

Рекомендация: программное развертывание пользовательских форм

Если вы разрабатываете настраиваемую форму Outlook, которая будет использоваться другими пользователями, существует несколько подходов, которые можно использовать. Используемый подход зависит от нескольких факторов. К этим факторам относятся тип формы, кто будет использовать форму, где будет использоваться форма и т. д. Как правило, если настраиваемая форма будет использоваться многими пользователями, рекомендуется опубликовать форму в библиотеке организационных форм. Однако если это невозможно, может потребоваться опубликовать форму в общей папке или в личной библиотеке форм некоторых пользователей. Вы можете программно установить пользовательскую форму с помощью метода CreateItemFromTemplate в библиотеке объектов Outlook. Метод CreateItemFromTemplate используется для открытия OFT-файла, а затем публикации формы с помощью метода PublishForm. В этом случае изменения пользовательских свойств не влияют на файл .oft.

Не рекомендуется: развертывание или отправка OFT-файлов для открытия пользователями

Пользовательские формы Outlook можно сохранить как OFT-файлы. Эти формы могут содержать настраиваемые поля, изменения пользовательского интерфейса и пользовательский код microsoft Visual Basic Scripting Edition (VBScript) для добавления функциональных возможностей в форму. Хотя Outlook уже содержит функции, которые препятствуют запуску кода VBScript в OFT-файлах, Outlook теперь также ограничивает использование OFT-файлов. Если OFT-файл содержит настраиваемые свойства и пользователь ранее не использовал эти настраиваемые свойства, пользовательские свойства не находятся в хранилище пользователя по умолчанию. Outlook не будет отображать настраиваемую форму, когда пользователь дважды щелкает файл. Тем не менее, чтобы Outlook открыл пользовательскую форму, которая хранится в виде OFT-файла, щелкните Файл, нажмите кнопку Создать, а затем Выберите форму. Затем можно изменить расположение на Шаблоны пользователей в файловой системе, а затем нажать кнопку Обзор , чтобы открыть OFT-файл. Откроется форма, и вы можете сохранить пользовательские свойства в хранилище по умолчанию.

Не рекомендуется: используйте раздел реестра AllowNamedProps.

Некоторые организации могут иметь веские причины, чтобы некоторые настраиваемые свойства были доступны в организации. Если используется несколько хранилищ, может потребоваться добавить набор настраиваемых свойств во все хранилища. Таким образом, Outlook 2003 с пакетом обновления 2 (SP2) и более поздних версий поддерживают разделы реестра на стороне клиента, указывающие, какие пользовательские свойства можно создать. Чтобы указать, какие настраиваемые свойства следует включить, настраиваемые свойства определяются в следующем разделе реестра: HKEY_CURRENT_USER\Software\Microsoft\Office\<version>\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-0000000000046}. В MAPI GUID называется PS_PULIC_STRINGS. Однако пользовательские программы MAPI могут иметь собственные идентификаторы GUID для пользовательских свойств.

• <имя свойства>. Указывает имя свойства. Если свойство именуется строкой,> имя свойства <— это фактическое строковое имя свойства. Если свойство называется по идентификатору, значение этого раздела реестра игнорируется. Однако необходимо присвоить свойству уникальное имя, чтобы его можно было сохранить в реестре. Если для параметра Kind задано значение 1 или значение <> 0, имя свойства будет определяться именем раздела реестра. Если раздел Kind не равен 1, это имя раздела реестра будет игнорироваться.

• "Kind" (dword): указывает, называется ли свойство идентификатором или строкой. Если значение равно 0, свойство будет называться по идентификатору. Имя является числовым значением, заданным идентификатором. Если значение равно 1, свойство будет называться строкой. Этот параметр является параметром по умолчанию, если "Kind" отсутствует.

• "ID" (dword): содержит имя идентификатора свойства, именуемого по идентификатору. Эти сведения необходимы, если для ключа 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
Ниже приведен пример задания свойства именованного по идентификатору.

Идентификатор: 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


В этих двух примерах реестр выглядит примерно так, как в редакторе реестра:


{00020329-0000-0000-C000-000000000046}
 

MyStringFieldName1

Тип = 3
MyStringFieldName2

Тип = 3
{00020329-0000-0000-C000-000000000046}

MyMAPIProp1

Тип = 0
ID = 330

Тип = 3
MyMAPIProp2

Тип = 0
Идентификатор = 331
Тип = 3

Не рекомендуется: повторно включите возможность создания свойств.

На клиентских компьютерах можно развернуть три раздела реестра, чтобы отключить блокировку пользовательских свойств и отменить изменения Outlook к его предыдущему поведению. Эти разделы реестра поддерживаются групповыми политиками. Следующие разделы реестра могут отменить изменения Outlook 2003 к его предыдущему поведению:

Примечание. Приведенные ниже разделы реестра не отменить изменения Outlook 2007 с предыдущим поведением.

• AllowTNEFtoCreateProps (HKEY_CURRENT_USER\Software\Microsoft\Office\11.0\Outlook\Options\Mail] "AllowTNEFtoCreateProps"=dword:00000000000): если значение равно 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 также удаляется при пересылке сообщения или ответе на него.