Como configurar funções do utilizador?

1. Aceder a Extensibilidade | Funções na área de configurações do ERP (backstage);
2. Clicar em Nova;
3. No separador Geral, definir as seguintes propriedades da função: - Definir o nome da função; - Definir o tipo de função, selecionando a opção Query SQL; - Indicar uma descrição da função (opcional);
4. No separador Definição, indicar a Query SQL a utilizar na execução;
5. Clicar em Confirmar.

Ao definir as funções do utilizador do tipo Query SQL,poderá utilizar parâmetros na especificação da Query. Assim, é potencializada a adaptabilidade a cenários que utilizem componentes de natureza variável.

Deverá também definir o resultado da função, uma vez que a forma como a datatable resultante da Query SQL será interpretada pelo motor de execução depende do tipo de resultado selecionado:

• Nenhum: a Query SQL não devolve qualquer resultado;
• Texto, Inteiro, Numérico, Data, Booleano: a Query SQL devolve uma datatable com apenas um registo e com uma coluna, que deve ser interpretada de acordo com o tipo de dados selecionado;
• Lista de Registos: a QuerySQL devolve uma datatable com vários registos e várias colunas.

1. Aceder à opção Extensibilidade | Funções na área de configurações do ERP (backstage);
2. Clicar em Nova;
3. No separador Geral, definir o nome da função;
4. Definir o tipo de função, clicando na opção Email;
5. Indicar uma descrição da função (opcional);
6. No separador Definição, definir o destinatário, selecionando a opção Para e indicar o endereço de email do destinatário;
7. Definir o assunto, indicando o tópico do assunto que será tratado na mensagem;
8. Definir a mensagem, digitando o conteúdo da mensagem;
9. Indicar os anexos, selecionando os ficheiros a anexar à mensagem (opcional);
10. Por fim, clicar em Confirmar.

Ao definir as funções de utilizador do tipo Email, sugere-se a utilização de parâmetros na configuração da mensagem de email. Assim, é reforçado o envio da mensagem, independentemente dos destinatários e de outras particularidades meramente adaptáveis no contexto da mensagem.

Nota: As funções do tipo Email não permitem a definição dos respetivos resultados.

1. Aceder a Extensibilidade | Funções na área de configurações do ERP (backstage);
2. Clicar em Nova;
3. No separador Geral, definir o nome da função;
4. Definir o tipo de função, selecionando a opção Formulário do Utilizador;
5. Indicar uma descrição da função (opcional);
6. No separador Definição, selecionar o formulário do utilizador a utilizar na execução; Nota: Os formulários customizados devem ser previamente implementados em PEX (Extensibility) e as extensões associadas à empresa;
7. Por fim, clicar em Confirmar.

Nota: As funções do tipo Formulário do Utilizador não permitem a definição de parâmetros nem dos resultados.

1. Aceder a Extensibilidade | Funções na área de configurações do ERP (backstage);
2. Clicar em Nova;
3. No separador Geral, definir o nome da função;
4. Definir o tipo de função, selecionando a opção Aplicação Externa;
5. Indicar uma descrição da função (opcional);
6. No separador Definição, definir o comando, identificando a localização da aplicação/documento externo;
7. Definir os parâmetros, enumerando os parâmetros adicionais a aplicar na execução (opcional);
8. Definir a diretoria inicial, identificando a respetiva localização física (opcional);
9. Definir o tipo de janela a utilizar na execução;
10. Por fim, clicar em Confirmar.

Ao definir as funções do utilizador do tipo Aplicação Externa, sugere-se a utilização de parâmetros na configuração da aplicação/documento externo. Assim, a execução de uma determinada aplicação ou documento é potencializada baseada em critérios dinâmicos.

A execução de aplicações externas permite definir qual o tratamento aplicar ao resultado, sendo possível especificar dois tipos de resultados:

• Nenhum - o resultado da execução não será tratado pelo motor de execução;
• Inteiro - a aplicação executada produzirá um exit code que será tratado pelo motor no final da execução.

1. Aceder a Ferramentas | Funções do Utilizador;
2. Clicar em  Nova;
3. No separador Geral, definir o nome da função;
4. Definir o tipo de função, selecionando a opção Mapa do Utilizador;
5. Indicar uma descrição da função (opcional);
6. No separador Definição, definir o mapa a ser executado;
7. Selecionar o formato do mapa;
8. Definir o envio por email, caso pretenda que o resultado da execução do mapa seja enviado por email (opcional);
9. Definir a localização física, caso pretenda que o resultado da execução do mapa seja guardado em ficheiro (opcional);
10. Por fim, clicar em Confirmar.

Ao definir as funções do tipo Mapas do Utilizador, sugere-se a utilização de parâmetros na configuração do mapa, de forma a facilitar a adaptação ao processo de exportação. Se o mapa do utilizador tiver parâmetros definidos no Crystal Reports, estes serão automaticamente detetados e adicionados à lista de parâmetros da função.

O resultado deste tipo de função é fixo e corresponde sempre à localização física do mapa do utilizador depois de exportado no formato selecionado.

Não será disponibilizado o resultado da execução, se a configuração da função do utilizador não incluir o envio do mapa por email e/ou a exportação para uma diretoria em disco.

As macros de extensibilidade devem ser criadas em extensões PEX e carregadas na configuração de extensibilidade antes que seja possível criar funções com base nas macros destas extensões.

Poderá consultar as extensões em Extensibilidade | Extensões na área de configurações do ERP.

Para criar uma função macro de extensibilidade, siga os seguintes passos:

1. Aceder a Extensibilidade | Funções na área de configurações do ERP (backstage);
2. Clicar em Nova;
3. No separador Geral, definir o nome da função;
4. Selecionar a opção Macro Extensibilidade no tipo de função;
5. Indicar uma descrição da função (opcional);
6. No separador Definição, definir o projeto no qual está definida a macro;
7. Selecionar a macro definida no projeto Extensibilidade;
8. Por fim, clicar em Confirmar.

Os parâmetros da função do utilizador serão os parâmetros que correspondem à função que implementa a macro. O resultado da função do utilizador será determinado também pela definição da macro, como o tipo de retorno da função que implementa a macro.

1. Aceder a Extensibilidade | Funções na área de configurações do ERP (backstage);
2. Clicar em Nova;
3. No separador Geral, definir o nome da função;
4. Definir o tipo de função, selecionando a opção Stored Procedure;
5. Indicar uma descrição da função (opcional);
6. No separador Definição, selecionar a Stored Procedure a utilizar na execução;
7. Por fim, clicar em  Confirmar.

Os parâmetros da função do utilizador serão determinados pela própria definição da Stored Procedure na base de dados.

Deverá definir o resultado da função. Apesar de em princípio uma stored procedure não produzir resultados, o SQLServer permite que a respetiva definição inclua queries à base de dados.

Se definidas corretamente, estas queries permitem simular um resultado na forma de um recordset. A forma como o recordset será interpretado pelo motor de execução depende do tipo de resultado selecionado:

• Nenhum: a Stored Procedure não devolve qualquer resultado;
• Texto, Inteiro, Numérico, Data, Booleano: a Stored Procedure devolve um recordset com apenas um registo e uma coluna, que deve ser interpretada de acordo com o tipo de dados selecionado;
• Lista de registos: a Stored Procedure devolve um recordset com vários registos e colunas.

1. Aceder a Extensibilidade | Funções na área de configurações do ERP (backstage);
2. Clicar em Nova;
3. No separador Geral, definir o nome da função;
4. Definir o tipo de função, selecionando a opção User Defined Function;
5. Indicar uma descrição da função (opcional);
6. No separador Definição, selecionar a User Defined Functiona utilizar na execução;
7. Por fim, clicar em Confirmar.

Os parâmetros e resultados da função do utilizador serão determinados pela própria definição User Defined Function na base de dados.