ExtendedFieldURI

Статья
03/29/2023

Элемент 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="https://schemas.microsoft.com/exchange/services/2006/types">
  <soap:Body>
    <CreateItem xmlns="https://schemas.microsoft.com/exchange/services/2006/messages" 
                  xmlns:t="https://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>

Сведения об элементе

Элемент	Пример
Пространство имен	https://schemas.microsoft.com/exchange/services/2006/types
Имя схемы	Схема Types
Файл проверки	Types.xsd
Может быть пустым	False