Abrevia el contenido de uno o de varios campos; esta función:

• Selecciona las palabras del texto más significativas.
• Abrevia las palabras de uso común.
• Omite las vocales.
• Suprime el texto innecesario; por ejemplo, los encabezados de los mensajes de correo o los espacios en blanco.

Sintaxis

@Abstract( [ palabras-clave ] ; tamaño ; comentario-inicial ; campos-texto )

Parámetros

[ palabras-clave ]

Cualquier número de palabras clave. Éstas indican a Lotus Notes/Domino el modo en que debe abreviar y organizar el texto (vea la lista). Las palabras clave se ejecutan en el orden en que se incluyen. Encierre cada una de las palabras clave entre corchetes y separe unas de otras con el signo de dos puntos (:). [DROPVOWELS]:[NOTRIMWHITE]:[ABBREV]

Número. El tamaño máximo que ha de tener el texto abreviado. Éste no puede ser superior a 64.994 bytes. El número de bytes disponible para el texto abreviado es tamaño - 1; se reserva un byte para uso interno.

Texto. Comentario que se insertará al principio del texto resultante y que no superará los 10 caracteres. Los caracteres de comentario-inicial se incluirán en el máximo especificado en tamaño, pero su contenido no resultará afectado por los comandos de @Abstract. Si no desea incluir un comentario, especifique una cadena vacía ("").

Texto o lista de texto. Cualquier número de campos con el texto que se desea abreviar. Los campos pueden ser de texto, de texto enriquecido o de palabras clave. El texto de cada uno de los campos se concatena con espacios en el orden especificado. Si Notes/Domino no puede localizar un campo por su nombre, utiliza en su lugar la cadena de texto especificada entre comillas. Encierre cada uno de los nombres de campo entre comillas (por ejemplo, "Ventas") y separe unos de otros con el signo de dos puntos (por ejemplo, "Ventas":"Cifras").

Resultado

texto-abreviado

Texto. El texto de cada uno de los campos-texto, abreviado y organizado según los comandos especificados.

Puede utilizar las siguientes palabras clave con @Abstract:

[TEXTONLY]

Suprime los bloques de encabezados de mensajes de correo y los de signos de puntuación.

Determina la importancia de cada una de las palabras en el texto. La importancia de una palabra depende del número de veces que aparece en el texto. Cuando una palabra está incluida en la lista de palabras importantes (vea "Archivos" más adelante), Notes aumenta su grado de importancia. Por el contrario, Notes considera no importantes todas aquellas palabras que están incluidas en la lista de palabras no importantes (vea "Archivos" más adelante).

Guarda el texto en el estado actual. El texto guardado puede restaurarse con la palabra clave [RESTORE].

Desecha el texto actual y restaura la última versión guardada. Sólo es posible restaurar el texto guardado una sola vez. Si no hay texto guardado, esta palabra clave no tiene efecto.

Comprueba si el texto actual es lo suficientemente pequeño como para que quepa en el espacio especificado en tamaño. En caso afirmativo, @Abstract da como resultado el texto actual y paraliza la ejecución de la función, ignorando el resto de los comandos. En caso negativo, @Abstract continúa con la siguiente palabra clave.

Organiza el texto de acuerdo con su importancia. El texto se divide en bloques, que pueden ser de tres tipos: de texto, de encabezados de mensajes de correo y de signos de puntuación.
• Los bloques de texto son normalmente frases. Éstas pueden estar al principio, al final o dentro de un párrafo.
• Los bloques de encabezados de mensajes de correo se crean de acuerdo con el contenido del archivo de encabezados de mensajes de correo (vea "Archivos" más adelante).
• Los bloques de signos de puntuación están compuestos por cualquier texto que no contenga ni letras ni dígitos.
La importancia de un bloque depende de la importancia de las palabras que lo componen, del número de palabras que contiene, y del tipo y la posición del bloque. Para poder utilizar [SORTCHUNKS], también debe utilizar [COUNTWORDS].

Sustituye las palabras por abreviaturas. Sustituye las palabras del texto por abreviaturas, utilizando para ello un diccionario de abreviaturas (vea "Archivos" más adelante). Los comandos siguientes le sirven para controlar otros aspectos del proceso de creación de abreviaturas. Estos comandos no tienen efecto, a menos que vayan detrás de la palabra clave [ABBREV]):

[USEDICT]

Indica que se ha de utilizar el diccionario de abreviaturas. Ésta es la opción predeterminada.

[NODICT]

Indica que no se ha de utilizar el diccionario de abreviaturas.

[KEEPVOWELS]

Conserva las vocales en las palabras. Ésta es la opción predeterminada.

[DROPVOWELS]

Elimina las vocales de las palabras. Cuando una palabra comienza por vocal, ésta no resulta afectada. Si utiliza [DROPVOWELS], también podrá utilizar (opcionalmente) uno de los subcomandos siguientes:


[DROPFIRSTVOWEL]

Elimina las vocales cuando éstas son iniciales de palabra.

[KEEPFIRSTVOWEL]

Conserva las vocales cuando éstas son iniciales de palabra. Ésta es la opción predeterminada.


[TRIMWHITE]

Sustituye las cadenas de espacios en blanco por un único espacio en blanco. Ésta es la opción predeterminada.

[NOTRIMWHITE]

Conserva las cadenas de espacios en blanco.

[TRIMPUNCT]

Suprime del texto todos los espacios en blanco que rodean a los signos de puntuación.

[NOTRIMPUNCT]

Conserva los espacios en blanco extras que rodean a los signos de puntuación.

[NOSTOPLIST]

Desactiva la lista de palabras no importantes (notestop.txt).

[NOSIGLIST]

Desactiva la lista de palabras importantes (notesigl.txt).

Existen tres programas de comandos predefinidos, denominados Rules que puede utilizar con @Abstract.

[RULE1] se compone de los comandos siguientes, que se ejecutan en este orden:

[TEXTONLY]:[TRYFIT]

Suprime todos los bloques de encabezados de mensajes de correo y los de signos de puntuación. Si, una vez hecho esto, el texto resultante es lo suficientemente pequeño, la función se da por finalizada; en caso contrario, continúa.

Suprime del texto todos los espacios en blanco que rodean a los signos de puntuación.

Guarda el texto en el estado actual.

Sustituye las palabras por abreviaturas. Si, una vez hecho esto, el texto resultante es lo suficientemente pequeño, la función se da por finalizada; en caso contrario, continúa.

Restaura el estado del texto antes del proceso de abreviación.

Guarda el texto en el estado actual.

Suprime las vocales. Si, una vez hecho esto, el texto resultante es lo suficientemente pequeño, la función se da por finalizada; en caso contrario, continúa.

Restaura el estado del texto antes del proceso de abreviación.

Cuenta las palabras y organiza los bloques. Sustituye las palabras por abreviaturas y les antepone un asterisco (*).

[RULE2] emite los comandos siguientes:

[TRIMPUNCT]:[ABBREV]

[RULE3] emite los comandos siguientes:

[TEXTONLY]:[TRYFIT]:

Suprime todos los bloques de encabezados de mensajes de correo y los de signos de puntuación. Si, una vez hecho esto, el texto resultante es lo suficientemente pequeño, la función se da por finalizada; en caso contrario, continúa.

Suprime del texto todos los espacios en blanco que rodean a los signos de puntuación.

Guarda el texto en el estado actual.

Sustituye las palabras por abreviaturas. Si, una vez hecho esto, el texto resultante es lo suficientemente pequeño, la función se da por finalizada; en caso contrario, continúa.

Restaura el estado del texto antes del proceso de abreviación.

Suprime las vocales.

Guarda el texto en el estado actual.

Si, una vez hecho esto, el texto resultante es lo suficientemente pequeño, la función se da por finalizada; en caso contrario, continúa.

Restaura el estado del texto antes del proceso de abreviación.

Cuenta las palabras y organiza los bloques. Sustituye las palabras por abreviaturas y les antepone un asterisco (*).

Archivos

@Abstract hace uso de los archivos indicados a continuación. Dependiendo del modo en que desee usar @Abstract, puede crear todos, alguno de ellos o ninguno. Los nombres de los archivos que cree deben seguir la regla de asignación de nombres mostrada más abajo, y deberán estar presentes en la ruta de acceso a los archivos de Notes/Data al ejecutar el software.

Diccionario de abreviaturas (noteabbr.txt)

Cada línea del archivo debe tener dos palabras: la primera es la palabra original y la segunda la abreviatura. Las abreviaturas deben ser más cortas que las palabras a las que sustituyen. Por ejemplo:

teléfono tl

número núm

El uso de mayúsculas se regula por las normas siguientes:

• Si la abreviatura se especifica en mayúsculas, siempre aparecerá en mayúsculas.
• Si la palabra original aparece en minúsculas, la abreviatura aparece tal como se especifica en el diccionario de abreviaturas.
• Si la palabra original aparece en mayúsculas o es una combinación de mayúsculas y minúsculas, la abreviatura aparecerá en mayúsculas:
• La inicial de la abreviatura coincidirá (en el uso de mayúsculas y minúsculas) con la inicial de la palabra original.
• Las letras restantes de la abreviatura coincidirán (en el uso de mayúsculas y minúsculas) con la segunda letra de la palabra original.

Este archivo es una lista de palabras significativas, como "urgente" o "inmediatamente". Cuando @Abstract calcula la significación del texto, considera prioritarias las palabras incluidas en esta lista. Por ejemplo:

cliente

jefe

chocolate

Este archivo es una lista de las palabras que nunca son significativas, como "el", "y", y "de". Cuando @Abstract calcula la significación del texto, considera como no significativas todas y cada una de las palabras incluidas en esta lista. Por ejemplo:

el

y

de

Este archivo es una lista de las palabras que suelen usarse en los encabezados de correo, como Subject, From y To. Para que @Abstract considere un bloque como un encabezado de correo, debe comenzar por una de las palabras especificadas en este archivo, y ésta debe ir seguida de un signo de dos puntos y un espacio. Si desea que los encabezados de correo se consideren significativos, incluya un asterisco detrás de la palabra. Por ejemplo:

Subject*

From

Método Abstract de la clase NotesItem de LotusScript

Método abstractText de la clase Item de Java

Método GetFormattedText de la clase NotesRichTextItem de LotusScript

Método getFormattedText de la clase RichTextItem de Java

Ejemplo
Véase también

"Revealing the hidden secrets of hide-when" en Lotus Developer Domain
"Displaying contents of rich text fields in a view" en Tips de Lotus Developer Domain
Rich text fields