ExtendedFieldURI
O elemento ExtendedFieldURI identifica uma propriedade MAPI estendida.
<ExtendedFieldURI DistinguishedPropertySetId="" PropertySetId="" PropertyTag="" PropertyName="" PropertyId="" PropertyType="" />
Pathtoextendedfieldtype
Atributos e elementos
As seções a seguir descrevem os atributos, os elementos filhos e os elementos pai.
Atributos
| Atributo | Descrição |
|---|---|
| DistinguishedPropertySetId |
Define as IDs conhecidas do conjunto de propriedades para propriedades MAPI estendidas. Se esse atributo for usado, os atributos PropertySetId e PropertyTag não poderão ser usados. Esse atributo deve ser usado com o atributo PropertyId ou PropertyName e o atributo PropertyType . A tabela Atributo DistinguishedPropertySetId posteriormente neste tópico lista os valores possíveis para esse atributo. Esse atributo é opcional. |
| Propertysetid |
Identifica um conjunto de propriedades estendidas mapi ou namespace por meio de seu GUID de identificação. Se esse atributo for usado, o atributo DistinguishedPropertySetId e PropertyTag não poderá ser usado. Esse atributo deve ser usado com o atributo PropertyId ou PropertyName e o atributo PropertyType . Esse atributo é opcional. |
| Propertytag |
Identifica a marca de propriedade sem a parte de tipo da marca. O PropertyTag pode ser representado como um hexadecimal ou um inteiro curto. O intervalo entre 0x8000 e 0xFFFE representa o intervalo personalizado de propriedades. Quando um banco de dados de caixa de correio encontra uma propriedade personalizada pela primeira vez, ele atribui a essa propriedade personalizada uma marca de propriedade dentro do intervalo de propriedades personalizado de 0x8000-0xFFFE. Uma determinada marca de propriedade personalizada provavelmente será diferente entre bancos de dados. Portanto, uma solicitação de propriedade personalizada por marca de propriedade pode retornar propriedades diferentes em bancos de dados diferentes. O uso do atributo PropertyTag é proibido para propriedades personalizadas. Em vez disso, use o atributo PropertySetId e o atributo PropertyName ou PropertyId . IMPORTANTE: acesse qualquer propriedade personalizada entre 0x8000 e 0xFFFE usando o GUID + nome/ID. Se o atributo PropertyTag for usado, os atributos DistinguishedPropertySetId, PropertySetId, PropertyName e PropertyId não poderão ser usados. Esse atributo é opcional. OBSERVAÇÃO: você não pode usar um atributo de marca de propriedade para propriedades dentro do intervalo personalizado 0x8000-0xFFFE. Você deve usar uma propriedade nomeada nesse caso. |
| PropertyName |
Identifica uma propriedade estendida pelo nome. Essa propriedade deve ser associada a DistinguishedPropertySetId ou PropertySetId. Se esse atributo for usado, os atributos PropertyId e PropertyTag não poderão ser usados. Esse atributo é opcional. |
| PropertyId |
Identifica uma propriedade estendida por sua ID de expedição. A ID de expedição pode ser identificada em formatos decimal ou hexadecimal. Essa propriedade deve ser associada a DistinguishedPropertySetId ou PropertySetId. Se esse atributo for usado, os atributos PropertyName e PropertyTag não poderão ser usados. Esse atributo é opcional. |
| Propertytype |
Representa o tipo de propriedade de uma marca de propriedade. Isso corresponde à palavra menos significativa em uma marca de propriedade. A tabela Atributo PropertyType posteriormente neste tópico contém os valores possíveis para esse atributo. Esse atributo é necessário. |
Atributo DistinguishedPropertySetId
| Valor | Descrição |
|---|---|
| Endereço |
Identifica a ID do conjunto de propriedades de endereço pelo nome. |
| Compromisso |
Identifica a ID do conjunto de propriedades de compromisso pelo nome. |
| CalendarAssistant |
Identifica a ID do conjunto de propriedades do assistente de calendário pelo nome. |
| Comum |
Identifica a ID do conjunto de propriedades comum pelo nome. |
| InternetHeaders |
Identifica a ID do conjunto de cabeçalhos da Internet pelo nome. |
| Reunião |
Identifica a ID do conjunto de propriedades da reunião pelo nome. |
| Compartilhamento |
|
| PublicStrings |
Identifica a ID do conjunto de cadeias de caracteres públicas pelo nome. |
| Tarefa |
Identifica a ID do conjunto de propriedades de tarefa pelo nome. |
| UnifiedMessaging |
Identifica a ID do conjunto de mensagens unificada pelo nome. |
Atributo PropertyType
| Valor | Descrição |
|---|---|
| ApplicationTime |
Um valor duplo que é interpretado como uma data e hora. A parte inteiro é a data e a parte da fração é a hora. |
| ApplicationTimeArray |
Uma matriz de valores duplos que são interpretados como uma data e hora. |
| Binária |
Um valor binário codificado em Base64. |
| BinaryArray |
Uma matriz de valores binários codificados por Base64. |
| Boolean |
Um booliano verdadeiro ou falso. |
| CLSID |
Uma cadeia de caracteres GUID. |
| CLSIDArray |
Uma matriz de cadeias de caracteres GUID. |
| Moeda |
Um inteiro de 64 bits que é interpretado como o número de centavos. |
| CurrencyArray |
Uma matriz de inteiros de 64 bits que são interpretados como o número de centavos. |
| Duplo |
Um valor de ponto flutuante de 64 bits. |
| DoubleArray |
Uma matriz de valores de ponto flutuante de 64 bits. |
| Error |
Valor SCODE; Inteiro sem sinal de 32 bits. Não usado para restrições ou para obter/definir valores. Isso só existe para relatórios. |
| Flutuação |
Um valor de ponto flutuante de 32 bits. |
| FloatArray |
Uma matriz de valores de ponto flutuante de 32 bits. |
| Inteiro |
Um inteiro assinado de 32 bits (Int32). |
| IntegerArray |
Uma matriz de inteiros assinados de 32 bits (Int32). |
| Longo |
Um inteiro assinado ou sem sinal de 64 bits (Int64). |
| LongArray |
Uma matriz de inteiros assinados ou não assinados de 64 bits (Int64). |
| Nulo |
Indica nenhum valor de propriedade. Não usado para restrições ou para obter/definir valores. Isso só existe para relatórios. |
| Objeto |
Um ponteiro para um objeto que implementa a interface IUnknown. Não usado para restrições ou para obter/definir valores. Isso só existe para relatórios. |
| ObjectArray |
Uma matriz de ponteiros para objetos que implementam a interface IUnknown. Não usado para restrições ou para obter/definir valores. Isso só existe para relatórios. |
| Curto |
Um inteiro de 16 bits assinado. |
| ShortArray |
Uma matriz de inteiros assinados de 16 bits. |
| Systemtime |
Um valor de tempo e dados inteiros de 64 bits na forma de uma estrutura FILETIME. |
| SystemTimeArray |
Uma matriz de dados inteiros de 64 bits e valores de tempo na forma de uma estrutura FILETIME. |
| Cadeia de caracteres |
Uma cadeia de caracteres Unicode. |
| StringArray |
Uma matriz de cadeias de caracteres Unicode. |
Elementos filho
Nenhum.
Elementos pai
| Elemento | Descrição |
|---|---|
| ExtendedProperty |
Identifica propriedades estendidas em pastas e itens. |
| AdditionalProperties |
Identifica propriedades adicionais. A seguir estão as expressões XPath para esse elemento: /FindFolder/FolderShape/AdditionalProperties /GetFolder/FolderShape/AdditionalProperties /SyncFolderHierarchy/FolderShape/AdditionalProperties /GetItem/ItemShape/AdditionalProperties /FindItem/ItemShape/AdditionalProperties /SyncFolderItems/ItemShape/AdditionalProperties /GetAttachment/AttachmentShape/AdditionalProperties |
| SetItemField |
Representa uma atualização para uma única propriedade de um item em uma operação UpdateItem. |
| SetFolderField |
Representa uma atualização para uma única propriedade em uma pasta em uma operação UpdateFolder. |
| DeleteItemField |
Representa uma operação de exclusão para excluir uma determinada propriedade de um item durante uma operação UpdateItem. |
| DeleteFolderField |
Representa uma operação de exclusão para excluir uma determinada propriedade de uma pasta durante uma chamada UpdateFolder. |
| AppendToItemField |
Identifica dados a serem acrescentados a uma única propriedade de um item durante uma operação UpdateItem. |
| AppendToFolderField |
Especifica dados a serem acrescentados a uma propriedade de pasta durante uma operação UpdateFolder. |
| Existe |
Representa uma expressão de pesquisa que retorna true se a propriedade fornecida existir em um item. |
| FieldURIOrConstant |
Representa uma propriedade ou um valor constante a ser usado ao comparar com outra propriedade. |
| IsEqualTo |
Representa uma expressão de pesquisa que compara uma propriedade com um valor constante ou outra propriedade e avalia como true se elas forem iguais. |
| IsGreaterThan |
Representa uma expressão de pesquisa que compara uma propriedade com um valor constante ou outra propriedade e retorna true se a primeira propriedade for maior. |
| IsGreaterThanOrEqualTo |
Representa uma expressão de pesquisa que compara uma propriedade com um valor constante ou outra propriedade e retorna true se a primeira propriedade for maior ou igual à segunda. |
| IsLessThan |
Representa uma expressão de pesquisa que compara uma propriedade com um valor constante ou outra propriedade e retorna true se a primeira propriedade for menor que a segunda. |
| IsLessThanOrEqualTo |
Representa uma expressão de pesquisa que compara uma propriedade com um valor constante ou outra propriedade e retorna true se a primeira propriedade for menor que a segunda. |
| IsNotEqualTo |
Representa uma expressão de pesquisa que compara uma propriedade com um valor constante ou outra propriedade e retorna true se os valores não forem os mesmos. |
| Exclui |
Executa uma máscara bit a bit das propriedades. |
| Contém |
Representa uma expressão de pesquisa que determina se uma determinada propriedade contém o valor de cadeia de caracteres constante fornecido. |
| FieldOrder |
Representa um único campo pelo qual classificar os resultados e indica a direção para o tipo. |
Comentários
Alguns atributos não podem ser usados em combinação com outros atributos. Qualquer solicitação que venha com uma combinação inválida de atributos de propriedade estendida gerará uma mensagem de erro.
O esquema que descreve este elemento está localizado no diretório virtual do EWS do computador que está executando o MicrosoftExchange Server 2007 que tem instalada a função de servidor de Acesso para Cliente.
Observação
No Microsoft .NET, um Long é um inteiro assinado de 64 bits, enquanto em MAPI e COM, um Long é um inteiro de 32 bits. A maioria dos desenvolvedores usará o Microsoft.NET Framework para desenvolver aplicativos cliente do Exchange Web Services. Portanto, a nomenclatura do .NET é usada em vez da nomenclatura MAPI.
Por exemplo, a propriedade MAPI PR_MESSAGE_FLAGS, 0x0E07, é um tipo PT_LONG. No .NET, isso é considerado um inteiro. Uma propriedade estendida para PR_MESSAGE_FLAGS é definida como <t:ExtendedFieldURI PropertyTag="0x0E07" PropertyType="Integer"/>.
Exemplo
O exemplo a seguir de uma solicitação cria um item que tem duas propriedades personalizadas. A primeira propriedade personalizada é chamada IsMyHouse com um valor booliano definido como true. A segunda propriedade estendida personalizada se chama HousePrices. Ele contém uma matriz de valores Conversor de Moedas.
<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>
Elemento de informações
| Elemento | Exemplo |
|---|---|
| Namespace |
http://schemas.microsoft.com/exchange/services/2006/types |
| Nome do esquema |
Esquema de tipos |
| Arquivo de validação |
Types.xsd |
| Pode ser vazio |
False |