Compartir a través de

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.

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, se notifica al usuario 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 de panel de tareas, es posible controlar si el complemento se inicia tras la instalación y, si es así, 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 de forma centralizada.
  • 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 de panel de tareas".

Nuevo comportamiento

El nuevo comportamiento es el siguiente:

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

Nota:

Si, por algún motivo, un usuario no puede seleccionar manualmente el comando del complemento que inicia el panel de tareas al iniciarse, por ejemplo, cuando se configura para deshabilitarse al iniciarse , no se abrirá automáticamente independientemente de la configuración.

Configuración del 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.

Nota:

El manifiesto unificado para Microsoft 365 se puede usar en complementos de Outlook de producción. Solo está disponible como versión preliminar para excel, PowerPoint y complementos de Word.

Para especificar el panel de tareas predeterminado, busque el objeto en tiempo de ejecución en la "runtimes" matriz cuya "code.page" propiedad está establecida en la dirección URL de la página que desea que sea la predeterminada. Asegúrese de que la "actions" matriz de este mismo objeto en tiempo de ejecución tiene al menos una acción cuyo "type" valor es "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 valor 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 seguir los pasos de configuración. Para obtener detalles y consejos sobre cuándo usar esta característica, consulte Abrir automáticamente un panel de tareas con un documento.

Vea también

  • Last updated on