Table of contents
TOC
Collapse the table of content
Expand the table of content
Última actualización: 20/06/2018

Crear controladores de archivos en Office 365

Se aplica a: Office 365

Este tutorial muestra la creación de un controlador de archivos básico para un tipo de archivo personalizado utilizando la plantilla del proyecto de aplicación de control de archivos. Puedes descargar la plantilla para Visual Studio 2013 y Visual Studio 2015 desde la aplicación de controlador de archivos, aunque también la encontrarás en la sección de plantillas en línea en el diálogo de proyecto nuevo.

Crear y personalizar la aplicación Office 365

Como hemos mencionado antes, este ejemplo se basa en la plantilla del proyecto de la aplicación de controlador de archivos, por lo que para empezar necesitas crear un nuevo proyecto con esta plantilla. Puedes descargarla desde la aplicación de controlador de archivos, aunque también la encontrarás en la sección de plantillas en línea en el diálogo de proyecto nuevo.

Para descargar la plantilla y crear el proyecto

  1. En el menú Archivo, haz clic en Nuevo y, a continuación, en Proyecto.
  2. En el panel izquierdo, selecciona En línea, y en la categoría Visual C#, selecciona Oficina.
  3. Aplicación de controlador de archivos debería aparecer como la opción en el panel central, selecciónala y escribe basicfilehandler en el nombre, luego haz clic en OK para crear el proyecto.

Si aún no has instalado la plantilla, se te pedirá que la instales.

Luego registrarás la aplicación con Azure AD y luego la modificarás para añadir la funcionalidad de la extensión del controlador de archivos.

Para registrar y configurar la aplicación con Azure AD

  1. En el Explorador de soluciones, haz clic con el botón derecho en el nombre del proyecto y selecciona Añadir > Servicio conectado.

  2. Selecciona API de Office 365 y haz clic en Configurar.

  3. Haz clic en Registra tu aplicación.

    Nota El texto en el diálogo Añadir servicio conectado puede variar según la versión de Visual Studio que tengas. Además, si Registrar tu aplicación no está disponible, puede que tengas que eliminar los valores del marcador para ClientId y ClientSecret en web.config. Para ello, busca las siguientes claves y elimínalas de web.config:

    <add key="ida:ClientId" value="[ClientId placeholder]" />
    <add key="ida:ClientSecret" value="[ClientSecret placeholder]" />
    
  4. Inicia sesión con una cuneta de administrador de inquilinos de tu organización de desarrolladores de Office 365.

  5. Haz clic en Propiedades de la aplicación.

  6. Añade lo siguiente a la lista de redirigir URI:

    • http://basicfilehandler.azurewebsites.net

    • https://basicfilehandler.azurewebsites.net

      Nota El sitio basicfilehandler.azurewebsites.net es donde se alojará la aplicación del controlador de archivos. Lo crearás cuando publiques este proyecto en Azure en un paso posterior.

  7. Haz clic en Aplicar para cerrar el diálogo de Propiedades de la aplicación y luego en OK para cerrar el diálogo de Gerente de servicios.

En este punto, Visual Studio añade los paquetes NuGet necesarios al proyecto. Ahora estás listo para configurar los permisos para tu aplicación, algo que tienes que hacer en el portal de administración de Azure AD.

  1. Inicia sesión en el portal de administración de Azure.

  2. En el panel de navegación izquierdo, selecciona Active Directory. Asegúrate de que la pestaña de Directorio esté seleccionada y luego haz clic en el nombre del directorio.

  3. En la página del directorio, selecciona «Aplicaciones». Deberías ver tu aplicación del controlador de archivos. Si no la ves en la lista, selecciona Aplicaciones que posee mi compañía en el desplegable Mostrar.

  4. Selecciona tu aplicación y luego haz clic en Configurar en el menú superior.

  5. Desplázate hasta la parte inferior de la página y debajo de permisos a otras aplicaciones, selecciona Añadir aplicación.

  6. Selecciona Microsoft Graph y haz clic en el icono de la marca de verificación.

  7. Debajo de permisos a otras aplicaciones, haz clic en la columna de Permisos delegados y selecciona Leer y escribir archivos que el usuario selecciona.

  8. Haz clic en Guardar en la barra de navegación inferior.

Codifica la aplicación del controlador de archivos

Ahora puedes añadir el código específico del controlador de archivos en la aplicación. Si has utilizado la plantilla del proyecto de la aplicación del controlador de archivos para crear el proyecto, una gran parte de este trabajo ya estará listo. Las tareas principales que te quedan por hacer son añadir el código a los métodos NuevoArchivo, Abrir y Versión preliminar para especificar qué debería suceder en el tipo de archivo personalizado.

Puedes encontrar estos métodos en el archivo FileHandlerController.cs en la carpeta de Controladores de la solución del proyecto.

Para el método de Versión preliminar, busca la siguiente declaración de método:

public async Task<ActionResult> Preview()

Para el método Abrir, busca la siguiente declaración de método:

public async Task<ActionResult> Open()

Para el método Nuevo archivo, busca la siguiente declaración de método:

public async Task<ActionResult> NewFile()

Nota La primera parte del código en estos métodos carga los parámetros de activación. Los parámetros de activación contienen información que Office 365 incluye como parte de la solicitud POST realizada al controlador de archivos. El código incluido con la plantilla del proyecto accede y almacena estos valores tan pronto como se invoca el controlador de archivos. Para obtener más información sobre los parámetros disponibles, consulta los parámetros de activación del controlador de archivos.

Publicar aplicación

Ahora estás preparado para publicar la aplicación en Azure.

  1. En Explorador de soluciones, haz clic con el botón derecho en el proyecto y selecciona Publicar.

  2. Selecciona sitios web de Microsoft Azure.

  3. Cuando te soliciten las credenciales, introduce las que has utilizado para gestionar tu suscripción de Azure.

  4. En Seleccionar sitios web existentes, haz clic en Nuevo.

  5. Escribe basicfilehander como el Nombre del sitio.

  6. Si no tienes un servidor de base de datos configurado, especifica Crear un nuevo servidor, de lo contrario, selecciona el servidor de base de datos que vayas a utilizar.

  7. Haz clic en Crear.

  8. Una vez hayas creado el sitio, haz clic en Publicar.

Configurar el controlador de archivos

Después de publicar la aplicación del controlador de archivos, estás listo para configurarlo en Office 365.

  1. Navega hacia la herramienta de muestra de Administrador de complementos, que es una herramienta de prueba que puedes utilizar para garantizar que realizas las consultas necesarias a la API de Azure AD Graph para configurar el controlador de archivos. El uso de la herramienta Administrador de complementos actualizará la configuración de la aplicación en Azure AD.

    Nota La herramienta de muestra Administrador de complementos es solo para fines de demostración y prueba, y no debe utilizarse en entornos de producción.

  2. Cuando la página se cargue en el navegador, hz clic Iniciar sesión en la parte superior derecha de la página.

  3. Introduce las credenciales para el administrador de la cuenta empresarial y haz clic conectarse.

  4. Selecciona el nombre de tu aplicación de control de archivos en Mis aplicaciones en la barra de navegación izquierda.

  5. Haz clic en Registrar complemento.

  6. En el cuadro de diálogo Registrar complemento , selecciona Controlador de archivos.

  7. Haz clic en el menú desplegable para Complemento del controlador de archivos.

  8. Introduce los detalles para tu controlador de archivos. Nota El protocolo debe ser https.

  9. Haz clic Actualizar complemento.

Probar el controlador de archivos

Para probar tu aplicación, sube algunos archivos de muestra utilizando el tipo de archivo personalizado a tu sitio SharePoint. Cuando veas la biblioteca de documentos, estos archivos deben aparecer con la imagen que has especificado para el icono de archivo personalizado. Si realizas cambios de metadatos en el complemento en Azure Active Directory, los verás en Office 365 actualizando tu navegador.

© 2018 Microsoft