El conjunto de comandos IMAP4 le permite a su base de datos acceder y manipular mensajes de correo electrónico en un servidor de correo IMAP y recuperar mensajes electrónicos de su servidor IMAP. Los comandos IMAP son compatibles con el protocolo Internet Message Access, versión 4 revisión 1 (IMAP4 rev1), definido por RFC 2060. IMAP4 rev1 permite la gestión de carpetas de mensajes a distancia, llamados "buzones", de la misma manera que los buzones locales.

Los comandos IMAP incluyen operaciones para crear, borrar y renombrar buzones, verificar la presencia de nuevos mensajes, eliminar permanentemente mensajes, asignar y borrar marcadores (flags) mensajes de búsqueda; y recuperar partes de mensajes.

Conexión: se refiere a la secuencia completa de interacciones cliente/servidor IMAP, desde la conexión de red inicial (IMAP_Login) hasta el final de la conexión (IMAP_Logout).

Sesión: se refiere a la secuencia de interacciones cliente/servidor IMAP desde el momento en que se selecciona un buzón de correo (IMAP_SetCurrentMB) hasta el final de la conexión (IMAP_SetCurrentMB, IMAP_CloseCurrentMB) o hasta que se cierra la conexión (IMAP_Logout).

• Inicialización de la comunicación TCP: IT_MacTCPInit (el comando IT_PPPConnect debe llamarse antes de IT_MacTCPInit en el caso de una conexión PPP).
• Apertura de una conexión: IMAP_Login
• Gestión de buzones: listar, crear, eliminar, renombrar, suscribirse o darse de baja, obtener el estado de los parámetros.
• Apertura de una sesión al definir el buzón de trabajo actual: IMAP_SetCurrentMB.
  Una vez se establece el buzón actual, puede administrar los mensajes que contiene.
• Gestión de mensajes: listar, descargar o eliminar mensajes; listar los marcadores de los mensajes, modificar los marcadores de los mensajes, copia a otro buzón, buscar y recuperar partes de mensajes sin descarga, etc.
• Una vez que haya terminado de trabajar con los mensajes del buzón actual, puede cerrar la sesión o abrir una nueva definiendo otro buzón actual. En todos los casos, el servidor IMAP actualiza de forma permanente sus mensajes. Por ejemplo, se eliminarán todos los mensajes con el marcador \Deleted.
• Una vez haya terminado, debe cerrar la sesión. Cierre de una conexión: IMAP_Logout.
• Otras operaciones: definición de las preferencias, capacidad, verificación de la conexión y reinicialización del temporizador de inactividad antes de cerrar la sesión automáticamente en el servidor IMAP.

Los comandos IMAP se dividen en dos secciones: IC IMAP Review Mail (intercambios con el servidor IMAP) e IC Downloaded Mail (tratamiento local). Estos comandos se han separado para mostrar los diferentes métodos de lectura de correo electrónico. Al leer el correo electrónico desde un servidor IMAP, los mensajes (o información de los mensajes) pueden importarse en las estructuras 4D (variables, campos, arrays) o descargarse en el disco. Esta sección describe las posibilidades ofrecidas por 4D Internet Commands para leer los mensajes desde un servidor IMAP.

Una vez importado al disco, la sección "IC Downloaded Mail" detalla los comandos que se utilizan para manipular archivos locales.

Un buzón de correo IMAP puede ser manejado como una carpeta y puede contener archivos y/o subcarpetas. Del mismo modo, un buzón de correo puede contener mensajes y/o sub buzones.

Un buzón se accede utilizando su nombre jerárquico completo. Según el servidor IMAP, cada nivel jerárquico está separado por un separador de jerarquía (un separador se devuelve utilizando el comando IMAP_ListMBs).

Puede utilizar el separador para crear buzones hijos y para buscar los niveles más altos o más bajos de la jerarquía de nombres. Todos los hijos de un nivel jerárquico principal utilizan el mismo carácter separador

Nota: los mensajes sólo se pueden administrar una vez se ha seleccionado el buzón de trabajo actual (IMAP_SetCurrentMB).

Cada cuenta puede tener uno o varios buzones.

Los nombres de buzones tienen en cuenta las mayúsculas y minúsculas, por lo tanto, no se pueden crear dos buzones con nombres que difieran sólo por tener mayúsculas o minúsculas.

El buzón INBOX es un caso particular: existe en todas las cuentas y se utiliza para almacenar los mensajes recibidos. El INBOX se crea automáticamente cada vez que una cuenta se configura.

Un usuario no puede eliminar el INBOX pero sí puede cambiar su nombre. Si decide cambiar el nombre, se crea inmediatamente un nuevo INBOX vacío. El nombre INBOX no tiene en cuenta las mayúsculas y minúsculas.

Algunos atributos del buzón, como el número total de mensajes o de mensajes nuevos, pueden obtenerse, incluso si el buzón no es el actual.

Para el uso de los comandos IMAP, es importante entender completamente los parámetros numMsg e IDunico.

numMsg es el número de un mensaje en el buzón en el momento que se ejecuta el comando IMAP_SetCurrentMB.

Una vez seleccionado un buzón actual, los mensajes en el buzón se numeran del 1 hasta el número total de elementos en el buzón. Los números se asignan en función del orden en que los mensajes fueron recibidos en el buzón, siendo 1 el más antiguo. Los números asignados a los mensajes sólo son válidos desde el momento de seleccionar el buzón de trabajo actual (IMAP_SetCurrentMB) hasta que se cierra (IMAP_CloseCurrentMB, IMAP_SetCurrentMB o IMAP_Logout).

Cuando el buzón se cierra, todos los mensajes marcados para eliminación se borran

Cuando el usuario inicia sesión de nuevo en el servidor IMAP, los mensajes presentes en el buzón se numeran de nuevo del 1 al X. Por ejemplo, si hay 10 mensajes en el buzón y si los mensajes del 1 al 5 se eliminan cuando el usuario vuelve a abrir el buzón, los antiguos mensajes 6-10 se han vuelto los mensajes del 1 al 5.

Por ejemplo, veamos el siguiente ejemplo: conéctese a un servidor IMAP y obtenga la siguiente lista de mensajes:

Durante esta sesión, usted borra los mensajes 3 y 4. Al cerrar el buzón de trabajo actual, se realizan las eliminaciones. Cuando vuelva al servidor, la lista de mensajes se reenumerará así:

numMsg no es un valor estático y pueden variar de una sesión a otra. Cambiará en relación con otros mensajes en el buzón en el momento en que se selecciona el buzón de trabajo actual.

Por el contrario, IDunico es un número único asignado al mensaje por el servidor IMAP en un orden estrictamente ascendente. A medida que cada mensaje se agrega al buzón, se le asigna un identificador más alto que el del mensaje previamente añadido.

Desafortunadamente, los servidores IMAP no utilizan el IDunico como referencia principal para sus mensajes. Al utilizar los comandos IMAP tendrá que especificar el numMsg como referencia para los mensajes en el servidor. Los desarrolladores deben tener cuidado al desarrollar soluciones que referencian los mensajes en la base de datos, dejando el cuerpo del mensaje en el servidor.

Como la característica principal de IMAP es la interoperabilidad, la recomendación final es “Probar TODO.” Es recomendable, probar el cliente con todos los servidores en los que tiene cuenta.

Para mayor información, consulte los siguientes sitios:

• IMAP Products and Services: http://www.imap.org/products.html
• MailConnect: http://www.imc.org/imc-mailconnect.

Notas:

• Servidores IMAP y POP3: en el caso de los servidores IMAP, no declare msgID de la misma forma, dado que msgID es un entero largo.
• La eliminación no funciona exactamente de la misma manera entre los protocolos POP3 e IMAP. IMAP_Delete elimina los mensajes en tiempo real. Para obtener el mismo resultado que POP3_Delete, use IMAP_SetFlags para establecer el marcador \Deleted; para obtener el mismo resultado que POP3_Reset, use IMAP_SetFlags para recuperar los marcadores \Deleted.
• Para una mayor flexibilidad, los comandos de Internet de 4D pueden omitir una referencia a la conexión IMAP controles de bajo nivel TCP y viceversa. Para obtener más información, consulte la sección Rutinas de bajo nivel, Presentación.