DET - Documento de Especificação Técnica Cadastro de Indicadores
1. Informações Gerais sobre o Levantamento
RESPONSÁVEL PELA ELABORAÇÃO
| Unidade | Nome | Fone | |
| GER-TI | Cassio Guilhermy Tavares Souza | cguilhermy@tce.go.gov.br | |
| GER-TI | Igor Vinicius dos Santos Silva | ivinicius@tce.go.gov.br |
1. Descrição das Necessidades
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.
2. Premissas e Restrições
N/A
3. Estórias de Usuário
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ódigo | Descrição |
|---|---|
| EU.01 | COMO 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.02 | COMO 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.03 | COMO 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.04 | COMO 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.05 | COMO 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.06 | COMO 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.07 | COMO 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.08 | COMO usuário (administrador) do TCE-GO QUERO pesquisar indicadores PARA que seja possível fazer alterações, ou revisão nos mesmos. |
2. Proposta de Solução
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.
2.1. Matriz de Indicadores
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;
2.2. Manutenção de Indicadores
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:
| Tipo | Descrição |
|---|---|
| Texto | Indicador de conteúdo textual. |
| Número | Indicador de conteúdo numérico, com ou sem cadas decimais. |
| Data e Hora | Indicador de conteúdo data e hora, apenas data ou apenas horas. |
| Booleano | Indicador de conteúdo Sim ou Não. |
| Sexo | Indicador de sexo Masculino ou Feminino. |
| CPF ou CNPJ | Indicador de CPF ou CNPJ. |
| Lista | Indicador do tipo lista de opções. |
| Lista Tabela | Indicador do tipo lista a partir de informações de uma determinada tabela do banco de dados. |
| Lista Web Service | Indicador do tipo lista a partir de informações obtidas de um serviço Web Service. |
| Imagem | Indicador de conteúdo do tipo imagem. |
| Assinatura | Indicador 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 |
|
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 |
|
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? |
|
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 |
|
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 |
|
||||||||||||
| Nº casas decimais |
|
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 |
|
||||||||||||
| Descrição (Opção) | X |
|
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 |
|
||||||||||||
| Coluna Chave | X |
|
||||||||||||
| Coluna Descrição | X |
|
||||||||||||
| Botão Visualizar |
|
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 |
|
||||||||||||
| Usuário |
|
|||||||||||||
| Senha |
|
|||||||||||||
| Botão Visualizar |
|
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 |
|
||||||||||||||||
| Tipo de Indicador | x |
|
||||||||||||||||
| Tipo de Dado | x |
|
2.2.3. Regras de Sistema
- O código do grupo do indicador deverá ser gerado automaticamente.
- 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.
- 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.
- No TCE-Docs, o indicador de número do processo só será vinculado após a assinatura do documento.
- 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;
2.3. Indicadores de Negócio
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.
| indicador | Origem | critério | tipo de dado |
|---|---|---|---|
| Ano Exercicio | VPRO_PREENCHEDOCUMENTO.NUMR_ANOREF_N | código do processo | numérico |
| Assunto | VPRO_PREENCHEDOCUMENTO.DESC_ASSUNTO_A | código do processo | alfanumerico |
| Código do Assunto | VPRO_PREENCHEDOCUMENTO.CODG_ASSUNTO_A | código do processo | alfanumerico |
| Conselheiro Substituto | VPRO_PREENCHEDOCUMENTO.NOME_AUDITOR_A | código do processo | alfanumerico |
| Auditor Substituto | VPRO_PREENCHEDOCUMENTO.NOME_AUDSUBST_A | código do processo | alfanumerico |
| Número do processo | VPRO_PREENCHEDOCUMENTO.CODG_PROCESSO_N | código do processo | numérico |
| Diretor | VGER_RESPATUAL.NOME_RESPONSA_A *A consulta pode mudar dependendo do tipo de documento | setor do usuário | alfanumerico |
| 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ário | alfanumerico |
| VPRO_PREENCHEDOCUMENTO.DESC_FUNCAO_A VPRO_PREENCHEDOCUMENTO.NOME_SETOR_A | código do processo | alfanumerico | |
| Mês Exercicio | VPRO_PREENCHEDOCUMENTO.NUMR_MESREF_N | código do processo | numérico |
| Orgão | VPRO_PREENCHEDOCUMENTO.NOME_SETOR_A | código do processo | alfanumerico |
| Origem(orgão de origem) | VPRO_DADOS_USUARIO.NOME_SETORUSU_A | usuário logado | alfanumerico |
| Procurador(a) | VPRO_PREENCHEDOCUMENTO.NOME_PROCURADOR_A | código do processo | alfanumerico |
| Relator(a) | VPRO_PREENCHEDOCUMENTO.NOME_RELATOR_A. Há um caso em que o valor é informado em tela | código do processo | alfanumerico |
| Responsável Setor | VGER_USUARIO.NOME_USUARIO_A ou VGER_RESPATUAL.DESC_NOME_A | usuário logado | alfanumerico |
| Setor | VPRO_PREENCHEDOCUMENTO.NOMESETORATUAL | código do processo | alfanumerico |
| Usuario | GER_PESSOAS.DESC_NOME_A | usuário logado | alfanumerico |
| Valor Autuação | VPRO_PREENCHEDOCUMENTO.VALOR_AUTUACAO_N | código do processo | numérico |
| Cargo do Responsável | VGER_RESPATUAL.DESC_FUNC_A | usuário logado | alfanumerico |
| Analista do Processo | PRO_ANDAMENTO.GERUSUA_ID | código do processo | alfanumerico |
| Gerente 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 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ário | alfanumerico |
| 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ário | alfanumerico |
| 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ário | alfanumerico |
| Nome Diretoria | 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 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ário | alfanumerico |
| Nome Secretaria | |||
| Nome Gerencia | |||
| Nome Chefia de Serviço |
2.3. Indicadores metadados
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 |
|---|---|---|
| 1 | Número do documento | 1.2 |
| 2 | Título | 1.11 |
| 3 | Descrição | 1.12 |
| 4 | Gênero | 1.21 |
| 5 | Quantidade de folhas/página | 1.25 |
| 6 | Indicação de anexos | 1.27 |
| 7 | Características técnicas | 5.3 |
| 8 | Formato de arquivo | 5.4 |
| 9 | Ambiente de software | 5.6 |
| 10 | Data 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.
2.4. Metadados SIGAD desconsiderados
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 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
|
|
|
|


