MANUAL DO USUÁRIO v.1.0

(1)

MANUAL DO USUÁRIO

v.1.0

Bichara Tecnologia www.bichara.com.br

(2)

Índice

1. Introdução...3

1.1 O que é VoIPzilla DTraf?...3

1.2 Interface Gráfica...3

1.3 Navegação e Operação do Sistema...4

1.3.1 Menu Lateral...5 1.3.2 Área de dados...5 1.3.2.1 Edição de Dados...5 1.3.2.2 Abas de Sub-Itens...6 2. Fluxograma de Processos...7 2.1 Cadastros...8

2.1.1 Elementos de Rede (menu Elementos Rede)...8

2.1.1.1 Colunas (aba de Elementos de Rede)...10

2.1.1.2 CDR (aba de Elementos de Rede)...11

2.1.1.2.1 Importação Manual de CDR (aba de Elementos de Rede)...12

2.1.2 Filtros (menu Filtros)...13

2.1.2.1 Filtros de Entrada (menu Filtros > Entrada (clientes))...14

2.1.2.1.1 Elementos para Filtros (menu Filtros > Entrada > aba Elementos)...15

2.1.2.1.2 Faixa de Horário para Filtros (menu Filtros > Entrada > aba Horários)...16

2.1.2.1.3 Tarifas para Filtros (menu Filtros > Entrada > aba Tarifas)...17

2.1.2.2 Filtros de Saída (menu Filtros > Saída (fornecedores))...19

2.1.2.2.1 Elementos para Filtros (menu Filtros > Saída > aba Elementos)...20

2.1.2.2.2 Faixa de Horário para Filtros (menu Filtros > Saída > aba Horários)...20

2.1.2.1.3 Tarifas para Filtros (menu Filtros > Saída > aba Tarifas)...21

(3)

1. Introdução

1.1 O que é VoIPzilla DTraf?

VoIPzilla DTraf é um produto da família VoIPzilla para captura, importação e tarifação de bilhetes de chamada telefônicas.

O DTraf é composto de 3 (três) módulos:

● Elementos de Rede: importação de bilhetes e CDR; ● Filtros: entradas (clientes) e saídas (fornecedores); ● Relatórios: encontro de contas, detalhamentos e etc.

1.2 Interface Gráfica

O Sistema foi desenvolvido para interface gráfica Web (Internet), estando disponível para acesso a partir de qualquer Navegador (Browser) que atenda os seguintes requisitos:

● Suporte JavaScript versão 1.1 ou superior ● Suporte para DIVs e Frames

O sistema foi testado nos seguintes navegadores:

● Internet Explorer versão 6.0

● Mozilla (Netescape Navigator) versão 1.2 ● Firefox versão 2.0

(4)

1.3 Navegação e Operação do Sistema

A navegação é iniciada no Menu Lateral, organizado hierarquicamente, e as informações são apresentadas na Área de Dados.

VoIPzilla DTraf – Bichara Tecnologia pág. 4

Menu Lateral

(5)

1.3.1 Menu Lateral

O Menu apresenta 4 tópicos: Elementos Rede, Filtros, Relatórios e System. Para acessar um tópico do Menu, clique na opção desejada ou na “pasta” para acessar os sub-menus.

1.3.2 Área de dados

Na Área de Dados são apresentadas as informações conforme seleção dos itens do Menu.

As informações são organizadas por tópico e a situação e ferramentas de edição são apresentadas na barra de navegação.

1.3.2.1 Edição de Dados

As informações são apresentadas na Área de Dados. Para editar as informações, posicione o cursor no campo desejado. Ao final, pressione “OK” para gravar. Para alguns itens, também está disponível a opção “Apagar”. Esta opção removerá o registro e toda informação relacionada do banco de dados.

Ferramentas de Edição

(6)

1.3.2.2 Abas de Sub-Itens

Os dados são organizadas em níveis hierárquicos. Cada nível está vinculado ao seu superior através das Aba.

✎

Nota:

Os campos marcados com * são obrigatórios.

No caso do item acima, para cada Elememento de Rede, temos vários arquivos de detalhamento do CDR, criando uma relação do tipo um para muitos (1 Elemento -> muitos arquivos de CDR). Quando clicar na lingüeta CDR, serão listados os arquivos de bilhetes:

Para acessar as informações do Arquivo CDR, clique na linha desejada. Para importar arquivos CDR em formato Excel (padrão 97/2000 .xls) ou CSV ou AMA-80, clique em “Importar CDR”.

Abas Sub-Itens

(7)

2. Fluxograma de Processos

As informações foram distribuídas de forma a garantir a flexibilidade do sistema, conforme quadros abaixo:

Aquisição Importação FTP, TFTP Classificação Filtros Custo Venda Inconsistências

(8)

2.1 Cadastros

Para o processamento de bilhetes de chamadas telefônicas são necessárias pré-informações cadastradas no sistema:

. Elementos de Rede: informações dos elementos para coleta de bilhetes; . CDR: detalhamento do formato do arquivo CDR e procedimento para coleta;

. Filtros: árvore de decisão para aplicação das tarifas de custo e venda, se for o caso.

2.1.1 Elementos de Rede

(menu Elementos Rede)

Os Elementos de Rede correspondem aos equipamentos (PABX, central pública, gateway,...) para coleta de bilhetes.

a) Nome/ID: identificação do elemento.

b) Local Instalação: local em que o equipamento está instalado.

c) Coleta Automática: utilize Sim para realizar coleta automática periódica.

d) Coleta Período (horas): intervalo em horas entre os períodos de coleta de bilhetes. e) Protocolo: para conexão e coleta automática de bilhetes: FTP ou TFTP.

f) IP: endereço IP para conexão e coleta automática de bilhetes. g) Porta: porta para conexão.

(9)

h) Usuário Coleta: usuário para autenticação durante conexão FTP. i) Senha Coleta: senha para autenticação durante conexão FTP.

j) Diretório Coleta: nome do diretório em que se encontram os arquivos para “download”. Utilize padrão FTP ou Linux no nome do diretório, ou seja, não utilize “barra invertida” do Windows.

k) Máscara Arquivo: máscara de arquivo para “download”. l) Formato CDR: CSV, XLS ou AMA-80.

m) Separador Colunas (CSV): caracter utilizado para separar as colunas em arquivos formato CSV.

n) Time Zone: zona de horário dos bilhetes. Os Elementos de Rede podem registrar os bilhetes em zonas de horário (fuso) diferentes. Estes bilhetes serão consolidados na zona de horário do Dtraf. Utilize a notação: (+/-)XX:XX, onde +00:00 é o padrão.

✎

Nota:

As colunas do arquivo CDR são definidas na aba Colunas.

(10)

2.1.1.1 Colunas (aba de Elementos de Rede)

Nesta aba são definidas as Colunas do arquivo CDR do Elemento de Rede, o formato de aquisição dos dados e as referências com os dados do banco de dados do DTraf.

a) Núm. Coluna: posição da coluna na linha. A primeira coluna recebe o número 1. b) Título: título da coluna para referência.

c) Máscara: formato de aquisição do dado. Utilize “@” na frente para definir o tamanho da colouna (especialmente útil para formato AMA-80), seguido de uma barra “/” e o máscara de formatação para de datas e hora. Se não for necessário definir o tamanho, digite apenas a máscara de formatação sem incluir “@” ou “/”.

d) Referência: referência entre a coluna do arquivo CDR e a informação do banco de dados do DTraf.

(11)

2.1.1.2 CDR (aba de Elementos de Rede)

Nesta aba são apresentados os arquivos CDR já importados (manualmente ou automaticamente).

a) Carga: data de importação no sistema.

b) Status: situação do arquivo: 1-Processamento OK; 2-Reprocessar; 3-Processado com erro. É possível alterar o status para 2-Reprocessar e o sistema reprocessará todos os bilhetes daquele arquivo.

c) Arquivo: nome original do arquivo importado.

d) Proc.: “timestamp” do último processamento do arquivo.

e) Erros Entrada: erros encontrados durante o processamento para filtros de entrada. f) Erros Saída: erros encontrados durante o processamento para filtros de saída.

✎

Nota:

Pressionando o botão “Apagar”, o arquivo e todos seus bilhetes serão removidos do sistema. Esta é uma operação que não poderá ser desfeita.

(12)

2.1.1.2.1 Importação Manual de CDR (aba de Elementos de Rede)

Arquivos CDR podem ser importados manualmente a partir de um clique na ação “Importar CDR” da aba CDR:

Serão considerados as informações do tipo de arquivo CDR registrado no cadastro do Elemento de Rede e as Colunas definidas para a importação dos registros de chamadas:

Selecione o arquivo no campo “Arquivo”. Se você configurar a opção “Cabeçalho” para “Campos na linha 1”, a primeira linha do arquivo será considerada como título para as colunas.

A opção “Depurador” ativa a apresentação das informações de processamento de cada linha do arquivo na tela para depuração dos filtros.

✎

Nota:

Ativar a opção “Depurador” para arquivos muito extensos poderá produzir lentidão ou até congelamento do navegador (browser).

(13)

2.1.2 Filtros

(menu Filtros)

Os Filtros são utilizados no processamento dos bilhetes. Existem filtros de entrada, normalmente utilizados para a tarifação pelo número de origem, ou seja, o preço de venda para cliente; e os filtros de saída, utilizados para a tarifação pelo destino das chamadas, o preço de custo dos fornecedores ou Operadoras de destino.

No menu lateral, para facilitar a localização, os filtros são organizados em ordem alfabética. Todavia, através de relações tipo pai/filho, os filtros podem ser organizados hierarquicamente e por prioridade de processamento.

A árvore de processamento hierárquico pode ser visualizada clicando no “link” do respectivo tipo de filtro: “Entrada (cliente)” ou “Saída (fornecedor)” – conforme demonstrado ao lado.

A árvore será apresenta na Área de Dados, conforme exemplo abaixo:

(14)

2.1.2.1 Filtros de Entrada (menu Filtros > Entrada (clientes))

O Filtros de Entrada definem os preços e formato de tarifação para venda aos clientes.

a) Nome: nome do filtro.

b) Pai: para vínculo hierárquico, defina o filtro “pai”. Utilize “nenhum” para indicar conexão com a raíz (primeiro nível).

c) Referência: coluna que será utilizada como referência para a tabela de Tarifas.

d) Prioridade: numero entre 1 e 99 indicando a ordem de processamento. O número 1 indica primeiro processamento.

e) Precificador: utilize “Sim” para indicar que a análise de preço poderá ser encerrada neste filtro. Quando configurado para “Não”, mesmo que atendidos os critérios do filtro e encontrada a relação em “Tarifas”, o sistema exigirá que um filtro “filho” defina os preços.

f) Verif. Portabilidade: define se o número de origem da chamada deve ser consultado no sistema de portabilidade numérica.

g) Decimais: quantidade de casas decimais para arredondamento, entre 2 e 4.

h) Coluna 1, Operador 1, Valor 1, Conector 1: critérios do filtro, indica que a “Coluna” deverá ser comparada utilizando o “Operador” com o “Valor” definido. O “Conector” é utilizado para a conexão lógica com o próximo critério e, no momento do processamento, os critérios conectados por “and” (E lógico) serão processados antes dos critérios conectados por “or” (OU lógico).

Após a definição de um critério, pressione o botão “Ok” para registrar e o sistema apresentará um novo critério abaixo. Para remover um critério, selecione “nenhum” na Coluna.

(15)

2.1.2.1.1 Elementos para Filtros (menu Filtros > Entrada > aba Elementos) Todos os Filtros podem ser aplicados para um ou mais Elementos de Rede.

Para atribuir o Filtro para um Elemento, clique no Elemento desejado no painel da esquerda e clique na seta vermelha ( > ) apontando para o painel da direita.

Para remover o Filtro de um Elemento, basta utilizar o processo inverso e clicar na seta vermelha contrária ( < ).

Um ou mais Elementos podem ser selecionado utilizando-se as teclas shift e control em combinação com os cliques ou movimentos com setas do teclado.

Ao final, clique no botão “Ok” para registrar as alterações.

(16)

2.1.2.1.2 Faixa de Horário para Filtros (menu Filtros > Entrada > aba Horários)

O horário da chamada pode ser classificado de acordo com o dia da semana e hora da chamada.

Esta diferenciação de horário pode ser utilizada para a aplicação de tarifas que veremos adiante.

a) Dia Semana: selecione o dia da semana para o horário.

b) Hora Início: horário início do intervalo, no formato HH:MM. Considere o início do intervalo no segundo “00” do horário especificado.

c) Hora Fim: horário final da faixa, no formato HH:MM. Considere o final do intervalo no segundo “59” do horário especificado.

d) Descritor: tipo do horário: Normal, Reduzido, Super Reduzido, Pico, Diurno, Noturno.

✎

Nota:

Os intervalos que não forem definidos serão considerados como Descritor Normal. Portanto, não é necessário informar os intervaos do tipo Normal, apenas os demais.

(17)

2.1.2.1.3 Tarifas para Filtros (menu Filtros > Entrada > aba Tarifas)

As chamadas classificadas pelo Filtro terão o horário adequado pela tabela de Horários e a tarifadas de acordo com as informações de Tarifas.

a) Referência / Prefixo: dado a ser comparado com a coluna de referência definida no Filtro para aplicação da Tarifa. No exemplo, o Filtro foi definido para utilizar como referência o “Número de A”, ou seja, o número do telefone de origem. Na imagem acima, todas chamadas com “Número de A” iniciado por “9” serão enquadrados na tarifa prevista neste registro.

b) Descrição / Localidade: descrição da Referência ou Prefixo. Pode ser o nome do cliente ou assinante ou a definição do tipo de acesso.

c) Cód. Tarifa: código de tarifação no padrão Anatel para definição da área de tarifação aplicada.

d) EOT: código da Operadora de origem da chamada no padrão Anatel para encontro de contas (DETRAF).

e) Categoria: classificação da categoria da origem de chamada.

f) Horário: faixa de horário para aplicação da tarifa. Utilize “Qualquer” para aplicar a tarifa para todos horários.

g) Tempo Desconsidera: duração mínima em segundos para que uma chamada seja considerada válida e seja tarifada. No exemplo, chamadas até 3 segundos são descartadas.

h) Tempo Mínimo: tempo inicial de tarifação. No exemplo, as chamadas até 30 segundos serão tarifadas como duração equivalente a 30 segundos.

i) Incremento: fração da unidade de tarifação, em segundos. No exemplo, o tempo da chamada será considerado com período de incremento de 6 segundos (intervalo mínimo).

j) Valor Conexão: valor a ser cobrado na conexão da chamada, desde que a chamada tenha uma duração mínima maior que “Tempo Desconsidera”.

(18)

k) Valor Mínimo: valor a ser cobrado para as chamadas que tiverem duração menor ou igual ao tempo definido em “Tempo Mínimo”.

l) Valor Minuto: valor da tarifa por minuto, cobrada a partir do “Tempo Mínimo” em fração de tempo definida em “Incremento”.

✎

Nota:

Os Filtros são processados em níveis hierárquicos e, no momento do processamento do Filtro filho, as definições de Código de Tarifação, EOT e Categoria são herdados do pai. Portanto, é possível que o Filtro Pai defina uma destas colunas e o Filtro Filho utilize uma destas colunas como “Referência” para aplicação de Tarifas.

(19)

2.1.2.2 Filtros de Saída (menu Filtros > Saída (fornecedores))

O Filtros de Saída definem os preços e formato de tarifação do custo das chamadas.

✎

Nota:

Para as definições do Filtro de Saída, consulte: Filtros de Entrada.

(20)

2.1.2.2.1 Elementos para Filtros (menu Filtros > Saída > aba Elementos)

Todos os Filtros podem ser aplicados para um ou mais Elementos de Rede.

✎

Nota:

Para as definições de Elementos para Filtro de Saída, consulte: Elementos para Filtros de Entrada.

2.1.2.2.2 Faixa de Horário para Filtros (menu Filtros > Saída > aba Horários)

O horário da chamada pode ser classificado de acordo com o dia da semana e hora da chamada.

Esta diferenciação de horário pode ser utilizada para a aplicação de tarifas que veremos adiante.

✎

Nota:

Para as definições de Horários para Filtro de Saída, consulte: Horários para Filtros de Entrada.

(21)

2.1.2.1.3 Tarifas para Filtros (menu Filtros > Saída > aba Tarifas)

As chamadas classificadas pelo Filtro terão o horário adequado pela tabela de Horários e o preço de custo será atribuído de acordo com as informações de Tarifas.

a) Referência / Prefixo: dado a ser comparado com a coluna de referência definida no Filtro para aplicação da Tarifa. No exemplo, o Filtro foi definido para utilizar como referência o “Número de B”, ou seja, o número do telefone de destino. Na imagem acima, todas chamadas com “Número de B” iniciado por “11202” serão enquadrados na tarifa prevista neste registro.

b) Descrição / Localidade: descrição da Referência ou Prefixo. Pode ser o nome da localidade de destino ou Operadora.

c) Cód. Tarifa: código de tarifação no padrão Anatel para definição da área de tarifação aplicada.

d) EOT: código da Operadora de destino da chamada no padrão Anatel para encontro de contas (DETRAF).

e) Categoria: classificação da categoria do destino de chamada.

f) Horário: faixa de horário para aplicação da tarifa. Utilize “Qualquer” para aplicar a tarifa para todos horários.

g) Tempo Desconsidera: duração mínima em segundos para que uma chamada seja considerada válida e seja tarifada. No exemplo, chamadas até 3 segundos são descartadas.

h) Tempo Mínimo: tempo inicial de tarifação. No exemplo, as chamadas até 30 segundos serão tarifadas como duração equivalente a 30 segundos.

(22)

i) Incremento: fração da unidade de tarifação, em segundos. No exemplo, o tempo da chamada será considerado com período de incremento de 6 segundos (intervalo mínimo).

j) Valor Conexão: valor a ser cobrado na conexão da chamada, desde que a chamada tenha uma duração mínima maior que “Tempo Desconsidera”.

k) Valor Mínimo: valor a ser cobrado para as chamadas que tiverem duração menor ou igual ao tempo definido em “Tempo Mínimo”.

l) Valor Minuto: valor da tarifa por minuto, cobrada a partir do “Tempo Mínimo” em fração de tempo definida em “Incremento”.

m) Tempo Desconsidera 2, Tempo Mínimo 2 e Incremento 2: análogos aos tempos definidos anteriormente mas aplicam-se para a segunda “perna” da chamada. Por exemplo: no caso de interconexão indireta com operadoras, os tempos definidos nas letras “g”,”h” e “i”, indicam os parâmetros para a primeira cobrança, ou seja, o transporte pago à Operadora que entrega a chamada na Operadora de destino, enquanto os valores deste item aplicam-se aos tempos de Tarifa de Uso de Rede da Operadora de destino.

n) Valor Conexão 2, Valor Mínimo 2 e Malor Minuto 2: análogos aos valores definidos anteriormente mas aplicam-se para a segunda “perna” da chamada, conforme exemplificado na letra “m” acima.

✎

Nota:

Os Filtros são processados em níveis hierárquicos e, no momento do processamento do Filtro filho, as definições de Código de Tarifação, EOT e Categoria são herdados do pai. Portanto, é possível que o Filtro Pai defina uma destas colunas e o Filtro Filho utilize uma destas colunas como “Referência” para aplicação de Tarifas.