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

Configurar y actualizar controladores de archivos en Office 365

Se aplica a: Office 365

Manifiesto de la aplicación y la propiedad addIns

La Entidad de aplicación en el directorio activo de Azure (AD) contiene una nueva propiedad, addIns, para admitir controladores de archivos. La propiedad addIns detalla los controladores de archivos contenidos en una aplicación y las propiedades asociadas. Estos detalles se usan para configurar un controlador de archivos para una extensión con Office 365, especificando el nuevo archivo y el comportamiento de apertura y vista previa para esa extensión.

La sintaxis del manifiesto es:

{
    "addIns": [
        {
            "id": "unique guid",
            "type": "FileHandler",
            "properties": [
                {
                    "key": "extension",
                    "value": "List of file extensions separated by semicolons"
                },
                {
                    "key": "fileIcon",
                    "value": "URL of icon for the file type"
                },
                {
                    "key": "newFileUrl",
                    "value": "URL for the new file function"
                },
                {
                    "key": "openUrl",
                    "value": "URL for the file open function"
                },
                {
                    "key": "previewUrl",
                    "value": "URL for the file preview function"
                }
            ]
        }
    ]
}

Nota Las claves de propiedad son sensibles a mayúsculas y minúsculas.

El esquema se describe en la siguiente tabla.

MiembroDescripciónTipo de datosPrimarioMiembros menores
addInsElemento de raíz; contiene una matriz de objetos que definen controladores de archivos en la aplicación.matrizningunotipo de letra
propiedades
idIdentifica un complemento individual dentro de la colección de complementos; puede usar una herramienta de generación de GUID para generar el valor.GUIDaddInsninguno
tipo de letraEl tipo de complemento. Para los controladores de archivos, el valor es "FileHandler".cadenaaddInsninguno
propiedadesDefine las propiedades del controlador de archivosobjetoaddInsextensión
fileIcon
newFileUrl
previewUrl
openUrl
extensiónLa extensión del controlador de archivos sin el carácter "." inicial; por ejemplo, "psd". Se pueden especificar múltiples extensiones de archivo, separadas por punto y coma.cadenapropiedadesninguno
fileIconURL para el icono que representa el tipo de archivo; por ejemplo, "https://fabrikam.com/SampleFileHandler/psdicon.png". El protocolo debe ser https y puede ser cualquier formato de imagen que se represente en una página HTML. La imagen cambiará de tamaño automáticamente y la dimensión recomendada para la imagen es 32x32 píxeles.cadenapropiedadesninguno
newFileUrlURL para la nueva función de archivo; por ejemplo, "https://fabrikam.com/SampleFileHandler/newFile". El protocolo debe ser https.cadenapropiedadesninguno
previewUrlURL para la función de vista previa; por ejemplo, "https://fabrikam.com/SampleFileHandler/preview". El protocolo debe ser https.cadenapropiedadesninguno
openUrlURL para la función que abre el archivo para su edición; por ejemplo, "https://fabrikam.com/SampleFileHandler/open". El protocolo debe ser https.cadenapropiedadesninguno

Para configurar un controlador de archivos debe agregar los detalles del controlador a través de la propiedad addIns al manifiesto de la aplicación en Azure AD. Actualmente, no hay UI en el portal de administración de Azure para hacer esto, por lo que tiene que hacerlo usando consultas Azure AD Graph API .

Con la primera consulta, necesita recuperar el objectId para la aplicación. Para hacer esto se utiliza una solicitud OBTENER con el appId como parámetro de filtro para la consulta. Nota Los objectId y appId son GUID que identifican la aplicación, pero no tienen el mismo valor.

Puede encontrar el appId, también conocido como ID de cliente, en la página de configuración de su aplicación en el portal de Azure Management, en la propiedad ID de cliente . También puede encontrarlo en la clave ClientID de la sección Ajustes de Aplicacion de web.config para su aplicación.

Para recuperar el objectId, envíe la siguiente solicitud OBTENER a Azure AD Graph.

GET https://graph.windows.net/contoso.com/applications?api-version=1.6&$filter=appId%20eq%20'appId'

Reemplace contoso.com con su dominio de cuenta empresarial y el appId con el valor de ID de cliente. Esta consulta devolverá el objeto de la aplicación, que contiene la propiedad objectId .

Ahora está listo para crear la consulta para actualizar la configuración del controlador de archivos de la siguiente manera:

PATCH https://graph.windows.net/contoso.com/applications/objectId/?api-version=1.6

Reemplace contoso.com con su dominio de cuenta empresarial y el objectId con el valor de objectId que recuperó con la primera consulta. Establezca el tipo de contenido en application/json, y pase el json especificando los detalles de configuración del controlador de archivos en el cuerpo de la solicitud.

Nota La propiedad addIns forma parte del esquema de Azure AD Graph 1.6, de manera que necesita especificar 1.6 para los parámetros api-version, como se muestra en los ejemplos anteriores.

Para más información, consulte Versiones de API Azure AD Graph.

Nota Después de actualizar la configuración de la aplicación, sus cambios no serán visibles si descarga el archivo de manifiesto.

Herramienta de muestra Administrador de complementos

Puede usar la herramienta de muestra Administrador de complementos para realizar las consultas de Azure AD Graph para configurar y actualizar un controlador de archivos una vez haya registrado la aplicación de control de archivos en Azure AD. 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.

Para usar la herramienta Administrador de complementos para configurar un controlador de archivos

  1. Vaya a Herramienta de muestra Administrador de complementos.
  2. Cuando la página se cargue en el navegador, haga clic Iniciar sesión en la parte superior derecha de la página.
  3. Introduzca las credenciales para el administrador de la cuenta empresarial y haga clic conectarse.
  4. Seleccione el nombre de su aplicación de control de archivos en Mis aplicaciones en la barra de navegación izquierda.
  5. Haga clic en Registrar complemento.
  6. En el cuadro de diálogo Registrar complemento , seleccione Controlador de archivos.
  7. Haga clic en el menú desplegable para Complemento File Handler.
  8. Introduzca los detalles para su controlador de archivos. Nota El protocolo debe ser https.
  9. Haga clic Actualizar complemento.

Si el controlador de archivos se configuró correctamente, verá un cuadro de mensaje que confirma la actualización exitosa.

© 2018 Microsoft