Abrir automáticamente un panel de tareas cuando se instala un complemento

Puede configurar el panel de tareas del complemento para que se inicie inmediatamente después de instalarlo. Esta característica aumenta el uso.

Sugerencia

En este artículo se describe una característica que permite a un complemento abrir su panel de tareas cuando un usuario final instala el complemento . Esta característica se limita a un único documento: el que está abierto cuando se instala el complemento. Esta característica es distinta de tres características similares:

  • Un complemento puede configurar mediante programación un documento para abrir automáticamente el panel de tareas del complemento cuando se abra el documento. La técnica tiene alcance documental, lo que significa que debe aplicarse a cada documento individualmente. Para obtener más información, vea Abrir automáticamente un panel de tareas con un documento.
  • Un complemento puede configurarse a sí mismo mediante programación para ejecutar código cuando se abre un documento. Esta característica también debe aplicarse a cada documento individualmente. Para obtener más información, vea Configurar un documento para que ejecute el código cuando se abre.
  • Se puede configurar un complemento en el manifiesto para ejecutar código cuando se abra cualquier documento. Esta característica tiene ámbito de aplicación de Office. Después de que un administrador de Microsoft 365 instale un complemento en el portal de Administración del inquilino de Microsoft 365, el complemento se inicia y ejecuta código en cada documento de Office que se abre en las aplicaciones de Office para las que el complemento, en el manifiesto, está configurado. Para obtener más información, vea Activar complementos con eventos, especialmente la información sobre el OnDocumentOpened evento.

De forma predeterminada, los complementos del panel de tareas que no incluyen ningún comando de complemento abren el panel de tareas inmediatamente después de la instalación. Sin embargo, cuando un complemento tiene uno o varios comandos de complemento, el usuario recibe una notificación del nuevo complemento, pero el complemento no se inicia automáticamente. Este comportamiento predeterminado histórico está cambiando, por lo que los complementos que tienen comandos de complemento se iniciarán automáticamente en algunas situaciones. Además, si el complemento tiene más de una página del panel de tareas, es posible controlar si el complemento se inicia durante la instalación y, en caso afirmativo, qué página se abre en el panel de tareas.

Nota:

  • Esta característica solo se aplica a los complementos instalados por un usuario final, no a los complementos implementados centralmente.
  • Esta característica no se aplica a complementos de contenido ni a complementos de correo (Outlook).
  • Esta característica solo se aplica a los complementos que tienen al menos un comando de complemento del tipo "comando del panel de tareas".

Comportamiento nuevo

El nuevo comportamiento es el siguiente:

  • Si el complemento tiene solo un comando en el panel de tareas, la pestaña de la cinta del complemento se selecciona y el panel de tareas se abre automáticamente tras la instalación. No es necesario configurar nada.
  • Si el complemento tiene varios comandos del panel de tareas y uno está configurado como predeterminado (consulte Configurar el panel de tareas predeterminado), se selecciona la pestaña de la cinta del complemento y se abre automáticamente el panel de tareas predeterminado tras la instalación.
  • Si el complemento tiene varios comandos del panel de tareas, pero ninguno está configurado para ser el predeterminado, la pestaña de la cinta del complemento se selecciona automáticamente durante la instalación y aparece una llamada cerca notificando al usuario del nuevo complemento, pero no se abre ningún panel de tareas. Es lo mismo que el comportamiento predeterminado histórico.

Nota:

Si, por cualquier motivo, un usuario no puede seleccionar manualmente el comando del complemento que inicia el panel de tareas en el inicio, como cuando está configurado para deshabilitarse en el inicio, no se abrirá automáticamente independientemente de la configuración.

Configurar el panel de tareas predeterminado en el manifiesto

El proceso para especificar el panel de tareas predeterminado depende del tipo de manifiesto que use el complemento.

Para especificar el panel de tareas predeterminado, busque el objeto de tiempo de ejecución de la "runtimes" matriz cuya "code.page" propiedad esté establecida en la dirección URL de la página que desee que sea predeterminada. Asegúrese de que la "actions" matriz de este mismo objeto en tiempo de ejecución tenga al menos una acción cuyo "type" valor sea "openPage". Agregue una "view" propiedad a este objeto de acción y establézcala en "Office.AutoShowTaskpaneWithDocument". Solo puede establecer este valor en un objeto de acción y debe ser una acción de tipo "openPage". Si establece este valor en varias acciones, la primera aparición del valor se reconocerá como el predeterminado y se omitirán las demás.

En el ejemplo siguiente se muestra un "view" valor establecido en "Office.AutoShowTaskpaneWithDocument".

"runtimes": [
    {
        ...
        "code": {
            "page": "https://contoso.com/taskpane.html"
        },
        "actions": [
            {
                "id": "ShowTaskPane",
                "type": "openPage",
                "view": "Office.AutoShowTaskpaneWithDocument"
            }
        ]
    }
]

Sugerencia

Si desea que el complemento se inicie automáticamente cada vez que el usuario vuelva a abrir el documento, debe realizar más pasos de configuración. Para obtener más información y consejos sobre cuándo usar esta característica, vea Abrir automáticamente un panel de tareas con un documento.

Vea también

  • Last updated on