DET - Documento de Especificação Técnica Cadastro de Indicadores

UnidadeNomeFonee-mail
GER-TICassio Guilhermy Tavares Souza cguilhermy@tce.go.gov.br
GER-TIIgor Vinicius dos Santos Silva ivinicius@tce.go.gov.br

Com a criação de uma nova suíte de gestão documental denominada de TCE-Docs que será composta por diversos módulos integrados, surge a necessidade da disponibilização de uma funcionalidade de cadastro de indicadores. Essa funcionalidade deverá ser disponibilizada no módulo do TCE-Docs para os usuários administradores do sistema, os indicadores definidos serão responsáveis por mapear informações primordiais dos documentos produzidos, e transmitidos dentro do tribunal de contas.

Os indicadores serão divididos em duas categorias, sendo indicadores de dados, e indicadores de modelos. Os indicadores de dados irão indicar as informações que serão capturadas do documento para a aplicação, já os indicadores de modelos, serão utilizados para definir os modelos dos documentos dentro do TCE-Docs, as informações desse indicador será da aplicação para o documento, sendo que serão carregados automaticamente na elaboração de um documento.

N/A

Com base na necessidade acima apresentada, foram identificadas as seguintes Estórias de Usuário, as quais são identificadas pelo prefixo EU (Estória de Usuário) seguida de um número, como apresentado abaixo:

CódigoDescrição
EU.01COMO usuário (administrador) do TCE-GO QUERO criar indicadores de modelo PARA que na elaboração de documentos possa vincular os dados da aplicação ao documento.
EU.02COMO usuário (administrador) do TCE-GO QUERO criar indicadores de dados PARA que na elaboração de um modelo de documentos possa definir quais indicadores de dados serão obrigatórios no momento da produção de um documento do tipo vinculado, os indicadores de dados poderão ser do tipo texto, numérico, CPF/CNPJ, data, seleção, e lista.
EU.03COMO usuário (administrador) do TCE-GO QUERO criar indicadores de modelos e de dados PARA que na revisão ou elaboração de um documentos possa definir uma query ou um webServices para trazer dados ao indicador.
EU.04COMO usuário (administrador) do TCE-GO QUERO criar grupos de indicadores de dados PARA que na revisão ou elaboração de um documentos possa informar dados aos indicadores daquele grupo.
EU.05COMO usuário (administrador) do TCE-GO QUERO desativar um grupos de indicadores de dados PARA que na revisão ou elaboração de um documentos o mesmo não seja mais mostrado.
EU.06COMO usuário (administrador) do TCE-GO QUERO vincular uma cor aos indicadores PARA que na revisão ou elaboração de um documentos possa identificar melhor a informação selecionada no texto do documento.
EU.07COMO usuário (administrador) do TCE-GO QUERO pesquisar um grupos de indicadores de dados PARA que seja possível fazer alterações, ou revisão nos mesmos.
EU.08COMO usuário (administrador) do TCE-GO QUERO pesquisar indicadores PARA que seja possível fazer alterações, ou revisão nos mesmos.

A proposta de solução descrita neste escopo é uma sugestão e poderá sofrer mudanças durante o processo de desenvolvimento, caso se identifique a necessidade.

A Matriz de Indicadores apresentará para o usuário que tem acesso a essa opção do menu os indicadores já cadastrados no sistema TCE-Docs. Quando o usuário acessar essa funcionalidade através do menu de acesso, o sistema irá apresentar os indicadores ordenados por descrição, possibilitando através do botão Filtros, consultar pelos filtros Descrição, Tipo de Indicador e Tipo de Dado. Através do botão Inserir, o usuário poderá incluir novos indicadores, através da funcionalidade de Manutenção de Indicador.

Na lista de indicadores localizados, será apresentadas as colunas Ação, Código, Descrição, Tipo de Indicador e Tipo de Dado. A coluna Ação, será apresentado para cada indicador as ações de Excluir (botão “X”), Editar (botão “E”) e Visualizar (botão “V”).

A ação de visualização de um indicador será apenas de mostrar para o usuário qual a configuração do indicador (a descrição, o tipo do indicador - modelo ou dado, o tipo de dado, o tamanho, a precisão, a configuração caso tipo lista, lista tabela e lista web service).

2.1.1. Protótipo de Tela

2.1.2. Descrição dos Atributos

N/A

2.1.3. Regras de Sistema

1. Não será permitido excluir um indicador que já esteja relacionado a um Modelo de Documento;

Como apresentado na seção 2.1., a funcionalidade de manutenção será apresentada no momento de inclusão de novo indicador ou no momento da edição de um indicador existente. Cada indicador, por padrão e de forma obrigatória, deverá ser informada sua Descrição, o Tipo do Indicador e o Tipo de Dado.

Os indicadores do tipo Modelo, serão utilizados para configurar o modelo do documento a fim de formatar o documento na forma de template (modelo Word) do documento que será criado a partir desse template. Já os indicadores do tipo Dado, serão indicadores que irão conter informações relevantes sobre o documento, seja informações obtidas do conteúdo do documento, ou sejam aquelas informadas manualmente em um campo de edição durante a elaboração do documento.

Os tipos de dados de indicadores identificados são:

TipoDescrição
TextoIndicador de conteúdo textual.
NúmeroIndicador de conteúdo numérico, com ou sem cadas decimais.
Data e HoraIndicador de conteúdo data e hora, apenas data ou apenas horas.
BooleanoIndicador de conteúdo Sim ou Não.
SexoIndicador de sexo Masculino ou Feminino.
CPF ou CNPJIndicador de CPF ou CNPJ.
ListaIndicador do tipo lista de opções.
Lista TabelaIndicador do tipo lista a partir de informações de uma determinada tabela do banco de dados.
Lista Web ServiceIndicador do tipo lista a partir de informações obtidas de um serviço Web Service.
ImagemIndicador de conteúdo do tipo imagem.
AssinaturaIndicador de conteúdo que identifique assinatura no documento.

Para melhor apresentar as funcionalidades para dada tipo de indicador e para cada tipo de dado do indicador, será documentada na seção Protótipo de Tela, o funcionamento para cada tipo de indicador e para cada tipo de dado do indicador.

2.2.1. Protótipo de Tela

Na manutenção de indicadores do tipo de dado Imagem, caso o mesmo seja do tipo Modelo, os sistema irá armazenar a imagem no indicador para ser utilizado no modelo do documento (modelo Microsoft Word), como por exemplo o brasão do Estado de Goiás, a logo do TCE-GO dentre outros. dessa forma o sistema irá apresentar a opção de seleção do arquivo para fazer upload da imagem para o sistema.

Já na manutenção de indicadores do tipo de dado Imagem quando for do tipo Dado, a imagem será selecionada na edição do documento documento e relacionada ao indicador.

Nome Funcionalidade Obrigação Regras Atributos
Arquivo de Imagem x
Finalidade Imagem selecionada para compor o modelo do documento.
Tipo/Tamanho byte[] / 100 Mb
Observação N/A

A manutenção de indicadores do tipo de indicador Modelo e do tipo de dado Texto, o sistema irá apresentar um editor de texto para o usuário informar o conteúdo do modelo textual do indicador de modelo. Esse conteúdo ser armazenado no indicador para ser utilizado na criação/formatação dos modelos de documento, na confecção do modelo de documento Microsoft Word.

Nome Funcionalidade Obrigação Regras Atributos
Texto do Modelo x
Finalidade Texto do modelo para formatação do documento Microsoft Word na criação de modelos.
Tipo/Tamanho Texto / N/A
Observação N/A

Indicador do tipo de indicador Modelo e do tipo de dado Assinatura, o usuário deverá informar se será utilizada a imagem da assinatura no momento de assinar o documento. Esse tipo de indicador será configurado no modelo de documento no local onde ficará a assinatura Digital ou da imagem da assinatura, para incluir a assinatura do usuário assinante conforme cadastro dos assinantes na funcionalidade de Controle de Assinantes.

O usuário assinante, quando o documento estiver para o usuário assinar o documento, e para o indicador de assinatura incluído no documento a propriedade “Utilizar imagem da assinatura manual?” estiver selecionada, o sistema além de incluir a assinatura digital do usuário, também irá incluir no campo selecionado pelo usuário a imagem da assinatura do usuário.

Nome Funcionalidade Obrigação Regras Atributos
Utiliza imagem da assinatura manual?
Finalidade Incluir no local onde foi incluído o modelo no documento além do identificador da assinatura digital do usuário, a imagem da assinatura manual o mesmo.
Tipo/Tamanho N/A
Observação N/A

Indicador do tipo de dado Texto poderá ser determinado o tamanho do texto que será informado ao indicador durante a elaboração do documento.

Nome Funcionalidade Obrigação Regras Atributos
Tamanho
Finalidade Define o tamanho da informação que será informada no indicador do tipo texto.
Tipo/Tamanho N/A
Observação N/A

Na manutenção de indicador do tipo de indicador Dado e tipo de dado Numérico, o usuário deverá informar o tamanho (número de dígitos) será permitido informar o indicador e a quantidade de casas decimal, que caso não seja informada será considero como número inteiro.

Nome Funcionalidade Obrigação Regras Atributos
Tamanho X
Finalidade Definir até que tamanho de número será permitido para o indicador informado.
Tipo/Tamanho N/A
Observação N/A
Nº casas decimais
Finalidade Determina quantas casas decimais o número terá, caso informado.
Tipo/Tamanho N/A
Observação N/A

O indicador de tipo de dado Data e Hora, poderá ser utilizado na configuração dos modelos de documento como sendo Data e Hora, apenas Data ou apenas Horas, conforme configuração do indicador pela sua mascara de configuração.

Na manutenção de indicador do tipo CPF ou CNPJ poderá ser utilizado tanto para CPF quanto para CNPJ, ainda que a informação poderá ser CPF ou CNPJ.

Os indicadores do tipo Lista deverão ser configuradas as opções que compõem a lista, de modo a determinar o valor Chave do campo e o valor da Descrição do campo.

Nome Funcionalidade Obrigação Regras Atributos
Campo Chave X
Finalidade Define a informação chave da opção da lista, sendo essa informação única para o indicador lista configurado.
Tipo/Tamanho Texto / 40
Observação N/A
Descrição (Opção) X
Finalidade Descrição que será apresentada no momento da edição de documentos para que usuário selecione uma das opções listadas para o indicador configurado.
Tipo/Tamanho Texto / 10
Observação N/A

Na manutenção de indicador do tipo de dado Lista Tabela, o usuário deverá informar o nome da Tabela, a Coluna Chave e a Coluna Descrição, todos os campos de preenchimento obrigatório.

Nome Funcionalidade Obrigação Regras Atributos
Nome da Tabela X
Finalidade Define o nome da tabela que contém a informação que será apresentado nas opções do indicador.
Tipo/Tamanho Texto / 30
Observação N/A
Coluna Chave X
Finalidade Nome da coluna que será utilizada como chave da informação que será apresentada como opção para o indicador configurado.
Tipo/Tamanho Texto / 30
Observação O sistema não irá verificar se para a tabela informada há mais de um registro com a mesma chave de identificação, assim esse controle é de responsabilidade do usuário ao configurar o indicador.
Coluna Descrição X
Finalidade Nome da coluna que contém a descrição do registro na tabela informada, que será apresentada no texto da opção de seleção para o usuário selecionar entre as opções do indicador configurado.
Tipo/Tamanho Texto / 30
Observação N/A
Botão Visualizar
Finalidade Possibilitar que o usuário teste e visualize as opções que serão apresentadas para o usuário apresentando a Chave do Indicador e a Descrição do Indicador que será apresentadas na forma de opções do indicador configurado.
Tipo/Tamanho N/A
Observação N/A

Na manutenção de indicador do tipo de dado Web Service, o usuário deverá informar a URL do serviço web, o usuário de autenticação se tiver, e a senha do usuário de autenticação se tiver.

Nome Funcionalidade Obrigação Regras Atributos
URL X
Finalidade URL do serviço web que será consumido para obter a lista de opções para o indicador do tipo Lista Web Service.
Tipo/Tamanho Texto / 300
Observação N/A
Usuário
Finalidade Nome de usuário utilizado para autenticar no serviço web para obter as informações das opções para o indicador.
Tipo/Tamanho Texto / 100
Observação Informar somente se para o serviço da URL informado exige autenticação para obter as informações.
Senha
Finalidade Senha do usuário de autenticação do serviço web informado no campo URL, que será utilizado para autenticar na obtenção da lista de opções para o indicador configurado.
Tipo/Tamanho Texto / 100
Observação N/A
Botão Visualizar
Finalidade Possibilitar que o usuário teste e visualize as opções que serão apresentadas para o usuário apresentando a Chave do Indicador e a Descrição do Indicador que será apresentadas na forma de opções do indicador configurado.
Tipo/Tamanho N/A
Observação N/A

Tela de visualização das opções obtidas na configuração do indicador do tipo de dado Lista Tabela e Lista Web Service.

2.2.2. Descrição dos Atributos

Nome Funcionalidade Obrigação Regras Atributos
Descrição x
Finalidade Descrição que identifica o Indicador
Tipo/Tamanho Texto / 200
Observação Campo padrão de todos os indicadores que serão cadastrados.
Tipo de Indicador x
Finalidade Identificador do tipo de indicador se de Dado ou de Modelo.
Tipo/Tamanho N/A
Domínio Dado ou Modelo
Observação Campo padrão de todos os indicadores que serão cadastrados.
Tipo de Dado x
Finalidade Identificador do tipo de dado do indicador, se do tipo Texto, Numérico, Data e outros.
Tipo/Tamanho N/A
Domínio Texto, Número, Valor Monetário,Data e Hora, Booleano, Sexo, CPF ou CNPJ, Lista, Lista Tabela, Lista Web Service, Assinatura e Imagem.
Observação Campo padrão de todos os indicadores que serão cadastrados.

2.2.3. Regras de Sistema
  1. O código do grupo do indicador deverá ser gerado automaticamente.
  2. Ao acionar a opção de “Salvar”, o sistema deverá realizar as devidas consistências nos dados informados quanto à obrigatoriedade, tipo, tamanho, composição, e demais regras definidas na “Descrição dos Atributos”. Caso exista alguma informação inconsistente, o sistema deve exibir mensagem informando a inconsistência, e não salvar as informações. Se as informações estiverem consistentes, o sistema deve salvá-las persistido na base de dados do TCE-Docs.
  3. Ao acionar a opção de “Excluir”, o sistema deverá realizar um consistências nos dados do indicador, e caso exista dados de um documento vinculado ao indicador do grupo, o mesmo não poderá ser excluído.
  4. No TCE-Docs, o indicador de número do processo só será vinculado após a assinatura do documento.
  1. Não será permitido alterar o Tipo do Indicador e nem o Tipo de Dado do indicador quando este já esteja relacionado a um Modelo de Documento;

Os indicadores de negócio são um tipo específico de indicadores de modelo. Eles serão usados para compor o modelo durante sua criação, e ao criar o documento terão seus valores obtidos através de uma rotina do sistema que será criada especificamente para cada indicador.

A lista abaixo foi criada com base nos indicadores do sistema GPRO e a forma de obtenção de cada indicador deve ser baseada nas regras existentes nele.

indicadorOrigemcritériotipo de dado
Ano ExercicioVPRO_PREENCHEDOCUMENTO.NUMR_ANOREF_Ncódigo do processonumérico
AssuntoVPRO_PREENCHEDOCUMENTO.DESC_ASSUNTO_Acódigo do processoalfanumerico
Código do AssuntoVPRO_PREENCHEDOCUMENTO.CODG_ASSUNTO_Acódigo do processoalfanumerico
Conselheiro SubstitutoVPRO_PREENCHEDOCUMENTO.NOME_AUDITOR_Acódigo do processoalfanumerico
Auditor SubstitutoVPRO_PREENCHEDOCUMENTO.NOME_AUDSUBST_Acódigo do processoalfanumerico
Número do processoVPRO_PREENCHEDOCUMENTO.CODG_PROCESSO_Ncódigo do processonumérico
DiretorVGER_RESPATUAL.NOME_RESPONSA_A
*A consulta pode mudar dependendo do tipo de documento
setor do usuárioalfanumerico


Função Setor
VGER_RESPSETOR.DESC_FUNCAO_A ou
VGER_RESPSETOR.NOME_SETOR_A ou
VGER_RESPATUAL.NOME_SETOR_A

*A consulta pode mudar dependendo do tipo de documento
setor do usuárioalfanumerico
VPRO_PREENCHEDOCUMENTO.DESC_FUNCAO_A
VPRO_PREENCHEDOCUMENTO.NOME_SETOR_A
código do processoalfanumerico
Mês ExercicioVPRO_PREENCHEDOCUMENTO.NUMR_MESREF_Ncódigo do processonumérico
OrgãoVPRO_PREENCHEDOCUMENTO.NOME_SETOR_Acódigo do processoalfanumerico
Origem(orgão de origem) VPRO_DADOS_USUARIO.NOME_SETORUSU_A usuário logadoalfanumerico
Procurador(a)VPRO_PREENCHEDOCUMENTO.NOME_PROCURADOR_Acódigo do processoalfanumerico
Relator(a)VPRO_PREENCHEDOCUMENTO.NOME_RELATOR_A.
Há um caso em que o valor é informado em tela
código do processoalfanumerico
Responsável SetorVGER_USUARIO.NOME_USUARIO_A ou
VGER_RESPATUAL.DESC_NOME_A
usuário logadoalfanumerico
SetorVPRO_PREENCHEDOCUMENTO.NOMESETORATUALcódigo do processoalfanumerico
UsuarioGER_PESSOAS.DESC_NOME_Ausuário logadoalfanumerico
Valor AutuaçãoVPRO_PREENCHEDOCUMENTO.VALOR_AUTUACAO_Ncódigo do processonumérico
Cargo do ResponsávelVGER_RESPATUAL.DESC_FUNC_Ausuário logadoalfanumerico
Analista do ProcessoPRO_ANDAMENTO.GERUSUA_IDcódigo do processoalfanumerico
Gerente do SetorGER_SETOINTERNO para obter o setor do usuário e o setor pai (gersein_id_pertence).
Deve-se usar o autorelacionamento até chegar ao nível de Gerência e então usar a
VGER_RESPATUAL para pegar o nome do responsável (secretário) ao qual o setor do usuário está subordinado
setor do usuárioalfanumerico
Chefe do Setor GER_SETOINTERNO para obter o setor do usuário e o setor pai (gersein_id_pertence).
Deve-se usar o autorelacionamento até chegar ao nível de serviço e então usar a
VGER_RESPATUAL para pegar o nome do responsável (secretário) ao qual o setor do usuário está subordinado
setor do usuárioalfanumerico
Secretário(a)GER_SETOINTERNO para obter o setor do usuário e o setor pai (gersein_id_pertence).
Deve-se usar o autorelacionamento até chegar ao nível de secretaria e então usar a
VGER_RESPATUAL para pegar o nome do responsável (secretário) ao qual o setor do usuário está subordinado
setor do usuárioalfanumerico
Nome DiretoriaGER_SETOINTERNO para obter o setor do usuário e o setor pai (gersein_id_pertence).
Deve-se usar o autorelacionamento até chegar ao nível desejado (Diretoria, secretaria, gerência ou Serviço);
GER_SETOGERAL para obter o nome do setor;
GER_PESSOAS e GER_USUARIO para filtrar por usuário logado.
setor do usuárioalfanumerico
Nome Secretaria
Nome Gerencia
Nome Chefia de Serviço

Algumas informações não serão usadas para compor o modelo e não aparecerão no documento mas serão armazenadas para futura utilização. A tabela abaixo contem todos os indicadores metadados que o sistema deverá tratar.

n.nome do indicador cod. SIGAD
1Número do documento 1.2
2Título 1.11
3Descrição 1.12
4Gênero 1.21
5Quantidade de folhas/página 1.25
6Indicação de anexos 1.27
7Características técnicas 5.3
8Formato de arquivo 5.4
9Ambiente de software 5.6
10Data e hora da captura
(criação do documento)
2.1

Outros metadados foram citados na documentação do SIGAD, porém foram tratados/implementados como atributos de entidades do sistema.

Após análise e validação, alguns metadados citados pelo SIGAD foram desconsiderados e não serão implementados como indicador e nem como atributos de entidades do sistema.

Os metadados relacionados ao Agente não estão nesta sessão, pois existem no sistema GPAC. Sendo assim, não estão desconsiderados.

1. Documento 2. Evento de Gestão 3. Classe 5. Componente Digital 6. Evento de preservação

código Descrição
1.3 Número do protocolo
1.4 Identificador do processo/dossiê
1.5 Número do processo/dossiê
1.6 Identificador do volume
1.7 Número do volume
1.8 Tipo de meio
1.14 Autor
1.15 Destinatário
1.16 Originador
1.17 Redator
1.17 Redator
1.19 Procedência
1.24 Idioma
1.26 Numeração sequencial dos documentos
1.32 Destinação prevista
1.33 Prazo de guarda
1.34 Localização

código Descrição
2.2 Tramitação
2.3 Transferência
2.4 Recolhimento
2.5 Eliminação
2.6 Abertura_processo/dossiê
2.7 Encerramento_processo/dossiê
2.8 Reabertura_processo/dossiê
2.9 Abertura_volume
2.10 Encerramento_volume
2.11 Juntada_anexação
2.12 Juntada_apensação
2.13 Desapensação
2.14 Desentranhamento
2.15 Desmembramento
2.16 Classificação_sigilo
2.17 Desclassificação_sigilo
2.18 Reclassificação_sigilo

CódigoDescrição
3.1 Descrição de classe
3.1.1 Classe_nome
3.1.2 Classe_código
3.1.3 Classe_subordinação
3.1.4 Registro de abertura
3.1.5 Registro de desativação
3.1.6 Reativação de classe
3.1.7 Registro de mudança de nome de classe
3.1.8 Registro de deslocamento de classe
3.1.9 Registro de extinção
3.1.10Indicador de classe ativa/inativa
3.2 Temporalidade associada à classe
3.2.1 Classe_código
3.2.2 Prazo de guarda na fase corrente
3.2.3 Evento que determina a contagem do
prazo de guarda na fase corrente e-Arq Brasil 95
3.2.4 Prazo de guarda na fase intermediária
3.2.5 Evento que determina a contagem do
prazo de guarda na fase intermediária
3.2.6 Destinação final
3.2.7 Registro de alteração
3.2.8 Observações

CódigoDescrição
5.5 Armazenamento
5.7 Ambiente de hardware
5.8 Dependências
5.9 Relação com outros componentes digitais
5.10 Fixidade

CódigoDescrição
6.1 Compressão
6.2 Decifração
6.3 Validação de assinatura digital
6.4 Verificação de fixidade
6.5 Cálculo hash
6.6 Migração
6.7 Replicação
6.8 Verificação de vírus
6.9 Validação

  • pres/gerti/servico_de_desenvolvimento_de_sistemas_de_informacao/projetos/tce-docs/documento_esp_tec_indicadores.txt
  • Última modificação: 25/09/2017 14:08
  • por lsiqueira