userProfileNN s.o. IE 4 (Win) DOM s.o.

L'objet userProfile reflète diverses informations contenues dans le profil utilisateur du navigateur pour l'utilisateur actuel. Cet objet offre quatre méthodes qui permettent respectivement d'accomplir les opérations suivantes:

 

Il est ensuite possible d'introduire les informations récupérées (avec l'autorisation de l'utilisateur) dans des éléments de formulaires (visibles ou cachés) pour envoi au serveur. Les éléments de la liste marqués comme compatibles ici indiquent la prise en charge par IE pour Windows uniquement. Bien qu´IE pour Mac accepte les appels des méthodes sans erreur, aucune fonctionnalité n´est associée à ces méthodes. Vous trouverez de plus amples détails sur le profil utilisateur sur le site Web de Microsoft à http://msdn.microsoft.com/workshop/management/profile/profile_assistant.asp.

 
Exemple
  
navigator.userProfile.addReadRequest("vcard.displayname");
navigator.userProfile.doReadRequest("3", "MegaCorp Customer Service");
var custName = navigator.userProfile.getAttribute("vcard.displayname");
navigator.userProfile.clearRequest();
if (custName) {
    ...
}
 
Référence de modèle d'objet
  
navigator.userProfile
 
Propriétés spécifiques à l´objet

Aucune.

 
Méthodes spécifiques à l´objet
 
addReadRequest()clearRequest()doReadRequest()getAttribute()
 
Propriétés de gestionnaire d´événements spécifiques à l´objet

Aucune.

addReadRequest()NN s.o. IE 4 (Win) DOM s.o.

addReadRequest("attributeName")

Ajoute à la file d'attente une demande d'examen d'un attribut de profil d'utilisateur particulier qu'il faut exécuter séparément (à l'aide des méthodes doReadRequest() et getAttribute()). Les éléments ajoutés à la file d'attente s'affichent pour permettre à l'utilisateur de sélectionner l'élément (ou les éléments) à envoyer au serveur. S'il y a plusieurs attributs, invoquez plusieurs fois la méthode addReadRequest().

 
Paramètres
 
vCard.Business.CityvCard.Business.Country
vCard.Business.FaxvCard.Business.Phone
vCard.Business.StatevCard.Business.StreetAddress
vCard.Business.URLvCard.Business.Zipcode
vCard.CellularvCard.Company
vCard.DepartmentvCard.DisplayName
vCard.EmailvCard.FirstName
vCard.GendervCard.Home.City
vCard.Home.CountryvCard.Home.Fax
vCard.Home.PhonevCard.Home.State
vCard.Home.StreetAddressvCard.Home.Zipcode
vCard.HomepagevCard.JobTitle
vCard.LastNamevCard.MiddleName
vCard.NotesvCard.Office
vCard.Pager
 
  • L'un des attributs suivants, sous forme de chaîne non sensible à la casse:
 
Valeur renvoyée

Valeur booléenne: true (si la commande a abouti) | false (si elle a échoué).

clearRequest()NN s.o. IE 4 (Win) DOM s.o.

Supprime les noms d'attribut à récupérer de la file d'attente. Utilisez cet objet une fois que votre script a récupéré les informations requises. Ceci prépare la file d'attente à recevoir la liste suivante.

 
Paramètres

Aucune.

 
Valeur renvoyée

Aucune.
doReadRequest()NN s.o. IE 4 (Win) DOM s.o.

doReadRequest(usageCode[, "friendlyName"[, "domain"[, "path"[, "expiration"]]]])

En fonction des éléments figurant dans la file d'attente, cette méthode inspecte le navigateur pour déterminer si, par le passé, l'utilisateur a autorisé l'examen de ces attributs. Dans la négative (partielle ou totale), la méthode affiche une boîte de dialogue (Assistant Profil) permettant aux utilisateurs de désactiver les éléments qu'il ne faut pas envoyer au serveur. Les paramètres fournissent des informations pour la boîte de dialogue et pour la maintenance de l'autorisation (comme pour les cookies). Seule la méthode doReadRequest() est requise, quel que soit le nombre d'attributs en file d'attente.

 
Paramètres
 
CodeSignification
0Utilisé pour l'administration du système.
1Utilisé pour la recherche et/ou le développement produit.
2Utilisé pour l'achèvement et le support de la transaction en cours.
3Utilisé pour personnaliser le contenu et l'aspect d'un site.
4Utilisé pour améliorer le contenu du site, y compris les publicités.
5Utilisé pour informer les visiteurs des mises à jour du site.
6Utilisé pour contacter des visiteurs pour assurer le marketing de services ou de produits.
7Utilisé pour mettre en relation d'autres informations recueillies.
8Utilisé à d'autres fins par le site.
9Transmis à d'autres utilisateurs pour la personnalisation ou l'amélioration du contenu et de l'aspect du site.
10Transmis à d'autres utilisateurs qui pourront vous contacter concernant le marketing de services et/ou de produits.
11Transmis à d'autres utilisateurs qui pourront vous contacter concernant le marketing de services et/ou de produits, en vous laissant la possibilité de demander au site de ne pas le faire.
12Transmis à d'autres utilisateurs à toute autre fin.
 
  • L'un des nombres entiers de code suivants qui affichent des messages compréhensibles définis par Internet Privacy Working Group, comme illustré dans le tableau suivant:
 
  • Chaîne facultative contenant un nom identifiable (adresse URL) que l'utilisateur peut reconnaître comme source de la demande. Il peut s'agir de l'identité d'une entreprise.
  • Chaîne facultative contenant le domaine du serveur qui fait la demande. Si une date d'expiration a été définie, cette information est stockée avec les attributs demandés afin d'éviter que de futures demandes venant de ce domaine n'interrompent l'utilisateur en affichant la boîte de dialogue Assistant Profil.
  • Chaîne facultative contenant le chemin du document serveur qui fait la demande. Si une date d'expiration a été définie, cette information est stockée avec les attributs demandés afin d'éviter que de futures demandes venant de ce domaine n'interrompent l'utilisateur en affichant la boîte de dialogue Assistant Profil.
  • Chaîne facultative contenant la date d'expiration des autorisations de l'utilisateur. Internet Explorer 4 ne reconnaît pas cette chaîne.
 
Valeur renvoyée

Dans Windows, la méthode ne renvoie aucune valeur, quelle que soit la réponse que l'utilisateur fournit à la boîte de dialogue Assistant Profil. Sur Macintosh (qui ne prend pas pleinement en charge cet objet), la méthode n'affiche pas la boîte de dialogue Assistant Profil et renvoie false.

getAttribute()NN s.o. IE 4 DOM s.o.

getAttribute("attributeName")

Renvoie la valeur de l´attribut, à condition que l´utilisateur en ait donné l´autorisation. Si cette autorisation a été refusée, la méthode renvoie null. Utilisez une méthode getAttribute() pour chaque valeur d´attribut extraite.

 
Paramètres
 
  • L´un des noms d´attribut vCard répertoriés dans la description de la méthode addReadRequest().
 
Valeur renvoyée

Valeur sous forme de chaîne ou null.
getAttribute()NN 6 IE 4 DOM 1

getAttribute(attributeName) getAttribute(attributeName[,caseSensitivity])

Renvoie la valeur de l'attribut nommé de l'élément  courant. Si l'attribut est représenté comme propriété dans le modèle d'objet, cette méthode renvoie la même valeur que lors de la lecture de la propriété de l'objet. C'est la meilleure méthode pour lire la valeur d'un attribut d'objet élément (c'est-à -dire sa propriété) sous le DOM W3C.

 

Le nom d'attribut que vous transmettez comme paramètre est insensible à la casse dans les navigateurs actuels. Cependant, IE fournit un second paramètre facultatif qui vous permet de forcer la distinction minuscules/majuscules dans les noms d'attributs. Cela peut encourager la réutilisation du même nom d'attribut avec un différent mélange minuscules/majuscules, ce qui n'est pas une bonne idée.

 

Reportez-vous à la méthode setAttribute() pour affecter des valeurs aux attributs et créer de nouvelles paires attribut/valeur.

 
Paramètres
 
  • Le nom d'attribut (insensible à la casse par défaut) utilisé dans la balise HTML (sans le symbole = ). Alors qu'IE vous permet de modifier les paramètres de distinction minuscules/majuscules, Netscape ne se soucie pas de la sensibilité à la casse. Mais, du fait de la tendance vers XHTML sensible à la casse, il vaut mieux s'habituer à faire la distinction minuscules/majuscules.
  • Une valeur facultative sous forme de nombre entier pour IE uniquement. La valeur par défaut est 0 (insensible à la casse). Si la valeur est 1 , l'attribut dans la balise HTML doit utiliser exactement les mêmes minuscules/majuscules que le paramètre attributeName pour que sa valeur soit renvoyée.
 
Valeur renvoyée

Le DOM W3C et Netscape 6 conservent les valeurs d'attribut exclusivement comme des types de données sous forme de chaînes. Cependant, IE peut renvoyer une valeur d'attribut sous la forme d'une chaîne, d'un nombre ou d'une valeur booléenne.