Introdução. Apresentação Arquitetura de 4D Server

Transcrição

1 Manual de 4D Server Introdução 4D Server em 10 minutos Uso de 4D Server Janela de administração de 4D Server Métodos banco de dados 4D Server Uso de um 4D Remoto 4D Server e a linguagem 4D

2 Introdução Apresentação Arquitetura de 4D Server

3 Apresentação 4D Server é o servidor de dados e de aplicações de multiplataforma de 4D. Com o 4D Server, você pode criar e usar banco de dados multiusuários e aplicações personalizados en arquitetura cliente/servidor. A arquitetura cliente/servidor independentemente da plataforma de 4D Server administra pedidos para clientes 4D em Windows e Macintosh. 4D Server inclui desenvolvimento de ferramentas e segurança de dados, escalabilidade completa e conectividade para todas as opções de sistemas da empresa. A arquitetura de 4D Server está totalmente integrada: o cliente e o servidor usam um aplicativo único 4D e os desenvolvedores não precisam projetar aplicativos específicos para o servidor e os clientes. Além disso, o 4D Server é um servidor "zero administração", é fácil de instalar, usar, administrar e é extremamente rentável. 4D Server fecha a lacuna entre sistemas baseados no compartilhamento de arquivos para nível baixo, lento e pouco eficaz e os mais avançados sistemas de RDBMS baseado em SQL que apesar de poderosos são complexos para implantar e evoluir com o tempo. Um aplicativo 4D Server pode ser facilmente integrado aos sistemas de informação existentes nas empresas (tais como Oracle, Sybase ou qualquer servidor compatível com ODBC). 4D Server direciona as necessidades dos grupos de trabalho em empresas de todos os tamanhos. Arquitetura cliente/servidor integrado Um 4D sistema Server funciona com uma aplicação exclusiva para o cliente e o servidor. O software de cliente e o aplicativo de servidor são dois lados do mesmo produto, 4D. A aplicação 4D Server está dividida em duas partes: 4D Server e 4D em modo remoto, que formam a arquitetura cliente/servidor. A parte 4D Server reside na máquina do servidor e armazena e gerencia o banco de dados no servidor e permite aos usuários manipular a base de seus próprios computadores (clientes). A aplicação 4D reside em cada máquina cliente e pode ser usada no modo local ou remoto. Em modo local, os usuários podem trabalhar com um banco de dados ou uma aplicação 4D armazenado localmente em sua máquina. No modo remoto, os usuários acessam à base no servidor e executam operações de banco de dados, como adição de registros, gerar relatórios e modificar o design da base. Tudo pode ser feito com o 4D em modo local utilizando o 4D Server e 4D em modo remoto. Não é necessário nenhum middleware ou desenvolvimentos adicionais para operar em um ambiente cliente/servidor. 4D e 4D Server compartilham as mesmas ferramentas de interface, a mesma linguagem e o mesmo sistema de gerenciamento de informações. Uma aplicação local independente facilmente se transforma em um configuração cliente/servidor para o grupo de trabalho. Da mesma forma, uma aplicação criada com 4D Server passa automaticamente a uma aplicação independente com 4D em modo local. Servidor de dados e de aplicações Zero Administração 4D Server é como 4D, centrado no usuário. 4D Server é um sistema Plug and Play (PNP) completo.

4 Janela de administração de 4D Server Administração centralizada em linha, gráfica: A janela de administração de 4D Server exibe automaticamente informações importantes relacionadas com a atividade do aplicativo: total memória atribuída para o 4D Server, os dados em cachê, número e nome de usuários conectados, número de processos e o estado de cada um, monitoramento de backups e solicitações e atividade dos servidores. Auto configurável e escalável: 4D Server está desenhado para integrar novos protocolos, clientes e plug-ins sem que seja necessário reconfigurar ou fazer reengenharia. Atualização automática e dinâmica das equipes clientes, controle de versões: Todas as equipes de 4D conectadas recebem automaticamente e dinamicamente os novos elementos de uma aplicação cada que a base evolui o que um plugin ou componente de plug-in é adicionado, excluído ou modificado. Além de se há criado uma aplicação de cliente/servidor personalizada, é possível baixar automaticamente as novas versões das aplicações 4D client executável quando a aplicação 4D Server é atualizada. Conexões automáticas assíncronas via o protocolo estandarte TCP/IP: 4D Server e 4D se comunicam de maneira transparente utilizando o protocolo TCP/IP sem importar a plataforma do cliente e do servidor. Como o protocolo TCP/IP está integrado em todos os sistemas operativos, seu uso não requer nenhuma instalação adicional. Gestão simultânea das sessões e dos contextos das conexões 4D, SQL e HTTP: 4D Server cria e mantém automaticamente um ambiente de trabalho atual para cada combinação tabela/processo/usuário. Esta arquitetura baseada nas sessões permitem a cada processo usuário manipular os dados independentemente e simultaneamente. O servidor SQL de 4D Server lida automaticamente as petições SQL internas ou externas. O servidor HTTP de 4D Server responde as petições HTTP e eventualmente as petições SOAP. Bloqueio automático de registros: 4D Server oferece bloqueio e liberação automática dos registros, evitando problemas comuns associados à modificação dos registros em uso. O bloqueio de registros também elimina problemas associados com o bloqueio de páginas os arquivos que se encontram em outros sistemas. Sistema de mensagens usuário integrada: 4D Server oferece todos os aspectos de interface usuário que respondem as necessidades dos entornos de desenvolvimento integrados modernos. Por exemplo, 4D Server pode informar aos clientes das ações de administração que se estão levando a cabo, tais como desconexões e backups. Métodos de inicio e de desconexão automatizados: 4D Server chama automaticamente vários métodos base que respondem a aspectos específicos: On Server Startup, On Server Shutdown, On Server Open Connection, On Server Close Connection, e On Web Connection. Método banco de dados On Server Startup pode inicializar e carregar automaticamente todos os objetos que se utilizarão durante o resto da sessão.

5 Um conjunto de funções inigualáveis Além das funções de 4D, 4D Server oferece as seguintes características: Gestão de dados em ambiente multiusuário: Vários usuários simultaneamente podem executar operações de banco de dados na mesma tabela ou tabelas diferentes, como adicionar, modificar, excluir, pesquisar, classificar e imprimir registros. A integridade dos dados é assegurada por um sistema de bloqueio interno de registros. Desenvolvimento de multiusuário: Vários usuários podem desenvolver e projetar uma base ao mesmo tempo. Por exemplo, membros de uma equipe podem, simultaneamente, modificar os atributos de uma tabela, criar e modificar formas e métodos. A integridade da estrutura está protegida por um sistema interno de objetos de bloqueio. Arquitetura independente da plataforma cliente /servidor: A arquitetura gerencia o desempenho de banco de dados de forma idêntica para os clientes Macintosh e Windows. Incluindo plataformas desenvolvimento plataforma cruzada simultânea ou para operações de dados de entrada e modificação de dados para as equipes em diferentes ambientes materiais. Arquitetura de plug-ins Windows e Mac OS: A versão do Windows e a versão de Mac OS de 4D Server permite que você instale plug-ins Windows e Mac OS X ao mesmo tempo no computador servidor. Essa arquitetura simplifica a distribuição de plug-ins 4D independentemente da plataforma. Os plug-ins são tratadas com transparência por 4D e 4D Server, independentemente da plataforma que executam o cliente. Servidor HTTP integrado: Como 4D em modo local, 4D Server e cada 4D em modo remoto tem um motor HTTP que permite publicar as bases 4D na Web. Sua base de dados pode ser publicada diretamente na Web. Não necessita desenvolver um sistema de base de dados, um site web ou uma interface CGI entre eles. Sua base é seu site web. Também pode transformar toda equipe 4D remoto em um servidor web. Para maior informação sobre o motor web integrado de 4D Server e 4D, consulte a seção SORT ARRAY no manual Linguagem de 4D. Seguridade das conexões via SSL (Secured Socket Layer): Pode criptografar as conexões 4D Server. A arquitetura cliente/servidor clássica pode utilizar os serviços de criptografar SSL. Para maior informação, consulte a seção Criptografar conexões cliente-servidor. Triggers: Um trigger é um método associado a uma tabela. É uma das propriedades da tabela. Você não chama aos triggers; eles são chamados automaticamente pelo motor da base de dados cada vez que manipula os registros da tabela (adicionar, excluir e modificar). Com 4D Server, os triggers se executam na equipe servidor. Todo cliente, bem seja 4D ou uma aplicação conectada via ODBC, está sujeita as regras da base de dados controladas pelos triggers. Para maior informação sobre os triggers 4D, consulte a seção ARRAY REAL no manual Linguagem de 4D. Procedimentos armazenados: Pode criar métodos 4D que se executarão localmente em seu próprio processo na equipe servidor ou em vários equipes clientes. Utilizando a terminologia da indústria cliente/servidor estas funções se chamam procedimentos armazenados. No entanto, 4D Server oferece uma arquitetura que vai além do conceito estandarte dos procedimentos armazenados. Com 4D Server, um procedimento armazenado é em realidade um processo servidor (ou um processo cliente, ver a continuação) que executa o código de maneira assíncrona e independentemente de todos os outros processos executados nos equipes cliente o servidor. Em uma arquitetura cliente/servidor estandarte, um procedimento armazenado executa e devolve um resultado (de maneira síncrona ou assíncrona). Com 4D Server, pode iniciar um procedimento armazenado que se executa durante uma sessão cliente/servidor e que responde a demanda, as mensagens enviados pelos clientes. Simultaneamente, pode lançar outro procedimento armazenado que não interage com os clientes, mas que sincronize os dados com um servidor SQL ou com outro 4D Server, utilizando um plug-in de conectividade 4D ou ODBC. Não há limite (exceto hardware e memória) para o número de procedimentos armazenados que pode executar simultaneamente. Um procedimento armazenado se executa em seu próprio processo e portanto, como qualquer processo usuário, pode manter seu próprio contexto de base de dados (seleção atual). Adicionalmente, a linguagem 4D oferece comandos que permitem aos processos cliente ler e escrever as variáveis processo nos procedimentos armazenados (incluindo as variáveis BLOB), permitindo uma comunicação eficaz e flexível entre os clientes e os procedimentos armazenados. Utilizando procedimentos armazenados, pode adicionar novos serviços personalizados a 4D Server. Para maior informação consulte a seção Stored Procedures. Procedimentos armazenados executados em cliente: 4D Server permite, a partir de uma equipe cliente ou servidor, executar procedimentos armazenados em um ou várias equipes clientes. Portanto, pode otimizar a repartição de cargas de trabalho entre as equipes e o servidor, o construir aplicações utilizando as possibilidades de comunicação entre clientes. Para maior informação, consulte a seção Stored Procedures. Rota de acesso ao servidor: A rota de acesso a uma base de dados servidor pode ser guardada com uma senha de usuário. Esta funcionalidade permite a um usuário conectar-se a uma base de dados no servidor fazendo dobre clique simplesmente em um documento.4dlink. Para maior informação, consulte a seção Conexão a um banco de dados 4D Server. Registro como serviço: Em Windows, 4D Server pode ser lançado como um serviço. Sistema de backup integrado: Em Windows, 4D Server inclui um módulo completo de back-up de base de dados e de restauração. Este modulo permite fazer back up de uma base em uso, sem ter que sair da aplicação. Os back-ups podem ser lançados manual ou automaticamente, a intervalos regulares e sem intervenção do usuário. Em caso de um incidente, a restituição e/o reinício da base podem igualmente ser iniciado automaticamente.

6 Backup por espelho lógico: Em aplicações críticas, é possível estabelecer um sistema de backup por espelho lógico, o qual permite um reinicio instantâneo se ocorre um incidente na base operacional. Plug-ins de conectividade: Com los plug-ins de conectividade 4D tais como 4D ODBC Pro, 4D Server e 4D podem acessar diretamente as bases em mini ou grandes sistemas como ORACLE ou toda fonte de dados ODBC. A informação pode ser compartilhada de forma interativa entre estas bases. Além disso, 4D oferece um driver 4D Server ODBC que permite a todos clientes ODBC se conectar e trabalhar com 4D Server.

7 Arquitetura de 4D Server Com sua arquitetura cliente/servidor, 4D Server não só armazena e gerencia a base, também fornece serviços aos clientes. Esses serviços funcionam através de uma rede através de um sistema de solicitações e respostas. Para pesquisar um conjunto de linhas, por exemplo, um computador cliente envia uma solicitação para o servidor. Uma vez recebido o pedido, o servidor executa a pesquisa no local, ou seja, no computador do servidor, e quando ela termina retorna o resultado (registros encontrados). A arquitetura de 4D Server se baseia no modelo cliente/servidor. Por muitos anos, prevaleceu a arquitetura cliente/servidor, tornando-se no modelo mais eficiente em bancos de dados de multiusuários. O tipo de arquitetura cliente/servidor de 4D Server é semelhante à usada no mundo dos minicomputador. No entanto, 4D Server oferece duas importantes inovações: Uma interface intuitiva e gráfica, presente em todos os níveis da base Uma arquitetura integrada que oferece maior eficiência e velocidade Arquitetura de compartilhamento de arquivos Antes do aparecimento da arquitetura cliente/servidor, os sistemas multiusuários usavam como um modelo de arquitetura de rede o compartilhamento de arquivos. Neste modelo, todos os usuários compartilham os mesmos dados, mas o gerenciamento de dados não é controlado por um motor de base de dados central. Cada máquina cliente deve guardar uma cópia da estrutura do motor da base, enquanto o servidor é responsável pela gestão do software de compartilhamento de arquivos na rede. No modelo de compartilhamento de arquivos, cada estação de trabalho opera no local todas as ações de modificação de dados. Isso cria um tráfego significativo na rede, uma vez que cada solicitação consiste em várias comunicações através da rede. O diagrama a seguir é um exemplo de tráfego de rede gerado quando um usuário procura por pessoas de sobrenome "Gómez." Outra desvantagem do modelo do compartilhar de arquivos é a incapacidade de usar um cachê para conservar registros na memória. Se os registros são mantidos na memória, pode haver diferentes versões do mesmo registro armazenados na memória cachê, produzindo inconsistência nos dados. Portanto, cada vez que um usuário acessa um registro, deve ser baixado do servidor de arquivos. Isso produz um tráfego de rede e aumenta o tempo necessário para acessar os dados. A arquitetura cliente / servidor heterogênea A arquitetura cliente/servidor é amplamente utilizada no mundo dos minicomputador, para o gerenciamento de bancos de dados muito grandes, graças a sua eficiência e rapidez. Nesta arquitetura, o trabalho é dividido entre os clientes e o servidor para aumentar o desempenho. O servidor contém o motor central da base, que armazena e gerencia os dados. O mecanismo de base é o único software que acessa aos dados armazenados no disco rígido. Quando um cliente envia uma solicitação ao servidor, o servidor envia o resultado. O resultado pode ser de todos os tipos desde um simples registro para alterar até uma lista ordenada de registros. Geralmente, a maioria das arquiteturas cliente/servidor são chamadas arquiteturas heterogêneas, porque as aplicações frontais executadas nos computadores cliente e o motor do banco de dados executado no computador servidor são dois produtos diferentes. Nessa situação, um driver de banco de dados é necessário para servir de tradutor entre os clientes e o servidor. Para procurar um registro, por exemplo, um cliente envia uma solicitação para o servidor. Como a base é armazenada no servidor, o servidor executa o comando localmente no computador do servidor e envia o resultado para o cliente. A imagem a seguir mostra um exemplo de tráfego de rede gerado quando um usuário procura cada pessoa de apelido "Smith" e mostra o primeiro registro encontrado.

8 Este exemplo mostra duas diferenças maiores entre o compartimento de arquivos e a arquitetura cliente/servidor: A arquitetura cliente/servidor autoriza o uso de uma memória cachê: como o motor é o único software que acessa fisicamente aos dados, o servidor pode utilizar um cachê que conserva em memória os registros modificados até que escrevam no disco. Como os dados são enviados desde um lugar central, as máquinas clientes asseguram de receber sempre a última versão de um registro. Adicional ao controle de integridade dos dados assegura, o uso de um mecanismo de cachê central acelera as operações de base de dados substituindo os acessos ao disco por acesso à memória. Sobre o modelo de compartimento de arquivos, todos os acessos são de acesso de disco. As operações de base de dados de baixo nível se realizam no servidor: a arquitetura cliente/servidor oferece um aumento significativo na velocidade de execução, como a navegação de tabelas de índice e direções, localmente se executam no servidor, na velocidade da máquina. Com o compartimento de arquivos, as mesmas operações se tornam lentas pelas transferências de rede e as limitações da máquina cliente. Arquitetura cliente/servidor integrada de 4D Server Na maiorias das arquiteturas cliente/servidor, a aplicação cliente e a aplicação de servidor são dois produtos distintos, que precisam de uma camada de comunicação para entender uns aos outros. Com 4D Server, a arquitetura cliente/servidor é totalmente integrada. 4D Server e 4D são dois aplicativos que compartilham a mesma estrutura e se comunicam diretamente. Como 4D Server e 4D falam a mesma língua, não é necessário traduzir as solicitações. A divisão do trabalho entre o cliente e o servidor é transparente e automaticamente é gerenciada pelo 4D Server. A divisão do trabalho está organizada de tal maneira que um pedido está associado a uma resposta. Como você pode ver no diagrama anterior, o cliente é responsável de: Pedidos: o cliente 4D envia solicitações ao 4D Server. Essas solicitações podem ser construídas com a ajuda dos editores integrados, tais como o editor de pesquisas e o editor de tipos, usando a linguagem integrada de 4D ou através de SQL. 4D oferece editores em que os métodos podem ser criados e alterados. Também lida com os elementos dos métodos tais como as variáveis e arrays. Recepção de respostas: o cliente 4D recebe as respostas de 4D Server e atualiza o usuário através da interface de usuário (os diferentes registros são exibidos em um formulário, etc.). Por exemplo, se o cliente busca todos os registros com o sobrenome "Gomez", 4D recebe os registros de 4D Server e os mostra em um formulário. O servidor é responsável das seguintes tarefas: Gestão de acesso: 4D Server utiliza todas as conexões simultâneas e os processos criados pelos clientes. Esta gestão aproveita a arquitetura múltiplas tarefas de 4D Server. Objeto de estrutura e de dados: 4D Server guarda e administra todos os objetos de estrutura e de dados, incluindo

9 campos, registros, formulários, métodos, barras de menus e listas. Cachê: 4D Server mantém uma cachê com os registros também com os objetos de dados criados pelas máquinas clientes, tais como seleções e conjuntos. Operações de base de dados de nível baixo: 4D Server realiza operações de base de dados de nível baixo, tais como pesquisas e ordens, que implicam o uso de tabelas de índices e direções. Esta divisão do trabalho é extremamente eficaz graças à integração de 4D Server e 4D. A integração da arquitetura de 4D Server está presente em cada nível: A nível da petição: quando 4D envia a 4D Server uma petição, tal como uma pesquisa ou uma ordem, 4D envia uma descrição da operação de procura ou ordenação utilizando a mesma estrutura interna que 4D Server. A nível da estrutura e dos dados: quando 4D e 4D Server trocaram uma estrutura de objeto ou de dados, ambos os aplicativos usam o mesmo formato interno. Por exemplo, quando 4D necessita de um registro, 4D Server envia diretamente os dados em formato que estão no cachê de disco ou de memória. Da mesma forma, quando 4D deseja atualizar um registro e envia os dados a 4D Server, o qual armazenam dados diretamente na cachê tal como é recebido. A nível da interface de usuário: quando 4D mostra uma lista de registros, o formulário utilizado exibe os registros que desempenham um papel na arquitetura cliente/servidor. Por exemplo, a seguinte imagem mostra o resultado de um pedido na tabela [Clientes]. Como o tamanho da janela só permite exibir 12 registros e 5 campos ao mesmo tempo. 4D Server envia exatamente 12 registros. Em vez de enviar todos os registros, 4D Server envia apenas o número de registros de campos que podem ser exibidos na janela. Se o usuário se desloca pelo formulário, 4D Server envia os registros adicionais ou campos necessários. Essa otimização reduz o tráfego de rede, garantindo que os registros e campos sejam enviados somente quando necessário.

10 4D Server em 10 minutos Verificação da instalação Criar um banco de dados servidor Conexão ao banco de dados servidor com um 4D remoto Definir a estrutura do banco de dados Processamento de dados com 4D Server Criar uma barra de menus personalizada Trabalhar simultaneamente com vários 4D remotos

11 Verificação da instalação O capítulo de iniciação 4D Server em 10 minutos permite descobrir rapidamente 4D Server, particularmente lhe mostrará como: Criar uma base servidor Conectar um cliente à base servidor Criar a estrutura da base, incluindo tabelas, campos, formulários, menus e métodos Conectar um segundo cliente e trabalhar simultaneamente Para realizar estes exercícios necessitará pelo menos de dois computadores: Um computador com 4D Server, 4D e um navegador web Outro ordenador no qual esteja instalado 4D Antes de começar a trabalhar por primeira vez com 4D Server e 4D em modo local, é uma boa idéia verificar sua instalação. Para fazer isto, leia esta seção. Elementos instalados Este parágrafo especifica a localização dos elementos instalados em seu disco logo de uma instalação padrão de 4D + 4D Server. Windows Os elementos se instalam na pasta Program Files\4D\4D vxx e aparece no menu Inicio. 4D Server: Esta pasta contém a aplicação 4D Server como os arquivos e pastas associadas. Para lançar 4D Server, simplesmente faça duplo clique no arquivo 4DServer.exe. 4D: Esta pasta contém a aplicação 4D assim como os arquivos e pastas associadas. Para lançar 4D, simplesmente faça duplo clique no arquivo 4D.exe. Mac OS Os elementos se instalam na pasta Aplicações:4D:4DXX e aparecem nas aplicações. 4D Server: software (pacote) de 4D Server. Para lançar 4D Server, simplesmente faça duplo clique neste pacote. 4D: 4D software (pacote) de 4D. Para lançar 4D, faça duplo clique neste pacote. Para este exercício em particular, deve instalar 4D em um computador adicional. Para onde ir agora? Observe que o protocolo TCP/IP deve ser configurado corretamente para que suas máquinas possam se comunicar pela rede. Se 4D Server e 4D estão instalados corretamente, continue com a seção Criar um banco de dados servidor. Caso contrário, se falta qualquer um dos arquivos listados acima, consulte a Guia de instalação e siga para a instalação dos arquivos.

12 Criar um banco de dados servidor Esta seção descreve a criação de um servidor de banco de dados que pode ser acessado pela rede, usando 4D em modo remoto. Antes de trabalhar com 4D Server e 4D pela primeira vez, é uma boa ideia para verificar a instalação. Para fazer isso, leia a seção Verificação da instalação. Nota: Neste exemplo, nós assumimos que você ativou sua licença de 4D Server, conforme descrito no Guia de instalação. A utilização de 4D no modo remoto não requer uma licença no computador cliente. As licenças são geradas na máquina 4D Server. Para obter mais informações, consulte a Guia de instalação. Para criar ou abrir uma base servidor, lance 4D Server. 1. Lance 4D Server fazendo duplo clique no ícone do programa. Quando é lançado por primeira vez a aplicação, mostra a caixa de diálogo de ativação da aplicação. Posteriormente, se mostrará uma janela vazia ao início. Este funcionamento pode ser configurado utilizando as Preferências da aplicação. Neste exercício, criaremos uma nova base vazia. 2. Selecione o comando Nova base de dados... no menu Arquivo de 4D Server. Aparece uma caixa de diálogo estandarte de guardar arquivo, a qual lhe permite definir o nome e o lugar da base a criar. 3. Defina uma localização, logo ingresse o nome de sua base. Digite Empregados, logo faça clique em Guardar. 4D Server cria automaticamente os arquivos e pastas necessárias para a operação da base, logo aparece a janela de administração:

13 A Janela de administração de 4D Server é composta por várias páginas, acessíveis através de guias. A página Monitor exibe informações dinâmicas relativa a operação do banco de dados e também informações sobre o sistema e a aplicação 4D Server. Entre outras páginas, note que as páginas Usuários e Processos indicam respectivamente o número de usuários conectados a base e o número de processos em execução atualmente. Observe que, neste momento, o número de usuários conectados é zero. Isso significa que atualmente nenhum cliente está conectado a base. O número de processos que está sendo implementado é doze. Estes doze processos são criados automáticos pelo motor de base e servidores integrados de 4D Server (servidor de aplicação, servidor HTTP, servidor SQL). Para onde ir agora? Neste ponto, a base está disponível para as conexões distantes 4D Windows e/o Macintosh. No entanto, a base não está pronta para as conexões HTTP, porque estas conexões não estão autorizadas por padrão. Consulte a seção Conexão ao banco de dados servidor com um 4D remoto. Neste tutorial, primeiro se conectará utilizando um 4D remoto, definirá a estrutura da base e adicionará alguns registros à base.

14 Conexão ao banco de dados servidor com um 4D remoto Esta seção trata os seguintes temas: Como conectar um 4D remoto à base servidor que você criou. Como criar a estrutura da base. Esta seção inclui um tutorial no qual você cria tabelas e campos na base, introduz novos registros e modifica registros existentes. Como conectar um segundo usuário. Como trabalhar simultaneamente com os dois clientes remotos. Conexão a base de dados Ainda que criou a base com 4D Server (ver a seção Criar um banco de dados servidor), todas as modificações no desenho e os dados da base se realizam desde computadores clientes. Nesta seção, aprenderá como se conectar ao servidor e abrir a base servidor. 1. Duplo clique no ícone da aplicação 4D remota. Nota: Para este tutorial, pode utilizar uma aplicação 4D instalada na mesma máquina que 4D Server. Se este é o primeiro lançamento da aplicação 4D ou se não há modificado os parâmetros de inicio, aparece a caixa de diálogo de boas vindas: 2. Faça clique em "Conectar-se a 4D Server". Ou: Se não aparece esta caixa de diálogo, escolha o comando Abrir>Base de dados remota... no menu Arquivo de 4D:

15 É mostrada a caixa de diálogo de conexão, por padrão mostra os servidores utilizados recentemente (a lista está vazia a primeira vez que é usada: 3. Faça clique na guia TCP/IP para mostrar a lista de bases 4D publicadas na rede. A base Empregados deve aparecer na lista:

16 4. Selecione Empregados e faça clique em Aceitar. A base se abrirá no computador remoto, em modo Desenho, preparado para criar a estrutura de sua base. Recomendações Caso não veja o nome da base que acaba de criar com 4D Server, revise os seguintes pontos: 4D Server se está executando em outro computador? Se utiliza um segundo computador, as duas máquinas estão conectadas a rede? O protocolo TCP/IP está configurado corretamente em ambas máquinas? Se não está seguro sobre o uso da caixa de diálogo de conexão, consulte a seção Conexão a um banco de dados 4D Server. Atividade do Servidor Quando você olhar a janela de administração de 4D Server, você pode perceber que seu nome de usuário é exibida na página correspondente, e que o número de usuários conectados é um (1).

17 Agora há um total de dezesseis processos em execução: Nota: por padrão, como na imagem acima, os processos são agrupados para melhor legibilidade. Desmarque a opção Mostrar os processos por grupos para exibir todos os processos. Os primeiros doze processos são necessários para o funcionamento do servidor e foram criados durante o lançamento de 4D Server. Os quatro novos processos (agrupados em duas linhas) são da conexão do primeiro usuário ao servidor:

18 o processo principal administra a exibição dos registros e o modo de Aplicação. o processo design administra o modo Desenho. Cada usuário adicional adicionará, pelo menos, quatro processos para a lista de processos. Você pode filtrar a lista de processos exibidos usando os botões Processos usuários, Processos 4D e a área de filtro localizada na parte superior direita da janela de administração. Para onde ir agora? Agora que está conectado, pode trabalhar com a base com as mesmas funcionalidades que utiliza 4D em modo local. Primeiro, deve definir a estrutura. Consulte a seção Definir a estrutura do banco de dados.

19 Definir a estrutura do banco de dados No computador 4D remoto, logo de conecta-se a base servidor (ver a seção Conexão ao banco de dados servidor com um 4D remoto ), escolha o comando Database Structure no menu Design. Aparece a janela de estrutura, vazia por padrão. Vamos criar uma simples tabela. Criar a tabela [Empregados] 1. Escolha Nova>Tabela no menu Arquivo ou na barra de ferramentas de 4D. Ou Faça clique direito na janela de estrutura e escolha Adicionar tabela no menu contextual. Ou Faça clique no botão adicionar da janela de estrutura (em forma de +) e escolha Tabela. É criada a tabela. 2. Faça clique na área de título e de nome a tabela Empregados. 3. Faça duplo clique na área de campos para criar um novo campo. 4. Renome o campo Sobrenome e conserve o tipo Alfa (255). Pode fazer duplo clique no campo para mostrar a paleta do Inspetor. 5. Adicione da mesma forma os campos seguintes na tabela [Empregados]: Nome do campo Tipo de campo Nome Alfa (255 caracteres) Salário Real Departamento Alfa (255 caracteres) Nota: Se outras aplicações 4D remotas trabalham simultaneamente com a mesma base, os campos que acabou de criar aparecerão no computador cliente dentro de alguns instantes. As alterações são implementadas no servidor em tempo real, mas não aparecem em outras telas imediatamente, para evitar a atualização da tela com frequência. Criar formulários para a tabela [Empregados] Uma vez definido o conteúdo da tabela [Empregados], deve criar os formulários para poder adicionar e trabalhar com seus registros. Para fazer, pode utilizar o Assistente de criação de formulários e criar os formulários a sua conveniência. No entanto,

20 4D oferece um recurso prático para criar rapidamente formulários de entrada e saída por padrão. 1. Faça clique no botão Tabelas da barra de ferramentas de 4D. Ou Escolha o comando Mostrar a tabela atual no menu Registros. É mostrada a janela de registros. 4D detecta que a tabela não dispõe de nenhum formulário e lhe pergunta se deseja que o programa crie por você. 2. Faça clique em Sim. Agora tem um formulário de entrada para adicionar ou mostrar registros um por um e um formulário de saída para mostrar o introduzir múltiplos registros em modo listado. Para onde ir agora? Sua base servidor está lista para a manipulação de dados. Vá para a seção Processamento de dados com 4D Server.

21 Processamento de dados com 4D Server Na seção Definir a estrutura do banco de dados, você criou a tabela [Empregados] e permitiu 4D criar os formulários por padrão para esta tabela. Agora está pronto para introduzir registros. Introduzir os registros No modo Desenho, 4D lhe oferece por padrão as ferramentas e editores para a entrada, pesquisa, impressão ou modificação de registros. Portanto, pode definir suas próprias ferramentas para o modo Aplicação. 1. Escolha Novo registro no menu Registros. Aparece o formulário de entrada vazio. 2. Indique seu primeiro registro. Use a tecla Tab ou o mouse para navegar entre os campos. 3. Faça clique no botão de validação do formulário para validar sua entrada. Aparece um formulário de entrada vazio, que lhe permite continuar adicionando novos registros. 4. Indique cinco registros mais, com os seguintes valores. Sobrenome Nome Salário Departamento Silva Miguel Engenharia Da Silva João Produção Pedrosa Maria Engenharia Sales Manuel Produção Luís Gabriel Produção Depois de ter introduzido o último registro, clique no ícone de cancelamento (que contém uma cruz sobre o ícone de validação) para cancelar o novo formulário de entrada vazia. Aparece o formulário de saída. 5. Se não são mostrados todos os seis registros, escolha Mostrar todos no menu Registros e redimensione a janela ou as colunas caso seja necessário. Deve ter:

22 Agora os registros são guardados no banco de dados na máquina servidor. Se um segundo 4D remoto está conectado ao equipo servidor, poderia mostrar os registros que acaba de agregar. Caso contrário, se os outros clientes também estavam introduzindo registros, pode escolher Mostrar todos desde o menu Registros para mostrar todos os registros, incluindo os que foram inseridos. Os registros armazenados no servidor são acessíveis a todos os usuários. Consultar registros Uma vez criado os registros na tabela [Empregados], pode realizar pesquisas, classificações, impressões, etc. com os registros. Por exemplo, procuremos os empregados do departamento de Engenharia. 1. Faça clique no botão Pesquisar na barra de ferramentas. Aparece o editor de pesquisas: 2. Conserve "[Empregados]Departamento" como critério de pesquisa e é na lista de comparadores, logo introduza "Engenheria": 3. Faça clique no botão Buscar. A petição é enviada ao 4D Server, depois 4D Server responde a 4D. O formulário de entrada mostra unicamente os empregados que trabalham no departamento de Engenharia. Para mostrar todos os registros novamente, escolha Mostrar todos no menu Registros. Para onde ir agora? Em poucos minutos, você criou uma base servidor, definindo uma tabela, adicionando registros, depois realizou uma pesquisa utilizando os dados introduzidos na base.

23 utilizando os dados introduzidos na base. Agora é tempo de adicionar uma barra de menus personalizada para seu banco de dados. Consulte a seção Criar uma barra de menus personalizada.

24 Criar uma barra de menus personalizada Nesta seção, você desenhará dois métodos e uma barra de menus personalizada. Em resumem, irá criar uma aplicação 4D. Criar os dois métodos 1. Selecione Novo > Método.. no menu Arquivo. Aparece a caixa de diálogo de criação do método. 2. Insira M_ADD_RECORDS na caixa de diálogo Novo método, depois faça clique em Aceitar. Aparece uma janela do editor de métodos chamada Método:M_ADD_RECORDS. 3. Insira o código do método M_ADD_RECORDS como é mostrado a continuação: 4. Crie um segundo método chamado M_LIST_RECORDS com o seguinte código: Agora que os dois métodos foram criados, crie uma barra de menus personalizada e associe os métodos aos comandos de menus. Criar uma barra de menu personalizado 1. Selecione Caixa de ferramentas > Menus no menu Desenho. O editor de barras de menus é mostrado com uma barra de menus por padrão. 2. Selecione a etiqueta "Barra # 1" faça clique no botão adicionar na parte central da janela. 3. Insira Tutorial como título do menu e pressione Intro. 4. Faça clique direito no título Tutorial e escolha o comando Adicionar um elemento ao menu "Tutorial": 5. Insira Adicionar registros... e pressione Intro. 6. Faça clique direito novamente no título Tutorial para adicionar um segundo comando de menu ao menu "Tutorial. 7. Insira Pesquisar... e pressione Intro. A barra de menus #1 deve ser vista assim:

25 8. Faça clique no comando de menu Adicionar registros... e selecione M_ADD_RECORDS na caixa de combinação Nome do método. 9. Faça clique no título Pesquisar... e selecione M_LIST_RECORDS na caixa de combinação Nome do método. A barra de menus #1 agora é vista assim: 10. Feche a janela da caixa de ferramentas. Pronto! 11. Selecione testar a aplicação no menu Execução. Agora pode utilizar a aplicação com os menus que desenhou: Por exemplo, se seleciona Pesquisar... no menu Tutorial, aparece o editor de pesquisas padrão de 4D. Pode definir sua pesquisa, depois mostrar e modificar os registros encontrados. O ponto interessante, é que sem saber, você acaba de desenvolver duas aplicações! Para saber por que, consulte a seção Trabalhar simultaneamente com vários 4D remotos.

26 Trabalhar simultaneamente com vários 4D remotos Se você faz os exercícios deste tutorial em Windows, pode utilizar o banco de dados servidor como está em Macintosh. É feito os exercícios deste tutorial em Macintosh, pode utilizar este banco de dados servidor como está em Windows. Conexão ao banco de dados servidor com um segundo usuário Para este tutorial, nos conectaremos ao banco de dados servidor com um 4D remoto em Windows e um 4D remoto em Mac OS. Logo como seja estabelecida a conexão, poderá ver ao segundo usuário na janela de administração de 4D Server (a primeira coluna indica o sistema operativo do computador remoto): Em cada computador cliente, tudo que seja feito na base é reutilizado instantaneamente e de maneira transparente. Este é o ambiente Desenho no computador cliente remoto em Mac OS: Os seus seis registros e seus dois métodos estão aqui! Trabalhar simultaneamente nos registros 1. No primeira computador remoto, em modo "Test Application", escolha Pesquisar... no menu Tutorial e procure os registros onde Departamento é igual a Engenharia. 2. Faça o mesmo no segundo computador remoto. Em ambos computadores, obtém uma lista composta por três registros. 3. Na primeira máquina, faça duplo clique no registro Santos, José. Você deve ser sua tela assim:

27 4. Faça a mesma coisa no segundo computador. 4D Server tem um sistema de gestão integrado de bloqueio de dados que lhe adverte que o registro já está em uso: No entanto, você tem acesso ao registro em somente modo leitura (você pode ver, mas não modificar). 5. No primeiro computador, mude o nome Miguel e valide suas mudanças. A lista é atualizada com o novo nome.

28 6. No segundo computador, cancele a visualização do registro no formulário de entrada. A lista foi atualizada com o novo nome também! Trabalhar simultaneamente com objetos de desenho 4D Server é um servidor de dados e de aplicações. Vamos ver o que isto significa. No segundo equipo, pressione a tecla Esc., em seguida, escolha o comando Voltar ao modo Desenho no menu Modo. Faça a mesma coisa na primeira máquina. Na primeira máquina, escolha Explorador> Formulários no menu Desenho. Aparece a janela do Explorador. Escolha os formulários tabela e desloque a tabela Empregados:

29 Faça duplo clique no formulário de entrada. Aparece o editor de formulários, com o formulário de entrada: Faça a mesma coisa na segunda máquina. Como o formulário está em modo edição na outra máquina, o mecanismo integrado de bloqueio de objetos 4D Server lhe informa:

30 Não obstante, pode abrir o formulário na segunda máquina no modo de visualização. Pode selecionar objetos e copiar a outros formulários, mas não pode modificar o formulário mesmo. Note o ícone de cadeado na esquina superior direita do formulário. Este ícone lhe lembra que não pode mudar o formulário. Na primeira máquina, selecione a etiqueta "Sobrenome" a esquerda do campo [Empregados]Nome. Selecione no menu hierárquico Objeto>Cor. Se torna vermelha a cor deste objeto. Selecione Salvar o formulário: [Empregados]Entrada no menu Arquivo. Na segunda máquina, feche e volte a abrir o formulário para que o recarregue. A mudança realizada na outra máquina agora está disponível nesta. 4D Server lhe permite desenvolver ao mesmo tempo uma base de dados com outros usuários Fechar o servidor Além de informações dos usuários remotos 4D durante os acessos simultâneos os mesmos registros ou objetos, 4D Server inclui uma mensagem de aviso de encerramento interno através da rede. 1. Mantendo aos dois clientes conectados, na máquina de servidor, selecione Sair no menu Arquivo (Windows) ou no menu de 4D Server (Mac OS). Aparece a caixa de diálogo Fechar: 2. Faça clique em Aceitar. Quase que instantaneamente, as duas máquinas cliente são informadas que o servidor está sendo desligado. Por exemplo, se um cliente estava adicionando um registro, o usuário teria tempo suficiente para completar e validar a entrada de dados.

31 Esta caixa de diálogo de advertência se repete regularmente em cada máquina de cliente. Nota: alternativamente, pode fechar o servidor utilizando a opção "Aguardar que todos os usuários sejam desconectados" (enviando-lhes uma mensagem pedindo-lhes para desconectar-se logo que possível) ou forçar a desconexão imediata dos clientes por meio da opção "Desconectar todos os clientes e sair". 3. Enquanto o servidor fecha, feche 4D nas duas máquinas remotas. Conclusão Com este tutorial, você descobriu como fácil que é utilizar 4D Server: Criou uma base de dados desde zero. Criou uma tabela e permitiu a 4D Server criar os formulários por si. Adicionou e manipulou registros. Personalizou sua aplicação com sua própria barra de menus. Utilizou o banco de dados servidor simultaneamente em Windows e Macintosh. Fechou e reiniciou o servidor Em conclusão, ele criou dois aplicativos personalizados (Windows e Macintosh) com um desenvolvimento único. Além disso, se você precisar usar o banco de dados em modo local, você pode abrir diretamente, com 4D. Para saber mais sobre 4D Server, leia as seções introdutórias deste manual, bem como as outras seções que descrevem o funcionamento de 4D Server. Para obter informações completas sobre o ambiente 4D, consulte: O manual de Desenho para aprender acerca de desenhar e utilizar aplicações e bases de dados 4D. O manual de Linguagem para aprender acerca dos comandos da linguagem 4D. Por exemplo para aprender acerca da capacidade web de 4D Server, leia a seção Introdução ao Web Server no manual de Linguagem de 4D.

32 Using 4D Server Creating a New 4D Server Database Exiting 4D Server Using a 64-bit 4D Server (Windows) 4D Server Menus Configuration preferences Publishing preferences Encrypting Client/Server Connections Managing the Resources folder Registering a Database as a Service Setting up a logical mirror

33 Creating a New 4D Server Database To create a server database or open an existing database, launch 4D Server by double-clicking the 4D Server application icon. You can then create a new database or open an existing one using the File menu of 4D Server. Creating a database To create a new database, choose one of the commands from the New> submenu: : Database: can be used to create a blank database, in other words, one without any tables, forms or predefined interface. When you choose this command, a standard save file dialog box appears so that you can set the name and location of the database. Database From Template: creates a database using a "ready to use" template that you can customize subsequently. In order to be able to use this function, the template databases must be placed in a "4D Templates" or "4D Modèles" folder at the same level as the 4D Server.exe (Windows) file or the 4D Server software package (Mac OS). When you choose this command, a database template selection dialog box appears. Database From Structure File: can be used to create a database based on a description of the structure in XML format. This definition can come from a structure exported from 4D or any design application. When you choose this command, a standard open file dialog box appears so that you can designate the XML file to use. For more information about these options, please refer to the Design Reference manual. Opening a database To open an existing database, you can use a standard open document dialog box ( File>Open... command) or select a previouslyopened database directly (File>Open Recent command). If a database was already open when you select an Open command, it will first be closed. If any client machines were connected, they are disconnected using the Wait for all Users to disconnect mode (see the Exiting 4D Server section). Note: You can also open an existing database directly by dragging and dropping an interpreted or compiled structure file (.4db ou.4dc) or a shortcut file (.4dlink) onto the 4D Server application icon.

34 Exiting 4D Server To shut down the server: 1. Choose the Quit command from the File menu of 4D Server (Windows) or the 4D Server menu (Mac OS). The following dialog box is displayed on the server machine: 2. Enter the number of minutes in which you want the server to shut down, or choose the Wait for all Users to disconnect option. As soon as you do this, no new client can connect to the server. If you choose the Disconnect from Server in XX min. option, the following window appears: An identical window appears on each 4D client machine (the Cancel button does not appear on the 4D machines). This window is repeated or updated on each client machine every 20 seconds or so, in order to prompt them to quit. When the time limit is reached, the server quits even if there are client machines still connected. If you choose the Wait for all Users to disconnect option without entering a message, the following window appears, which indicates the number of clients that are still connected: On each 4D client machine, the following window appears displaying a default message: If you entered a custom message in the 4D Server shutdown dialog box, it is displayed instead of the default message on each client machine. For example:

35 The server will quit as soon as all the clients are disconnected. Notes: If you have chosen the Disconnect all clients and quit option, the server ends all processes and all connections and quits after a few seconds. In all cases, if no client is connected to the server when the shutting down window is validated, 4D Server quits immediately. If you click Cancel in the 4D Server shutdown window, the process of shutting down the server is canceled. You can close the database (and disconnect the clients) without quitting the 4D Server using the Close database... command. For more information, please refer to the ON EVENT CALL4D Server Menus section.

36 Using a 64-bit 4D Server (Windows) Beginning with version 12, 4D Server supports Windows 64-bit operating systems. The main advantage of 64-bit technology is the fact that more RAM memory can be addressed. This section covers the particularities concerning the implementation and use of the 64-bit version of 4D Server. Windows versions A 64-bit 4D Server requires a Windows 64-bit operating system. Please refer to the certification matrices available on the 4D Web site to know which Windows operating systems are compatible with respect to your 4D Server release. Architecture The 4D Server.exe application intended for 64-bit architectures is a specific version, dedicated to this environment. It will not run on a 32-bit system. Conversely, if you launch the standard 4DServer.exe (32 bits) on a Windows 64-bit system, it will run, but in emulation mode. On the client side, any 4D machine (Mac OS or Windows) can connect to a 64-bit version of 4D Server. The 4D applications to be used are the standard 32-bit versions (see the diagram below). Compatibility In interpreted mode, the same 4D databases can be executed with a 64-bit 4D Server or a 32-bit 4D Server. Development is identical regardless of which application is used. In compiled mode, the databases must have been compiled for 64-bit processors in order to be executed with a 64-bit 4D Server (see the "64-bit compilation" paragraph). A database that has been compiled in 32-bit only and that does not contain interpreted code cannot be executed with a 64-bit 4D Server. During execution, the following differences should be noted: Only the plug-ins compiled specifically in 64-bit mode will be loaded by the 64-bit 4D Server. A 64-bit plug-in must be built as a folder and placed in the Plugins folder of the server (the former architecture based on the.4dx and.rsr files placed in the Win4DX folder is no longer supported). 32-bit plug-ins are not loaded by a 64-bit 4D Server. They can however be stored in the Plugins folder of the server and distributed on the remote machines, without initialization. Mechanisms that call the server (for example, writing or reading templates on the server via the WR SET AREA PROPERTY command of 4D Write) will not function. The.4DX file for 32 bits must be placed in a subfolder named /Contents/Windows and the file for 64 bits must be placed in a subfolder named /Contents/Windows64. The compiled 4D components used with a 64-bit 4D Server must have been compiled in 64 bits. The amount of memory that can be used for the BLOBs loaded by the application remains limited to 2 GB. QuickTime is not supported by a 64-bit 4D Server. Generally, we do not recommend working with pictures in PICT format: if the picture is 100% Quickdraw, it can be handled by a 64-bit version of 4D Server, but if it contains Quicktime, it cannot be loaded. 4D Internet Commands To be able to use 4D Internet Commands with a 64-bit 4D Server, you must install version 12.1 (minimum) of this plug in.

37 You can download the version 12.1 of 4D Internet Commands from the 4D Web site. 64-bit compilation 4D v12 applications can now be compiled for 32-bit and 64-bit processors. To do this, a new Also compile for 64-bit processors option is available on the "Compiler" page of the Database settings: When this option is checked, the compiler includes the 64-bit code and the 32-bit code in the.4dc and.4db files. These files can then be run with either a 32-bit or a 64-bit 4D Server. By default, this option is not checked. Note: In order to compile a 64-bit version of the database, it must be operating in Unicode mode. Otherwise, an error is generated during compilation. Size of cache memory Since 64-bit architectures allow up to 1 TB (1000 GB) of RAM memory to be addressed, the cache memory that can be allocated to the 64-bit 4D Server is virtually unlimited. Note: By comparison, 32-bit architectures are limited to 4 GB of RAM. If the quantity of cache specified on the "Database/Memory" page of the database Settings cannot be obtained, 4D Server allocates the largest size possible and informs the user on startup of the application. It is then possible to quit or continue with the size offered. Interface During execution, you can distinguish between the 64-bit 4D Server application and the standard 4D Server application via a logo that appears on the Monitor page of the server administration window: Note: This logo also appears in the About 4D Server window.

38 Language Modified commands The following 4D language commands have been adapted to the new capacities of the 64-bit 4D Server: Version type, SET DATABASE PARAMETER and Get database parameter. For more information, refer to the descriptions of these commands. Size of the process stack The process stack running on a 64-bit version of 4D Server requires more memory than on a 32-bit version (about twice as much). When you create a process on the server using the Execute on server or New process commands with a 64-bit version of 4D Server, we recommend that you pass a minimum value of 128,000 bytes in the stack parameter and increase it when handling a sizeable call chain or if you receive an "out of stack" error. Make sure that you check this parameter when your code is intended for execution on a 64-bit 4D Server. Commands not allowed on a 64-bit server In addition to standard commands that cannot be used on 4D Server (see Stored Procedures), the following commands cannot be executed on a 64-bit server. If they are called for example within a stored procedure, a warning dialog box appears and the error 67 is returned. This error can be intercepted by an error-handling method installed by the ON ERR CALL command. 4D, Quick Report theme QR New offscreen area 4D Chart, CT Area theme CT New offscreen area

39 4D Server Menus The interface of the 4D Server application is made up of the following menus: File, Edit, Window, Help. Under Mac OS, certain commands are found in the 4D Server menu (application menu). File New This hierarchical command has submenus that can be used to create a database or a new data file on the server machine. The database creation commands are detailed in the Creating a New 4D Server Database section. Open.../Open Recent These commands can be used to open a database with 4D Server. The Open Recent> command displays a submenu listing databases that have been opened recently by 4D Server. To reset this menu, choose the Clear Menu command. The database opening commands are detailed in the Creating a New 4D Server Database section. Close Database... This command closes the current database without exiting the 4D Server application. When you choose this command, the server shutdown dialog box appears so that you can set the disconnection mode for any connected clients(see the Exiting 4D Server section). Close Window This command closes the window in the foreground of the 4D Server application. Close All Windows This command closes all the windows of the 4D Server application. Note that in this case only the fact that the Close Database... command is activated in the File menu will indicate whether the database is still published. Register Current Database as Service/Unregister Current Database/Unregister All Server Services (Commands available under Windows) These commands are used to manage the registering of the database as a Service. This function is detailed in the Registering a Database as a Service section. Flush Data Buffers

40 This command can be used to "force" the saving of data in the cache to the disk. By default, 4D Server automatically flushes the cache after a time limit set in the database preferences (Database/Data Management page). Backup This command lets you launch a back-up of the database at any time. When you select this command, the following dialog box appears: The Backup button immediately launches a back-up that takes the parameters set in the Preferences dialog box of the application into account (files to be backed up, location of archives, number of sets kept, etc.). The Preferences button opens the Backup theme of the Preferences, which lets you view and, if necessary, modify the current back-up settings. The Cancel button interrupts the back-up process. For more information about back-up configuration, refer to the Design Reference manual of the 4D documentation. Restore... This command displays an open file dialog box so that you can select the archive to restore. Quit This command lets you close the 4D Server application. For more information, refer to the Exiting 4D Server section. Note: Under Mac OS X, the Quit command is located in the 4D Server menu (application menu). Edit The Edit menu of 4D Server includes standard copy/paste commands, the Show Clipboard command, etc. This menu also includes (under Windows) the Preferences... command, which displays the Preferences dialog box of the application. This dialog box is used to define numerous functions of the database. For more information about this dialog box, refer to the Design Reference manual of the 4D documentation. The preferences specific to 4D Server are described in the Configuration preferences and Publishing preferences sections. Note: Under Mac OS, the Preferences... command is found in the 4D Server menu (application menu).

41 Window The first part of the Window menu includes standard commands for organizing workspace windows (these commands differ depending on the platform). It also contains display commands for windows specific to 4D Server: Administration This command displays the 4D Server Administration window if it has been closed or minimized. This window is detailed in the 4D Server Administration Window chapter (see the Monitor Page section). Runtime Explorer This command displays the 4D Server Runtime Explorer window. The Runtime Explorer enables you to view the status of the database various structural elements and to check that the available resources are correctly managed. The Runtime Explorer is particularly useful while developing or analyzing a database. The Runtime Explorer window contains four pages that can be accessed by clicking on the following buttons: Watch, Process, Break and Catch. The Runtime Explorer works the same way in 4D Server and 4D. For more information, please refer to the 4D Design Reference manual (see chapter Runtime Explorer). Help

42 Maintenance Security Center This command displays the Maintenance and Security Center (MSC) which groups together all the tools required for verification, analysis, maintenance, back-up and compacting of data and structure files. This command is available even when no database is opened by 4D Server: in this case, it can be used to open a database in "maintenance mode" (it displays the standard open file dialog box so that you can designate the database to be opened). Maintenance mode is used more particularly for operations such as compacting or opening damaged databases. For more information about the MSC, please refer to the Design Reference manual. Update License... This command displays the window used to activate additional licenses in your 4D environment. For more information about this dialog box, refer to the 4D Installation Guide manual. About 4D Server... This command displays the 4D Server About... window, which provides various information organized in different pages that can be accessed via tabs: Program: 4D Server version and license Copyrights: legal mentions 4D online: additional resources related to 4D that can be accessed on line 4D: a view of the company 4D SAS around the world. Note: Under Mac OS, the About 4D Server command is found in the 4D Server menu (application menu).

43 Configuration preferences You can set various parameters concerning the network and the client-server communication on the "Network options" tab of the Client-Server page in the Database settings (accessible on both 4D in remote mode and 4D Server): These parameters are detailed in this section. Network Publish database at startup This option lets you indicate whether or not the 4D Server database will appear in the list of published databases. When this option is checked (default option), the database is made public and appears in the list of published databases (TCP/IP page). When the option is not checked, the database is not made public and it does not appear in the list of published databases. To connect, users must manually enter the address of the database on the Custom page of the connection dialog box. Note: If you modify this parameter, you must restart the server database in order for it to be taken into account. Publication name This option lets you change the publication name for a database published by 4D Server, i.e., the name displayed on the dynamic TCP/IP publication page of the connection dialog box (see the Connecting to a 4D Server Database section). By default, 4D Server uses the name of the database structure file. You can enter any custom name you want. Note: This parameter is not taken into account in custom client-server applications. In theory, the client application connects directly to the server application, without passing by the connection dialog box. However, in the event of an error, this dialog box will appear; in this case, the publication name of the server application is the name of the compiled database.

44 Port Number This option lets you change the TCP port number on which 4D Server publishes the database. This information is stored in the structure of the database and on each client machine. By default, the TCP port number used by 4D Server and 4D in remote mode is Customizing this value is necessary when you want to use several 4D applications on the same machine with the TCP protocol; in this case, you must specify a different port number for each application. When you modify this value from 4D Server or 4D, it is automatically passed on to all the 4D machines connected to the database. To update any other client machines that are not connected, you just need to enter the new port number (preceded by a colon) after the IP address of the server machine on the Custom page of the connection dialog box at the time of the next connection. For example, if the new port number is 19888: Note: Only databases published on the same port as the one set in 4D client are visible on the TCP/IP dynamic publication page. 4D Server and port numbers 4D Server uses three TCP ports for communications between internal servers and clients: SQL Server: by default (can be modified via the "SQL/Configuration" page of the Preferences). Application Server: by default (can be modified via the "Client-Server/Configuration" page of the Preferences, see above). DB4D Server (database server): by default. This port number cannot be modified directly but it always consists of the application server port number + 1. When a 4D client connects to 4D Server, it uses the TCP port of the application server (19813 or the port indicated after the colon ':' in the IP address shown in the connection dialog box). Connection to other servers via their respective ports is then automatic; it is no longer necessary to specify them. Note that in the case of access via a router or a firewall, the three TCP ports must be opened explicitly. Client-Server Connections Timeout This thermometer is used to set the timeout (period of inactivity beyond which the connection is closed) between 4D Server and the client machines connecting to it. The Unlimited option removes the timeout. When this option is selected, client activity control is eliminated. When a timeout is selected, the server will close the connection of a client if it does not receive any requests from the latter during the specified time limit. Client-Server Communication Register Clients at Startup For Execute On Client When this option is checked, all the 4D remote machines connecting to the database can execute methods remotely. This mechanism is detailed in the section Stored procedures on client machines. Encrypt Client-Server Connections This option lets you activate the SSL mode (secured mode) for communications between the server machine and the 4D remote machines. This option is detailed in the Encrypting Client/Server Connections section.

45 Update "Resources" folder during a session This setting can be used to globally set the updating mode for the local instance of the Resources folder on the connected 4D machines when the Resources Resources folder of the database is modified during the session (the Resources folder is automatically synchronized on the remote machine each time a session is opened). Three settings are available: Never: The local Resources folder is not updated during the session. The notification sent by the server is ignored. The local Resources folder may be updated manually using the Update Local Resources command. Always: The synchronization of the local Resources folder is automatically carried out during the session whenever notification is sent by the server. Ask: When the notification is sent by the server, a dialog box is displayed on the client machines, indicating the modification. The user can then accept or refuse the synchronization of the local Resources folder. The Resources folder centralizes the custom files required for the database interface (translation files, pictures, etc.). Automatic or manual mechanisms can be used to notify each client when the contents of this folder have been modified. For more information, please refer to the Managing the Resources folder section. Open the structure in mode This option sets the opening mode for the database structure on client machines. By default, the Read/Write mode is set but you can also set it to Read only in order to prevent the structure from being modified.

46 Publishing preferences You can set parameters concerning the network configuration of 4D Server databases on the IP configuration tab of the Client- Server page in the Database settings (accessible on both remote 4D machines and 4D Server): These parameters are detailed in this section. Allow-Deny Configuration Table This table allows you to set access control rules for the database depending on 4D remote machine IP addresses. This option allows reinforcing security, for example, for strategic applications. Note: This configuration table does not control Web connections. The behavior of the configuration table is as follows: The Allow-Deny column allows selecting the type of rule to apply (Allow or Deny) using a pop-up menu. To add a rule, click on the Add button. A new row appears in the table. The Delete button lets you remove the current row. The IP Address column allows setting the IP address(es) concerned by the rule. To specify an address, click in the column and enter the address in the following form: You can use an * (asterisk) character to specify starts with type addresses. For example, * indicates all addresses starting with The application of rules is based on the display order of the table. If two rules are contradictory, priority is given to the rule located highest in the table. You can re-order rows by modifying the current sort (click the header of the column to alternate the direction of the sort). You can also move rows using drag and drop. For security reasons, only addresses that actually match a rule will be allowed to connect. In other words, if the table only contains one or more Deny rules, all addresses will be refused because none will match at

47 least one rule. If you want to deny only certain addresses (and allow others), add an Allow * rule at the end of the table. For example: - Deny * (deny all addresses beginning with ) - Allow * (but allow all other addresses) By default, no connection restrictions are applied by 4D Server: the first row of the table contains the Allow label and the * (all addresses) character.

48 Encrypting Client/Server Connections You can configure the client/server connections so that 4D Server and 4D remote workstations communicate in secured mode. The secured client/server communication is based on SSL (Secured Socket Layer) protocol. SSL Protocol and Client/Server Connections The SSL protocol has been designed to secure data exchanges between two applications primarily between a Web server and a browser. The SSL protocol is designed to authenticate the sender and receiver and to guarantee the confidentiality and integrity of the exchanged information. For a detailed description of the SSL protocol, refer to section Using SSL Protocol in the 4D Language Reference. Regarding 4D Server and 4D Client, the SSL protocol allows communications security reinforcement. Key generation, authentication and integrity mechanisms are handled transparently by 4D Server and do not require any additional user setting. Note: Encrypting client/server connections slows connections. Settings At the network level, the SSL protocol is inserted between the TCP/IP layer (low level) and the high level protocol. To use SSL in a classic client/server architecture, make sure that on the 4D Server machine as well as on every 4D Client machine, the 4DSLI.DLL file (Windows) or 4DSLI.bundle bundle (Mac OS) is properly installed. This is the Secured Layer Interface dedicated to the SSL management. It should be located: under Windows: next to the executable files of the 4D and 4D Server applications under Mac OS: in the Native Components subfolder of the 4D and 4D Server software packages. This file is installed by default. On the other hand, the encryption of 4D Server connections is not activated by default. You should activate this mode: open the Client-Server/Network options page of the Database settings dialog box and select the option Encrypt Client/Server Connections in the Encryption area (see section Configuration preferences). By default, the box is not checked. You should then quit and relaunch 4D Server so that this setting is taken into account. All 4D remote stations will then connect in secured mode. Secured Mode 4D Client Connection The circumflex accent (^) is placed before the name of the databases published in SSL mode in the TCP/IP page of the connection dialog box:

49 Note: When a database is not published dynamically in the Connection dialog box, the user can enter its name in the Custom page (see the Connecting to a 4D Server Database and Publishing preferences sections). In this case, a ^ (circumflex accent) must be placed before the database name if the database is published in secured mode; otherwise the connection will be rejected.

50 Managing the Resources folder The Resources folder of the database can be used to share custom data (pictures, files, subfolders, etc.) between the server machine and all the client machines. On the server machine, the Resources Resources folder must simply be located next to the database structure file. All referencing mechanisms associated with the Resources folder are supported in client/server mode (.lproj folder, XLIFF, pictures and so on). For more information about this point, please refer to the 4D Design Reference manual. Each client has a local copy of this folder. The contents of the local folder are automatically synchronized with that of the server each time the client connects. Moreover, client machines can be dynamically "notified" during a session when the contents of the Resources folder of the server database are modified by a developer. This notification can be triggered: either automatically by the server, two minutes after the last modification made by a client (this delay helps to avoid inopportune notification in the case where numerous files are being copied). or manually via the Notify clients command in the action menu of the resources explorer on the client machine at the origin of the modification. or by programming, via a NOTIFY RESOURCES FOLDER MODIFICATION command. This command is useful when the contents of the Resources folder are modified on the server machine via a stored procedure. On the client side, the way the notification of any modifications will be handled depends on how the "Update "Resources" folder during a session" preference is set. This can also be set individually via the SET DATABASE PARAMETER command. Three choices are available: no synchronization, auto synchronization or ask. For more information, please refer to the Configuration preferences section and the description of the SET DATABASE PARAMETER command. Lastly, each client machine can synchronize itself with the server at any time via the Update Local Resources command in the action menu of the resources explorer. For more information about the resources explorer, please refer to the 4D Design Reference manual in the Resources explorer chapter. Compatibility Note: In previous versions of 4D Server, the transfer of custom data was carried out via a folder named "Extras" that was placed next to the structure file. This folder is now obsolete and its use is no longer recommended. It nevertheless remains supported by 4D Server in order to preserve the compatibility of existing applications.

51 Registering a Database as a Service Under Windows, 4D Server can be launched as a Service. Compatibility note: This function is no longer available under Mac OS starting with version 12 of 4D Server. A 4D Server application registered as a service is automatically launched on start-up of the machine with the current database, even before a user session is opened. It is not closed when the user exits their session. This operation lets you guarantee the availability of a 4D Server database even in the event of an incident that requires restarting the machine. Maintenance can be carried out remotely. Notes: On a 64-bit Windows platform, a 4D Server application registered as a service is executed with no interface (the server administration window does not appear). For more information about the mechanisms for managing Services, refer to the documentation of your operating system. To register a 4D Server database as a Service, select Register Current Database as Service in the File menu of 4D Server. The next time the machine is started, 4D Server will be launched automatically and the current database opened. You can register any number of databases. Each database can be registered only once. Note: Under Windows, this command may be grayed out when access to the service management functions is restricted. In this case, to be able to use this command, you must either: Launch 4D Server with an administrator level (to do this, right click on the application icon and choose the Run as administrator command in the context menu) or Disable the User Account Control (UAC) via the "User Accounts" configuration panel (to do this, choose the "Never notify" option). Warning: Be sure to use a valid account when you open the session, otherwise an error message will be displayed. By default, 4D Server is executed with the "Local System Account", which may not necessarily have the settings required to use your application. In particular, if you want to be able to print, you must open the session with a user account which has default print settings. To change accounts, go to Control Panel > System and Security > Administrative Tools > Services. In the Services list, right-click on 4D Server, choose the Properties option, then go to the Log On tab and specify the account under which the server must run (setting used at next startup). To unregister your database, select Unregister Current Database from the 4D Server File menu. This command is dimmed if the database is not registered as a service. To unregister all 4D Server databases at once, select Unregister all Server Services from the 4D Server File menu. This command is dimmed if no 4D Server service is enabled. You cannot change the service registration status of 4D Server from within 4D Server, if the application has been launched as a service on start-up. In this case, the three menu items are disabled. To stop the service, use the Services control panel.

52 Setting up a logical mirror 4D Server offers an integrated solution that allows the setting up of a backup system via a logical mirror. This solution is based on two commands: New log file and INTEGRATE LOG FILE. What is a logical mirror? A logical mirror is a sophisticated backup mode, primarily intended for critical or high-load databases. Using a logical mirror consists in operating a database on one machine and keeping a copy of it that is periodically updated on a second machine. Both machines communicate via the network with the machine in operation regularly transmitting any changes made in the database to the mirror machine via the intermediary of the log file. In this way, when there is an incident affecting the operational database, the mirror database can be used to get things back in working order quickly without any data loss. Moreover, the operational database is never blocked by backup operations. Why choose to back up using a logical mirror? The use of a logical mirror corresponds to specific needs. The standard strategy based on periodic backups and the use of a log file in most cases offers a simple, reliable and inexpensive solution. The database is backed up regularly (every 24 hours in general). During backup, the database remains accessible in read-only mode. This period of partial unavailability is very short, and even in the case of large databases (greater than 2 GB), it lasts no longer than 5 minutes. This operation can even be programmed to take place outside of normal periods of database usage. Nevertheless, for certain kinds of organizations, such as hospitals for instance, critical databases must be entirely operational 24 hours a day. The database cannot be in read-only mode, even for a very short period of time. In this case, setting up a logical mirror is an appropriate solution. Note: The mirror database only reflects changes made to the data. This backup mode is not suitable for databases in the process of development, where frequent structural modifications will make the mirror rapidly obsolete or will require repeated updating of the mirror database structure. How it works Setting up a backup system using a logical mirror is based on two new commands: New log file and INTEGRATE LOG FILE. These commands are described in the 4D Language Referemce manual. The following principles are implemented: The database is installed on the main 4D Server machine (operational machine) and an identical copy of the database is installed on the 4D Server mirror machine. A test on startup of the application (for instance, for the presence of a specific file in a subfolder of the 4D Server application) is used to distinguish between the two versions (operational and mirror) and thus execute the appropriate operations. On the 4D Server machine in operation, the log file is segmented at regular intervals using the New log file command. Since no backup is carried out on the main server, the database remains permanently available in read-write mode. Each segment of the log file is sent to the mirror machine, where it is integrated into the mirror database using the INTEGRATE LOG FILE command. Setting up this system requires programming specific code, in particular: A timer on the main server for managing the execution cycles of the New log file command, A transfer system for the segments of the log file between the operational machine and the mirror machine (using 4D Internet Commands for a transfer via FTP or messaging systems, Web Services, etc.), A process on the mirror machine intended to supervise the arrival of new segments of the log file and to integrate them using the INTEGRATE LOG FILE command, A communication and error-handling system between the main server and the mirror server. WARNING: A backup system using a logical mirror is not compatible with standard backups on a database in use since the simultaneous use of these two backup modes would lead to the desynchronization of the operational and mirror databases. Consequently, you must be sure that no backups, whether automatic or manual, are carried out on the operational database. On the other hand, it is possible to backup the mirror database (see following paragraph). Backup of a mirror database 4D Server can be used to carry out backups of the database on the mirror machine.

53 Any conventional means can be used to carry out backups on the mirror machine: manual backups using the command in the File menu, scheduled backups set in the Preferences/Settings or programmed backups using language commands. To avoid risks of desynchronization with the operational machine, 4D automatically locks the mirror machine when it is carrying out one of two basic operations: the integration of the log file from the operational machine and the backup of the mirror database. When a log file is being integrated, it is not possible to carry out a backup. If the BACKUP command is used, the error 1417 is generated (see the Backup Manager Errors (1401 -> 1421) section in the manual 4D Language). When a backup is underway, all the processes are frozen and it is not possible to launch the integration of a log file. Beginning with 4D v14, you can enable the current log file on the mirror machine, which means that you can set up a "mirror-mirror," or a series of cascading mirror servers. This possibility is based on the INTEGRATE MIRROR LOG FILE command. For more information, refer to the description of this command. Operating scenario for a logical mirror The following scenario illustrates, from the viewpoint of each 4D Server machine, the setting up of a backup system using a mirror: Step Operational machine Mirror machine 1 Start up of the application, back up of the data file and activation (when necessary) of the log file. 4D creates the MyDatabase.journal file. For better security, this file is stored on a separate hard disk. The application is exited. Copy of all the database files (log file included) onto the mirror machine. Start up of the mirror application. 4D Server requests the current log file: 2 Select the MyDatabase.journal file that was transferred from the Restarting of the application and beginning operational database. If you do not want to use the log of the mirror, of operation (verify that there is not a full disable the current log on the Backup/Configuration page of the backup programmed). Preferences/Settings (make sure the Use Log File option is not checked). Decision made to update the mirror (for 3 example, after a certain period of operation). Execution of the method containing the New log file. The file saved is named MyDatabase[ ].journal. Sending of the MyDatabase[ ].journal file via programming to the mirror machine (using 4DIC, Web Services, etc.). The database is operating. Detection of a file that is waiting to be integrated. Execution of the 4 method containing the INTEGRATE LOG FILE command in order to integrate the MyDatabase[ ].journal file. Incident occurs on the machine; the 5 database is unusable. Decision made to switch to the mirror machine. Copy of the current log file MyDatabase.journal onto the mirror machine, via the usual destination folder 6 Analysis of incident and repair. Detection of a file that is waiting to be integrated. Execution of the method containing the INTEGRATE LOG FILE command in order to integrate the MyDatabase.journal file. As a precaution, creation of a current log file using the Backup/Configuration page of the Preferences. The database is operating. 7 The machine is repaired. Replacement of the database files by those of the mirror database. Start up of the application. 4D Server requests the log file: Select the file that was transferred from the mirror database. The database is exited. Return to step 2.

54 Janela de administração de 4D Server 4D Server tem uma janela de administração completa e fácil de usar. Esta janela oferece diferentes ferramentas de análise e controle para bases de dados publicadas. A janela contém várias páginas que podem ser acessar utilizando os botões na parte superior: Cada página se detalha em uma seção deste capítulo. Nota: A janela de administração pode acessar desde um computador 4D remoto. Para obter mais informação sobre este ponto, consulte a seção Administração de máquinas remotas. Página Monitor Página Usuários Página Processos Página Manutenção Página Servidor de Aplicações Página Servidor SQL Página Servidor HTTP Página Monitor tempo real

55 Página Monitor A página Monitor mostra informação dinâmica sobre o uso da base bem como informação do sistema e a aplicação 4D Server: Nota: Em Windows, a visualização desta informação está relacionada com os direitos do usuário que abriu a sessão. Para maior informação, consulte o parágrafo Visualização de informação do monitor (Windows). Área gráfica A área gráfica permite visualizar a evolução em tempo real de vários parâmetros: o uso dos processadores, o tráfico de rede e a ocupação da memória. Você seleciona o parâmetro a mostrar utilizando o menu localizado ao centro da janela: Uso de processadores: uso global de CPU da máquina, para todas as aplicações juntas. A parte específica de 4D Server nesta taxa de uso está na área de informação "Processadores". Rede: número de bytes recebidos por segundo por 4D Server. O número de bytes enviados por 4D Server se oferece na área de informação "Rede".

56 O número de bytes enviados por 4D Server se oferece na área de informação "Rede". Memória física: quantidade de memória RAM da máquina utilizada por 4D Server. Uma vista mais detalhada do uso da memória se encontra na área de informação "Memória". Memória Virtual: mostra na área gráfica a quantidade de memória virtual utilizada pela aplicação 4D Server. Esta memória é atribuída pelo sistema de acordo as necessidades da aplicação. O valor na parte inferior direita da área indica a quantidade de memória em uso. O valor na parte superior esquerda indica a quantidade máxima de memória virtual utilizada. O valor máximo se calcula dinamicamente em função dos parâmetros de memória geral da aplicação. Cachê: Mostra na área gráfica a quantidade de memória cachê utilizada pela aplicação 4D Server. O valor na parte inferior direita da área indica a quantidade de memória em uso. O valor na parte superior esquerda indica o tamanho total da memória cachê, tal como foi definido nas Propriedades da base. Observe que quando esta opção está selecionada, o deslocamento da área gráfica desacelera porque uma análises eficaz da cachê se realiza geralmente em um período de observação bastante longa. Área Introdução A área "Introdução" oferece diferente informação relativa ao sistema, a aplicação e as licenças instaladas na máquina de 4D Server. Área Detalhes A área "Detalhes" repete parte da informação mostrada na área gráfica e oferece informação adicional. Disco duro: Capacidade global do disco duro e distribuição entre o espaço ocupado pelos dados da base (arquivo de dados + índice de dados), o espaço utilizado por outros arquivos e o espaço disponível. Memória: Memória RAM instalada na máquina e quantidade de memória ocupada por 4D Server, pelas outras aplicações e memória disponível. A memória ocupada por 4D Server pode igualmente ser mostrada dinamicamente na área gráfica. Processadores: Taxa instantânea de ocupação dos processadores da máquina por 4D Server e pelas outras aplicações. Esta taxa se recalcula permanentemente. A taxa de ocupação por 4D Server também pode ser mostrada dinamicamente na área gráfica. Rede: Número instantâneo de bytes recebidos pela rede por 4D Server e número de bytes enviados pela aplicação. Este valor se atualiza constantemente. O número de bytes recebidos por 4D Server também podem ser mostrados dinamicamente na área gráfica.

57 Mostrar informação do monitor (Windows) Em Windows, alguma informação do sistema mostrada na página Monitor se recupera nas ferramentas do "Monitor de rendimento" de Windows. O acesso a estas ferramentas somente se permite quando o usuário que abre a sessão aonde foi lançado 4D Server tem as autorizações necessárias. Este usuário deve: Pertencer ao grupo "Administradores", Em Windows Vista: pertencer ao grupo "Usuários do monitor de rendimento" (para um usuário que não é Administrador). Para colocar um usuário no administrador no grupo "Usuários do analisador de rendimento" em Windows Vista (necessitará usar uma conta Administrador para fazer estas operações): 1. Ir para o painel de controle e abra o painel de "Contas de usuário". 2. Faça clique na guia "Opções Avançadas" e depois no botão "Avançado" da seção "Gestão avançada de usuários". É executada a aplicação "Usuários e grupos locais". 3. Duplo clique na pasta "Grupos". 4. Duplo clique no grupo "Usuários do monitor de rendimento". Aparece uma janela chamada "Propriedades de usuários do monitor de rendimento". 5. Faça clique no botão Adicionar... para adicionar um usuário. 6. Na área de texto titulada "Introduzir os nomes dos objetos a selecionar," introduzir os nomes dos usuários a autorizar. 7. Faça clique em Aceitar (duas vezes). Feche a aplicação "Usuários e grupos locais" depois as "Contas de usuários."

58 Página Usuários A página Usuários lista os usuários conectados à base: O botão "Usuários" indica, entre parênteses, o número total de usuários conectados a base (este número não leva em conta os possíveis filtros de visualização aplicados a janela). Esta página também contém uma área de pesquisa dinâmica e os botões de controle. Pode modificar a ordem das colunas arrastando e soltando a área de cabeçalho das colunas. Também pode ordenar a lista de valores de uma coluna fazendo clique no seu cabeçalho: Faça clique várias vezes para definir alternativamente uma ordem ascendente/descendente. Lista de usuários Para cada usuário conectado a base, a lista oferece a seguinte informação: Sistema da máquina cliente (Mac OS ou Windows) forma de ícone. Usuário 4D: nome de usuário 4D. Se as senhas não estão ativas, todos os usuários se chamam "Desenhador." Nome de máquina: nome da máquina cliente. Nome de sessão: nome da sessão aberta na máquina cliente. Direção IP: direção IP da máquina cliente. Conexão: data e hora da conexão da máquina cliente. Tempo CPU: tempo de CPU consumido por este usuário desde a conexão. Atividade: rádio de tempo que 4D Server outorga a este usuário (visualização dinâmica). Área de pesquisa/filtro Esta função permite reduzir o número de linhas mostradas na lista as quais correspondem ao texto introduzido na área de pesquisa. A área indica as colunas nas quais será realizada a pesquisa/filtro. Na página Usuários, serão as colunas Usuário 4D,

59 Nome de máquina e Nome de sessão. A lista se atualiza em tempo real a medida que introduz o texto na área. É possível introduzir mais de um valor a buscar. Utilize ponto e vírgula para separar os valores. O operador utilizado neste caso é de tipo OU. Por exemplo, é introduzido "João;Maria;Pedro," somente serão conservadas as linhas com João OU Maria OU Pedro nas colunas objetivo. Botões de administração Esta página inclui três botões de controle. Estes botões estão ativos se pelo menos uma linha está selecionada. Pode selecionar várias linhas pressionando a tecla Shift para uma seleção adjacente ou Ctrl (Windows) / Comando (Mac OS) para uma seleção não adjacente. Enviar mensagem: Este botão permite enviar uma mensagem aos usuários 4D selecionados na janela. Se nenhum usuário 4D está selecionado, o botão se desativa. Ao fazer clique neste botão, aparece uma caixa de diálogo que lhe permite introduzir a mensagem. A caixa de diálogo indica o número de usuários que receberão a mensagem: A mensagem será mostrada em forma de alerta nas máquinas clientes: Visualizar processos: Este botão permite visualizar diretamente os processos de usuário selecionado na página Processo da janela de administração. Ao fazer clique no botão, 4D Server passa para a página Processos e introduz os nomes de usuários selecionados na área de pesquisar/filtrar desta página. Para maior informação, consulte a descrição desta página. Desconectar: Este botão pode ser utilizado para forçar a desconexão dos usuários selecionados. Quando você faz clique neste botão, aparece uma caixa de diálogo de alerta que lhe permite confirmar ou anular a operação. Nota: Pode também desconectar diretamente os usuários selecionados sem mostrar a caixa de diálogo de confirmação: para fazer isto, pressione Alt (Windows) ou Opção (Mac OS) enquanto pressiona o botão Desconectar.

60 Página Processos A página Processos lista os processos em execução: O botão "Processos" indica entre parênteses o número total de processos em execução na base (este número não leva em consideração os possíveis filtros de visualização aplicados a janela, nem ao estado da opção Mostrar os processos por grupos). Pode mudar a ordem das colunas simplesmente arrastando e soltando as áreas de cabeçalho das colunas. Também pode ordenar a lista dos valores de uma coluna fazendo clique em seu cabeçalho. Como a Página Usuários, esta página contém uma área de pesquisa/filtro dinâmica, que permite reduzir o número de linhas mostradas na lista que corresponda o texto introduzido na área de pesquisa. A pesquisa/filtro se realiza nas colunas Sessão e Nome de processo. Também existem três botões de atalhos que permitem filtrar por tipo os processos mostrados na janela: Processos de usuário: processos gerados por e para as sessões usuário. Estes processos estão precedidos por um ícone em forma de pessoa. Processos 4D: processos gerados pelo motor de 4D Server. Estes processos estão precedidos por um ícone em formato de roda serrilhada. Processos livres: processos inativos mas que são conservados temporariamente e que podem ser reutilizados em qualquer momento. Este mecanismo otimiza a reatividade de 4D Server. Estes processos estão precedidos por um ícone cinza em forma de pessoa. A opção Mostrar os processos por grupos permite reagrupar os processos internos de 4D Server assim como os processos cliente, para maior legibilidade. Quando seleciona esta opção: Os processos clientes 4D "twinned" (Processos cliente 4D principal e Processos base 4D client, ver o parágrafo Tipo de processo ) se juntam em um só, É criado um grupo "Administradores de tarefas"; o qual inclui os processos internos dedicados a repartição das tarefas

61 (Shared balancer, Net session manager, Exclusive pool worker), É criado o grupo "Gerenciamento de clientes"; o qual inclui os diferentes processos internos clientes. A área inferior da janela permite mostrar a representação gráfica da atividade dos processos selecionados: Nota: Pode selecionar várias linhas pressionando a tecla Shift para uma seleção adjacente ou Ctrl (Windows) / Comando (Mac OS) para uma não adjacente. A atividade do processo é a porcentagem de tempo que 4D Server tem dado a este processo (radio). Como nas versões anteriores de 4D Server, a janela oferece a seguinte informação para cada processo: Tipo de processo (ver a continuação), Sessão (vazia no caso de um processo 4D e nome de usuário 4D no caso de um processo usuário), Nome do processo, Número do processo (tal como devolve a função New process por exemplo). O número do processo é o número atribuído pelo servidor. No caso de um processo global, este número pode ser diferente do assinalado no computador cliente. Estado atual do processo, Tempos (em segundos) de execução do processo desde sua criação, Porcentagem de tempo que 4D Server deu a este processo (radio). Tipo de processo Cada processo está identificado por um ícone e um tipo. A cor e a forma do ícone indica o tipo de processo: Servidor de aplicação Servidor SQL Servidor DB4D (motor do banco de dados) Servidor web Servidor SOAP Processo cliente 4D protegido (processo desenvolvido de um 4D conectado) Processo cliente 4D principal (processo principal de um 4D conectado). Processo colaborador, equivalente ao servidor do processo criado na máquina cliente) Processo base 4D client (processo paralelo a um processo 4D client. Processo preemptive responsável de controlar o processo cliente 4D principal correspondente) Processo em espera (anterior o futuro "Processo cliente 4D banco de dados") Processo 4D client (processo executado no 4D conectado) Procedimento armazenado (processo lançado por um 4D conectado e executado no servidor) Método web (lançado por um 4D ACTION por exemplo) Método SOAP (lançado por um serviço web) Método SQL (lançado por uma petição SQL) Nota: Um processo cliente 4D principal e seu processo base 4D client "twinned" são agrupados quando a opção Mostrar os processos por grupos está selecionada. Botões de administração A página tem cinco botões de controle que atuam nos processos selecionados. Observe que somente se pode atuar nos processos usuário. Abortar processo: permite abortar os processos selecionados. Ao fazer clique neste botão, aparece uma caixa de diálogo de alerta de maneira que possa confirmar ou cancelar a operação. Nota: também pode abortar diretamente os processos selecionados sem mostrar a caixa de diálogo de confirmação pressionando a tecla Alt (Windows) ou Opção (Mac OS) enquanto faz clique neste botão. Pausar processo: permite colocar pausa aos processos selecionados. Ativar processo: permite reativar ele ou os processos selecionados. Os processos devem ter sido suspendidos anteriormente (utilizando o botão Parar ou por programação); caso contrário, este botão não tem nenhum efeito. Depurar processo: permite abrir no computador servidor uma ou várias janelas do depurador para os processos

62 selecionados. Ao fazer clique neste botão, aparece uma caixa de diálogo de maneira que pode confirmar ou cancelar a operação. Observe que a janela do depurador não mostra quando o código 4D é executado no computador servidor (por exemplo dentro de um trigger ou da execução de um método com o atributo "Execute on Server"). Nota: também pode depurar diretamente um processo, sem mostrar a caixa de diálogo de confirmação, pressionando a tecla Alt (Windows) ou Opção (Mac OS) enquanto realiza clique neste botão. Olhar usuários: permite mostrar na página Usuários todos os processos dos usuários selecionados. Este botão está ativo quando pelo menos um processo usuário está selecionado.

63 Página Manutenção A página Manutenção oferece informação sobre o funcionamento atual da base. Também oferece acesso às funções de manutenção básicas: Última verificação: Esta área indica a data, hora e o estado da última verificação de dados realizada na base. Para maiores informações sobre a verificação de dados, consulte o manual de Desenho. O botão Verificar registros e índices permite lançar diretamente a operação de verificação sem interromper o servidor. Observe que o servidor pode diminuir durante a operação. São verificados todos os registros e índices da base. Se você quiser definir a verificação ou ter opções adicionais, você precisará do Centro de segurança e manutenção (CSM). Após verificação, ele gera um relatório de arquivos no formato XML e HTML no servidor na pasta Logs localizado ao lado da estrutura do arquivo base. O botão Ver relatório (chamado Baixar relatório se a operação for realizada desde uma máquina cliente) permite exibir o arquivo no seu navegador. Última compactação: Esta área indica a data, hora e o estado da última compactação do banco de dados. Para obter mais informações sobre o processo de compactação de dados, consulte o manual de Desenho. O botão Compactar dados... permite lançar diretamente uma operação de compactação de dados. Esta operação requer parar o servidor: ao clicar neste botão, aparece a caixa de diálogo de fechamento da base 4D Server, permitindo que você escolha o modo de interrupção da operação:

64 Para maior informação sobre esta caixa de diálogo, consulte a seção Sair de 4D Server. Após a interrupção da base, 4D Server executa uma compactação padrão dos dados da base. Se você quer opções adicionais, você precisará do Centro de segurança e manutenção (CSM). Quando termine a compactação, 4D Server reiniciará automaticamente a base. Os usuários 4D podem se reconectar. Nota: Se o pedido de compactação é realizado de um computador 4D cliente remoto, esta máquina é reconectada automaticamente pelo 4D Server. Um arquivo de relatório é gerado nos formatos XML e HTML no servidor na pasta Logs localizado ao lado da estrutura do arquivo base. O botão Ver relatório (chamado Baixar relatório se a operação é feita de um computador cliente) permite que você mostre o arquivo no seu navegador. Duração de funcionamento: esta área indica a duração do funcionamento do servidor desde a última vez que se iniciou (dias, horas e minutos). O botão Reiniciar o servidor... permite reiniciar imediatamente o servidor. Ao fazer clique neste botão, aparece a caixa de diálogo de fechamento da base 4D Server de modo que possa escolher o modo de interromper a operação (ver a seção Sair de 4D Server). Depois de reiniciar, 4D Server faz o relançamento automaticamente da base. Os usuários 4D podem ser reconectados. Nota: se a petição de reinicio se realiza desde uma máquina 4D client remota, esta máquina se reconecta automaticamente por 4D Server. Último backup: Esta área indica a data e hora do último backup da base e fornece informações sobre o próximo backup automático agendado (se houver). Os backups automáticos são configurados usando a página "periodicidade" das preferências de base. - Próximo backup data e hora do próximo backup automático. - Espaço necessário: espaço estimado para o backup. O tamanho atual do arquivo de backup pode variar de acordo com os parâmetros (compressão, etc.) e de acordo as variações do arquivo de dados. - Espaço disponível: espaço disponível no volume do backup. O botão Backup da base permite iniciar o backup da base imediatamente usando os parâmetros atuais de backup (arquivos salvados, localização dos arquivos, opções, etc.). Você pode ver esses parâmetros clicando no botão Preferências... Durante um backup no servidor, as máquinas clientes são "bloqueadas" (mas não desligadas) e não é possível conectar novos clientes. Petições e depuração: Esta área indica a duração do registro do histórico de petições e dos eventos de depuração quando ele estiver ativo. O arquivo de histórico de petições guarda diferente informação sobre os pedidos recebidos pelo servidor (excluindo as solicitações da web): hora, número de processo, usuário, o tamanho da solicitação, duração do processo, etc., que podem ser usados para analisar a operação do servidor. Esse arquivo é denominado 4DRequestsLog_X (onde X é o número sequencial do arquivo) e é armazenado na pasta Logs da base. Uma vez que o arquivo chegar a um tamanho de 10 MB, fecha e gera um novo arquivo, com um número sequencial aumentado. O arquivo de eventos de depuração armazena cada execução de um método, comando 4D ou comando de plug-in em um arquivo chamado "4DDebugLog.txt", localizado automaticamente na pasta Registros da base, junto ao arquivo de estrutura. Cada evento se registra de maneira sistemática no arquivo antes de sua execução, o que garante sua presença no arquivo inclusive se a aplicação é fechada inesperadamente. Tenha em conta que este arquivo é apagado e reescreve cada vez que é iniciada a aplicação. Pode configurar este arquivo com o comando SET DATABASE PARAMETER. O botão Iniciar o histórico de petições permite gerar um novo arquivo e ativar o modo de registro dos pedidos. Como isto pode prejudicar significativamente o desempenho do servidor, ele é reservado para a fase de desenvolvimento do aplicativo. Uma vez ativado o registro de petições, o título do botão muda para Parar o histórico de petições, assim pode parar o registro das solicitações a qualquer momento. Lembre-se de que iniciar o histórico de solicitações após interrompê-lo "apaga" o arquivo anterior. Nota: É possível iniciar e parar o histórico de petições por programação através do comando SET DATABASE PARAMETER. O botão Ver relatório (chamado Baixar relatório se a operação é realizada desde um computador cliente) lhe permite abrir uma janela sistema mostrando o arquivo de histórico das petições.

65 Página Servidor de Aplicações A página Servidor de aplicações reúne a informação relativa ao banco de dados publicado por 4D Server e permite administrar esta publicação: Informação do estado A parte superior da página oferece informação sobre o estado atual do servidor de aplicações de 4D Server. Estado: Iniciado ou Parado. Hora de inicio: data e hora de lançamento da base servidor. Esta data corresponde a abertura da base por 4D Server. Duração de funcionamento: tempo decorrido desde a última abertura da base. Botão Aceitar/Rejeitar novas conexões Este botão alterna entre dois estados e permite administrar o acesso dos novos computadores clientes a aplicação servidor. Por padrão, quando é publicada a base: O botão se chama "Rejeitar novas conexões." Novos clientes podem ser conectados livremente (dentro dos limites das conexões permitidas pela licença). O nome da base é publicada na caixa de diálogo de conexão (se a opção "Publicar o nome da base ao início no diálogo de conexão" está selecionada nas Preferências). Se fizer clique no botão Rejeitar novas conexões: O título do botão mudar a "Aceitar novas conexões." Nenhum novo cliente pode ser conectado. O nome da base não é mais mostrado na caixa de diálogo de conexão. Os clientes conectados não se desconectam e podem continuar trabalhando normalmente. Se você fizer clique no botão Aceitar novas conexões, a base volta a seu estado por padrão. Esta característica permite por exemplo a um administrador executar várias operações de manutenção (verificação, compactação, etc) apenas depois de iniciar o servidor. Se o administrador utiliza uma conexão cliente, pode ter certeza de ser o

66 único que modifica os dados. Também é possível usar essa função na preparação de uma operação de manutenção que requer que nenhum computador cliente esteja conectado. Configuração Esta área oferece informação sobre o banco de dados 4D publicado pelo servidor: nome e localização dos arquivos de estrutura e de dados e nome do arquivo de histórico da base. Pode fazer clique no nome do arquivo de estrutura ou de dados com a finalidade de visualizar seu caminho de acesso completo: O campo "Modo" indica o modo de execução atual da base: compilado ou interpretado. A parte inferior da área indica os parâmetros de configuração do servidor (lançado como serviço, porto e direção IP) e a ativação do SSL para as conexões cliente servidor (não preocupa as conexões SQL ou Web). Memória Esta área indica a memória cachê total (parâmetro definido nas preferências da base) e a memória cachê utilizada (localização dinâmica por 4D Server em função das necessidades). Conexões máximas "Máximo:" indica o número máximo de conexões clientes simultâneas autorizadas pelo servidor da aplicação. Este valor depende da licença instalada no computador servidor. "Used:" indica o número de conexões que atualmente estão sendo utilizadas.

67 Página Servidor SQL A página Servidor SQL agrupa a informação relativa ao servidor SQL integrado de 4D Server. Isso também inclui um botão que permite controlar a ativação do servidor: Informação do estado A parte superior da página oferece informação sobre o estado atual do servidor SQL de 4D Server. Estado: Iniciado ou Parado Hora de inicio: data e hora de lançamento da base do servidor SQL. Esta valor pode diferir do valor do servidor da aplicação se o lançamento do servidor SQL não se realiza "ao início." Tempo de funcionamento: tempo decorrido desde a última iniciação do servidor SQL. Botão Iniciar/ Parar o servidor SQL Este botão muda e permite controlar a ativação do servidor SQL de 4D Server. Quando o estado do servidor SQL é "Iniciado," o botão se chama Parar o servidor SQL. Se você fizer clique neste botão, o servidor SQL de 4D Server é detido imediatamente; não responde mais as petições SQL externas recebidas no porto TCP designado. Quando o estado do servidor SQL é "Detido," o botão se chama Iniciar o servidor SQL. Se você faz clique neste botão, o servidor SQL de 4D Server inicia imediatamente; responde as petições SQL externas recebidas no porto TCP designado. Você necessitará uma licença adequada para poder usar o servidor SQL de 4D. Nota: O servidor SQL também pode ser lançado automaticamente ao inicio da aplicação (opção das Preferências) ou por programação. Configuração Esta área fornece informações sobre os parâmetros de configurações do servidor SQL: lançamento automático no início,

68 Esta área fornece informações sobre os parâmetros de configurações do servidor SQL: lançamento automático no início, endereço IP de escuta, porto TCP (19812 por padrão) e ativação do SSL para as conexões SQL (não sobre conexões 4D nem Web). Estes parâmetros podem ser alterados por meio das Preferências de 4D. Conexões Número de conexões SQL atualmente abertas em 4D Server. Conexões máximas Número máximo de conexões SQL simultâneas autorizadas. Este valor depende da licença instalada no computador servidor.

69 Página Servidor HTTP A página Servidor HTTP agrupa a informação relativa ao funcionamento do servidor web e do servidor SOAP de 4D Server. O servidor web permite publicar conteúdo web tal como páginas HTML ou imagens para os navegadores web. O servidor SOAP administra a publicação dos serviços web. Estes dois servidores são apoiados no servidor HTTP interno de 4D Server. A página contém igualmente botões que permitem controlar a ativação dos servidores: Informação do estado A parte superior da página oferece informação sobre o estado atual do servidor HTTP de 4D Server. Estado: Iniciado ou Parado Hora de inicio: data e hora de lançamento da base do servidor HTTP. Este valor pode diferir do valor do servidor de aplicação se o lançamento do servidor HTTP não se realiza "ao início." Tempo de atividade: tempo decorrido desde a última iniciação do servidor HTTP. Número de visitas HTTP: número de visitas HTTP (nível baixo) recebidos pelo servidor HTTP desde seu início. Botão Iniciar/ Parar o servidor HTTP Este botão muda e permite controlar a ativação do servidor HTTP de 4D Server. Notas: Quando o estado do servidor HTTP é "Iniciado," o botão se chama Parar o servidor HTTP. Se você fizer clique neste botão, o servidor HTTP de 4D Server é detido imediatamente; o servidor web e o servidor SOAP não aceitam mais solicitações. Quando o estado do servidor HTTP é "Detido," o botão se chama Iniciar o servidor HTTP. Se você fizer clique neste botão, o servidor HTTP de 4D Server inicia imediatamente; são aceitas as petições web e as petições SOAP (observe que é possível parar separadamente o servidor SOAP, ver o parágrafo "Informação SOAP"). Deve ter uma licença apropriada para poder iniciar o servidor HTTP. O servidor HTTP também pode ser lançado automaticamente ao inicio da aplicação (opção das Preferências) ou por

70 programação. Informação Web Esta área oferece informação específica sobre o servidor web de 4D Server. Petições web: Aceitadas ou Rejeitadas. Esta informação indica se o servidor web está ativo. Como o servidor web está associado diretamente ao servidor HTTP, as petições web são aceitas quando se inicia o servidor HTTP e é rejeitado quando se detém. Conexões máximas: número máximo de conexões web autorizadas. Este valor depende da licença instalada no computador servidor. Informação SOAP Esta área oferece informação específica relativa ao servidor SOAP de 4D Server e inclui um botão de controle. Petições SOAP: Aceitadas ou Rejeitadas. Esta informação indica se o servidor SOAP está ativo. Para que se aceitem as petições SOAP, deve ser iniciado o servidor HTTP e o servidor SOAP deve aceitar explicitamente as petições (ver o botão Aceitar/Rejeitar). Conexões máximas: número máximo de conexões SOAP autorizadas. Este valor depende da licença instalada no computador servidor. Botão Aceitar/Rejeitar as petições SOAP: este botão muda e permite controlar a ativação do servidor SOAP de 4D Server. Este botão modifica o valor da opção Autorizar petições SOAP na página "Serviços web/soap" das Preferências (e vice versa). Se fizer clique no botão Aceitar petições SOAP e o servidor HTTP se detém, 4D inicia ele automaticamente. Configuração servidor HTTP Esta área oferece informação sobre os parâmetros de configuração e o funcionamento do servidor HTTP: Lançamento automático ao iniciar: parâmetro definido através das Preferências de 4D Server. Processos servidor HTTP (utilizado/total): número de processos HTTP criados no servidor (número atual de processos / total de todos os processos criados). Memória cachê (utilizada/total): tamanho da memória cachê do servidor HTTP, quando é ativado (tamanho ocupado realmente pela cachê / tamanho máximo teórico assinalado a cachê nas Preferências). Escutando direção IP, Porto TCP (80 por padrão), SSL ativo para as conexões HTTP (não convém as conexões 4D nem SQL) e Porto HTTPS utilizado: parâmetros de configuração atuais do servidor HTTP, especificados na página Web/Configuração das Preferências (ver a seção no manual de Linguagem de 4D). Informação sobre o arquivo de histórico: localização, formato e data do próximo backup automático de histórico do servidor HTTP (arquivo logweb.txt).

71 Página Monitor tempo real A página Monitor tempo real permite supervisionar em tempo real o progresso das operações "longas" realizadas pela aplicação. Estas operações são, por exemplo, pesquisas sequenciais, execução de fórmulas, etc.: Esta página está disponível na janela de administração da equipe servidor e também em uma equipe 4D remota. No caso de uma máquina remota, a página mostra os dados das operações realizadas na equipe servidor. Uma linha se adiciona para cada operação longa realizada sobre os dados. Esta linha desaparece automaticamente quando finaliza a operação. Se proporciona a seguinte informação para cada linha: Hora inicial: hora de início da operação em formato: "dd/mm/aaaa - hh:mm:ss" Duração (ms): duração em milissegundos da operação em curso Informação: título da operação. Sub-operações: operações dependentes da operação selecionada (as linhas que contém sub-operações que se mostram em negrito). A página está ativa e atualizada permanentemente tão rápido como é mostrado. Cabe dar o sinal que seu funcionamento pode desacelerar significativamente a execução da aplicação. É possível suspender a atualização desta página de uma das seguintes maneiras: ao fazer clique no botão Pausa, clique na lista, pressionando a barra de espaço. Quando a página está em pausa, aparecerá uma mensagem "SUSPENDIDA" e a etiqueta do botão muda a Reiniciar. Pode reiniciar a monitoração das operações mediante a realização da mesma ação que para fazer uma pausa. Nota: A monitoração em tempo real das operações também está disponível utilizando um comando, GET ACTIVITY SNAPSHOT, que contém opções adicionais.

72 Métodos banco de dados 4D Server Método banco de dados On Server Startup Método banco de dados On Server Shutdown Método banco de dados On Server Open Connection Método banco de dados On Server Close Connection

73 Método banco de dados On Server Startup Método banco de dados On Server Startup Este comando não requer parâmetros O Método banco de dados On Server Startup é chamado uma vez na máquina servidor quando abre uma base com 4D Server. O Método banco de dados On Server Startup NÃO é executado em um ambiente diferente a 4D Server. O Método banco de dados On Server Startup é a localização ideal para: Inicializar as variáveis interprocesso utilizadas durante toda a sessão 4D Server. Iniciar automaticamente os Procedimentos armazenados ao abrir a base. Carregar preferências ou parâmetros guardados durante a sessão anterior de 4D Server. Evitar a abertura da base se não se cumpre uma condição (ausência de recursos sistema) para uma chamada explícita a QUIT 4D. Realizar outras ações que queira fazer automaticamente cada vez que seja aberta a base. Para executar código automaticamente na máquina cliente quando um 4D remoto se conecta ao servidor, utilize o Método banco de dados On Server Startup. Nota: O Método banco de dados On Server Startup se executa de forma atômica, o que significa que nenhum 4D remoto pode ser conectado enquanto a execução do método não tenha terminado.

74 Método banco de dados On Server Shutdown Método banco de dados On Server Shutdown Este comando não requer parâmetros O Método banco de dados On Server Shutdown é chamado uma vez na máquina servidor quando a base atual é fechada em 4D Server. O Método banco de dados On Server Shutdown NÃO é chamado por outro ambiente 4D diferente de 4D Server. Para fechar a base atual no servidor, pode selecionar o comando de menu Fechar a base... no servidor. Também pode escolher o comando Sair ou chamar ao comando QUIT 4D dentro de um procedimento armazenado executado no servidor. Quando se inicia o processo de fechamento da base, 4D realiza as seguintes ações: Se não há um Método banco de dados On Server Shutdown, 4D Server aborta cada processo em execução um por um, sem distinção. Se existe um Método banco de dados On Server Shutdown, 4D Server executa este método em um novo processo local. Portanto pode utilizar este método base para informar os outros processos, via comunicação interprocesso, que devem deter sua execução. Note que 4D Server sairá finalmente, o Método banco de dados On Server Shutdown pode realizar todas as operações de limpeza ou fechamento que você queira, mas não pode recusar a sair e em algum momento terminará. O Método banco de dados On Server Shutdown é o lugar ideal para: Deter os procedimentos armazenados lançados automaticamente quando é aberta a base. Guardar (localmente, em disco) as preferências ou os parâmetros a reutilizar ao inicio da sessão seguinte no Método banco de dados On Server Startup. Realizar qualquer outra ação que queira ativar automaticamente cada vez que sair da base. Importante: Se utiliza o Método banco de dados On Server Shutdown para fechar os procedimentos armazenados, lembre que o servidor sai logo que se executa o Método banco de dados On Server Shutdown (e não os procedimentos armazenados). Se os procedimentos armazenados ainda estão correndo neste momento, serão abortados. Portanto, se deseja estar seguro de que os procedimentos armazenados se executem completamente antes de ser abortados pelo servidor, o Método banco de dados On Server Shutdown deve indicar aos procedimentos armazenados que devem terminar sua execução (por exemplo, utilizando uma variável interprocesso) e deve permitir a eles fechar (por meio de um laço de x segundos ou outra variável interprocesso). Se deseja que o código se execute automaticamente em uma máquina cliente quando um 4D remoto deixa de conectar-se ao servidor, utilize o Método banco de dados On Exit.

75 Método banco de dados On Server Open Connection $1, $2, $3 -> Método banco de dados On Server Open Connection -> $0 Parâmetro Tipo Descrição $1 Inteiro longo Número de usuário utilizado internamente por 4D Server para identificar os usuários $2 Inteiro longo Número de conexão utilizado internamente por 4D Server para identificar uma conexão $3 Inteiro longo Obsoleto: devolve sempre 0 (mas deve ser declarado) $0 Inteiro longo 0 se omitido = conexão aceita; outro valor = conexão rejeitada Quando é chamado o método base On Server Open Connection? O Método banco de dados On Server Open Connection é chamado uma vez no equipo servidor cada vez que um equipo remoto 4D inicia um processo de conexão. O Método banco de dados On Server Open Connection NÃO é invocado por outro entorno 4D diferente de 4D Server. O Método banco de dados On Server Open Connection é chamado cada vez que: um 4D remoto se conecta (inicio do processo principal) um 4D remoto abre o entorno Desenho (inicio do processo de Desenho) um 4D remoto inicia um processo global, (cujo nome começa por "$") o qual necessita da criação de um processo cooperativo no servidor (*). Este processo pode ser criado utilizando o comando New process, um comando de menu ou caixa de diálogo "Executar um método". Em cada caso com um 4D remoto, três processos são iniciados. Um na máquina cliente e outros dois no equipo servidor. Na máquina cliente, o processo executa o código e envia as petições a 4D Server. No equipo servidor, o processo 4D Client mantém o entorno da base de dados do processo cliente (as seleções atuais e o bloqueio de registros para o processo usuário) e responde aos pedidos enviadas pelo processo executado na máquina cliente. O processo base 4D Client está a cargo de controlar o processo 4D Client correspondente. (*) A partir de 4D v13, por razões de otimização os processos servidores (processo apropriado para os acessos ao motor da base e processo cooperativo para o acesso à linguagem) só são criadas durante a execução do código do lado do cliente. Por exemplo, estes são os detalhes de uma sequencia de código 4D que se executa em um novo processo cliente: [#code4d]// o processo global começa sem um novo processo no servidor, como um processo local. CREATE RECORD([Table_1]) [Table_1])field1_1:="Hello world" SAVE RECORD([Table_1]) // criação aqui do processo apropriado no servidor< Como se chama ao método base On Server Open Connection? O Método banco de dados On Server Open Connection é executado no equipo servidor no processo 4D Client que provocou a chamada do método. Por exemplo, se um 4D remoto se conecta a uma base 4D Server interpretada, é iniciado o processo usuário, o processo de desenho e o processo de registro do cliente (por defeito). O Método banco de dados On Server Open Connection se executa três vezes seguidas. A primeira vez dentro do processo principal, a segunda vez no processo de inscrição do cliente e a terceira vez no processo de desenhoo. Se os três processos são respectivamente o sexto, sétimo e oitavo processo a iniciar-se no equipo servidor, e é chamado Current process desde o Método banco de dados On Server Open Connection, a primeira vez Current process devolve 6, a segunda vez 7 e a terceira 8. Observe que o Método banco de dados On Server Open Connection se executa no equipo servidor, ao interior do processo 4D Client no servidor, independente do processo executado no cliente. Além disso, no momento em que se invoca o método, o processo 4D Client ainda não foi nomeado (PROCESS PROPERTIES não devolverá neste momento o nome do processo 4D Client). O Método banco de dados On Server Open Connection não têm acesso à tabela das variáveis processo do processo executado no client. Esta tabela reside no equipo client, não no equipo servidor. Quando o Método banco de dados On Server Open Connection acede a uma variável processo, trabalha com uma tabela de variáveis processo particular, criada dinamicamente pelo processo 4D Client. 4D Server passa três parâmetros de tipo Inteiro longo ao Método banco de dados On Server Open Connection e espera um resultado Inteiro longo. O método deve portanto ser declarado explicitamente com três parâmetros Inteiro longo assim também como com um resultado de função Inteiro longo: C_LONGINT($0;$1;$2;$3) Se não devolve um valor em $0, por conseguinte deixa a variável indefinida ou inicializada em zero, 4D Server considera que o método base aceita a conexão. Se não é aceitada a conexão, devolve um valor não nulo em $0. Esta tabela detalha a informação oferecida pelos três parâmetros passados no método base:

76 Parâmetro Descrição $1 Número de usuário utilizado internamente por 4D Server para identificá-los $2 Número de conexão utilizado internamente por 4D Server para identificá-la $3 Obsoleto: sempre devolve 0 mas deve ser declarado Estes números de referencia não são utilizados diretamente como fontes de informação a passar, por exemplo, como parâmetros a um comando 4D. No entanto, oferecem uma maneira particular de identificar um processo 4D Client entre o Método banco de dados On Server Open Connection e o On Server Close Connection database method. A combinação destes valores é único no momento de uma seção 4D Server. Ao guardar esta informação em uma tabela ou em um array entre processos, os dois métodos base podem trocar informações. No exemplo ao final desta sessão, os dois métodos base utilizam esta informação para armazenar a data e hora de inicio e fim de uma conexão no mesmo registro de uma tabela. Exemplo 1 O seguinte exemplo mostra como manter um histórico das conexões a base de dados utilizando o Método banco de dados On Server Open Connection e utilizando o On Server Close Connection database method. A tabela [Server Log] (mostrada a continuação) se utiliza para fazer seguimento aos processos de conexão: A informação armazenada nesta tabela é administrada pelo Método banco de dados On Server Open Connection e o On Server Close Connection database method listado a continuação: ` Método base On Server Open Connection C_LONGINT($0;$1;$2;$3) ` Criar um registro [Server Log] CREATE RECORD([Server Log]) [Server Log]Log ID:=Sequence number([server Log]) ` Guardar o histórico Data e Hora [Server Log]Log Date:=Current date [Server Log]Log Time:=Current time ` Guarda a informação de conexão [Server Log]User ID:=$1 [Server Log]Connection ID:=$2 SAVE RECORD([Server Log]) ` Não devolve erro de maneira que a conexão pode continuar $0:=0 ` Método base On Server Close Connection C_LONGINT($1;$2;$3) ` Recuperar o registro [Server Log] QUERY([Server Log];[Server Log]User ID=$1;*) QUERY([Server Log];&;[Server Log]Connection ID=$2;*) QUERY([Server Log];&;[Server Log]Process ID=0) ` Guardar data e hora de desconexão [Server Log]Exit Date:=Current date [Server Log]Exit Time:=Current time ` Guardar informação processo [Server Log]Process ID:=Current process PROCESS PROPERTIES([Server Log]Process ID;$vsProcName;$vlProcState;$vlProcTime) [Server Log]Process Name:=$vsProcName SAVE RECORD([Server Log]) Estas são algumas entradas em [Server Log] mostrando várias conexões remotas:

77 Exemplo 2 O seguinte exemplo evita uma nova conexão entre as 2 e 4 A.M. ` Método base On Server Open Connection C_LONGINT($0;$1;$2;$3) If((?02:00:00?<=Current time)&(current time<?04:00:00?)) $0:=22000 Else $0:=0 End if

78 Método banco de dados On Server Close Connection $1, $2, $3 -> Método banco de dados On Server Close Connection Parâmetro Tipo Descrição $1 Inteiro longo Número de usuário utilizado internamente por 4D Server para identificar usuários $2 Inteiro longo Número de conexão utilizado internamente por 4D Server para identificar uma conexão $3 Inteiro longo Obsoleto: devolve sempre 0 mas deve ser declarado Descrição O Método banco de dados On Server Close Connection é chamado no computador servidor cada vez que termina um processo 4D Client. Como para o On Server Open Connection database method, 4D Server passa três parâmetros de tipo inteiro longo ao Método banco de dados On Server Close Connection. Por outra parte, 4D Server não espera um resultado em retorno. O método deve conter a declaração explícita de três parâmetros Inteiro longo: C_LONGINT($1;$2;$3) Esta tabela detalha a informação oferecida pelos três parâmetros passados ao método base: Parâmetro Descrição $1 Número de usuário utilizado internamente por 4D Server para identificar usuários $2 Número de conexão utilizado internamente por 4D Server para identificar uma conexão $3 Obsoleto: devolve sempre 0 mas deve ser declarado O Método banco de dados On Server Close Connection é o inverso exato do On Server Open Connection database method. Para maior informação e uma descrição deste método base, assim como para a descrição dos processos 4D Client, ver a descrição deste método base. Exemplo Ver o primeiro exemplo para On Server Open Connection database method.

79 Uso de um 4D Remoto Conexão a um banco de dados 4D Server Administração de máquinas remotas Compilação de máquinas remotas

80 Conexão a um banco de dados 4D Server Conectando com uma aplicação remota Há três maneiras de se conectar a um banco de dados 4D Server via um 4D remoto: Usar a caixa de diálogo da conexão Usar o menu Abrir Banco Recente Usar um atalho 4DLink contendo os parâmetros de acesso ao Banco de Dados. Usar a caixa de diálogo de conexão Para mostrar a caixa de diálogo de conexão 4D Server, primeiro inicie uma aplicação 4D. Você pode usar o comando Abrir no menu Arquivo (ou o botão correspondente na barra de ferramentas 4D) para selecionar o modo de abertura do banco de dados 4D: Selecione o comando Abrir>Banco Remoto... A caixa de diálogo de conexão 4D Server aparece. Essa caixa de diálogo tem três páginas e poder ser acessada através das seguintes abas: Recente, TCP/IP e Personalizado:

81 Se você selecionar a opção Exibir essa janela na próxima vez, essa caixa de diálogo aparecerá automaticamente na próxima vez que uma aplicação 4D iniciar. Nota: Você também pode iniciar essa caixa de diálogo ao selecionar o link Conectar ao 4D Server no Assistente de Boas Vindas.. Aba Disponível O 4D Server inclui um sistema de publicação TCP/IP integrado que publica automaticamente o nome do banco de dados 4D Server disponíveis na rede. Esses nomes estão listados na aba TCP/IP da caixa de diálogo de conexão. A lista está organizada por ordem de surgimento e é atualizada automaticamente. Para conectar-se a um servidor dessa lista, dê um duplo-clique no nome ou o selecione e clique no botão OK. Notas: Um acento circunflexo (^) aparece antes do nome dos bancos de dados publicados com a opção de encriptografado. Para maiores informações, consulte a seção Criptografar conexões cliente-servidor. É possível evitar a publicação dinâmica do banco de dados na rede (veja a seção Preferências de publicação). Nesse caso, a conexão só pode ser realizada manualmente na aba "Personalizado". Aba Recente

82 A aba Recente memoriza a listagem de todos os 4D servers usados recentemente. A lista está ordenada alfabeticamente. Para conectar-se a um servidor dessa lista, dê um duplo-clique no nome ou selecione o servidor e clique no botão OK.. Aba Personalizado A aba Personalizado permite designar um servidor publicado na rede usando seu endereço IP e criando um nome personalizado. Você pode personalizar o sistema de publicação TCP/IP do 4D Server de maneira que os nomes dos servidores de banco de dados não sejam publicados automaticamente na rede (veja a seção Preferências de publicação). Nesse caso, o nome não aparecerá na página "TCP/IP". Entretanto, se você sabe o endereço IP do servidor de uma base de dados cujo nome não está publicado, você pode entrar o endereço IP manualmente. Nome do banco de dados: permite definir o nome do banco de dados 4D Server. Esse nome será usado na aba Recente quando se referir a esse banco de dados. Endereço de Rede: permite entrar o endereço IP da máquina onde se encontra o 4D Server. Se dois servidores estão sendo executados simultaneamente na mesma máquina, o endereço IP deve ser acompanhado de uma vírgula e um número de porta, por exemplo: : A porta de publicação padrão do 4D Server is Esse número pode ser modificado na aplicação Preferências (veja a seção Preferências de configuração).

83 Nota: Se um banco de dados foi selecionado nas abas Recente ou TCP/IP no momento em que você clicou na aba Personalizado, os dois campos mostrarão a informação correspondente. Logo que essa aba atribuir um servidor, clique no botão OK, e você se conectará ao servidor. O servidor estará listado na aba Recente. Nota: Se o banco de dados for publicado usando a opção de criptografia, você deve adicionar um acento circunflexo (^) antes do nome; do contrário a conexão será recusada. Para maiores informações, veja a seção Criptografar conexões clienteservidor.criptografar conexões cliente-servidor Forçar a atualização dos recursos locais Essa opção causa a atualização periódica dos recursos locais na máquina cliente quando ela conecta. Os recursos locais são a informação estrutural relacionada ao banco de dados que está armazenada em cada máquina cliente. De maneira geral, a atualização dos recursos locais na máquina remota acontece automaticamente quando ela se conecta, se a estrutura do banco de dados foi modificada entre duas conexões. Na maior parte do tempo, essa opção é desnecessária. Mesmo assim, em certos casos pode ser necessário forçar a atualização. Usar o menu Abrir banco de dados recente O menu de comando Abrir Bancos Recentes pode ser usado para se conectar automaticamente a um banco de dados 4D Server ao qual você já se conectou previamente. Esse comando se encontra no menu Arquivo do 4D. Se você usar a aplicação 4D para abrir banco de dados locais e conectarse a banco de dados remotos, esse menu listará os dois tipos de bancos de dados. Os bancos de dados remotos estão disponíveis na parte de baixo do menu: O endereço IP do servidor está indicado ao lado do nome do banco de dados. O comando Excluir Menu pode ser usado para limpar o menu. Usar um arquivo 4DLink Você pode gerar arquivos de acesso a bancos de dados contendo os parâmetros com o objetivo de automatizar e simplificar a abertura ou conexão com os bancos de dados 4D. Geralmente, um arquivo de acesso pode salvar o endereço de um servidor remoto 4D Server assim como os identificadores de conexão, assim eliminando diversas operações para o usuário. Arquivos de acesso também podem ser usados para abrir bancos de dados locais. Criação de Arquivos Os arquivos de acesso dos bancos de dados 4D são arquivos XML que tem a extensão ".4DLink". 4D gera e usa esse tipo de arquivo para construir o submenu "banco de dados recentes": um arquivo.4dlink é automaticamente gerado por 4D quando um banco de dados local é aberto pela primeira vez ou na primeira vez em que se conecta a um servidor. Os arquivos.4dlink que são criados automaticamente por 4D estão disponíveis na pasta de preferências locais do usuário. Nessa pasta, dois diretórios são criados: Local e Remoto. A pasta Local contem os arquivos ".4DLink" que podem ser usados para conectar-se a bancos de dados locais, e a pasta Remoto contém os arquivos "4DLink" que podem ser usados para conectar-se a bancos de dados remotos. As pastas de preferências locais se encontram em: Windows 7 e posteriores: C:\Users\NomeUsuario\AppData\Roaming\4D\Favorites vxx\ OS X: Users/NomeUsuario/Library/Application Support/4D/Favorites vxx/... onde XX representa o número de versão da aplicação (por exemplo, "Favorites v14" para 4D v14). Os arquivos encontrados nesses diretórios são mostrados no submenu Abrir bancos recentes> do menu Arquivo do 4D:

84 Os arquivos ".4DLink" também podem ser criados com um editor XML e contém informação personalizada como identificadores de conexão (nome de usuário e senha) ou o modo de abertura do banco de dados. 4D oferece uma DTD que descreve as chaves XML que podem ser usadas para construir um arquivo ".4DLink". Esse DTD se chama database_link.dtd e se encontra na subpasta \Resources\DTD\ da aplicação 4D. Usar Arquivos Um arquivo de acesso.4dlink pode ser usado para iniciar uma aplicação 4D e abrir o banco de dados desejado. Há duas maneiras diferentes de fazer isso: Com um duplo-clique ou arrastar e soltar na aplicação 4D, Com o submenu Abrir bancos recentes (arquivo localizado na pasta de preferências locais). Um arquivo.4dlink do tipo "banco de dados remoto" pode ser copiado e usado em várias máquinas diferentes. Nota: Também é possível selecionar um arquivo 4DLink no 4D e na caixa de diálogo de abertura do 4D Server (apenas para a abertura de bancos de dados locais).

85 Administração de máquinas remotas Pode administrar o computador 4D Server desde um 4D remoto (computador client) abrindo a janela de administração de 4D Server (ver a seção Página Monitor) no computador cliente. Abrir a janela de administração em um computador 4D remoto Para abrir uma janela de administração do servidor desde um computador cliente, deve ser conectado a base remota como Desenhador ou Administrador. Caso contrário, quando tentar abrir a janela de administração, será gerado um erro de privilegio (- 9991). O acesso a janela é realizada por uma destas dois formas: Selecione o comando Janela de administração do menu Ajuda ou faça clique no botão correspondente na barra de ferramentas de 4D: Execute o comando OPEN ADMINISTRATION WINDOW. É mostrada uma janela de administração do servidor no computador cliente: Especificações da administração sob um computador cliente Um computador cliente que mostra a janela de administração do servidor tem acesso a toda informação disponível e pode atuar sobre os processos e o inicio dos servidores. Quando é mostrada a janela de administração do servidor em uma máquina cliente, há certas restrições e particularidades do funcionamento:

86 Na Página Processo, não é possível depurar um processo de usuário (a janela de depuração aparece na máquina servidor). Na Página Manutenção, é possível executar ações que permitam que todos os clientes se desconectem e o servidor se reinicie (compactação e reinicio). Neste caso, o computador cliente que solicita a operação volta a conectar-se automaticamente ao reiniciar. Na Página Manutenção, os botões Ver relatório mudam de nome por Baixar relatório depois da execução de uma operação de manutenção. Estes arquivos são baixados na pasta do banco de dados no computador cliente antes de ser mostrado.

87 Compilação de máquinas remotas É possível compilar uma aplicação 4D desde uma conexão remota. Em outras palavras, é possível compilar desde um computador cliente 4D. Nas versões de 4D Server anteriores a v11 SQL, a compilação só poderia ser conduzida desde a aplicação monousuário. Nota: Não é possível construir uma aplicação 4D personalizada (monousuário ou cliente/servidor) desde uma conexão remota. O Gerenciador de aplicações não é acessível neste ambiente (o comando de menu está atenuado). Do lado do cliente, a interface e os princípios de compilação são os mesmos que os das versões monousuário. A compilação pode ser ativada desde o menu Desenho ou na barra de ferramentas, ou desde a janela do compilador: Nota: A licença "4D Team Server" requer do lado de 4D Server para que os computadores clientes possam acessar a função de compilação. Só uma máquina cliente pode compilar uma base em um momento dado. A compilação por um cliente bloqueia a função das outras máquinas remotas. Se outro computador cliente tenta compilar a base ao mesmo tempo, aparece uma mensagem de advertência. Enquanto uma máquina cliente realiza uma compilação, as outras máquinas clientes podem seguir trabalhando e modificar os métodos ou qualquer outro elemento estrutural. O código compilado e o código interpretado serão diferentes, o que significa que será necessário voltar a compilar o banco de dados posteriormente. O código compilado é enviado no arquivo.db no servidor gradualmente a medida que a compilação seja realizada. Do lado do cliente, depois da finalização da operação, é possível reiniciar o servidor em modo interpretado ou em modo compilado utilizando os comandos correspondentes no menu Executar. Quando um computador 4D remoto solicita o reinicio do servidor em compilado/interpretado, aparece a caixa de diálogo estandarte de fechamento do servidor que lhe permite definir um tempo de espera ou enviar uma mensagem de advertência aos outros clientes (ver a seção Sair de 4D Server). Quando o servidor for reiniciado, o cliente na origem da operação de reinicio se conecta novamente automaticamente. Do lado do servidor, o reinicio em compilado/interpretado requer do uso da caixa de diálogo padrão de abertura de arquivos (menu pop up associado ao botão Abrir) Nota: A compilação na rede WAN, não se recomenda por razões de rendimento (especialmente no caso de bases com muitos métodos), como a operação gera uma grande quantidade de intercâmbios na rede.

88 4D Server e a linguagem 4D 4D Server e a linguagem 4D 4D Server, conjuntos e seleções temporais Procedimentos armazenados Procedimentos armazenados nas máquinas clientes Importação baseada nos procedimentos armazenados (exemplo) Serviços baseados nos procedimentos armazenados (exemplo) Executar no atributo servidor

89 4D Server e a linguagem 4D Com 4D Server, há três situações nas quais pode executar código 4D no computador servidor: Triggers Procedimentos armazenados Métodos de projeto com o atributo "Executar no servidor" Métodos base Triggers Um trigger é um método associado a uma tabela. Os triggers podem evitar operações ilegais nos registros de seu banco de dados. Os triggers é uma ferramenta muito poderosas que permite restringir as operações em uma tabela, como também evitar perdidas acidentais de dados ou sabotagem. Por exemplo, em um sistema de faturação, pode evitar que agregar uma fatura sem especificar o nome do cliente. Os triggers se executam na máquina na qual está o motor do banco de dados. Com 4D Server, os triggers se executam no contexto dos processos que correm no computador servidor e não no computador cliente. Mais precisamente, se executam no contexto dos processos "gêmeos" dos processos usuários que chamam a operação do banco de dados. Estes processos gêmeos compartilham o contexto da base com ls processos usuário no computador cliente (em particular, o estado das transações e o bloqueio dos registros) mas não compartilham o contexto da linguagem (variáveis, processos, conjuntos, seleções atuais). Observe no entanto que o registro atual da tabela do trigger é o mesmo em todos os contextos. Para maior informação sobre triggers, consulte a seção ARRAY REAL do manual de Linguagem 4D. Procedimentos armazenados Um procedimento armazenado 4D é um método de projeto executado em um processo separado na máquina servidor (ou em qualquer máquina cliente), no lugar da máquina cliente que lançou o método. Ver a seção Stored Procedures. Métodos com atributo "Executar no servidor" Os métodos de projeto que tem o atributo "Execute on Server" também são executados no servidor. No entanto, a diferença dos procedimentos armazenados, são executados nos processos "gêmeos" do processo cliente e se beneficiam de seu contexto do banco de dados. Para maior informação, consulte a seção Executar no atributo servidor. Métodos base Quatro métodos base unicamente são executados na máquina servidor: Método banco de dados On Server Startup ClientUpdateWin / StartElevatedMétodo banco de dados On Server Shutdown Método banco de dados On Server Open Connection Método banco de dados On Server Close Connection Cinco métodos base podem ser executados na máquina servidor ou em uma máquina cliente em função do contexto: Método de banco On Web Aunthentication Método de banco de dados On Web Connection Método de base On SQL Authentication Método de Banco de Dados On Backup Startup Método de Banco de Dados On Backup Shutdown Três métodos base unicamente podem ser executados em uma máquina cliente: Método banco de dados On Startup Método banco de dados On Exit Método de banco de dados On Drop Ver as seções correspondentes neste manual e no manual de Linguagem de 4D para maiores informações sobre os métodos base. 4D Server e as variáveis

90 4D Server mantém uma tabela de variáveis interprocesso. O alcance destas variáveis é o computador servidor. Para executar uma base compilada a definição da tabela das variáveis interprocessos é comum entre o servidor e todos os computadores cliente, cada máquina tem sua própria instância. Como todos os processos, cada procedimento armazenado, o método base e o trigger tem sua própria tabela de variáveis processo. Essas variáveis processo podem ser criadas e usados dinamicamente durante cada fase da execução. 4D Server, conjuntos e seleções temporais Com 4D Server, a visibilidade dos conjuntos e das seleções temporais dependem da origem da criação (processo servidor ou processo cliente) e o tipo destes objetos (objetos locais, processo ou interprocesso). Para maior informação, consulte a seção 4D Server, conjuntos e seleções temporais.

91 4D Server, conjuntos e seleções temporais Como se explica nas seções Conjuntos e Seleções temporárias do manual de Linguagem de 4D, pode criar e utilizar conjuntos e seleções temporais interprocesso, processo e locais: Conjuntos/seleções temporais processo: somente pode ser acessado a um objeto processo pelo processo no qual foi criado, se foi criado em um processo cliente, pelo processo "gêmeo" criado no servidor. Os conjuntos processo se apagam logo que termina a execução do método de processo. Os objetos processo não necessitam um prefixo particular no nome. Conjuntos/seleções temporais interprocesso: um objeto interprocesso é visível para todos os processos na máquina (cliente ou servidor) onde foi criado. Um conjunto ou seleção temporal é um objeto interprocesso se o nome do conjunto está precedido pelos símbolos (<>) um signo menor que seguido por um signo maior que. Nota: esta sintaxes pode ser utilizada em Windows e Macintosh. Além disso, em Mac OS unicamente, pode utilizar o símbolo diamante (Opção-Shift-V). Conjuntos/Seleções temporais/clientes: um objeto local/cliente é visível unicamente no processo onde foi criado. O nome de um objeto local/cliente está precedido pelo signo dólar ($). Nota: ainda que seu nome não começa por $, o conjunto sistema UserSet é um conjunto local/cliente. A seguinte tabela indica os princípios de visibilidade das seleções e conjuntos em função de onde foram criados (a tabela é idêntica para ambos tipos de objetos): x = visible Deve lembrar desta matriz de visibilidade em função das operações que queira realizar. Por exemplo, se deseja realizar uma operação de tipo DIFFERENCE, INTERSECTION ou UNION, tenha certeza de que todos os conjuntos possam ser vistos na máquina que realiza a operação. Por razões de otimização, se recomenda escolher o lugar de criação e o alcance dos objetos em função de suas necessidades de visibilidade.

92 Procedimentos armazenados O que é um procedimento armazenado em um sistema SQL? O termo "Procedimento armazenado" vem do mundo dos servidores SQL. Quando uma estação de cliente envia uma solicitação para um servidor SQL, ele na verdade envia texto em linguagem SQL ao servidor SQL. Este pedido é sintaticamente (parsing) e é executado no servidor SQL antes de executá-lo. Obviamente, se o texto do pedido é importante, e se a solicitação é enviada várias vezes durante uma sessão, você pode levar um longo tempo enviar o código na rede, a análise e a interpretação do pedido. Assim, a idéia era encontrar uma maneira de enviar o pedido através da rede, analisados e interpretados uma vez e, em seguida, unicamente executado cada vez que receba de uma estação cliente. A solução foi preservar o código fonte do pedido (em outras palavras, um procedimento) no servidor e que o cliente envie uma solicitação com apenas o nome do procedimento para executar. O procedimento é, portanto, "guardado" no servidor e daí vem o termo "procedimento armazenado." Observe que um procedimento armazenado SQL é um procedimento que pode receber parâmetros de uma estação cliente, execute as tarefas para as quais foi criado (de forma síncrona ou assíncrona) e possivelmente retornar um resultado para o cliente. Quando um cliente solicita a execução de um procedimento armazenado, em certa medida, ele delega a execução do código no computador do servidor. O que é um procedimento armazenado em 4D Server? Ainda que utilizamos o termo utilizado na indústria, as funções dos procedimentos armazenados de 4D Server superam significativamente o conceito regular de procedimentos armazenados. Com 4D em modo local, quando utiliza um comando como New process, pode abrir um processo usuário no qual pode executar um método. Este método é chamado um método processo (ver a seção Métodos de projeto no manual Linguagem de 4D). Pode fazer o mesmo com 4D Server, em um computador cliente. Além disso, utilizando o comando Execute on server na máquina servidor, pode iniciar um processo de usuário na qual executar um método. Além disso, utilizando o comando EXECUTE ON CLIENT, pode correr um método em outro processo em um cliente diferente. Em ambos casos, o método é chamado um procedimento armazenado e por extensão, o processo iniciado na máquina servidor ou outro computador cliente também chamado procedimento armazenado. Importante: A diferença principal entre um procedimento armazenado SQL e um procedimento armazenado 4D Server como no primeiro caso você executa um procedimento SQL, no segundo caso, execute um processo 4D autônomo. Arquitetura dos processos armazenados de 4D Como um processo 4D normal, um procedimento armazenado tem seu próprio ambiente: Uma seleção atual por tabela: cada procedimento armazenado tem sua própria seleção atual. Uma tabela pode ter uma seleção atual diferente em cada procedimento armazenado. Um registro atual por tabela: cada tabela pode ter um registro atual diferente em cada procedimento armazenado. Variáveis: cada procedimento armazenado tem suas próprias variáveis processo. As variáveis processo são reconhecidas unicamente no contexto do procedimento armazenado ao qual pertencem. Tabela por padrão: cada procedimento armazenado tem sua própria tabela por padrão. Conjuntos processo: cada procedimento armazenado tem seu próprio conjunto processos. On Error Call: cada procedimento armazenado tem seu próprio método de gestão de erros. Janela de depuração: cada procedimento armazenado tem sua própria janela de depuração. Em términos de interface de usuário, um procedimento armazenado pode abrir janelas e mostrar dados (DISPLAY RECORD). Um procedimento armazenado executado em uma máquina cliente 4D permite a entrada de dados. Por outra parte, um procedimento armazenado executado no servidor não permite a entrada de dados. Pode iniciar tantos procedimentos armazenados como autorize o sistema (hardware e memória). Na verdade, a máquina servidor deve ser considerada como uma máquina que não só responde aos clientes 4D e aos navegadores web, e também é capaz de executar processos que interagem com outros processos que passam na máquina servidor e nas máquinas remotas. Da mesma forma que 4D oferece um entorno multitarefas aos processos usuário que passam na máquina, 4D Server oferece um entorno multitarefas aos procedimentos armazenados. Por exemplo, 4D Server mantém uma tabela das variáveis interprocesso que podem ser utilizadas pelos processos armazenados para que se comuniquem entre eles. Nota: A propriedade de método "Executar em servidor" permite executar um método em um processo no servidor, mas o método utiliza um processo "twinned" do processo cliente, que lhe permite em particular ser beneficiado do ambiente deste processo cliente. Neste caso, não é um procedimento armazenado 4D. Para maior informação, consulte a seção Executar no atributo servidor. O que um procedimento armazenado pode fazer? Grande parte das funções dos processos e comandos descritas no manual de Linguagem 4D aplicam também aos

93 procedimentos armazenados, exceto pela entrada de dados para os procedimentos armazenados executados no servidor. Um procedimento armazenado pode adicionar, pesquisar, ordenar, atualizar ou apagar registros. Um procedimento armazenado pode utilizar conjuntos e seleções temporais, acessar a documentos no disco, trabalhar com BLOBs, imprimir registros, etc. Pense simplesmente que no lugar de fazer algo na máquina 4D local, ele faz na máquina servidor ou em várias máquinas clientes. Uma vantagem evidente dos procedimentos armazenados executados no servidor é que precisamente um procedimento armazenado se executa na máquina servidor, aonde se encontra o motor da base de dados. Por exemplo, um APPLY TO SELECTION não é eficiente na rede, mas é ao interior de um procedimento armazenado. O exemplo proposto na seção Importação baseada nos procedimentos armazenados (exemplo) mostra a importante otimização do rendimento que pode alcançar implementando um procedimento armazenado. Os procedimentos armazenados executados em um ou várias máquinas clientes permitem otimizar a otimização da repartição de tarefas entre clientes e a comunicação entre várias máquinas clientes. Consulte o comando REGISTER CLIENT no manual de Linguagem para ver um exemplo de procedimentos armazenados executados em várias máquinas clientes. No entanto, a vantagem principal da arquitetura dos procedimentos armazenados é a dimensão adicional que da a 4D Server. Utilizando procedimentos armazenados pode implementar seus próprios serviços 4D Server. O único limite é sua imaginação. O exemplo na seção Importação baseada nos procedimentos armazenados (exemplo) mostra um procedimento armazenado que oferece informação sobre 4D Server a seus clientes. Pode, por exemplo, listar os volumes da máquina servidor. Este exemplo pode ser expandido facilmente para reenviar a informação sobre os diretórios ou documentos ao cliente. O que não pode fazer um procedimento armazenado (executado no servidor)? Geralmente, os procedimentos armazenados executados no servidor não devem realizar operações que impliquem elementos de interface (tal como menus, janelas, formulários...). Os mecanismos de gestão de interface não são lidados no servidor. Devem ser evitados os comandos que provocam a aparição de caixas de diálogo no computador servidor bem como as caixas de diálogo com entrada de dados. Esta é a lista de comandos que NÃO deve utilizar em procedimentos armazenados executados no servidor. Estes comandos se classificam em três categorias: Comandos proibidos no servidor A presença de um destes comandos em um procedimento armazenado provoca a aparição de uma caixa de diálogo de alerta que indica que o comando não pode ser executado em 4D Server. É retornado o erro #67, o qual pode ser interceptado por meio de um método instalado pelo comando ON ERR CALL. ACCUMULATE ADD RECORD ADD SUBRECORD APPEND MENU ITEM BREAK LEVEL CALL PROCESS CHANGE LICENSES Count menu items Count menus DELETE MENU ITEM DISABLE MENU ITEM DISPLAY SELECTION EDIT ACCESS ENABLE MENU ITEM FILTER EVENT Get menu item Get menu item key Get menu item mark Get menu item style Get menu title SET PICTURE TO LIBRARY _o_graph TABLE INSERT MENU ITEM Level (Nível de quebra) Menu selected MODIFY RECORD MODIFY SELECTION MODIFY SUBRECORD ON EVENT CALL Open external window PAGE BREAK PAGE SETUP PRINT SETTINGS QUERY BY EXAMPLE

94 QR REPORT Printing page REMOVE PICTURE FROM LIBRARY SET MENU ITEM SET MENU ITEM SHORTCUT SET MENU ITEM MARK SET MENU ITEM STYLE SET PICTURE TO LIBRARY SHOW MENU BAR Subtotal Comandos inapropriados no servidor A utilização destes comandos em procedimentos armazenados não é recomendável como seu funcionamento não se adapta a uma execução no servidor. Estes comandos podem ser bloqueados pelo servidor, provocar erros e não produzem os efeitos esperados. Não é devolvido um código de erro específico. ACCEPT Activated ADD DATA SEGMENT After APPEND DATA TO PASTEBOARD APPEND TO LIST Before BLOB TO DOCUMENT BLOB to list BRING TO FRONT C_GRAPH CANCEL CHANGE CURRENT USER CHANGE PASSWORD CLEAR LIST CLEAR PASTEBOARD Copy list Count list items Count screens Create document(1) Create resource file(1) Current form table Current user Deactivated DELETE FROM LIST DELETE USER DIALOG DISABLE BUTTON DRAG AND DROP PROPERTIES DRAG WINDOW Drop position During ENABLE BUTTON ERASE WINDOW EXPORT DATA(1) FILTER KEYSTROKE Find window Focus object FONT LIST Font name Font number Form event FIRST PAGE FORM Get current page GET FORM PROPERTIES FORM GOTO PAGE LAST PAGE NEXT PAGE PREVIOUS PAGE INPUT FORM OUTPUT FORM Frontmost process Frontmost window

95 Get edited text GET GROUP LIST GET GROUP PROPERTIES GET HIGHLIGHT GET LIST ITEM GET LIST ITEM PROPERTIES GET LIST PROPERTIES GET MOUSE GET PASTEBOARD DATA GET PICTURE FROM PASTEBOARD Get text from pasteboard GET USER LIST GET USER PROPERTIES GET WINDOW RECT Get window title GOTO AREA GRAPH SETTINGS HIDE PROCESS HIDE TOOL BAR HIDE WINDOW HIGHLIGHT RECORDS HIGHLIGHT TEXT IMPORT DATA(1) In break In footer In header INSERT IN LIST INVERT BACKGROUND Is a list Is user deleted Keystroke List item parent List item position LIST TO BLOB Load list MAXIMIZE WINDOW Menu bar height Menu bar screen MINIMIZE WINDOW Modified New list Next window GET OBJECT RECT OBJECT MOVE OBJECT SET LIST BY NAME SET COLOR SET ENTERABLE SET FILTER OBJECT SET FORMAT SET RGB COLORS OBJECT SET TITLE OBJECT SET VISIBLE Old Open document(1) Open resource file(1) ORDER BY(2) Outside call Pasteboard data size Pop up menu POST CLICK POST EVENT POST KEY QUERY BY FORMULA(2) QUERY(2) REDRAW REDRAW LIST REDRAW WINDOW REGISTER CLIENT

96 REJECT SAVE LIST SCREEN COORDINATES SCREEN DEPTH Screen height Screen width Select folder SELECT LIST ITEMS BY POSITION SELECT LIST ITEMS BY REFERENCE SELECT LOG FILE Selected list items Self SET CURSOR SET FIELD TITLES Set group properties SET LIST ITEM SET LIST ITEM PROPERTIES SET LIST PROPERTIES SET PICTURE TO PASTEBOARD SET SCREEN DEPTH SET TABLE TITLES SET TEXT TO PASTEBOARD SET TIMER Set user properties SET WINDOW RECT Shift down SHOW PROCESS SHOW WINDOW SORT LIST User in group Validate password Window kind WINDOW LIST Window process (1) Unicamente quando o primeiro parâmetro é uma cadeia vazia. (2) Unicamente quando a sintaxes utilizada provoca a aparição da caixa de diálogo (ex.: ORDER BY([Table])). Comandos sem efeito no servidor Os seguintes comandos não têm efeito quando se executam em um procedimento armazenado no servidor. Não é devolvido nenhum código de erro específico. GRAPH MESSAGES OFF MESSAGES ON SET MENU BAR SHOW TOOL BAR Como iniciar um procedimento armazenado? Desde 4D, pode iniciar manualmente um procedimento armazenado na caixa de diálogo de execução do método:

97 Pode executar em 4D Server ou em outra máquina 4D client. Note que para as máquinas clientes 4D nesta lista, devem ter sido registrados (ver a seção Procedimentos armazenados nas máquinas clientes e o comando REGISTER CLIENT). Em 4D, pode iniciar um procedimento armazenado por programação com a ajuda dos comandos Execute on server ou EXECUTE ON CLIENT. Nota: Não é possível utilizar os comandos de gestão de processos DELAY PROCESS, PAUSE PROCESS e RESUME PROCESS desde um 4D remoto com procedimentos armazenados no servidor. Um método executado em 4D Server (método base do servidor, método com atributo Executar em servidor, trigger ou procedimento armazenado) pode iniciar um procedimento armazenado com a ajuda dos comandos Execute on server, New process ou EXECUTE ON CLIENT. Comunicação interprocesso entre os procedimentos armazenados e os processos usuário Os procedimentos armazenados podem comunicar-se entre eles utilizando: variáveis interprocesso semáforos globais ou locais registros conjuntos interprocesso e seleções temporais interprocesso os comandos GET PROCESS VARIABLE, SET PROCESS VARIABLE e VARIABLE TO VARIABLE. Consulte as seções correspondentes do manual Linguagem de 4D. Novamente, lembre que os comandos 4D atuem dentro do alcance da máquina que executa o procedimento armazenado (servidor ou clientes) da mesma forma que no local em uma máquina cliente. Nota: Os mecanismos CALL PROCESS e Outside call não tem significado na máquina servidor, porque os procedimentos armazenados não tem uma interface usuário com entrada de dados. Também há outra funcionalidade importante: os processos usuário dos clientes (processos que passam em uma máquina cliente) podem ler e escrever as variáveis processo (*) de um procedimento armazenado, utilizando os comandos GET PROCESS VARIABLE, SET PROCESS VARIABLE e VARIABLE TO VARIABLE. (*) Assim como as variáveis interprocesso da máquina servidor. Importante: A comunicação processo Inter máquina, oferecida pelos comandos GET PROCESS VARIABLE, SET PROCESS VARIABLE e VARIABLE TO VARIABLE, somente é possível o fechamento cliente ao servidor. Sempre é um processo cliente que lê ou escreve as variáveis de um procedimento armazenado.

98 Procedimentos armazenados nas máquinas clientes Você pode executar os procedimentos armazenados em um ou vários clientes 4D. O funcionamento geral dos procedimentos armazenados executados nos clientes é idêntico ao dos procedimentos armazenados executados no servidor, exceto que o cliente pode chamar a entrada de dados. Para obter mais informações, consulte a seção Procedimentos armazenados. Toda equipe cliente que execute procedimentos armazenados por pedido do servidor ou de outra equipe cliente, deve estar explicitamente registrado para a sessão. Há dois métodos para registrar um cliente: pode ser registrado automaticamente quando conectado ou por programação. Registro automático de cada cliente 4D que se conecta a 4D Server A opção "Inscrever os clientes ao inicio para executar em cliente" está disponível nas preferências da aplicação, página Opções de rede da página "Cliente-Servidor : Quando esta opção está selecionada, cada equipo cliente 4D que se conecta à base é referenciado automaticamente com 4D Server com pode executar os procedimentos armazenados. É criado um processo de tipo 4D Client com o nome da máquina da equipe cliente no servidor. É criado também um processo equivalente sobre cada equipe cliente. Registro de 4D Client por programação Pode registrar uma ou várias equipes clientes 4D por programação. Esta opção permite selecionar as equipes clientes que devem ser inscritas e definir seu nome de registro. O tema "Processo" contém o comando REGISTER CLIENT que permite inscrever uma equipe cliente com o nome que prefira. Para cancelar um 4D Client

99 Não importa como os computadores cliente são registrados, você pode lhes dar baixa para a sessão atual usando o comando UNREGISTER CLIENT (Tema "Processo") para um determinado cliente. O processo de registro (nomeado de acordo com o cliente) desaparece do grupo de processos de usuário no computador servidor, bem como o usuário da equipe cliente. Nota: O comando GET REGISTERED CLIENTS permite obter a lista e a carga de trabalho (o número de métodos pendentes por executar) dos clientes registrados na sessão. Para obter mais informações sobre esses comandos, consulte o manual de linguagem de 4D.

100 Importação baseada nos procedimentos armazenados (exemplo) O seguinte exemplo mostra como a importação de dados pode ser acelerada drasticamente em um entorno cliente/servidor. O método Regular Import permite medir quanto tempo toma importar os registros utilizando o comando IMPORT TEXT ` Método de projeto Import clássico $vhdocref:=open document("") If(OK=1) CLOSE DOCUMENT($vhDocRef) INPUT FORM([Tabla1];"Import") $vhstarttime:=current time IMPORT TEXT([Tabla1];Document) $vhendtime:=current time ALERT("La operación toma "+String(0+($vhEndTime-$vhStartTime))+" segundos.") End if Com a importação de dados clássica, 4D analisa o arquivo de texto, depois para cada registro, cria um novo registro, enche os campos com os valores importados e envia o registro à máquina servidor para ser adicionado a base. Por conseguinte circulam numerosas petições pela rede. Uma maneira de otimizar a operação é utilizar um procedimento armazenado para realizar a importação localmente na máquina servidor. A máquina cliente carrega o documento em um BLOB, depois inicia um procedimento armazenado que passa o BLOB como parâmetro. O procedimento armazenado guarda o BLOB em um documento no disco, depois importa o documento localmente. Portanto, a importação dos dados se realiza localmente (a uma velocidade comparada com a de uma versão local de 4D) porque a maioria das petições que transitam por la rede são eliminadas. Este é o método de projeto CLIENT IMPORT. Executado na máquina cliente, produz a execução do procedimento armazenado SERVER IMPORT que é mostrado a continuação: ` Método de projeto CLIENT IMPORT ` CLIENT IMPORT ( Ponteiro ; Texto) ` CLIENT IMPORT ( -> [Tabela] ; Formulário de entrada ) C_POINTER($1) C_TEXT($2) C_TIME($vhDocRef) C_BLOB($vxDatos) C_LONGINT(spErrCode) ` Selecione o documento a importar $vhdocref:=open document("") If(OK=1) ` Foi selecionado um documento, não o conserve aberto CLOSE DOCUMENT($vhDocRef) $vhstarttime:=current time ` Trate de carregar em memória DOCUMENT TO BLOB(Document;$vxDatos) If(OK=1) ` Se o documento pode ser carregado no BLOB, ` Inicie o procedimento armazenado que importará os dados na máquina servidor $spprocessoid:=execute on server("server IMPORT";32*1024; "Servidor Import Services";Table($1);$2;$vxDados) ` Neste ponto, já não necessitamos o BLOB neste processo CLEAR VARIABLE($vxDatos) ` Espere a que termine a operação realizada pelo procedimento armazenado Repeat DELAY PROCESS(Current process;300) GET PROCESS VARIABLE($spProcessosID;spErrCode;spErrCode) If(Undefined(spErrCode)) ` Nota: se o procedimento armazenado não iniciou sua própria instância ` da variável sperrcode, pode ser que devolva uma variável indefinida sperrcode:=1 End if Until(spErrCode<=0) ` Enviamos um aviso de recibo ao procedimento armazenado

101 sperrcode:=1 SET PROCESS VARIABLE($spProcessosID;spErrCode;spErrCode) $vhendtime:=current time ALERT("Tomó "+String(0+($vhEndTime-$vhStartTime))+" segundos.") Else ALERT("Não há suficiente memória para carregar o documento.") End if End if Este é o método de projeto SERVER IMPORT executado como um procedimento armazenado: ` Método de projeto SERVER IMPORT ` SERVER IMPORT ( Inteiro longo ; Texto; BLOB ) ` SERVER IMPORT ( Número de Tabela ; Formulário de entrada ; Dados importados ) C_LONGINT($1) C_TEXT($2) C_BLOB($3) C_LONGINT(spErrCode) ` A operação não terminou, assinale 1 a sperrcode sperrcode:=1 $vptabla:=table($1) INPUT FORM($vpTabela->;$2) $vsdocname:="arquivo Import "+String(1+Random) If(On Windows) $vsdocname:=$vsdocname+".txt" ` Em Windows, a extensão é obrigatória End if DELETE DOCUMENT($vsDocName) BLOB TO DOCUMENT($vsDocName;$3) IMPORT TEXT($vpTable->;$vsDocName) DELETE DOCUMENT($vsDocName) ` A operação terminou, assinale 0 a sperrcode sperrcode:=0 ` Espere a que a máquina cliente que originou a petição tenha recebido o resultado Repeat DELAY PROCESS(Current process;1) Until(spErrCode>0) Nota: O método de projeto On Windows é listado na seção Documentos de Sistema do manual de Linguagem de 4D. Uma vez que estes dois métodos tenham sido implementados em uma base, pode realizar uma importação baseada em um procedimento armazenado, escrevendo por exemplo: CLIENT IMPORT(->[Tabela1];"Import") É realizada algumas provas comparativas, você vai descobrir que utilizando este método se pode importar registros até 60 vezes mais rápido que com uma importação regular.

102 Serviços baseados nos procedimentos armazenados (exemplo) No exemplo da seção Importação baseada nos procedimentos armazenados (exemplo), um procedimento armazenado se inicia e termina cada vez que se solicita uma operação de importação de dados. Neste exemplo, um procedimento armazenado é iniciado automaticamente quando inicia a base do servidor e pode ser iniciado e parado a vontade por qualquer 4D conectado a base. Logo como se executa, o procedimento armazenado pode responder de maneira assíncrona a múltiplos pedidos enviados pelos clientes conectados a base. Enquanto a seção Importação baseada nos procedimentos armazenados (exemplo), mostra como otimizar um serviço 4D Server existente, este exemplo mostra como implementar serviços novos e personalizados disponíveis para todos as máquinas 4D client conectados. Além disso, este exemplo pode ser utilizado como modelo para a criação de seus próprios serviços. Início automático do procedimento armazenado O procedimento armazenado é lançado automaticamente pelo Método banco de dados On Server Startup: ` Método de base On Server Startup START SP SERVICES Como o Método banco de dados On Server Startup lança ao método de projeto SP SERVICES como um procedimento armazenado, SP SERVICES começa a correr logo como a base se abre com 4D Server, tendo ou não clientes conectados à base. Na seguinte imagem, a janela de administração de 4D Server mostra o procedimento armazenado em execução quando nenhum cliente está conectado. Iniciar e parar voluntariamente o procedimento armazenado Este é o método de projeto START SP SERVICES: ` START SP SERVICES Project Method vlspservices:=execute on server("sp SERVICES";32*1024;"SP SERVICES";*)

103 Como o comando Execute on server atua como New process ao ser chamado na máquina servidor, o mesmo método (START SP SERVICES) pode ser utilizado na máquina servidor ou em uma máquina cliente para iniciar a vontade o método SP SERVICES como um procedimento armazenado na máquina servidor. O método de projeto STOP SP SERVICES ordena parar ao método de projeto SP SERVICES. ` Método de projeto STOP SP SERVICES SET PROCESS VARIABLE( vlspservices;vbstopspservices;true) Quando é iniciado o método de projeto SP SERVICES, da a variável processo vbstopspservices o valor False e depois executa um laço até que esta variável Booleana se transforme em True. O comando, permite a todo processo usuário executado no servidor ou em uma máquina cliente modificar o valor da variável vbstopspservices, e portanto parar o procedimento armazenado a vontade. Comunicação com o procedimento armazenado O procedimento armazenado deve poder receber pedidos de clientes e responder de maneira assíncrona em qualquer momento e sem importar a ordem. Uma maneira direta de assegurar esta comunicação é utilizar uma tabela. A tabela [SP Requests] contém os seguintes campos: [SP Requests]reqID é assinalado utilizando o comando Sequence number. Este campo identifica cada pedido de maneira única. [SP Requests]reqType descreve o tipo do pedido. [SP Requests]reqStatus pode tomar um dos seguintes valores: Valor Descrição 1 foi publicada a petição mas não foi processada. 0 foi processado com êxito a petição. < 0 foi processada a petição mas ocorreu um erro. Nota: Estes valores são escolhidos arbitrariamente para este exemplo, não são impostos por 4D. [SP Requests]reqData é um BLOB que contém os dados da petição. Pode conter os dados enviados pela pessoa que solicita os dados devolvidos pelo procedimento armazenado ao requerente. [SP Requests]reqParams contém eventualmente os valores dos parâmetros enviados pelo requerente ao procedimento armazenado. Por que usar uma tabela? A comunicação entre um processo cliente e um procedimento armazenado pode ser implantado utilizando os comandos GET PROCESS VARIABLE, SET PROCESS VARIABLE e VARIABLE TO VARIABLE. Por exemplo, esta solução utilizada na seção Importação baseada nos procedimentos armazenados (exemplo), como também no método de projeto STOP SP SERVICES listado anteriormente. Aqui, o sistema deve permitir ao procedimento armazenado receber e reenviar as quantidades das variáveis de dados. Pode utilizar arrays, incluindo arrays de texto e imagem), mas há duas razões principais para preferir o emprego de uma tabela: O algoritmo de gestão de petições sob os registros é mais fácil de implementar. Enviar uma petição desde uma máquina cliente consiste simplesmente em adicionar uma petição na tabela. Responder a petição desde o procedimento armazenado consiste simplesmente em modificar esta petição. Como as petições se armazenam em uma tabela, são guardadas no disco. Portanto, se o tamanho de uma petição é importante, não será um problema na medida em que possa ser suprimido da memória (a diferença dos dados armazenados nos arrays). Enviar uma petição desde a máquina cliente O método de projeto Client post request é um método genérico para enviar uma petição: ` Método de projeto Client post request

104 ` Client post request ( Cadeia { ; Texto } ) -> Inteiro longo ` Client post request ( Tipo de petição { ; Parâmetros } ) -> Número de petição CREATE RECORD([SP Requests]) [SP Requests]reqID:=Sequence number([sp Requests]) [SP Requests]reqType:=$1 [SP Requests]reqStatus:=1 If(Count parameters>=2) [SP Requests]reqParams:=$2 End if SAVE RECORD([SP Requests]) $0:=[SP Requests]reqID O método devolve o número da petição, cuja unicidade está garantida pelo uso do comando Sequence number. Uma vez adicionado o registro a tabela [SP Requests], o cliente não têm que interrogar regularmente o campo [SP Requets]redStatus até que o procedimento armazenado termine de processar a petição. Provar o estado da petição e recuperar o resultado na máquina cliente O método de projeto Client get result é um método genérico para provar o estado da petição. Como foi explicado anteriormente, logo como o campo [SP Requets]redStatus se torna diferente de 1, o cliente sabe que o procedimento armazenado foi tratado (com êxito ou não) a petição. ` Método de projeto Client get result ` Client get result ( Inteiro longo ; ->BLOB {; Inteiro longo } ) -> Inteiro longo ` Client get result ( Número de petição ; ->Dados {; Duração } ) -> Código do erro C_LONGINT($0;$1;$vlDelay) $0:=1 $vldelay:=0 If(Count parameters>=3) $vldelay:=$3 End if READ ONLY([SP Requests]) Repeat QUERY([SP Requests];[SP Requests]reqID=$1) If(Records in selection([sp Requests])>0) If([SP Requests]reqStatus&NBSP;#&NBSP;1) $2->:=[SP Requests]reqData READ WRITE([SP Requests]) While(Locked([SP Requests])) WAITING LOOP($vlDelay) LOAD RECORD([SP Requests]) End while DELETE RECORD([SP Requests]) $0:=[SP Requests]reqStatus End if Else ` Se perdeu o registro da petição ` Isto não deveria passar. Mas de todas formas estabelece o código de erro -2 (valor arbitrário) $0:=-2 End if ` A petição ainda não foi processada If($0=1) WAITING LOOP($vlDelay) End if Until($0&NBSP;#&NBSP;1) READ ONLY([SP Requests]) Se a petição foi administrada com êxito pelo procedimento armazenado, o método copia o resultado (se existe) do registro ao BLOB cujo ponteiro foi passado como parâmetro. O método chamado depois analisa e utiliza os dados do BLOB em função do tipo de pedido. Note que o cliente está encarregado de apagar o registro [SP Requests] uma vez termina o pedido. O pequeno método de projeto WAITING LOOP faz um laço até um certo número de tics: ` Método de projeto WAITING LOOP ` WAITING LOOP ( Inteiro longo ) ` WAITING LOOP ( Tempo em tics ) C_LONGINT($1)

105 $vlstartticks:=tickcount Repeat IDLE Until((Tickcount-$vlStartTicks)>=$1) Lembrança: DELAY PROCESS não tem efeito no processo principal. Se utiliza o método de projeto WAITING LOOP, o processo esperará a quantidade de tempo necessário, ainda que o pedido tenha origem desde o processo do ambiente usuário de uma máquina cliente. O procedimento armazenado e suas subrotinas O método de projeto SP SERVICES é o método executado como procedimento armazenado na máquina servidor. A estrutura geral deste método, a continuação, muito simples: Inicialização de uma variável stop Repetir Pesquisa das petições cujo campo [SP Requests]reqStatus é igual a 1 Para cada petição Em função do tipo de petição, chamar uma subrotina que guarde o resultado no campo [SP Requests]reqData Mudar o estado da petição para que o cliente saiba que passou End for Dormir um pouco antes de voltar a começar Até que a variável stop se torne true Este é o código fonte real: ` Método de projeto SP SERVICES ` O procedimento armazenado começa vbstopspservices:=false ` O procedimento armazenado não necessita acesso em leitura escritura as tabelas... READ ONLY(*) `...exceto a tabela [SP Requests] READ WRITE([SP Requests]) Repeat ` Pesquisa dos pedidos ainda não processados QUERY([SP Requests];[SP Requests]reqStatus=1) ` Processo destas petições uma por uma For($vlRecord;1;Records in selection([sp Requests])) ` Se o registro da petição está bloqueado, esperar até que esteja desbloqueado While(Locked([SP Requests])) ` Esperar um segundo antes de tentar novamente DELAY PROCESS(Current process;60) ` Trata de obter acesso leitura-escritura LOAD RECORD([SP Requests]) End while ` Assume que a petição será processada com sucesso [SP Requests]reqStatus:=0 Case of :([SP Requests]reqType="Server Information") SP DO SERVER INFORMATION :([SP Requests]reqType="Volume List") SP DO VOLUME LIST :([SP Requests]reqType="Browse Directory") SP DO BROWSE DIRECTORY([SP Requests]reqParams) `... ` OUTROS TIPOS DE PETIÇÕES PODERIAM SER INCLUÍDAS AQUI `... Else ` O tipo de petição é desconhecido, devolver o erro -1 (valor arbitrário) [SP Requests]reqStatus:=-1 End case ` Forçar o estado da petição a outro diferente de 1 ` (em caso de uma subrotina dar o valor 1) If([SP Requests]reqStatus=1) [SP Requests]reqStatus:=-3 End if

106 ` Atualizar o registro da petição SAVE RECORD([SP Requests]) ` Ir a seguinte petição não processada NEXT RECORD([SP Requests]) End for ` Liberar o último registro processado UNLOAD RECORD([SP Requests]) ` Espere um segundo antes de continuar respondendo petições DELAY PROCESS(Current process;60) ` Bucle até que seja ordenado ao procedimento armazenado parar sua execução Until(vbStopSPServices) O método de projeto SP SERVICES pode ser utilizado como modelo para implementar serviços inovadores em uma base. Nesta seção, detalhamos as subrotinas SP DO SERVER INFORMATION e SP DO VOLUME LIST. A subrotina SP DO BROWSE DIRECTORY (que toma como parâmetro um parâmetro enviado pelo cliente no campo [SP Requests]reqParams) não se trata neste documento. Dependendo do tipo da petição, o método de projeto SP SERVICES chama a uma subrotina cuja tarefa é guardar os dados resultantes no campo [SP Requests]reqData. O armazenamento do registro e a mudança do estado a realizar o método de projeto SP SERVICES. Esta é a subrotina SP DO SERVER INFORMATION que guarda a informação relativa ao servidor no BLOB. Outro método de projeto extrairá os dados do BLOB em função da máquina cliente. ` Método de projeto SP DO SERVER INFORMATION TEXT TO BLOB(Application version(*);[sp Requests]reqData;UTF8 C string) TEXT TO BLOB(Structure file;[sp Requests]reqData;UTF8 C string;*) TEXT TO BLOB(Data file;[sp Requests]reqData;UTF8 C string;*) PLATFORM PROPERTIES($vlPlatform;$vlSystem;$vlMachine) VARIABLE TO BLOB($vlPlatform;[SP Requests]reqData;*) VARIABLE TO BLOB($vlSystem;[SP Requests]reqData;*) VARIABLE TO BLOB($vlMachine;[SP Requests]reqData;*) Esta é a subrotina SP DO VOLUME LIST, que guarda a informação relativa aos volumes no BLOB. Outro método de projeto extrairá os dados do BLOB em função da máquina cliente. ` Método de projeto SP DO VOLUME LIST VOLUME LIST($asVName) $vlsize:=size of array($asvname) ARRAY REAL($arVSize;$vlSize) ARRAY REAL($arVUsedSpace;$vlSize) ARRAY REAL($arVFreeSpace;$vlSize) For($vlElem;1;$vlSize) VOLUME ATTRIBUTES($asVName{$vlElem};$arVSize{$vlElem};$arVUsedSpace{$vlElem} ;$arvfreespace{$vlelem}) End for VARIABLE TO BLOB($asVName;[SP Requests]reqData) VARIABLE TO BLOB($arVSize;[SP Requests]reqData;*) VARIABLE TO BLOB($arVUsedSpace;[SP Requests]reqData;*) VARIABLE TO BLOB($arVFreeSpace;[SP Requests]reqData;*) Mostrar a informação do servidor em uma máquina cliente Com os métodos de projeto genéricos Client post request e Client get result, o método de projeto M_SERVER_INFORMATION mostra, na máquina cliente, a informação devolvida pelo procedimento armazenado. Este método pode estar associado a um comando de menu ou ser chamado, por exemplo, desde o método de objeto de um botão: ` M_SERVER_INFORMATION C_BLOB(vxData) C_LONGINT($vlReqID;$vlErrCode;$vlOffset) ` Envio do pedido $vlreqid:=client post request("server Information") ` Prova do estado do pedido e recepção do resultado $vlerrcode:=client get result($vlreqid;->vxdata;60) ` Caso o pedido termina com sucesso, é mostrado o resultado If($vlErrCode=0) ` Extração da informação resultante do BLOB $vloffset:=0

107 vsserverversion:=blob to text(vxdata;utf8 C string;$vloffset) vsstructurefile:=blob to text(vxdata;utf8 C string;$vloffset) vsdatafile:=blob to text(vxdata;utf8 C string;$vloffset) BLOB TO VARIABLE(vxData;$vlPlatform;$vlOffset) BLOB TO VARIABLE(vxData;$vlSystem;$vlOffset) BLOB TO VARIABLE(vxData;$vlMachine;$vlOffset) ` Análises das propriedades da plataforma vs4dplatform:="versão de 4D Server desconhecida" vssystem:="versão do sistema desconhecida" vsmachine:="computador desconhecido" `... ` Este é o código (não listado) que analisa $vlsystem e $vlmachine ` ( ver o exemplo do comando PLATFORM PROPERTIES) `... ` Visualização da informação resultante DIALOG([SP Requests];"SERVER INFORMATION") Else ALERT("Erro de pedido "+String($vlErrCode)) End if ` Não é mais necessário o BLOB CLEAR VARIABLE(vxData) Este é o formulário [SP Requests];"SERVER INFORMATION" em execução: Mostrar a lista de volumes do servidor em uma máquina cliente Com os métodos de projeto genéricos Client post request e Client get result, o método de projeto M_SERVER_VOLUMES mostra, na máquina cliente, a informação na lista dos volumes do servidor devolvidos pelo procedimento armazenado. Este método pode estar associado a um comando de menu ou chamado, por exemplo, desde o método de objeto de um botão: ` M_SERVER_VOLUMES C_BLOB(vxData) ` Envio do pedido $vlreqid:=client post request("volume List") ` Prova do estado da petição e recepção do resultado $vlerrcode:=client get result($vlreqid;->vxdata;120) ` Se a petição termina com sucesso, mostra o resultado If($vlErrCode=0) ` Extração da informação resultante do BLOB $vloffset:=0 BLOB TO VARIABLE(vxData;asVName;$vlOffset) BLOB TO VARIABLE(vxData;arVSize;$vlOffset) BLOB TO VARIABLE(vxData;arVUsedSpace;$vlOffset) BLOB TO VARIABLE(vxData;arVFreeSpace;$vlOffset) For($vlElem;1;Size of array(arvsize)) ` Conversão de bytes em MB arvsize{$vlelem}:=arvsize{$vlelem}/

108 arvusedspace{$vlelem}:=arvusedspace{$vlelem}/ arvfreespace{$vlelem}:=arvfreespace{$vlelem}/ End for ` Visualização da informação resultante DIALOG([SP Requests];"VOLUME LIST") Else ALERT("Erro de petição "+String($vlErrCode)) End if ` Já não é necessário o BLOB CLEAR VARIABLE(vxData) Este é o formulário [SP Requests];"VOLUME LIST" em execução:

109 Executar no atributo servidor O atributo do método de projeto "Execute on Server" pode ser definido na seguinte caixa de diálogo de modificação global dos atributos ou na caixa de diálogo das propriedades do método: Quando se seleciona esta opção, o método de projeto sempre se executa no servidor, sem importar como se chama o método. Nota: Este atributo só leva em conta para uma aplicação 4D executada em cliente/servidor. Contexto de execução Quando este atributo está selecionado, o contexto de execução do método de projeto é comparado com o dos triggers (ver a seção 4D Server e a linguagem 4D): o método no servidor compartilham o mesmo contexto de banco de dados para o bloqueio de registros e para as transações que o contexto correspondente do lado do cliente, mas não o mesmo contexto de linguagem (variáveis processo, conjuntos, seleções atuais). No entanto, a diferença de um trigger, o método executado no servidor não compartilha o registro atual com o contexto do cliente. Todos os parâmetros do método ($1, $2, etc.) são enviados no servidor e o valor do parâmetro $0, é utilizado, e devolvido ao cliente. A diferença do comando Execute on server, esta opção não provoca a criação do processo no servidor. 4D Server utiliza o processo "gêmeo" do processo cliente que solicitou a execução. Além disso, esta opção simplifica o principio de delegação da execução de um método no servidor como a transferência de parâmetros se realiza automaticamente nos dois sentidos, como para uma chamada de método "normal". O comando Execute on server, funciona de forma anacrônica e portanto requer maior programação e uso de semáforos para a leitura dos resultados. Comandos utilizáveis Os métodos que têm o atributo "Execute on Server" estão sujeitos as mesmas regras que os procedimentos armazenados em matéria de uso dos comandos da linguagem 4D. A execução de certos comandos não está permitida no servidor, a execução de outros não é recomendável. Para maior informação, consulte o parágrafo " O que um procedimento armazenado não pode fazer (executado no servidor)?" na seção Procedimentos armazenados. Ponteiros Se passa um ponteiro a uma variável (variável simples, array ou elemento de array), o valor apontado também é enviado ao servidor. Se o valor apontado é modificado no servidor pelo método, o valor modificado se devolve ao cliente para atualizar a variável correspondente do lado do cliente. Os ponteiros em uma tabela ou campo são enviados como referência (número de tabela, número de campo). O valor do registro atual não é trocado automaticamente.