Entidade: Nome da entidade sobre qual o processamento será executado.

É processamento de registo: Processamento que será usado tendo somente um registo dado fonte.

É processamento de entidade: Processamento que será usado tendo múltiplos registos de uma entidade como dados fonte.

Entrada principal do menu: Menu onde será disponibilizado o processamento.

Entrada secundária do menu: Sobre o menu Gestão, escolher em qual dos sub-menus queremos que o processamento seja disponibilizados. (Campo apenas disponível quando se seleciona a opção Gestão no campo Entrada principal do menu.

Título da ação de execução: Sendo um processamento de registo, é o texto que aparecerá no botão de executar a ação.

Código de disponibilidade da ação: Permite mostrar a ação consoante uma determinada condição, ou seja, caso defina um simples:

return true

return currentSeries.tiposaft === "OT"

Descrição do Processamento: Campo para incluir uma descrição geral do processamento.

Através desta área, é onde define as variáveis que serão exibidas no primeiro passo do assistente do processamento. Estas variáveis podem ser usadas tanto no código de Dados a processar como no Código de execução do processamento.

Número: Trata-se do nº interno atribuído ao dado inicial e que representa a ordem pela qual vem exibido ao aceder à análise.
O valor deste campo é incrementado automaticamente em uma unidade com base no valor do último registo de dado inicial criado na grelha, muito embora, possa posteriormente alterar a ordem dos dados iniciais conforme pretenda.

Nome: Campo para preencher o nome que terá o dado inicial.

Tipo: Campo para determinar o tipo de dado inicial.
Tem disponível para seleção um dos seguintes tipos: Texto, Mês, Numérico, Lógico, Data, Ano, Tabela, Percentagem, Moeda base e Ficheiro.

Opções: Se tipo "Tabela": lista de opções, separada por vírgulas. Se tipo "Ano": ano inicial com 4 dígitos: Este campo pode albergar dados de diversas formas, em função do tipo de dado selecionado no campo anterior.
Dicas




a) Para dados de tipo Tabela pode preencher neste campo entre outras coisas:

» Um dado inicial que permita selecionar um item a partir de uma lista de itens fixos (separados por vírgula). Por exemplo, um campo dropdown para selecionar o estado para visualizar encomendas: Todas,Abertas,Fechadas

» Um dado inicial que permita selecionar um item a partir de uma lista que pode variar em função de uma query SQL (implica ativar a coluna Lista é uma query)

Exemplo 1 - query que retorna o nome de cada um dos clientes presentes na tabela de Clientes (CL) sendo que o 1º item representa "Todos os Clientes"


select uval from (select ´Todos os Clientes´ as uval from cl (nolock) 

union select distinct nome as uval from cl (nolock)) a 

ORDER BY CASE uval WHEN ´Todos os Clientes´ THEN 1 ELSE 2 END, uval


Exemplo 2 - query que retorna o nome das séries de documentos de faturação (tabela TD), que sejam do tipo ´FT´, ´FR´, ´FS´ ou ´NC´, e que o 1º item representa "Todos os Tipos de Documentos"


select uval from (select ´Todos os Tipos de Documentos´ as uval from td (nolock) union 

select distinct nmdoc as uval from td (nolock) where 

td.tiposaft=´FT´ or 

td.tiposaft=´NC´ or 

td.tiposaft=´FR´ or 

td.tiposaft=´FS´) a 

ORDER BY CASE uval WHEN ´Todos os Tipos de Documentos´ THEN 1 ELSE 2 END, uval 


Lista é uma query: A lista deve ser uma expressão de SQL que retorna uma lista com um campo designado por "uval" (ver exemplos anteriores).

Obrigatório: Indica que este dado inicial é de preenchimento obrigatório.

Nº de carateres: Número máximo de carateres que este dado inicial pode receber. Se deixar o campo a zero não terá limite de nº de caracteres. O preenchimento desta coluna da grelha apenas se aplica a dados iniciais do tipo numérico e caracter.

Decimais: Número de decimais caso o campo seja "numérico".

v.d texto: Valor por defeito para este dado inicial caso seja do tipo "Texto".

v.d. número: Valor por defeito para este dado inicial caso seja do tipo "Numérico".

v.d. lógico: Valor por defeito para este dado inicial caso seja do tipo "Lógico".

v.d. data: Valor por defeito para este dado inicial caso seja do tipo "data". Neste caso, este campo representa o nº de dias de diferença para a data atual. Por exemplo, -365 neste campo, colocará no dado inicial a data de há 365 dias atrás.

Tooltip: Informação a explicar o âmbito do dado inicial.

Colunas a ocupar: Indica quantas colunas do layout, o campo de dado inicial irá ocupar. Cada linha do formulário contém até 4 colunas.

Colunas a pular: Indica quantas colunas à esquerda do campo de dado inicial deve pular.

Rejeita cache: Caso ative este campo, o valor preenchido pelo utilizador do processamento para a variável do dado inicial não será guardada na base de dados com o último valor introduzido (ou seja, sempre que o processamento for inicializado, o valor da variável de dado inicial será automaticamente preenchido pela aplicação, tendo por base o valor preenchido nos campos v.d. texto, v.d. número, v.d. lógico ou v.d. data (conforme o tipo de dado definido, se texto, numérico, lógico, data,..).

fieldsStates("1").Value

Código de atualização de campos: Código para definir o comportamento do estado de um campo, podendo-se alterar por exemplo a visibilidade, o estado de desabilitado, o estado de obrigatoriedade e o valor dos campos.

fieldsStates("1").Hidden = TRUE

fieldsStates("2").Value = "Hello World"

Snapshots: Através dos campos Snapshot principal e Snapshot secundário, é possível a utilização de snapshots no processamento, sendo o valor destes exibido ao utilizador no segundo passo do processamento.


É também possível, através dos campos Número da variável inicial, a passagem das variáveis utilizadas no processamento, para o cálculo do snapshot (sendo que o valor deste campo diz respeito ao índice da variável a ser utilizada [seguem a mesma ordem que nos fieldStates]).

É um programa VB.NET: Permite definir que o código dos dados a processar é um programa VB.NET ou SQL.

Código para obter os dados de origem do processamento: Código que irá ser usado para obter os dados de origem do processamento.
É importante que os dados retornados por esse código, tanto VB.NET como SQL tenham uma propriedade chamada Stamp, que é chave única de cada registo. Exemplo:

select ft.ftstamp as stamp, ft.fno, ft.nmdoc from ft

Dim DocumentsList = SDK.Query.GetEntityData("select ft.ftstamp as stamp, ft.fno, ft.nmdoc from ft where (Cast(nmdoc AS varchar) LIKE ´%" + searchExpression + "%´ OR Cast(fno AS varchar) LIKE ´%" + searchExpression + "%´)")



return DocumentsList

Colunas da tabela de apresentação dos dados de origem: Configuração de colunas de apresentação dos dados de origem.

Pode ser executado para todos os registos: Caso este campo não esteja selecionado, o processamento não terá disponível o botão de emissão para todos os registos, desabilitando os campos Texto do botão de executar sobre todos os registos e Tooltip do botão de executar sobre todos os registos.

Texto do botão de executar sobre todos os registos: Texto que será exibido no botão de executar sobre todos os registos.

Tooltip do botão de executar sobre todos os registos: Mensagem na tooltip que será exibida quando o utilizador colocar o ponteiro do rato em cima do botão de executar o processamento sobre todos os registos.

Texto do botão de executar sobre os registos selecionados: Texto que será exibido no botão de executar apenas sobre os registos selecionados.

Tooltip do botão de executar sobre os registos selecionados: Mensagem na tooltip que será exibida quando o utilizador colocar o ponteiro do rato em cima do botão de executar o processamento apenas sobre os registos selecionados.

Código da execução: Código VB.NET que receberá uma lista de stamps selecionados no passo de seleção dos dados de origem do processamento e fará a execução do mesmo. Assim, poderá usar os seguintes parâmetros:

• selectedItems: Lista de objectos selecionados pelo utilizador nos dados a processar.

• fieldsStates: Dicionário que guarda os estados de Hidden, Disabled e Required e também o valor das variáveis definidas nos Dados inicias.

• successList: Lista de objetos que serão usados para exibir os registos processados com sucesso no processamento. Esta lista, tem que ter uma propriedade chamada stamp, que é um identificador único de cada registo. Exemplo:
  

  For Each itemFt As Object In SelectedItems
  
      successList.Add(New With {
  
          .stamp = itemFt.ftstamp,
  
          .fno = itemFt.fno,
  
          .nmdoc = itemFt.nmdoc
  
      })
  
  Next
  
  

• messagesList: Lista de MessageVO usada para definir mensagens que serão exibidas no resultado do processamento.

• targetRecordStamp: Este parâmetro está disponível apenas em processamentos de registo e guarda o stamp do registo a ser processado.

Nesta área, pode configurar as colunas que serão usadas para a exibição dos resultados.

Sobre esta área de Traduções, pode definir as respetivas traduções dos campos que foram criados na configuração do processamento.