ExtendedFieldURI
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="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>
Informations sur l'élément
| Élément | Exemple |
|---|---|
| Espace de noms |
http://schemas.microsoft.com/exchange/services/2006/types |
| Nom du schéma |
Schéma Types |
| Fichier de validation |
Types.xsd |
| Peut être vide |
False |