Share via

Activar el complemento de Outlook sin el panel de lectura habilitado o un mensaje seleccionado

  • Artículo

Con una configuración de manifiesto simple, puede crear complementos de Outlook para la superficie lectura de mensajes que activen un panel de tareas sin el panel de lectura habilitado o un mensaje seleccionado primero en el buzón. Esta característica se denomina "sin contexto de elemento". Siga el tutorial para obtener más información y desbloquear funcionalidades adicionales para el complemento. Por ejemplo, puede permitir que los usuarios accedan al contenido de diferentes orígenes de datos, como OneDrive o un sistema de administración de relaciones con el cliente (CRM), directamente desde su cliente de Outlook.

Nota:

La compatibilidad con esta característica se introdujo en el conjunto de requisitos 1.13. Vea clientes y plataformas compatibles con este conjunto de requisitos.

Aunque Outlook en la Web y el nuevo conjunto de requisitos de compatibilidad de Outlook en Windows (versión preliminar) 1.13, un complemento no se activará si el panel de lectura está oculto o no se selecciona un mensaje. Para obtener más información, vea Compatibilidad con características en Outlook en la Web y nueva Outlook en Windows (versión preliminar).

Configurar el entorno

Complete el inicio rápido de Outlook en el que crea un complemento de Outlook con el generador de Yeoman para complementos de Office.

Para activar esta característica en un proyecto de complemento preexistente, consulte Configuración del manifiesto.

Configuración del manifiesto

Los pasos para configurar el manifiesto varían en función del tipo de manifiesto que use el complemento.

  1. En el editor de código que prefiera, abra el proyecto de inicio rápido de Outlook que creó.

  2. Abra el archivo manifest.json ubicado en la raíz del proyecto.

  3. En el primer objeto de la matriz "extensions.runtimes", haga lo siguiente:

    1. Cambie "requirements.capabilities.minVersion" a "1.13".
    2. Agregue una propiedad "supportsNoItemContext" al objeto de la matriz "actions" y establezca su valor trueen .
    3. Agregue una propiedad "multiselect" al mismo objeto y establézcala en true.
    4. Cambie la propiedad "anclable" del mismo objeto a true.

    Cuando haya terminado, debería tener un aspecto similar al siguiente.

    "runtimes": [
    {
        "requirements": {
            "capabilities": [
                {
                    "name": "Mailbox",
                    "minVersion": "1.13"
                }
            ]
        },
        "id": "TaskPaneRuntime",
        "type": "general",
        "code": {
            "page": "https://localhost:3000/taskpane.html"
        },
        "lifetime": "short",
        "actions": [
            {
                "id": "TaskPaneRuntimeShow",
                "type": "openPage",
                "view": "dashboard",
                "pinnable": true,
                "supportsNoItemContext": true,
                "multiselect": true
            }
        ]
    }
]

  4. Elimine el segundo objeto de la matriz "extensions.runtimes", cuyo "id" es "CommandsRuntime".

  5. La matriz "extensions.ribbons.tabs.groups.controls" tiene dos objetos. Elimine el segundo, cuyo "id" es "ActionButton".

Configuración del panel de tareas

  1. En el proyecto, vaya a la carpeta panel de tareas y abra taskpane.html.

  2. Reemplace todo <el elemento body> por el marcado siguiente.

    <body class="ms-font-m ms-welcome ms-Fabric">
    <header class="ms-welcome__header ms-bgColor-neutralLighter">
        <img width="90" height="90" src="../../assets/logo-filled.png" alt="logo" title="Add-in logo" />
        <h1 class="ms-font-su">Activate your add-in without enabling the Reading Pane or selecting a message</h1>
    </header>
    <section id="sideload-msg" class="ms-welcome__main">
        <h2 class="ms-font-xl">Please <a target="_blank" href="https://learn.microsoft.com/office/dev/add-ins/testing/test-debug-office-add-ins#sideload-an-office-add-in-for-testing">sideload</a> your add-in to see app body.</h2>
    </section>
    <main id="app-body" class="ms-welcome__main" style="display: none;">
        <ul class="ms-List ms-welcome__features">
            <li class="ms-ListItem">
                <i class="ms-Icon ms-Icon--CheckList ms-font-xl"></i>
                <span class="ms-font-m">Item multi-select is automatically enabled when the <b>SupportsNoItemContext</b> manifest element is set to <code>true</code>. You can test this by selecting multiple messages in Outlook, then choosing <b>Show Taskpane</b> from the ribbon.</span>
            </li>
            <li class="ms-ListItem">
                <i class="ms-Icon ms-Icon--Pin ms-font-xl"></i>
                <span class="ms-font-m">Support to pin the task pane is also automatically enabled. You can test this by selecting the <b>pin</b> icon from the top right corner of the task pane.</span>
            </li>
            <li class="ms-ListItem">
                <i class="ms-Icon ms-Icon--DockRight ms-font-xl"></i>
                <span class="ms-font-m">This feature can only be implemented with a task pane.</span>
            </li>
            <li class="ms-ListItem">
                <i class="ms-Icon ms-Icon--Design ms-font-xl"></i>
                <span class="ms-font-m">Implement your scenario using this feature today! For example, enable your users to access content from different data sources, such as OneDrive or your customer relationship management (CRM) system, without first selecting a message.</span>
            </li>
        </ul>
    </main>
</body>

  3. Guarde los cambios.

Actualización del archivo JavaScript del panel de tareas

  1. En la carpeta del panel de tareas , abra taskpane.js.

  2. Vaya a la Office.onReady función y reemplace su contenido por el código siguiente.

    if (info.host === Office.HostType.Outlook) {
    document.getElementById("sideload-msg").style.display = "none";
    document.getElementById("app-body").style.display = "flex";
}

  3. Guarde los cambios.

Pruébelo

  1. Desde un terminal, ejecute el código siguiente en el directorio raíz del proyecto. Esto inicia el servidor web local y carga localmente el complemento.

    npm start

    Sugerencia

    Si el complemento no se carga de forma local automáticamente, siga las instrucciones de Transferencia local de complementos de Outlook para realizar pruebas a fin de transferirlo de forma local manualmente en Outlook.

  2. Vaya a la bandeja de entrada y realice una de las siguientes acciones:

  3. Seleccione Mostrar panel de tareas en la cinta de opciones.

  4. Explore y pruebe las sugerencias enumeradas en el panel de tareas.

Compatibilidad con las características del panel de tareas de selección múltiple y anclables de elementos

La habilitación de la compatibilidad con ningún contexto de elemento en el manifiesto permite automáticamente la compatibilidad con características de panel de tareas de selección múltiple y anclables de elementos, incluso si estas características no están configuradas explícitamente en el manifiesto.

Compatibilidad con características en Outlook en la Web y nueva Outlook en Windows (versión preliminar)

En Outlook en la Web y nueva Outlook en Windows (versión preliminar), los complementos que implementan ningún contexto de elemento no se activan cuando el panel de lectura está oculto o cuando no se selecciona un mensaje. Esto se debe a que los comandos de complemento de Outlook en la Web no aparecen en la cinta de opciones. Para activar un complemento desde la superficie Lectura de mensajes, primero debe seleccionar un mensaje y, a continuación, seleccionar el comando del complemento en la barra de acciones del mensaje.

Dado que al habilitar ningún contexto de elemento se habilita automáticamente la característica de selección múltiple de elementos, podrá activar el complemento en Outlook en la Web y el nuevo Outlook en Windows en varios elementos de correo.

Consulte también