ExtendedFieldURI
Элемент ExtendedFieldURI определяет расширенное свойство MAPI.
<ExtendedFieldURI DistinguishedPropertySetId="" PropertySetId="" PropertyTag="" PropertyName="" PropertyId="" PropertyType="" />
PathToExtendedFieldType
Атрибуты и элементы
В разделах ниже приводится описание атрибутов, дочерних и родительских элементов.
Атрибуты
| Атрибут | Описание |
|---|---|
| DistinguishedPropertySetId |
Определяет известные идентификаторы наборов свойств для расширенных свойств MAPI. Если этот атрибут используется, нельзя использовать атрибуты PropertySetId и PropertyTag . Этот атрибут должен использоваться с атрибутом PropertyId или PropertyName , а также с атрибутом PropertyType . В таблице Атрибуты DistinguishedPropertySetId далее в этом разделе перечислены возможные значения для этого атрибута. Этот атрибут является необязательным. |
| PropertySetId |
Определяет расширенный набор свойств MAPI или пространство имен по идентификатору GUID. Если этот атрибут используется, нельзя использовать атрибуты DistinguishedPropertySetId и PropertyTag . Этот атрибут должен использоваться с атрибутом PropertyId или PropertyName , а также с атрибутом PropertyType . Этот атрибут является необязательным. |
| PropertyTag |
Идентифицирует тег свойства без части типа тега. Объект PropertyTag можно представить в виде шестнадцатеричного или короткого целого числа. Диапазон между 0x8000 и 0xFFFE представляет настраиваемый диапазон свойств. Когда база данных почтового ящика впервые обнаруживает пользовательское свойство, она назначает ему тег свойства в диапазоне настраиваемых свойств 0x8000-0xFFFE. Заданный настраиваемый тег свойства, скорее всего, будет отличаться в разных базах данных. Таким образом, настраиваемый запрос свойства по тегу свойства может возвращать различные свойства в разных базах данных. Использование атрибута PropertyTag запрещено для пользовательских свойств. Вместо этого используйте атрибут PropertySetId и атрибут PropertyName или PropertyId . ВАЖНО! Доступ к любому пользовательскому свойству между 0x8000 и 0xFFFE с помощью GUID + имя или идентификатор. Если используется атрибут PropertyTag , нельзя использовать атрибуты DistinguishedPropertySetId, PropertySetId, PropertyName и PropertyId . Этот атрибут является необязательным. ПРИМЕЧАНИЕ. Атрибут тега свойства нельзя использовать для свойств в настраиваемом диапазоне 0x8000 0xFFFE. В этом случае необходимо использовать именованное свойство. |
| PropertyName |
Определяет расширенное свойство по его имени. Это свойство должно быть сопряжено с DistinguishedPropertySetId или PropertySetId. Если этот атрибут используется, нельзя использовать атрибуты PropertyId и PropertyTag . Этот атрибут является необязательным. |
| PropertyId |
Определяет расширенное свойство по идентификатору отправки. Идентификатор отправки можно определить в десятичном или шестнадцатеричном формате. Это свойство должно быть сопряжено с DistinguishedPropertySetId или PropertySetId. Если этот атрибут используется, нельзя использовать атрибуты PropertyName и PropertyTag . Этот атрибут является необязательным. |
| PropertyType |
Представляет тип свойства тега свойства. Это соответствует наименее значимому слову в теге свойства. Таблица PropertyType Attribute далее в этом разделе содержит возможные значения для этого атрибута. Этот атрибут является обязательным. |
Атрибут DistinguishedPropertySetId
| Значение | Описание |
|---|---|
| Address |
Идентифицирует идентификатор свойства адреса по имени. |
| Appointment |
Идентифицирует свойство встречи, заданное по имени. |
| CalendarAssistant |
Определяет свойство помощника по календарю, заданное идентификатором по имени. |
| Распространенная |
Определяет идентификатор набора общих свойств по имени. |
| InternetHeaders |
Идентифицирует идентификатор свойства заголовков Интернета по имени. |
| Собрание |
Определяет идентификатор свойства собрания, заданного по имени. |
| Общий доступ |
|
| PublicStrings |
Идентифицирует идентификатор свойства открытых строк по имени. |
| Задача |
Определяет идентификатор набора свойств задачи по имени. |
| UnifiedMessaging |
Определяет свойство единой системы обмена сообщениями, заданное идентификатором по имени. |
Атрибут PropertyType
| Значение | Описание |
|---|---|
| ApplicationTime |
Двойное значение, интерпретируемое как дата и время. Целочисленная часть — это дата, а часть дроби — время. |
| ApplicationTimeArray |
Массив двойных значений, которые интерпретируются как дата и время. |
| Binary |
Двоичное значение в кодировке Base64. |
| BinaryArray |
Массив двоичных значений в кодировке Base64. |
| Boolean |
Логическое значение true или false. |
| CLSID |
Строка GUID. |
| CLSIDArray |
Массив строк GUID. |
| Валюта |
64-разрядное целое число, которое интерпретируется как число центов. |
| CurrencyArray |
Массив из 64-разрядных целых чисел, которые интерпретируются как число центов. |
| Двойное с плавающей точкой |
64-разрядное значение с плавающей запятой. |
| DoubleArray |
Массив 64-разрядных значений с плавающей запятой. |
| Error |
Значение SCODE; 32-разрядное целое число без знака. Не используется для ограничений или для получения и установки значений. Он существует только для создания отчетов. |
| С плавающей запятой |
32-разрядное значение с плавающей запятой. |
| FloatArray |
Массив 32-разрядных значений с плавающей запятой. |
| Целое число |
32-разрядное целое число со знаком (Int32). |
| IntegerArray |
Массив со знаком 32-разрядных целых чисел (Int32). |
| Длинное целое |
64-разрядное целое число со знаком или без знака (Int64). |
| LongArray |
Массив со знаком или без знака 64-разрядных целых чисел (Int64). |
| Null |
Указывает отсутствие значения свойства. Не используется для ограничений или для получения и установки значений. Он существует только для создания отчетов. |
| Объект |
Указатель на объект, реализующий интерфейс IUnknown. Не используется для ограничений или для получения и установки значений. Он существует только для создания отчетов. |
| ObjectArray |
Массив указателей на объекты, реализующие интерфейс IUnknown. Не используется для ограничений или для получения и установки значений. Он существует только для создания отчетов. |
| Короткие |
16-разрядное целое число со знаком. |
| ShortArray |
Массив со знаком 16-разрядных целых чисел. |
| Systemtime |
64-разрядные целочисленные данные и значение времени в виде структуры FILETIME. |
| SystemTimeArray |
Массив 64-разрядных целочисленных данных и значений времени в виде структуры FILETIME. |
| Строка |
Строка Юникода. |
| StringArray |
Массив строк Юникода. |
Дочерние элементы
Нет.
Родительские элементы
| Элемент | Описание |
|---|---|
| ExtendedProperty |
Определяет расширенные свойства папок и элементов. |
| AdditionalProperties |
Определяет дополнительные свойства. Ниже приведены выражения XPath для этому элементу: /FindFolder/FolderShape/AdditionalProperties /GetFolder/FolderShape/AdditionalProperties /SyncFolderHierarchy/FolderShape/AdditionalProperties /GetItem/ItemShape/AdditionalProperties /FindItem/ItemShape/AdditionalProperties /SyncFolderItems/ItemShape/AdditionalProperties /GetAttachment/AttachmentShape/AdditionalProperties |
| SetItemField |
Представляет обновление одного свойства элемента в операции UpdateItem. |
| SetFolderField |
Представляет обновление одного свойства в папке в операции UpdateFolder. |
| DeleteItemField |
Представляет операцию удаления для удаления заданного свойства из элемента во время операции UpdateItem. |
| DeleteFolderField |
Представляет операцию удаления для удаления заданного свойства из папки во время вызова UpdateFolder. |
| AppendToItemField |
Определяет данные для добавления к одному свойству элемента во время операции UpdateItem. |
| AppendToFolderField |
Указывает данные, добавляемые в свойство папки во время операции UpdateFolder. |
| Exists |
Представляет выражение поиска, возвращающее значение true , если указанное свойство существует в элементе. |
| FieldURIOrConstant |
Представляет свойство или константное значение, используемое при сравнении с другим свойством. |
| IsEqualTo |
Представляет выражение поиска, которое сравнивает свойство с константой или другим свойством и вычисляет значение true , если они равны. |
| IsGreaterThan |
Представляет выражение поиска, которое сравнивает свойство с константой или другим свойством и возвращает значение true , если первое свойство больше. |
| IsGreaterThanOrEqualTo |
Представляет выражение поиска, которое сравнивает свойство с константой или другим свойством и возвращает значение true , если первое свойство больше или равно второму. |
| IsLessThan |
Представляет выражение поиска, которое сравнивает свойство с константой или другим свойством и возвращает значение true , если первое свойство меньше второго. |
| IsLessThanOrEqualTo |
Представляет выражение поиска, которое сравнивает свойство с константой или другим свойством и возвращает значение true , если первое свойство меньше второго. |
| IsNotEqualTo |
Представляет выражение поиска, которое сравнивает свойство с константой или другим свойством и возвращает значение true , если значения не совпадают. |
| Исключает |
Выполняет побитовую маску свойств. |
| Contains |
Представляет выражение поиска, определяющее, содержит ли данное свойство указанное строковое значение константы. |
| FieldOrder |
Представляет одно поле, по которому сортируются результаты, и указывает направление сортировки. |
Замечания
Некоторые атрибуты нельзя использовать в сочетании с другими атрибутами. Любой запрос, который поставляется с недопустимым сочетанием атрибутов расширенных свойств, создаст сообщение об ошибке.
Схема, описывающая этот элемент, расположена в виртуальном каталоге EWS на компьютере с MicrosoftExchange Server 2007 и установленной ролью сервера клиентского доступа.
Примечание.
В Microsoft .NET long — это 64-разрядное целое число со знаком, а в MAPI и COM — 32-разрядное целое число. Большинство разработчиков будут использовать Microsoft.NET Framework для разработки клиентских приложений веб-служб Exchange. Поэтому вместо именования MAPI используется именование .NET.
Например, свойство MAPI PR_MESSAGE_FLAGS 0x0E07 является типом PT_LONG. В .NET это считается целым числом. Расширенное свойство для PR_MESSAGE_FLAGS определяется как <t:ExtendedFieldURI PropertyTag="0x0E07" PropertyType="Integer"/>.
Пример
В следующем примере запроса создается элемент с двумя настраиваемыми свойствами. Первое пользовательское свойство называется IsMyHouse с логическим значением true. Второе пользовательское расширенное свойство называется HousePrices. Он содержит массив значений currency.
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types">
<soap:Body>
<CreateItem xmlns="http://schemas.microsoft.com/exchange/services/2006/messages"
xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types"
MessageDisposition="SaveOnly">
<SavedItemFolderId>
<t:DistinguishedFolderId Id="inbox"/>
</SavedItemFolderId>
<Items>
<t:Item>
<t:ItemClass>IPM.Note</t:ItemClass>
<t:Subject>Create an extended property</t:Subject>
<t:Body BodyType="Text">Added info to extended props</t:Body>
<t:ExtendedProperty>
<t:ExtendedFieldURI DistinguishedPropertySetId="PublicStrings"
PropertyName="IsMyHouse"
PropertyType="Boolean"/>
<t:Value>true</t:Value>
</t:ExtendedProperty>
<t:ExtendedProperty>
<t:ExtendedFieldURI DistinguishedPropertySetId="PublicStrings"
PropertyName="HousePrices"
PropertyType="CurrencyArray"/>
<t:Values>
<t:Value>30000000</t:Value>
<t:Value>40000000</t:Value>
<t:Value>50000000</t:Value>
</t:Values>
</t:ExtendedProperty>
</t:Item>
</Items>
</CreateItem>
</soap:Body>
</soap:Envelope>
Сведения об элементе
| Элемент | Пример |
|---|---|
| Пространство имен |
http://schemas.microsoft.com/exchange/services/2006/types |
| Имя схемы |
Схема Types |
| Файл проверки |
Types.xsd |
| Может быть пустым |
False |