CONTEÚDO
- Visão Geral
- Exemplo de utilização
- Tabelas utilizadas
Aviso |
---|
|
Esta funcionalidade está em etapa de desenvolvimento e testes de pilotos. |
Aviso |
---|
|
Esta funcionalidade está disponível a partir do release 12.1.33 (Expedição contínua com data >= à 24/06/2022). |
Nota |
---|
title | ATENÇÃO: Pacotes necessários para o funcionamento da rotina |
---|
|
Para o funcionamento desta rotina, foi necessária a criação de dois campos e um índice: - Campos A1P_CUSTOM e A1N_CUSTOM;
- Índice 2 para a tabela A1Q.
Portanto, deve-se aplicar o pacote da expedição contínua do Faturamento ou do Backoffice Protheus superior ou igual a data de corte XX17/XX/XXXX (Informar link)03/2022. Mais informações podem ser obtidas nas documentações DT API Tipos de Cards e Gráficos Customizados e DT Validação na exclusão de Tipos de Cards e Gráficos Customizados. |
01. VISÃO GERAL
O menu Customizações (Manutenção de Cards e Gráficos Customizados) permite Incluir, Editar e Excluir tipos de gráficos e cards customizados.
Âncora |
---|
| EXEMPLO_UTILIZACAO |
---|
| EXEMPLO_UTILIZACAO |
---|
|
02. EXEMPLO DE UTILIZAÇÃO
...
Expandir |
---|
title | Manutenção de Tipos de Card Customizados |
---|
|
Na manutenção de Tipos de Card Customizados, são disponibilizadas três opções: Incluir, alterar e excluir. Abaixo detalhes sobre elas Alterar e Excluir: Expandir |
---|
| Na inclusão de um tipo de card customizado, ele é inserido na base de dados informando o campo A1N_CUSTOM = .T., campo que indica quando um dado é customizado ou não. Segue abaixo o processo de inclusão: Totvs custom tabs box |
---|
tabs | Passo 1, Passo 2, Passo 3, Passo 4, Passo 5 |
---|
ids | passo1,passo2,passo3,passo4,passo5 |
---|
| Totvs custom tabs box items |
---|
default | yes |
---|
referencia | passo1 |
---|
| Clicar na opção Incluir, informar o título para o card e selecionar a opção de 'Tipo' como 'Card':
Ao selecionar a opção de 'Tipo' como 'Card', um formulário é aberto solicitando os quatro endpoints necessários para o funcionamento de um Card. Para entender detalhadamente cada um deles, consultar documentação CoreDash - Criação de novos Cards e Gráficos, tópico EXEMPLO DE UTILIZAÇÃO. URI Serviço do Card: Serviço que retorna as informações que poderão ser apresentadas no card (Correspondente ao endpoint cardInfo do exemplo citado acima); URI Serviço de Campos: Serviço que retorna a propriedade e o nome dos campos que poderão ser apresentados no card (Correspondente ao endpoint fieldsInfo do exemplo citado acima); URI Serviço de Itens: Serviço que retorna as informações que serão apresentadas na opção 'Detalhes' do card (Correspondente ao endpoint itemsDetails do exemplo citado acima); URI Serviço de Filtro: Serviço que retorna os campos que poderão ser utilizados no filtro do card (Correspondente ao endpoint cardFilter do exemplo citado acima). |
Totvs custom tabs box items |
---|
default | no |
---|
referencia | passo2 |
---|
| Preencher o formulário informando os endpoints e clicar em 'Validar':
O botão 'Validar' será liberado apenas quando todos os campos forem preenchidos. Sua função é validar se todos os endpoints retornam a estrutura necessária, conforme documento CoreDash - Criação de novos Cards e Gráficos, tópico EXEMPLO DE UTILIZAÇÃO (Retorno esperado para esse endpoint). Caso algum dos serviços informados não retorne a estrutura correta, o botão de 'Salvar' não será liberado e será retornada a mensagem de erro para cada endpoint que falhou. |
Totvs custom tabs box items |
---|
default | no |
---|
referencia | passo3 |
---|
| Clicar em 'Salvar':
|
Totvs custom tabs box items |
---|
default | no |
---|
referencia | passo4 |
---|
| Incluir um Card com o novo Tipo cadastrado: - Clicar em Cards;
- Incluir Card conforme documentação Gerenciar Cards.
|
Totvs custom tabs box items |
---|
default | no |
---|
referencia | passo5 |
---|
| Vincular o novo card criado à uma visão:
|
|
|
Expandir |
---|
| Totvs custom tabs box |
---|
tabs | Passo 1, Passo 2, Passo 3 |
---|
ids | passo6,passo7,passo8 |
---|
| Totvs custom tabs box items |
---|
default | yes |
---|
referencia | passo6 |
---|
| Posicionar no item que deseja alterar e clicar no ícone de lápis:
|
Totvs custom tabs box items |
---|
default | no |
---|
referencia | passo7 |
---|
| Alterar o que for necessário e clicar em 'Validar':
|
Totvs custom tabs box items |
---|
default | no |
---|
referencia | passo8 |
---|
| Clicar em 'Salvar':
|
|
|
Expandir |
---|
| Posicionar no item que deseja excluir e clicar no ícone de lixeira: Image Added |
|
Expandir |
---|
title | Manutenção de Tipos de Gráfico Customizados |
---|
|
Na manutenção de Tipos de Gráfico Customizados, são disponibilizadas três opções: Incluir, Alterar e Excluir: Expandir |
---|
| Na inclusão de um tipo de gráfico customizado, ele é inserido na base de dados informando o campo A1P_CUSTOM = .T., campo que indica quando um dado é customizado ou não. Segue abaixo o processo de inclusão: Totvs custom tabs box |
---|
tabs | Passo 1, Passo 2, Passo 3, Passo 4, Passo 5 |
---|
ids | passo9 | passo10,passo11,passo12,passo13,passo14 |
---|
| Totvs custom tabs box items |
---|
default | yes |
---|
referencia | passo10 |
---|
| Clicar na opção Incluir, informar o título para o gráfico e selecionar a opção de 'Tipo' como 'Gráfico': Image Added Ao selecionar a opção de 'Tipo' como 'Gráfico', um formulário é aberto solicitando os três endpoints necessários para o funcionamento de um Gráfico. Para entender detalhadamente cada um deles, consultar documentação CoreDash - Criação de novos Cards e Gráficos, tópico EXEMPLO DE UTILIZAÇÃO. URI Serviço do Formulário: Serviço que retorna o formulário para cadastro do gráfico (Correspondente ao endpoint form do exemplo citado acima); URI Serviço de Dados: Serviço que retorna os dados que serão apresentados no gráfico (Correspondente ao endpoint retdados do exemplo citado acima); URI Serviço de Itens: Serviço que retorna as informações que serão apresentadas na opção 'Detalhes' do gráfico (Correspondente ao endpoint itemsDetails do exemplo citado acima); |
Totvs custom tabs box items |
---|
default | no |
---|
referencia | passo11 |
---|
| Preencher o formulário informando os endpoints e clicar em 'Validar': Image Added O botão 'Validar' será liberado apenas quando todos os campos forem preenchidos. Sua função é validar se todos os endpoints retornam a estrutura necessária, conforme documento CoreDash - Criação de novos Cards e Gráficos, tópico EXEMPLO DE UTILIZAÇÃO (Retorno esperado para esse endpoint). Caso algum dos serviços informados não retorne a estrutura correta, o botão de 'Salvar' não será liberado e será retornada a mensagem de erro para cada endpoint que falhou. |
Totvs custom tabs box items |
---|
default | no |
---|
referencia | passo12 |
---|
| Clicar em 'Salvar': Image Added |
Totvs custom tabs box items |
---|
default | no |
---|
referencia | passo13 |
---|
| Incluir um Gráfico com o novo Tipo cadastrado: - Clicar em Gráficos;
- Incluir Gráfico conforme documentação Gerenciar Gráficos.
Image Added |
Totvs custom tabs box items |
---|
default | no |
---|
referencia | passo14 |
---|
| Vincular o novo gráfico criado à uma visão: Image Added |
|
|
Expandir |
---|
| Totvs custom tabs box |
---|
tabs | Passo 1, Passo 2, Passo 3 |
---|
ids | passo15,passo16,passo17 |
---|
| Totvs custom tabs box items |
---|
default | yes |
---|
referencia | passo15passo9 |
---|
| Posicionar no item que deseja alterar e clicar no ícone de lixeira:lápis: Image Added |
Totvs custom tabs box items |
---|
default | no |
---|
referencia | passo16 |
---|
| Alterar o que for necessário e clicar em 'Validar': Image Added |
Totvs custom tabs box items |
---|
default | no |
---|
referencia | passo17 |
---|
| Clicar em 'Salvar': Image AddedImage Removed |
|
|
| Manutenção de Gráficos Customizados | Fazer | Posicionar no item que deseja excluir e clicar no ícone de lixeira: Image Added |
|
03. TABELAS UTILIZADAS
- A1N - Tipos de Card
- A1P - Tipos de Gráfico
- A1Q - Gráficos
- A1O - Cards, A1P, A1Q e A1O
- Tabelas - Dashboard Backoffice
...