Este é o site histórico da documentação 4D. As documentações estão sendo movidas progressivamente para developer.4d.com
POP3_BoxInfo
Receiving Mail, Overview
Os comandos POP3 permitem seu banco de dados recuperar mensagens de um servidor de correio POP3. Os 4D internet commands são compatíveis com MIME e podem reconhecer e extrair as mensagens com vários adjuntos.
Os comandos POP3 se dividem em duas seções, "IC POP3 Review Mail" e "IC Downloaded Mail", que correspondem aos dois modos de leitura do e-mail. Ao ler o correio desde um servidor POP3, as mensagens (ou informação sobre as mensagens) podem importar nas estruturas 4D (variáveis, campos, arrays) ou ser baixada no disco. Esta seção descreve as possibilidades oferecidas por 4D Internet Commands para ler as mensagens desde um servidor POP3 em 4D.
O tamanho dos arquivos a baixar determina o uso de um modo ou outro. Por exemplo, um só e-mail que contém um arquivo adjunto de 5 MB pode facilmente superar a capacidade de armazenamento do banco de dados. A única estrutura 4D capaz de armazenar este tamanho é uma imagem ou um campo BLOB, mas a conversão de uma mensagem ou de um arquivo adjunto a este formato geralmente é ineficaz como as mensagens cliente devem utilizar grandes recursos de memória para acessar à imagem ou ao BLOB. Para resolver este problema, esta seção tem um comando POP3_Download que traz uma mensagem do servidor POP3 ao disco local do usuário. Uma vez importado ao disco, a seção "IC Downloaded Mail" detalha os comandos que se utilizam para manipular arquivos locais.
Para o uso dos comandos POP3, é importante entender completamente os parâmetros numMsg e IDunico. numMsg é o número de uma mensagem na caixa de correio no momento que se executa o comando POP3_Login. Uma vez realizada a conexão, as mensagens na caixa de correio são numeradas do 1 até o número total de elementos na caixa de correio. Os números se designam em função da ordem na qual as mensagens foram recebidas na caixa de correio, sendo 1 o mais antigo. Os números assinalados às mensagens somente são válidos durante o período entre POP3_Login e POP3_Logout.
No momento da execução de POP3_Logout, toda mensagem marcada para eliminação será eliminada. Quando o usuário inicia sessão de novo no servidor, as mensagens presentes na caixa de correio se numeram de novo do 1 a X. Por exemplo, se há 10 mensagens na caixa de correio e as mensagens numeradas do 1 ao 5 se eliminam, as mensagens do 6 ao 10 passarão a ser do 1 ao 5, a próxima vez que o usuário inicie sessão na caixa de correio.
Para ilustrar este funcionamento,vamos supor que se conecta a um servidor POP3 e obtém a seguinte lista de mensagens:
| # | IDunico | Data | De | Assunto |
| 1 | bd573a4dbd573a4d | 1 Julh 1998 … | jimw@acme.com | Clientes potenciais... |
| 2 | bd574dc7bd574dc7 | 1 Julh 1998 … | frank@acme.com | Ordem de licença em site |
| 3 | bd575f06bd575f06 | 3 Julh 1998 … | joe@acme.com | Alguém quer ir almoçar? |
| 4 | bd5761d4bd5761d4 | 4 Julh 1998 … | kelly@acme.com | Sua esposa chamou... |
| 5 | bd577dc7db577dc5 | 4 Julh 1995 … | track@fedex.com | Seguimento FedEx |
Durante a sessão elimina as mensagens 3 e 4. Ao fechar a sessão suas solicitações de eliminação são executadas. Quando retorna ao servidor, a lista de mensagens será renumerada assim:
| # | IDunico | Data | De | Assunto |
| 1 | bd573a4dbd573a4d | 1 Julh 1998 … | jimw@acme.com | Clientes potenciais... |
| 2 | bd574dc7bd574dc7 | 1 Julh 1998 … | frank@acme.com | Orden de licença em site |
| 3 | bd577dc7db577dc5 | 4 Julh 1995 … | track@fedex.com | Seguimento FedEx[ |
numMsg não é um valor estático com relação a uma mensagem específica e mudará de uma sessão a outra depende de sua relação com outros mensagens na caixa de correio no momento da abertura da sessão. O IDunico no entanto é um número único assinalado à mensagem quando é recebido pelo servidor. Este número se calcula com a hora e a data nas que é recebida a mensagem e um é valor assinalado pelo servidor POP3. Infelizmente, os servidores POP3 não utilizam o IDunico como referencia principal para suas mensagens. Ao utilizar os comandos POP3 terá que especificar o numMsg como referencia para as mensagens no servidor. Os desenvolvedores devem ter cuidado ao desenvolver soluções que referenciam as mensagens no banco de dados, deixando o corpo da mensagem no servidor.
Nota: Para maior flexibilidade, os comandos Internet de 4D permitem passar diretamente uma referencia de conexão POP3, IMAP ou FTP aos comandos de nível baixo TCP e vice-versa. Para mais informação, consulte a seção .
Produto: 4D
Tema: IC POP3 Review Mail (deprecated)
4D Internet Commands ( 4D v20)
