ExtendedFieldURI

Article
03/29/2023

L’élément ExtendedFieldURI identifie une propriété MAPI étendue.

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

PathToExtendedFieldType

Attributs et éléments

Les sections suivantes décrivent les attributs, les éléments enfants et les éléments parents.

Attributs

Attribut	Description
DistinguishedPropertySetId	Définit les ID de jeu de propriétés connus pour les propriétés MAPI étendues. Si cet attribut est utilisé, les attributs PropertySetId et PropertyTag ne peuvent pas être utilisés. Cet attribut doit être utilisé avec l’attribut PropertyId ou PropertyName et l’attribut PropertyType . La table DistinguishedPropertySetId Attribute plus loin dans cette rubrique répertorie les valeurs possibles pour cet attribut. Cet attribut est facultatif.
PropertySetId	Identifie un jeu de propriétés étendues MAPI ou un espace de noms par son GUID d’identification. Si cet attribut est utilisé, les attributs DistinguishedPropertySetId et PropertyTag ne peuvent pas être utilisés. Cet attribut doit être utilisé avec l’attribut PropertyId ou PropertyName et l’attribut PropertyType . Cet attribut est facultatif.
PropertyTag	Identifie la balise de propriété sans la partie type de la balise. Le PropertyTag peut être représenté sous la forme d’un entier hexadécimal ou d’un entier court. La plage entre 0x8000 et 0xFFFE représente la plage personnalisée de propriétés. Lorsqu’une base de données de boîtes aux lettres rencontre une propriété personnalisée pour la première fois, elle attribue à cette propriété personnalisée une balise de propriété dans la plage de propriétés personnalisées de 0x8000-0xFFFE. Une balise de propriété personnalisée donnée diffère probablement d’une base de données à l’autre. Par conséquent, une demande de propriété personnalisée par balise de propriété peut retourner différentes propriétés sur différentes bases de données. L’utilisation de l’attribut PropertyTag est interdite pour les propriétés personnalisées. Utilisez plutôt l’attribut PropertySetId et l’attribut PropertyName ou PropertyId . IMPORTANT : accédez à n’importe quelle propriété personnalisée entre 0x8000 et 0xFFFE à l’aide du GUID + nom/ID. Si l’attribut PropertyTag est utilisé, les attributs DistinguishedPropertySetId, PropertySetId, PropertyName et PropertyId ne peuvent pas être utilisés. Cet attribut est facultatif. REMARQUE : Vous ne pouvez pas utiliser un attribut de balise de propriété pour les propriétés dans la plage personnalisée 0x8000-0xFFFE. Dans ce cas, vous devez utiliser une propriété nommée.
PropertyName	Identifie une propriété étendue par son nom. Cette propriété doit être associée à DistinguishedPropertySetId ou PropertySetId. Si cet attribut est utilisé, les attributs PropertyId et PropertyTag ne peuvent pas être utilisés. Cet attribut est facultatif.
PropertyId	Identifie une propriété étendue par son ID de distribution. L’ID de distribution peut être identifié au format décimal ou hexadécimal. Cette propriété doit être associée à DistinguishedPropertySetId ou PropertySetId. Si cet attribut est utilisé, les attributs PropertyName et PropertyTag ne peuvent pas être utilisés. Cet attribut est facultatif.
PropertyType	Représente le type de propriété d’une balise de propriété. Cela correspond au mot le moins significatif dans une balise de propriété. La table PropertyType Attribute plus loin dans cette rubrique contient les valeurs possibles pour cet attribut. Cet attribut est obligatoire.

Attribut DistinguishedPropertySetId

Valeur	Description
Adresse	Identifie l’ID de jeu de propriétés d’adresse par nom.
Rendez-vous	Identifie l’ID du jeu de propriétés de rendez-vous par nom.
CalendarAssistant	Identifie l’ID de jeu de propriétés de l’Assistant calendrier par son nom.
Courant	Identifie l’ID du jeu de propriétés commun par nom.
InternetHeaders	Identifie l’ID de jeu de propriétés des en-têtes Internet par nom.
Réunion	Identifie l’ID du jeu de propriétés de réunion par nom.
Partage
PublicStrings	Identifie l’ID de jeu de propriétés de chaînes publiques par nom.
Tâche	Identifie l’ID de jeu de propriétés de tâche par nom.
UnifiedMessaging	Identifie l’ID défini par nom de la propriété de messagerie unifiée.

PropertyType, attribut

Valeur	Description
ApplicationTime	Valeur double interprétée comme une date et une heure. La partie entière est la date et la partie fraction est l’heure.
ApplicationTimeArray	Tableau de valeurs doubles interprétées comme une date et une heure.
Binary	Valeur binaire encodée en Base64.
BinaryArray	Tableau de valeurs binaires encodées en Base64.
Boolean	Valeur booléenne true ou false.
CLSID	Chaîne GUID.
CLSIDArray	Tableau de chaînes GUID.
Devise	Entier 64 bits interprété comme le nombre de cents.
CurrencyArray	Tableau d’entiers 64 bits qui sont interprétés comme le nombre de cents.
Double	Valeur à virgule flottante 64 bits.
DoubleArray	Tableau de valeurs à virgule flottante 64 bits.
Error	Valeur SCODE ; Entier non signé 32 bits. Non utilisé pour les restrictions ou pour obtenir/définir des valeurs. Cela existe uniquement pour la création de rapports.
Flottant	Valeur à virgule flottante 32 bits.
FloatArray	Tableau de valeurs à virgule flottante 32 bits.
Entier	Entier 32 bits (Int32) signé.
IntegerArray	Tableau d’entiers 32 bits (Int32) signés.
Entier long	Entier 64 bits (Int64) signé ou non signé.
LongArray	Tableau d’entiers 64 bits (Int64) signés ou non signés.
Null	Indique aucune valeur de propriété. Non utilisé pour les restrictions ou pour obtenir/définir des valeurs. Cela existe uniquement pour la création de rapports.
Objet	Pointeur vers un objet qui implémente l’interface IUnknown. Non utilisé pour les restrictions ou pour obtenir/définir des valeurs. Cela existe uniquement pour la création de rapports.
ObjectArray	Tableau de pointeurs vers des objets qui implémentent l’interface IUnknown. Non utilisé pour les restrictions ou pour obtenir/définir des valeurs. Cela existe uniquement pour la création de rapports.
Nom court	Entier 16 bits signé.
ShortArray	Tableau d’entiers 16 bits signés.
SystemTime	Données entières 64 bits et valeur d’heure sous la forme d’une structure FILETIME.
SystemTimeArray	Tableau de données entières 64 bits et de valeurs d’heure sous la forme d’une structure FILETIME.
String	Chaîne Unicode.
StringArray	Tableau de chaînes Unicode.

Éléments enfants

Aucun.

Éléments parents

Élément	Description
ExtendedProperty	Identifie les propriétés étendues sur les dossiers et les éléments.
AdditionalProperties	Identifie les propriétés supplémentaires. Voici les expressions XPath de cet élément : `/FindFolder/FolderShape/AdditionalProperties` `/GetFolder/FolderShape/AdditionalProperties` `/SyncFolderHierarchy/FolderShape/AdditionalProperties` `/GetItem/ItemShape/AdditionalProperties` `/FindItem/ItemShape/AdditionalProperties` `/SyncFolderItems/ItemShape/AdditionalProperties` `/GetAttachment/AttachmentShape/AdditionalProperties`
SetItemField	Représente une mise à jour d'une propriété unique d'un élément dans une UpdateItem Operation.
SetFolderField	Représente une mise à jour d’une propriété unique sur un dossier dans une opération UpdateFolder.
DeleteItemField	Représente une opération de suppression pour supprimer une propriété donnée d’un élément pendant une opération UpdateItem.
DeleteFolderField	Représente une opération de suppression pour la suppression d’une propriété donnée d’un dossier pendant un appel UpdateFolder.
AppendToItemField	Identifie les données à ajouter à une propriété unique d’un élément pendant une opération UpdateItem.
AppendToFolderField	Spécifie les données à ajouter à une propriété de dossier pendant une opération UpdateFolder.
Exists	Représente une expression de recherche qui retourne true si la propriété fournie existe sur un élément.
FieldURIOrConstant	Représente une propriété ou une valeur constante à utiliser lors de la comparaison avec une autre propriété.
IsEqualTo	Représente une expression de recherche qui compare une propriété avec une valeur constante ou une autre propriété et prend la valeur true si elles sont égales.
IsGreaterThan	Représente une expression de recherche qui compare une propriété avec une valeur constante ou une autre propriété et retourne true si la première propriété est supérieure.
IsGreaterThanOrEqualTo	Représente une expression de recherche qui compare une propriété avec une valeur constante ou une autre propriété et retourne true si la première propriété est supérieure ou égale à la seconde.
IsLessThan	Représente une expression de recherche qui compare une propriété avec une valeur constante ou une autre propriété et retourne true si la première propriété est inférieure à la seconde.
IsLessThanOrEqualTo	Représente une expression de recherche qui compare une propriété avec une valeur constante ou une autre propriété et retourne true si la première propriété est inférieure à la seconde.
IsNotEqualTo	Représente une expression de recherche qui compare une propriété avec une valeur constante ou une autre propriété et retourne true si les valeurs ne sont pas les mêmes.
Excludes	Effectue un masque au niveau du bit des propriétés.
Contains	Représente une expression de recherche qui détermine si une propriété donnée contient la valeur de chaîne constante fournie.
FieldOrder	Représente un champ unique selon lequel trier les résultats et indique la direction du tri.

Remarques

Certains attributs ne peuvent pas être utilisés en combinaison avec d’autres attributs. Toute demande fournie avec une combinaison non valide d’attributs de propriété étendue génère un message d’erreur.

Le schéma qui décrit cet élément se trouve dans le répertoire virtuel EWS de l'ordinateur qui exécute MicrosoftExchange Server 2007 pour lequel le rôle serveur d'accès au client est installé.

Remarque

Dans Microsoft .NET, un long est un entier signé 64 bits, tandis que dans MAPI et COM, un long est un entier 32 bits. La plupart des développeurs utilisent Microsoft.NET Framework pour développer des applications clientes des services web Exchange. Par conséquent, le nommage .NET est utilisé à la place du nommage MAPI.

Par exemple, la propriété MAPI PR_MESSAGE_FLAGS, 0x0E07, est un type PT_LONG. Dans .NET, il s’agit d’un entier. Une propriété étendue pour PR_MESSAGE_FLAGS est définie comme <t:ExtendedFieldURI PropertyTag="0x0E07" PropertyType="Integer"/>.

Exemple

L’exemple suivant d’une requête crée un élément qui a deux propriétés personnalisées. La première propriété personnalisée est nommée IsMyHouse avec une valeur booléenne définie sur true. La deuxième propriété étendue personnalisée est nommée HousePrices. Il contient un tableau de valeurs 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>

Informations sur l'élément

Élément	Exemple
Espace de noms	https://schemas.microsoft.com/exchange/services/2006/types
Nom du schéma	Schéma Types
Fichier de validation	Types.xsd
Peut être vide	False