Trabajar con invalidaciones extendidas del manifiesto

Cuando el complemento usa el manifiesto de solo complemento con formato XML, algunas características de extensibilidad de los complementos de Office se configuran con archivos JSON hospedados en el servidor, en lugar de con el manifiesto del complemento.

Nota:

En este artículo se supone que está familiarizado con los manifiestos de complementos de Office y su rol en los complementos. Lea el manifiesto de complementos de Office, si no lo ha hecho recientemente.

En la tabla siguiente se especifican las características de extensibilidad que requieren una invalidación extendida junto con vínculos a la documentación de la característica.

Característica	Instrucciones de desarrollo
Accesos rápidos de teclado	Agregar métodos abreviados de teclado personalizados a los complementos de Office

El esquema que define el formato JSON es un esquema de manifiesto extendido.

Sugerencia

Este artículo es algo abstracto. Considere la posibilidad de leer uno de los artículos de la tabla para agregar claridad a los conceptos.

Indicar a Office dónde buscar el archivo JSON

Use el manifiesto para indicar a Office dónde buscar el archivo JSON. Inmediatamente debajo (no dentro) del <elemento VersionOverrides> en el manifiesto, agregue un elemento ExtendedOverrides . Establezca el Url atributo en la dirección URL completa de un archivo JSON. A continuación se muestra un ejemplo del elemento ExtendedOverrides> más sencillo posible<.

    ...
    </VersionOverrides>  
    <ExtendedOverrides Url="https://contoso.com/addin/extended-overrides.json"></ExtendedOverrides>
</OfficeApp>

A continuación se muestra un ejemplo de un archivo JSON de invalidaciones extendidas muy sencillas. Asigna el método abreviado de teclado CTRL+MAYÚS+A a una función (definida en otro lugar) que abre el panel de tareas del complemento.

{
    "actions": [
        {
            "id": "SHOWTASKPANE",
            "type": "ExecuteFunction",
            "name": "Show task pane for add-in"
        }
    ],
    "shortcuts": [
        {
            "action": "SHOWTASKPANE",
            "key": {
                "default": "CTRL+SHIFT+A"
            }
        }
    ]
}

Localización del archivo de invalidaciones extendidas

Si el complemento admite varias configuraciones regionales, puede usar el ResourceUrl atributo del <elemento ExtendedOverrides para apuntar Office a un archivo de recursos localizados> . A continuación se muestra un ejemplo.

    ...
    </VersionOverrides>  
    <ExtendedOverrides Url="https://contoso.com/addin/extended-overrides.json" 
                       ResourceUrl="https://contoso.com/addin/my-resources.json">
    </ExtendedOverrides>
</OfficeApp>

Para obtener más información sobre cómo crear y usar el archivo de recursos, cómo hacer referencia a sus recursos en el archivo de invalidaciones extendidas y para obtener opciones adicionales que no se describen aquí, consulte Localización de invalidaciones extendidas.