4D Internet Commands v14

Formato dos parâmetros

Página Inicial

 
4D Internet Commands v14
Formato dos parâmetros

Formato dos parâmetros  


 

 

As descrições a continuação oferecem detalhes sobre o significado e o formato dos parâmetros mais utilizados neste manual.

ParâmetroTipoDescrição
nomeServidorCadeiaNome do servidor (Ex: "www.nomedaempresa.com")
ou Endereço IP (Ej: "204.118.90.2")
ip_InteiroLongoInteiro longoReferencia de um endereço IP em forma de inteiro longo
endereçoEmailTextoEx: "jsmith@4d.com"
listaEndereçosTextoEx: "jsmith@4d.com, jdupont@4d.fr" or
"jsmith@4d.com"+Char(13)+"jdupont@4d.fr"
viaLocalTexto- Documento
Mac: "My Hard Drive:4DDB:SalesDB:Report"
Win: "C:\MyDrive\4DDB\SalesDB\Report.txt"
- Diretório
Mac: "My Hard Drive:CoolStuff:" (Note o ":" final)
Win: "C:\MyDrive\CoolStuff\"
viaServidorText- Documento
"/usr/jsmith/reports/salesreport.txt"
- Diretório
"/usr/jsmith/reports/"(Note trailing "/")
tcp_IDInteiro longoReferencia de uma sessão TCP aberta
smtp_IDInteiro longoReferencia de uma nova mensagem
pop3_IDInteiro longoReferencia de uma sessão POP3 aberta
imap_IDInteiro longoReferencia de uma conexão IMAP aberta
ftp_IDInteiro longoReferencia de uma sessão FTP aberta
udp_IDInteiro longoReferencia de uma sessão UDP
ResultadoInteiroCódigo de erro

O parâmetro nomeServidor é o nome ou o endereço IP do servidor local (HostName), por exemplo "dns.4d.com" ou "204.118.90.2". Os nomes de servidores se convertem por meio de um sistema de nomes de domínio. Os nomes de domínios por padrão (primários) e secundários  normalmente se definem no painel de controle do driver TCP/IP instalado. Todo comando de Internet 4D necessita um nomeServidor como parâmetro aceitando seu nome ("www.4d.com") ou seu endereço IP ("204.118.90.2") . O formato "nome" sempre é preferível, já que protege a aplicação de efeitos nocivos devidos as mudanças de hardware em lugares remotos.

Os nomes dos servidores podem se resolver via os métodos descritos anteriormente aplicados a um endereço IP. As fórmulas matemáticas podem então se aplicar aos endereços IP para converter eles em inteiros longos únicos. Os comandos NET_NameToAddr e NET_AddrToName automatizam esta conversão. Este valor inteiro longo é designado como ip_InteiroLongo nesta documentação. Este valor só é utilizado em circunstâncias especiais pelos desenvolvedores que estabelecem comunicação TCP direta. Alguns desenvolvedores também preferem armazenar o valor inteiro longo de um nome de domínio para conservar o espaço em disco comparado com sua cadeia equivalente. No entanto, por razões de compatibilidade com IPV6, 4D não aconselha aos desenvolvedores utilizar esta funcionalidade.

O parâmetro endereçoEmail é uma especificação completa de email no formato "nome_usuario@nome_dominio". Neste documento, endereçoEmail se refere a um só endereço de correio eletrônico. Todo parâmetro 4D Internet Commands que possa tomar mais de um endereço especificará endereçoEmail. Se um parâmetro tem endereçoEmail como seu único tipo, pode tomar um e só um endereço de correio eletrônico. O formato de endereçoEmail deve ser uma referencia completa que contenha tanto o nome de usuário e como o nome de domínio:

  • "Felix Unger" <felix@pristine.com>
  • oscar@slobs.com (Oscar Madison)

O parâmetro listaEndereços contém um ou mais endereços eletrônicos no formato de endereçoEmail, separadas por vírgula ou um retorno de carro. A delimitação por retorno de carro é útil para oferecer aos usuários uma área de texto que permita introduzir ou colar vários endereços. Os seguintes três exemplos geram um valor $listaEndereços válido:

 $AddressList:="jsmith@4d.com"
 $AddressList:="jsmith@4d.com,scott@4d.com,marcel@4d.fr"
 For($i;1;Size of array(aAddresses))
    $AddressList:=$AddressList+aAddresses{$i}+Char(13)
 End for
 

O parâmetro viaLocal indica a localização de um arquivo ou de um diretório no ordenador do usuário (Mac ou Windows).

Em um Macintosh, os elementos ao interior das pastas estão separados pelos caracteres "dois pontos" (:). Por exemplo, o arquivo "Meu relatório" na pasta "Relatórios" no disco duro "Meu disco duro" será como via de acesso "Meu disco duro:Relatórios:Meu relatório". Uma especificação de diretório em um Macintosh deve terminar com um caractere "dois pontos". Por exemplo, se quer colocar um novo relatório na pasta indicada anteriormente, deve passar a cadeia "Meu disco duro:Relatórios:". A decisão de fazer referencia a um nome de arquivo ou de diretório está relacionada com o contexto do comando.

Em Windows, o princípio utilizado é idêntico, a exceção de que uma barra oblíqua inversa "\" se utiliza no lugar de "dois pontos".

Nota: Com o protocolo FTP, os comandos Internet de 4D não permitem trabalhar com arquivos cujo nomes tem mais de 31 caracteres (ver Transferência de arquivos, Apresentação ).

A viaServidor é a localização de um arquivo ou de um diretório em um ordenador que funciona sob o sistema operativo Unix. No entorno Unix, os diretórios estão separados por barras oblíquas ("/"). Por exemplo, o arquivo "relatório.txt" no diretório "relatórios" do diretório "4D" será designado por "/4D/relatórios/relatório.txt". A via de acesso de um diretório deve terminar com um caractere "/". Note que uma via de acesso completa começa por uma barra oblíqua "/" que representa a raiz do volume.

Nota: com o protocolo FTP, os comandos Internet de 4D trabalham com arquivos cujos nomes tem um tamanho limitado. Para mais informação, consulte a seção Transferência de arquivos, Apresentação ).

Ao longo de cada seção de 4D Internet Commands, se faz referencia a um número "ID" na maioria dos comandos. Cada conjunto de funções de comunicação estabelecerão sua própria "sessão", representada por um número inteiro longo "ID". Os comandos posteriores relacionados com a sessão aberta usarão este valor para dirigir seus efeitos pelo canal adequado.

Os números "ID" obtidos em cada seção (SMTP, POP3, IMAP, FTP, TCP, UDP), não podem passar como valores as diferentes seções. No entanto, para maior flexibilidade, 4D Internet Commands lhe permite passar uma referencia de conexão POP3, IMAP ou FTP diretamente a comandos TCP de baixo nível e vice-versa. Para obter mais informação, consulte a seção Low Level Routines, Overview.

Referencia de sessãoAberta porFechada por
tcp_IDTCP_Open or TCP_ListenTCP_Close
smtp_IDSMTP_NewSMTP_Clear
pop3_IDPOP3_LoginPOP3_Logout or POP3_VerifyID
imap_IDIMAP_LoginIMAP_Logout or IMAP_VerifyID
ftp_IDFTP_LoginFTP_Logout or FTP_VerifyID
udp_IDUDP_NewUDP_Delete

Todos os comandos de Internet  4D (com exceção de IT_ErrorText e IT_Version) devolvem um valor inteiro como resultado da função. Este inteiro contém todo número de erro que o comando deva transmitir de novo ao banco de dados 4D. Se um comando se executa corretamente, se devolve um zero. Caso contrário, se devolve um código de erro. Para obter mais informação sobre os códigos de erro de 4D Internet Commands, consulte Apêndice C, Códigos de erro de 4D Internet Commands.

 
PROPRIEDADES 

Produto: 4D Internet Commands
Tema: 4D Internet Commands

 
ARTICLE USAGE

4D Internet Commands ( 4D Internet Commands v11.4)
4D Internet Commands ( 4D v13.2)
4D Internet Commands ( 4D Internet Commands v12.1)
4D Internet Commands ( 4D Internet Commands v14 R2)
4D Internet Commands ( 4D Internet Commands v14)
4D Internet Commands ( 4D Internet Commands v14 R3)

Parent of : Formato dos parâmetros ( 4D Internet Commands v14 R4)