Compartir a través de

Solución de problemas de complementos de Word

  • Artículo

En este artículo se describe la solución de problemas que son únicos para Word. Use la herramienta de comentarios al final de la página para sugerir otros problemas que se pueden agregar a este artículo.

No se reconocen todos los intervalos seleccionados

Si se realizan selecciones no contiguas, la API de Word solo funciona en el último intervalo contiguo de la selección. Un caso inesperado de esto es cuando selecciona una columna de una tabla y, a continuación, llama a, por ejemplo, Document.getSelection, solo la API devuelve la celda final de la selección. Aunque la selección de una columna parece contigua, la API la reconoce como una selección no contigua (por ejemplo, una celda por fila).

Para obtener más información sobre cómo realizar selecciones no contiguas, consulte Selección de elementos que no están juntos.

Por diseño, el método Body.insertFileFromBase64 excluye cualquier encabezado o pie de página que estuviera en el archivo de origen.

Para incluir los encabezados o pies de página del archivo de origen, use Document.insertFileFromBase64 en su lugar.

Obtener una excepción GeneralException al trabajar con estilos

Si los usuarios alcanzan una excepción GeneralException cuando el complemento llama a Document.insertFileFromBase64 o a las API de estilo, es posible que esos usuarios superen los límites impuestos por la aplicación Word. Para obtener más información sobre estos límites, consulte Limitaciones y especificaciones de parámetros operativos en Word.

El diseño se interrumpe al usar insertHtml mientras el cursor está en el control de contenido en el encabezado

Este problema puede producirse cuando se cumplen las tres condiciones siguientes.

  1. Tenga al menos un control de contenido en el encabezado y al menos uno en el pie de página del documento Word.
  2. Asegúrese de que el cursor está dentro de un control de contenido en el encabezado.
  3. Llame a insertHtml para establecer un control de contenido en el pie de página.

A continuación, el pie de página se mezcla inesperadamente con el encabezado . Para evitarlo, borre el control de contenido en el pie de página antes de establecerlo, como se muestra en el ejemplo de código siguiente.

await Word.run(async (context) => {
    // Credit to https://github.com/barisbikmaz for this version of the workaround.
    // For more information, see https://github.com/OfficeDev/office-js/issues/129.

    // Let's say there are 2 content controls in the header and 1 in the footer.
    const contentControls = context.document.contentControls;
    contentControls.load();

    await context.sync().then(function () {
        // Clear the 2 content controls in the header.
        contentControls.items[0].clear(); 
        contentControls.items[1].clear();

        // Clear the control control in the footer then update it.
        contentControls.items[2].clear();
        contentControls.items[2].insertHtml('<p>New Footer</p>', 'Replace');
    });
});

Se ha perdido el formato de la última viñeta de una lista o último párrafo.

Si el formato de la última viñeta de una lista o del último párrafo se pierde en el cuerpo o el intervalo especificados, compruebe si usa Body.insertFileFromBase64 o Range.insertFileFromBase64. Si es así, actualice el código para usar Document.insertFileFromBase64 en su lugar.

Significado de los valores de propiedad null en la respuesta

nulltiene implicaciones especiales en las API de JavaScript de Word. Se usa para representar valores predeterminados o sin formato.

Las propiedades de formato, como el color , contendrán null valores en la respuesta cuando existan valores diferentes en el intervalo especificado. Por ejemplo, si recupera un rango y carga su propiedad range.font.color:

  • Si todo el texto del rango tiene el mismo color de fuente, range.font.color especifica ese color.
  • Si hay varios colores de fuente dentro del rango, range.font.color es null.

Vea también