MANUAL DO USUÁRIO v.1.0

Í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 VoIPzilla DTraf Bichara Tecnologia pág. 2

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 VoIPzilla DTraf Bichara Tecnologia pág. 3

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. Área de Dados Menu Lateral VoIPzilla DTraf Bichara Tecnologia pág. 4

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 VoIPzilla DTraf Bichara Tecnologia pág. 5

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. Abas Sub-Itens 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. VoIPzilla DTraf Bichara Tecnologia pág. 6

2. Fluxograma de Processos As informações foram distribuídas de forma a garantir a flexibilidade do sistema, conforme quadros abaixo: FTP, TFTP Custo Aquisição Filtros Classificação Importação Inconsistências Venda VoIPzilla DTraf Bichara Tecnologia pág. 7

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. VoIPzilla DTraf Bichara Tecnologia pág. 8

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. VoIPzilla DTraf Bichara Tecnologia pág. 9

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. VoIPzilla DTraf Bichara Tecnologia pág. 10

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. VoIPzilla DTraf Bichara Tecnologia pág. 11

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). VoIPzilla DTraf Bichara Tecnologia pág. 12

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: VoIPzilla DTraf Bichara Tecnologia pág. 13

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. VoIPzilla DTraf Bichara Tecnologia pág. 14

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. VoIPzilla DTraf Bichara Tecnologia pág. 15

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. VoIPzilla DTraf Bichara Tecnologia pág. 16

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. VoIPzilla DTraf Bichara Tecnologia pág. 17

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. VoIPzilla DTraf Bichara Tecnologia pág. 18

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. VoIPzilla DTraf Bichara Tecnologia pág. 19

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. VoIPzilla DTraf Bichara Tecnologia pág. 20

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. VoIPzilla DTraf Bichara Tecnologia pág. 21

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. VoIPzilla DTraf Bichara Tecnologia pág. 22