Descripción de los archivos DocIcon.xml
Última modificación: miércoles, 01 de diciembre de 2010
Hace referencia a: SharePoint Foundation 2010
Un archivo denominado DocIcon.xml está presente en cada servidor front-end web en una implementación de Microsoft SharePoint Foundation. Su objetivo es proporcionar una forma de especificar el icono que aparece para cualquier tipo de archivo determinado que se puede cargar a una lista o biblioteca de documentos y, opcionalmente, una forma de especificar si un control ActiveX debe usarse para abrir el archivo.
Funciones de DocIcon.xml
Todos los servidores front-end web de una implementación de SharePoint Foundation tienen un archivo DocIcon.xml ubicado en la siguiente ruta:
%ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\XML\DocIcon.xml
El objetivo de este archivo es asociar tipos de archivo con los siguientes elementos:
El icono de documento que representa un tipo de archivo en las listas y los resultados de búsqueda.
(Opcional) El control ActiveX que abre un archivo de este tipo para verlo o modificarlo.
(Opcional) El texto que aparece en los menús desplegables como el elemento de edición ("Editar en nombre de aplicación") para un archivo que se cargó en una lista.
Las opciones de configuración de DocIcon.xml son globales para una implementación de SharePoint Foundation y afectan a todas las definiciones de sitio en todos los servidores front-end web. Cada extensión de nombre de archivo o ProgID se puede asignar únicamente a un control de edición, un icono y una cadena de texto para mostrar. Esta asignación es la misma en toda la implementación de SharePoint Foundation. Se pueden agregar elementos de asignación para admitir ProgID y extensiones de nombre de archivo adicionales.
.gif "Nota de precaución") Precaución |
|---|
Si modifica DocIcon.xml, debe realizar cambios idénticos en cada servidor front-end web para que todos los servidores permanezcan sincronizados. Una buena manera de hacerlo sería distribuir los cambios realizados en DocIcon.xml como parte de una característica de nivel de conjunto o granja de servidores. Además, debe tener en cuenta que los cambios realizados en DocIcon.xml se pueden sobrescribir cuando se instalan actualizaciones o Service Packs en SharePoint Foundation o cuando se actualiza una instalación a la siguiente versión de producto. |
Formato de archivo
Para obtener información detallada sobre el esquema para DocIcon.xml, vea Esquema de iconos de documento. En general, el esquema proporciona dos formas para realizar la asignación: por extensión de nombre de archivo (por ejemplo, "docx") y por ProgID (por ejemplo, "Word.Document").
Nota
Un ProgID es una entrada del Registro que asocia el identificador de programación (ProgID) de un objeto COM con su identificador de clase (CLSID). Por ejemplo, la clave del Registro HKLM\Software\Classes\Word.Document tiene una subclave denominada CLSID con un valor de {F4754C9B-64F5-4B40-8AF4-679732AC0607}. En este caso, el nombre de clave Word.Document es un ProgID. Dado que la clave tiene una subclave con un valor de CLSID, se puede usar Word.Document como abreviatura de {F4754C9B-64F5-4B40-8AF4-679732AC0607}. Para obtener más información, vea Clave <ProgId> (COM).
El elemento ByProgID contiene una serie de elementos Mapping que asignan los identificadores de programa de los diferentes tipos de archivo a iconos de archivo, especifican el texto que se muestra para cada tipo de archivo en el menú desplegable que aparece cuando se hace clic en la flecha Editar y establecen el ProgID del control que se usará para abrir documentos de un tipo determinado. El siguiente ejemplo muestra parte de una sección de 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>
La imagen a la que se hace referencia en el atributo Value debe almacenarse en la carpeta IMAGES de cada servidor front-end en la siguiente ruta:
%ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\IMAGES
El control al que hace referencia el atributo OpenControl debe implementarse en cada cliente que tiene acceso el entorno de SharePoint Foundation.
El elemento ByExtension asigna las extensiones de nombre de archivo a iconos de archivo, especifica el texto que se muestra para cada extensión de nombre de archivo en el menú desplegable que aparece al hacer clic en la flecha Edit y establece el ProgID del control que se usará para abrir documentos con una extensión de nombre de archivo determinada. El siguiente ejemplo muestra parte de una sección 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>
El elemento Default especifica el archivo de imagen predeterminado que se usará para tipos de archivo que no se especificaron en DocIcon.xml, como se muestra en el siguiente ejemplo.
<Default>
<Mapping Value="icgen.gif" />
</Default>
</DocIcon
Nota
Para resolver los conflictos, ByProgID tiene prioridad sobre ByExtension. Sin embargo, las plantillas de documento especificadas en el archivo Onet.xml de una definición de sitio sólo funcionan en relación con tipos de archivo especificados en el elemento ByExtension.