Programação do lado do servidor¶

Na maioria dos casos, o cliente envia uma solicitação ao servidor quando os seguintes métodos de um item são executados:

Nesses casos, o cliente envia ao servidor o ID da tarefa do item, o ID do item, o tipo da solicitação e seus parâmetros.

Ao receber a solicitação, o servidor, com base nos IDs passados, encontra a tarefa (pode ser uma tarefa de Projeto ou uma tarefa do Construtor de Aplicações) e o item no servidor, executa o método correspondente com os parâmetros passados e retorna o resultado da execução para o cliente. O método do servidor pode disparar eventos que podem modificar seu comportamento padrão.

Cada item da árvore de tarefas possui os atributos ambiente e sessão que armazenam o contexto da solicitação atual.

Os eventos de servidor mais comuns são:

on_created - O evento é disparado pela tarefa quando ela acaba de ser criada pela aplicação do servidor. Pode ser usado para inicializar o projeto.
eventos on_apply - Esses eventos são disparados quando o método apply do item é chamado no cliente ou no servidor
eventos on_open - Esses eventos são disparados quando o método open do item é chamado no cliente ou no servidor
on_generate - O evento é disparado quando o método print de um relatório é chamado no cliente.

Nota

Note que a árvore de tarefas no servidor é imutável, você não pode alterar os atributos dos itens na árvore de tarefas.

Você deve usar o método copy para criar uma cópia de um item. Essa cópia é uma réplica exata de um item no momento da criação da árvore de tarefas. Ela não é adicionada à árvore de tarefas e será destruída pelo coletor de lixo do Python quando não for mais necessária.