@MailSend se puede utilizar de dos formas:

• Cuando se utiliza sin parámetros, @MailSend envía el documento actual (el que se está procesando en el momento en que se está evaluando la función @) al destinatario especificado en el campo SendTo del documento. Para que @MailSend funcione correctamente, en el documento debe haber un campo con el nombre SendTo (en inglés).
• Cuando se utiliza con uno o varios parámetros, @MailSend crea un nuevo mensaje de correo partiendo de la información suministrada a través de los parámetros y lo envía a los destinatarios especificados en los parámetros Para, cc y cco.

@MailSend
@MailSend( destinatarios ; cc ; cco ; asunto ; comentario ; campos-texto ; [ indicadores ] )

Parámetros

destinatarios

Texto o lista de texto. Los destinatarios principales del mensaje de correo.

Texto o lista de texto. Opcional. Los destinatarios a los que se desea enviar una copia del mensaje de correo.

Texto o lista de texto. Opcional. Los destinatarios a los que se desea enviar una copia oculta del mensaje de correo.

Texto. Opcional. Este parámetro equivale al campo Subject (Asunto) de un mensaje de correo. La descripción se visualizará en la columna Asunto de las vistas que componen las bases de datos de correo de los destinatarios.

Texto. Opcional. El nombre de un campo, o las frases que se incluirán al principio del texto del mensaje.

Texto. Los nombres de uno o varios campos del documento actual que se incluirán en el mensaje de correo. Los campos pueden ser del tipo texto o lista de texto y se incluyen en el mensaje en el orden en que los especifique. (Puede almacenar @Text de un campo numérico en una variable y usar el nombre de la variable como un nombre de campo). Encierre cada uno de los nombres entre comillas. Si desea incluir una lista con varios campos, utilice el formato de listas: "descripción":"asuntos":"resolución". Si guarda el nombre del campo en una variable, omita las comillas.

Cuando utilice el indicador [IncludeDocLink] (que se describe más adelante) para incluir en el mensaje un vínculo al documento actual, deberá definir al parámetro bodyFields como vacío (""). Si Notes/Domino no puede localizar un campo por su nombre, utiliza en su lugar la cadena de texto especificada entre comillas.

Palabra clave. Uno o varios indicadores que indican la prioridad y el nivel de seguridad del mensaje. Si especifica varios indicadores use el formato de las listas en Notes: [SIGN]:[PRIORITYHIGH]:[RETURNRECEIPT]. No los encierre entre comillas; encierre cada uno de ellos entre corchetes.

Los indicadores disponibles son:

[SIGN]

Firma electrónicamente el mensaje al enviarlo; para ello hace uso de la información del archivo ID del usuario. Si no incluye este indicador, el mensaje no irá firmado. No es posible utilizar este indicador en las aplicaciones para Web.

[ENCRYPT]

Codifica el documento haciendo uso de la clave pública del destinatario, de modo que sólo pueda leerlo el destinatario cuya clave privada coincida con la clave pública. Si no incluye este indicador, el mensaje no irá codificado. No es posible utilizar este indicador en las aplicaciones para Web.

[PRIORITYHIGH]

Comienza inmediatamente la transferencia del mensaje hacia el primer servidor en la ruta hacia el destinatario (de acuerdo con los documentos de conexión y de servidor existentes en el Directorio de Domino). Si es preciso realizar una llamada telefónica para transferir el mensaje, ésta se realiza inmediatamente, independientemente de las conexiones programadas en el documento de conexión remota del Directorio de Domino. Si no incluye este indicador, el mensaje se enviará con prioridad Normal.

[PRIORITYNORMAL]

Transfiere el mensaje al primer servidor en la ruta hacia el destinatario de acuerdo con lo programado en los documentos de conexión del Directorio de Domino. Si tanto el servidor de correo del destinatario como el del remitente están situados en la misma red de Domino, la entrega se realiza de inmediato. Si no incluye este indicador, el mensaje se enviará con prioridad Normal.

[PRIORITYLOW]

Si el servidor de correo del destinatario se encuentra situado en una red de Domino distinta de la del remitente, la entrega se realiza en horario nocturno. Si tanto el servidor de correo del destinatario como el del remitente están situados en la misma red de Domino, la entrega se realiza de inmediato. La transferencia del correo de poca prioridad también puede controlarse mediante una variable de entorno de Notes/Domino denominada MailLowPriorityTime=x, donde x representa un número del 0 al 23. Cuando se sitúa en el archivo NOTES.INI, esta variable indica al servidor cuándo debe realizar la transferencia del correo de poca prioridad. Si no incluye este indicador, el mensaje se enviará con prioridad Normal.

[RETURNRECEIPT]

Envía un informe al remitente cada vez que uno de los destinatarios abre el mensaje. Si no incluye este indicador, Notes no enviará informes sobre la recepción.

[DELIVERYREPORTCONFIRMED]

Envía al remitente un informe para indicarle si el mensaje se entregó o no (en el archivo de correo del destinatario). De forma predeterminada, se utiliza el informe de confirmación de la entrega general, que sólo informa al remitente cuando se produce un fallo en la entrega del mensaje.

[INCLUDEDOCLINK]

Incluye un vínculo de documento con destino al documento que se encontraba abierto o seleccionado en el momento de emplear @MailSend. Para que se incluya el vínculo de documento en el mensaje de correo es imprescindible incluir este indicador. Debe guardarse un nuevo documento.

Utilice @MailSend en agentes, acciones de formulario, eventos de formulario, acciones de vista y en botones de barras de herramientas. Le resultará especialmente útil con agentes programados para enviar correo cada cierto tiempo; por ejemplo, para enviar recordatorios sobre una reunión departamental. Para que el agente programado funcione correctamente, una vista de la base de datos debe estar seleccionada como vista predeterminada cuando la base de datos se abra por primera vez. @MailSend no funciona en fórmulas de columna, de selección, de ocultación ni de título de ventana.

Si el archivo NOTES.INI del usuario incluye esta sentencia:

NoExternalApps=1

Notes desactivará cualquier fórmula que incluya @MailSend. El usuario no verá ningún mensaje de error; simplemente no se ejecutará la fórmula.

Envío de campos de texto enriquecido

Se puede especificar un campo de texto enriquecido como uno de los campos-texto sólo en las fórmulas de agentes.

Campos del documento relacionados con el correo

Cuando se utiliza @MailSend sin parámetros, el documento puede contener uno o varios campos relacionados con el correo; si es así, dichos campos se utilizarán durante el envío del documento.

• Si el documento contiene los campos CopyTo o BlindCopyTo, la función también enviará el documento a los destinatarios especificados en dichos campos.
• Si el documento contiene los campos DeliveryPriority, DeliveryReport o ReturnReceipt, la función los utilizará para controlar la prioridad de la entrega y si han de enviarse o no al remitente informes sobre la entrega y sobre la recogida, tal y como se hace cuando se utiliza el comando Acciones - Enviar documento. Si no contiene ninguno de estos campos, la función utiliza los valores predeterminados: prioridad normal, y sin informes sobre la entrega y sobre la recogida respectivamente.

Método Send de la clase NotesDocument de LotusScript

Método Send de la clase NotesUIDocument de LotusScript

Método send de la clase Document de Java

Ejemplo
Véase también

Accessing the current document in the formula language
Funciones @ afectadas por la Lista de control de ejecución
MailAddress - @Command
MailComposeMemo - @Command
MailSend - @Command
"Taking your Domino applications to the Web" en Lotus Developer Domain