Présentation des fichiers DocIcon.xml

Dernière modification : mercredi 1 décembre 2010

S’applique à : SharePoint Foundation 2010

Un fichier nommé DocIcon.xml est présent sur chaque serveur Web frontal dans un déploiement Microsoft SharePoint Foundation. Il permet de spécifier l’icône qui s’affiche pour un type de fichier donné susceptible d’être téléchargé vers une liste ou vers une bibliothèque de documents et, éventuellement, d’indiquer si un contrôle ActiveX doit être utilisé pour ouvrir le fichier.

Fonctions de DocIcon.xml

Chaque serveur Web frontal dans un déploiement SharePoint Foundation contient un fichier DocIcon.xml situé dans le chemin d’accès suivant :

%ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\XML\DocIcon.xml

La finalité de ce fichier est d’associer des types de fichiers aux éléments suivants :

  • L’icône de document qui représente un type de fichier dans les listes et les résultats de recherche.

  • (Facultatif) Le contrôle ActiveX qui ouvre un fichier de ce type en vue de son affichage ou de sa modification.

  • (Facultatif) Le texte qui apparaît dans les menus déroulants en tant qu’élément pour l’édition (« Modifier dans Nom d’application ») pour un fichier qui est téléchargé vers une liste.

Les paramètres dans DocIcon.xml s’appliquent à l’ensemble d’un déploiement SharePoint Foundation et concernent toutes les définitions de site sur la totalité des serveurs Web frontaux. Chaque extension de nom de fichier ou ProgId ne peut correspondre qu’à un seul contrôle d’édition, à une seule icône et à une seule chaîne de texte d’affichage. Ce mappage est le même dans l’ensemble d’un déploiement SharePoint Foundation. Vous pouvez ajouter des éléments de mappage pour prendre en charge des extensions de noms de fichiers et des ProgId supplémentaires.

Note AttentionAttention

Si vous modifiez DocIcon.xml, vous devez apporter les mêmes modifications sur chaque serveur Web frontal afin que tous les serveurs demeurent synchronisés. Pour ce faire, vous pouvez distribuer les modifications apportées à DocIcon.xml dans le cadre d’une fonctionnalité au niveau de la batterie de serveurs. En outre, vous devez savoir que les modifications que vous apportez à DocIcon.xml peuvent être écrasées lorsque vous installez des mises à jour ou des Service Packs pour SharePoint Foundation ou que vous mettez à niveau une installation vers la version suivante du produit.

Format de fichier

Pour des informations détaillées sur le schéma de DocIcon.xml, voir Schéma des icônes de documents. En général, le schéma permet d’effectuer le mappage de deux façons : par extension de nom de fichier (par exemple, « docx ») et par ProgId (par exemple, « Word.Document »).

Note

Un ProgId est une entrée de Registre qui associe l’identificateur par programme (ProgID) d’un objet COM à son identificateur de classe (CLSID). Par exemple, la clé de Registre HKLM\Software\Classes\Word.Document a une sous-clé nommée CLSID ayant la valeur {F4754C9B-64F5-4B40-8AF4-679732AC0607}. Dans ce cas, le nom de la clé Word.Document est un ProgId. Étant donné que la clé possède une sous-clé dont la valeur est CLSID, vous pouvez utiliser Word.Document comme forme abrégée pour {F4754C9B-64F5-4B40-8AF4-679732AC0607}. Pour plus d’informations, voir Clé <ProgID> (COM) (éventuellement en anglais).

L’élément ByProgID contient une série d’éléments Mapping qui mappent les identificateurs de programmes de types de fichiers différents à des icônes de fichiers, spécifie le texte affiché pour chaque type de fichier dans le menu déroulant qui apparaît lorsque la flèche Modifier est sélectionnée et spécifie le ProgId du contrôle à utiliser pour l’ouverture des documents d’un type donné. L’exemple suivant montre une partie d’une section ByProgID :

<DocIcons>
  <ByProgID>
    <Mapping
      Key="Excel.Sheet" 
      Value="ichtmxls.gif" 
      EditText="Microsoft Office Excel" 
      OpenControl="SharePoint.OpenDocuments" />
    <Mapping 
      Key="FrontPage.Editor.Document" 
      Value="ichtmfp.gif" 
      EditText="Microsoft Office FrontPage" 
      OpenControl="SharePoint.OpenDocuments" />
    ...
  </ByProgID>

L’image référencée dans l’attribut Value doit être stockée dans le dossier IMAGES de chaque serveur frontal dans le chemin d’accès suivant :

%ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\IMAGES

Le contrôle référencé par l’attribut OpenControl doit être déployé sur chaque client qui accède à l’environnement SharePoint Foundation.

L’élément ByExtension mappe les extensions des noms de fichiers à des icônes de fichiers, spécifie le texte à afficher pour chaque extension de nom de fichier dans le menu déroulant qui apparaît lorsque la flèche Modifier est sélectionnée et spécifie le ProgId du contrôle à utiliser pour ouvrir des documents avec une extension de nom de fichier donnée. L’exemple suivant montre une partie d’une section ByExtension :

  <ByExtension>
    <Mapping
      Key="asax" 
      Value="icasax.gif" />
    <Mapping 
      Key="ascx" 
      Value="icascx.gif" />
    <Mapping 
      Key="asmx" 
      Value="icasmx.gif" />
    ...
    <Mapping 
      Key="mpp" 
      Value="icmpp.gif" 
      EditText="Microsoft Office Project" 
      OpenControl="SharePoint.OpenDocuments" /> 
    <Mapping 
      Key="mps" 
      Value="icmps.gif" /> 
    <Mapping 
      Key="mpt" 
      Value="icmpt.gif" 
      EditText="Microsoft Office Project" 
      OpenControl="SharePoint.OpenDocuments" />
    ...
  </ByExtension>

L'élément Default spécifie le fichier image par défaut à utiliser pour les types de fichiers qui ne sont pas spécifiés dans DocIcon.xml, comme indiqué dans l'exemple suivant.

  <Default>
    <Mapping Value="icgen.gif" />
  </Default>
</DocIcon

Note

Pour résoudre les conflits, ByProgID est prioritaire sur ByExtension. Toutefois, les modèles de document qui sont spécifiés dans le fichier Onet.xml d’une définition de site fonctionnent uniquement en relation avec les types de fichiers qui sont spécifiés dans l’élément ByExtension.

Voir aussi

Concepts

Schéma des icônes de documents

Procédure : ajouter un modèle de document, un type de fichier et une application d'édition à une définition de site