Programación con el espacio de nombres Microsoft.HtmlTrans
Última modificación: martes, 01 de febrero de 2011
Hace referencia a: SharePoint Foundation 2010
Los usuarios pueden ver un documento de una biblioteca de documentos aunque no tengan instalada en el equipo cliente una aplicación que permita mostrar el documento solicitado. Microsoft SharePoint Foundation proporciona el espacio de nombres Microsoft.HtmlTrans como una infraestructura en la que se pueden crear aplicaciones personalizadas de convertidor que proporcionan una versión HTML del documento solicitado en lugar del formato de archivo binario no reconocido.
.gif "Nota de precaución") Precaución |
|---|
Para usar esta funcionalidad, el visor de HTML debe estar habilitado en la administración central de SharePoint Foundation. |
El espacio de nombres Microsoft.HtmlTrans.Interface consta de dos interfaces, IHtmlTrLoadBalancer e IHtmlTrLauncher. La implementación de estas interfaces también se basa en un archivo de configuración XML, denominado htmltransinfo.xml , que reside en el servidor en el que se ejecuta SharePoint Foundation.
La interfaz IHtmlTrLoadBalancer permite seleccionar el servidor en el que se va a ejecutar la aplicación de convertidor personalizado.
La interfaz IHtmlTrLauncher inicia la aplicación de convertidor personalizado y devuelve los resultados HTML a SharePoint Foundation.
El archivo htmltransinfo.xml redirige la solicitud de documento a una página de controlador que, a continuación, llama a los componentes del iniciador y equilibrador de carga. Las entradas del archivo de configuración htmltransinfo.XML usan el siguiente formato:
<HtmlTrInfo> <Mapping Extension="ext" AcceptHeader="application/vnd.my-app" HandlerUrl="myapphandler.aspx" ProgId=""/> </HtmlTrInfo>
| Precaución |
|---|
Los cambios realizados en el archivo htmltransinfo.XML pueden perderse al actualizar SharePoint Foundation con una revisión de seguridad o un Service Pack. |
Uso del espacio de nombres Microsoft.HtmlTrans
Cuando un usuario solicita un documento desde un servidor que ejecuta SharePoint Foundation, se produce la siguiente secuencia de eventos:
SharePoint Foundation identifica la extensión de archivo del documento en el archivo htmltransinfo.xml. Si la encuentra, SharePoint Foundation recupera el atributo AcceptHeader coincidente; si no la encuentra, SharePoint Foundation solicita al usuario que descargue el documento.
SharePoint Foundation comprueba el valor del atributo AcceptHeader con el valor Accept-Header HTTP header de la solicitud para determinar si el equipo cliente reconoce el tipo de documento solicitado. De ser así, SharePoint Foundation proporciona el documento en su formato nativo.
SharePoint Foundation también recupera el atributo ProgId del archivo Htmltransinfo.xml e intenta abrir el archivo en el equipo cliente usando el componente designado por ProgId. Si este intento falla, SharePoint Foundation continúa con el proceso de conversión de HTML.
Si el equipo cliente no reconoce el tipo de documento solicitado, SharePoint Foundation pregunta al usuario si desea convertir el documento para visualizarlo en el explorador. Si el usuario elige no convertir el documento, SharePoint Foundation solicita al usuario que descargue el documento.
Si el usuario elige convertir el documento, SharePoint Foundation reenvía la solicitud a la página de controlador especificada por el atributo HandlerUrl en el archivo Htmltransinfo.xml. La página de controlador administra el proceso de conversión y proporciona al usuario el archivo convertido para verlo en el explorador.
Implementación de conversión de documentos personalizada
Para implementar la conversión de documentos personalizada en la plataforma de SharePoint Foundation, se deben crear los siguientes elementos:
Una entrada en el archivo Htmltransinfo.xml para el tipo de documento.
Una página de controlador que inicie el proceso de conversión de documentos y devuelva el resultado HTML al usuario.
Un conjunto de componentes de conversión personalizada.
Se deberá elegir entre tres métodos para generar el conjunto de componentes de conversión personalizada:
Generar implementaciones personalizadas de las interfaces IHtmlTrLoadBalancer y IHtmlTrLauncher que pueden usarse para iniciar una aplicación de conversión personalizada y devolver los resultados a SharePoint Foundation.
Crear un conjunto de componentes de conversión personalizada que no usen las interfaces Microsoft.HtmlTrans.
Llamar a las implementaciones personalizadas de las interfaces IHtmlTrLoadBalancer y IHtmlTrLauncher que se incluyen con el kit de recursos de Microsoft Office 2003 Editions y proporcionar una aplicación de conversión personalizada para las llamadas de IHtmlTrLauncher.
Vea también
Conceptos
Espacios de nombres en el modelo de objetos de SharePoint Foundation