Compartir a través de


ExtendedFieldURI

El elemento ExtendedFieldURI identifica una propiedad MAPI extendida.

<ExtendedFieldURI DistinguishedPropertySetId="" PropertySetId="" PropertyTag="" PropertyName="" PropertyId="" PropertyType="" />

PathToExtendedFieldType

Atributos y elementos

En las siguientes secciones se describen los atributos, elementos secundarios y elementos primarios.

Atributos

Atributo Descripción
DistinguishedPropertySetId
Define los identificadores del conjunto de propiedades conocidos para las propiedades MAPI extendidas.

Si se usa este atributo, no se pueden usar los atributos PropertySetId y PropertyTag . Este atributo debe usarse con el atributo PropertyId o PropertyName y el atributo PropertyType .

La tabla DistinguishedPropertySetId Attribute más adelante en este tema enumera los valores posibles para este atributo.

Este atributo es opcional.
PropertySetId
Identifica un conjunto de propiedades extendidas MAPI o un espacio de nombres mediante su GUID de identificación.

Si se usa este atributo, no se pueden usar los atributos DistinguishedPropertySetId y PropertyTag . Este atributo debe usarse con el atributo PropertyId o PropertyName y el atributo PropertyType .

Este atributo es opcional.
PropertyTag
Identifica la etiqueta de propiedad sin la parte de tipo de la etiqueta. PropertyTag se puede representar como un entero hexadecimal o corto.

El intervalo entre 0x8000 y 0xFFFE representa el intervalo personalizado de propiedades. Cuando una base de datos de buzón de correo encuentra una propiedad personalizada por primera vez, asigna a esa propiedad personalizada una etiqueta de propiedad dentro del intervalo de propiedades personalizado de 0x8000-0xFFFE. Es probable que una etiqueta de propiedad personalizada determinada difiera entre bases de datos. Por lo tanto, una solicitud de propiedad personalizada por etiqueta de propiedad puede devolver propiedades diferentes en bases de datos diferentes. El uso del atributo PropertyTag está prohibido para las propiedades personalizadas. En su lugar, use el atributo PropertySetId y el atributo PropertyName o PropertyId .

IMPORTANTE: Acceda a cualquier propiedad personalizada entre 0x8000 y 0xFFFE mediante el GUID + nombre/identificador. Si se usa el atributo PropertyTag , no se pueden usar los atributos DistinguishedPropertySetId, PropertySetId, PropertyName y PropertyId .

Este atributo es opcional.

NOTA: No se puede usar un atributo de etiqueta de propiedad para las propiedades dentro del intervalo personalizado 0x8000-0xFFFE. En este caso, debe usar una propiedad con nombre.
PropertyName
Identifica una propiedad extendida por su nombre. Esta propiedad debe combinarse con DistinguishedPropertySetId o PropertySetId.

Si se usa este atributo, no se pueden usar los atributos PropertyId y PropertyTag .

Este atributo es opcional.
PropertyId
Identifica una propiedad extendida por su identificador de distribución. El identificador de distribución se puede identificar en formatos decimales o hexadecimales. Esta propiedad debe combinarse con DistinguishedPropertySetId o PropertySetId.

Si se usa este atributo, no se pueden usar los atributos PropertyName y PropertyTag .

Este atributo es opcional.
PropertyType
Representa el tipo de propiedad de una etiqueta de propiedad. Esto corresponde a la palabra menos significativa de una etiqueta de propiedad.

La tabla Atributo PropertyType más adelante en este tema contiene los valores posibles para este atributo.

Este atributo es obligatorio.

Atributo DistinguishedPropertySetId

Valor Descripción
Address
Identifica el identificador del conjunto de propiedades de dirección por nombre.
Cita
Identifica el identificador del conjunto de propiedades de cita por nombre.
CalendarAssistant
Identifica el identificador del conjunto de propiedades del asistente de calendario por nombre.
Común
Identifica el identificador del conjunto de propiedades común por nombre.
InternetHeaders
Identifica el identificador del conjunto de propiedades de encabezados de Internet por nombre.
Reunión
Identifica el identificador del conjunto de propiedades de reunión por nombre.
Compartir

PublicStrings
Identifica el identificador del conjunto de propiedades de cadenas públicas por nombre.
Tarea
Identifica el identificador del conjunto de propiedades de tarea por nombre.
UnifiedMessaging
Identifica el identificador del conjunto de propiedades de mensajería unificada por nombre.

Atributo PropertyType

Valor Descripción
ApplicationTime
Valor doble que se interpreta como una fecha y hora. La parte entera es la fecha y la parte de fracción es la hora.
ApplicationTimeArray
Matriz de valores dobles que se interpretan como una fecha y hora.
Binario
Valor binario codificado en Base64.
BinaryArray
Matriz de valores binarios codificados en Base64.
Boolean
Un valor booleano true o false.
CLSID
Cadena GUID.
CLSIDArray
Matriz de cadenas GUID.
Divisa
Entero de 64 bits que se interpreta como el número de céntimos.
CurrencyArray
Matriz de enteros de 64 bits que se interpretan como el número de céntimos.
Doble
Valor de punto flotante de 64 bits.
DoubleArray
Matriz de valores de punto flotante de 64 bits.
Error
Valor de SCODE; Entero de 32 bits sin signo.
No se usa para restricciones o para obtener o establecer valores. Esto solo existe para la generación de informes.
Float
Valor de punto flotante de 32 bits.
FloatArray
Matriz de valores de punto flotante de 32 bits.
Entero
Entero de 32 bits (Int32) con signo.
IntegerArray
Matriz de enteros de 32 bits (Int32) con signo.
Long
Entero de 64 bits (Int64) firmado o sin signo.
LongArray
Matriz de enteros de 64 bits (Int64) con signo o sin signo.
Null
Indica que no hay ningún valor de propiedad.
No se usa para restricciones o para obtener o establecer valores. Esto solo existe para la generación de informes.
Objeto
Puntero a un objeto que implementa la interfaz IUnknown.
No se usa para restricciones o para obtener o establecer valores. Esto solo existe para la generación de informes.
ObjectArray
Matriz de punteros a objetos que implementan la interfaz IUnknown.
No se usa para restricciones o para obtener o establecer valores. Esto solo existe para la generación de informes.
Corta
Entero de 16 bits con signo.
ShortArray
Matriz de enteros de 16 bits con signo.
SystemTime
Un valor de tiempo y datos enteros de 64 bits en forma de estructura FILETIME.
SystemTimeArray
Matriz de datos enteros de 64 bits y valores de tiempo en forma de estructura FILETIME.
Cadena
Cadena Unicode.
StringArray
Matriz de cadenas Unicode.

Elementos secundarios

Ninguno.

Elementos principales

Elemento Descripción
ExtendedProperty
Identifica las propiedades extendidas en carpetas y elementos.
AdditionalProperties
Identifica propiedades adicionales.

Las siguientes son las expresiones XPath de este elemento:

/FindFolder/FolderShape/AdditionalProperties
/GetFolder/FolderShape/AdditionalProperties
/SyncFolderHierarchy/FolderShape/AdditionalProperties
/GetItem/ItemShape/AdditionalProperties
/FindItem/ItemShape/AdditionalProperties
/SyncFolderItems/ItemShape/AdditionalProperties
/GetAttachment/AttachmentShape/AdditionalProperties
SetItemField
Representa una actualización de una sola propiedad de un elemento en una operación UpdateItem.
SetFolderField
Representa una actualización de una sola propiedad en una carpeta de una operación UpdateFolder.
DeleteItemField
Representa una operación de eliminación para eliminar una propiedad determinada de un elemento durante una operación UpdateItem.
DeleteFolderField
Representa una operación de eliminación para eliminar una propiedad determinada de una carpeta durante una llamada a UpdateFolder.
AppendToItemField
Identifica los datos que se van a anexar a una sola propiedad de un elemento durante una operación UpdateItem.
AppendToFolderField
Especifica los datos que se anexan a una propiedad de carpeta durante una operación UpdateFolder.
Exists
Representa una expresión de búsqueda que devuelve true si la propiedad proporcionada existe en un elemento.
FieldURIOrConstant
Representa una propiedad o un valor constante que se va a usar al comparar con otra propiedad.
IsEqualTo
Representa una expresión de búsqueda que compara una propiedad con un valor constante u otra propiedad y se evalúa como true si son iguales.
IsGreaterThan
Representa una expresión de búsqueda que compara una propiedad con un valor constante u otra propiedad y devuelve true si la primera propiedad es mayor.
IsGreaterThanOrEqualTo
Representa una expresión de búsqueda que compara una propiedad con un valor constante u otra propiedad y devuelve true si la primera propiedad es mayor o igual que la segunda.
IsLessThan
Representa una expresión de búsqueda que compara una propiedad con un valor constante u otra propiedad y devuelve true si la primera propiedad es menor que la segunda.
IsLessThanOrEqualTo
Representa una expresión de búsqueda que compara una propiedad con un valor constante u otra propiedad y devuelve true si la primera propiedad es menor que la segunda.
IsNotEqualTo
Representa una expresión de búsqueda que compara una propiedad con un valor constante u otra propiedad y devuelve true si los valores no son iguales.
Excluye
Realiza una máscara bit a bit de las propiedades.
Contains
Representa una expresión de búsqueda que determina si una propiedad determinada contiene el valor de cadena constante proporcionado.
FieldOrder
Representa un único campo por el que ordenar los resultados e indica la dirección de la ordenación.

Comentarios

Algunos atributos no se pueden usar en combinación con otros atributos. Cualquier solicitud que se incluya con una combinación no válida de atributos de propiedad extendida generará un mensaje de error.

El esquema que describe este elemento se encuentra en el directorio virtual EWS del equipo que ejecuta MicrosoftExchange Server 2007 que tiene instalado el rol de servidor acceso de cliente.

Nota:

En Microsoft .NET, long es un entero de 64 bits con signo, mientras que en MAPI y COM, long es un entero de 32 bits. La mayoría de los desarrolladores usarán Microsoft.NET Framework para desarrollar aplicaciones cliente de Exchange Web Services. Por lo tanto, se usa la nomenclatura de .NET en lugar de la nomenclatura MAPI.

Por ejemplo, la propiedad PR_MESSAGE_FLAGS MAPI, 0x0E07, es un tipo PT_LONG. En .NET, se considera un entero. Una propiedad extendida para PR_MESSAGE_FLAGS se define como <t:ExtendedFieldURI PropertyTag="0x0E07" PropertyType="Integer"/>.

Ejemplo

En el ejemplo siguiente de una solicitud se crea un elemento que tiene dos propiedades personalizadas. La primera propiedad personalizada se denomina IsMyHouse con un valor booleano establecido en true. La segunda propiedad extendida personalizada se denomina HousePrices. Contiene una matriz de valores 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>

Información del elemento

Elemento Ejemplo
Namespace
http://schemas.microsoft.com/exchange/services/2006/types
Nombre de esquema
Esquema de tipos
Archivo de validación
Types.xsd
Puede estar vacío
False

Vea también