Você está na página 1de 42

MANUAL DE INSTALAO / CONFIGURAO

ndice

Introduo ................................................................................................ 3
EasyLynq Empresa e EasyLynq Server .............................................. 3
EasyLynq Hotel .................................................................................... 4
Instalao ................................................................................................ 5
Convenes ......................................................................................... 5
Cuidados a ter com o CD ..................................................................... 5
Requisitos do computador ................................................................... 6
CD de instalao .................................................................................. 7
Instalao de mdulos ..................................................................... 8
Opes avanadas ........................................................................... 9
Configurao ......................................................................................... 10
TAXDBSrv .......................................................................................... 10
PBXAgent........................................................................................... 14
Informao de estado ..................................................................... 17
Mdulo de consulta e administrao EasyLynq ................................ 18
Instalao de atualizaes ................................................................. 25
Configurao do EasyLSQL (controlador ODBC) ............................. 26
Criao da origem de dados .......................................................... 26
Obteno de dados ........................................................................ 29
Notificaes SNMP ............................................................................ 34
Notas de instalao ............................................................................... 36

Manual de Instalao / Configurao -1-


EasyLynq - Sistema de Gesto Telefnica
verso 1.40

Manual de instalao / configurao


Data de edio: 2013.Novembro.29

Eurofluxo - Suporte a Novas Tecnologias, Lda.


Vila Nova de Gaia - Portugal
http://www.eurofluxo.pt/

-2-
Introduo

EasyLynq Empresa e EasyLynq Server


O EasyLynq um conjunto integrado de aplicaes desenvolvido para o
tratamento de custos e trfego de equipamentos de voz tradicionais e IP,
disponvel em configuraes que vo desde o pequeno escritrio grande
empresa geograficamente distribuda.

Apresentando um alto nvel de fiabilidade, como comprovam as mais de 12000


instalaes em todo o mundo, possui uma arquitetura optimizada para a
operao em redes alargadas.

Instalao nos sistemas operativos Windows 2000 e superior. Produto


certificado para o Windows 7, Windows Server 2012 e Windows 8, 32 e 64
bits.
Totalmente escalonvel para qualquer dimenso (at 100000 linhas),
facultando uma viso unificada dos custos e trfego da rede telefnica.
Operao convergente para servidores de voz IP, centrais telefnicas
tradicionais, routers e outros dispositivos de comunicaes.
Base de dados centralizada com indexao de ficheiros, com
possibilidade de ligao ODBC, permitindo tempos de pesquisa de
informao reduzidos.
Arquitetura totalmente distribuda e optimizada tanto para funcionamento
de rede (LAN/WAN) como em stand-alone.

Manual de Instalao / Configurao -3-


EasyLynq Hotel
Dispondo das mesmas propriedades que caracterizam a verso empresarial, o
EasyLynq Hotel oferece adicionalmente um vasto leque de funcionalidades
especficas para a rea hoteleira, das quais se evidenciam:

Opo multi-complexo para gesto de mltiplas unidades hoteleiras.

Compatvel com a maioria dos sistemas de Front-Office: Fidelio*, Protel,


SIHOT, NewHotel, Brilliant, HotelConcepts, Medallion, Host, NHS, Visual
One, etc.

Interligao com uma grande variedade de equipamentos de acesso a


internet banda larga 'in-room' e 'wireless' (opcional).

Identificao do hspede no visor dos telefones.

Atribuio, automtica e manual, de limite de crdito.

Mensagem em espera ('message waiting'), com ativao da lmpada de


sinalizao do telefone do quarto.

Dbito de artigos de minibar e lavandaria a partir do telefone do quarto por


pessoal autorizado ou diretamente no EasyLynq.

Modificao do estado do quarto ('room-status'), pela governanta e


pessoal de limpeza atravs do teclado do telefone, permitindo a imediata
atualizao de disponibilidade do alojamento.

Mltiplas classes de acesso rede pblica para os telefones dos


alojamentos.

Suporte para nove idiomas falados e escritos: Portugus (Portugal e


Brasil), Ingls, Espanhol, Francs, Alemo, Holands, Italiano e Turco.

Servio 'No incomodar'.

Abertura e fecho da caixa do correio de voz, na entrada e sada do


hspede.

Programao e controlo do atendimento do despertar automtico, com


emisso de alarmes sonoro e visual no EasyLynq em caso de falha de
resposta.

* O EasyLynq Hotel encontra-se certificado pela Micros/Fidelio para as verses 6, Suite 7,


Suite 8 e Opera (Fidelio Part-No: 5001-309)

-4-
Instalao
Este captulo destina-se a conduzir o instalador nos procedimentos e cuidados
a observar na instalao e configurao inicial do EasyLynq. Assume-se que o
instalador est familiarizado com as diversas verses do sistema operativo
Windows.

Algumas das informaes apresentadas neste manual podem no ser exatas


ou diferir das encontradas na instalao do cliente.

Convenes
Os seguintes sinais especiais so usados neste capitulo para destacar
informaes que devem ser lidas com ateno:

Aviso: alerta sobre pormenores de configurao que podem causar mau


funcionamento ou no funcionar como esperado.

Nota: indica informaes adicionais teis como referncia.

Cuidados a ter com o CD


Aps a finalizao dos trabalhos de instalao, coloque o CD na bolsa deste
manual e guarde o conjunto em local seguro, arejado e seco pois pode vir a
necessitar dele mais tarde.

O CD contm um nmero de srie. Tenha-o mo no caso de necessitar de


alguma informao tcnica e/ou comercial ou solicitar a sua substituio por
extravio ou deteriorao do meio ptico.

Manual de Instalao / Configurao -5-


Requisitos do computador
As tabelas seguintes apresentam as especificaes mnimas do computador do
EasyLynq. Se este equipamento fr usado para suportar outras aplicaes,
como, por exemplo, o IVTS, o Voqqale ou do cliente, estas estimativas devero
ser revistas.

Os requisitos apresentados nestas tabelas tm como referncia o Windows 7 e


o Windows 2008 Server. A utilizao de sistemas operativos mais antigos
permite especificaes de processador e memria menos restritivas.

EasyLynq Empresa / Server

Extenses Processador Intel Memria Disco Windows


100 i3 2.2 GHz 2 GB 60 GB Workstation
500 i5 2.4 GHz 4 GB 100 GB Workstation
1000 Xeon 2.2 GHz Quad Core 4 GB 160 GB Server
5000 Dual Xeon 2.8 GHz Quad Core 8 GB 250 GB Server

EasyLynq Hotel

Quartos Processador Intel Memria Disco Windows


100 i5 2.4 GHz 2 GB 80 GB Workstation
300 i7 2.8 GHz 4 GB 120 GB Workstation
500 Xeon 2.4 GHz Quad Core 4 GB 200 GB Server
1000 Dual Xeon 2.8 GHz Quad Core 8 GB 250 GB Server

O EasyLynq totalmente compatvel com o Windows 2000, XP SP3, 2003


Server, Vista, Server 2008, 7, Server 2012 e 8. O EasyLynq encontra-se
certificado para o Windows 7, Server 2012 e 8.

Embora a compatibilidade do EasyLynq esteja estendida at ao Windows 2000,


alguns servidores de voz podem requerer a utilizao de sistemas operativos
mais recentes. Consulte a documentao tcnica disponvel no CD para mais
informaes.

-6-
CD de instalao
O CD fornecido junto com este manual permite instalar os diversos mdulos
que compem o EasyLynq e disponibiliza documentos de carter comercial e
tcnico e vrias aplicaes complementares para criao e converso de
tabelas, reposio das palavras-chave padro, emulao de terminal, etc..

Introduza o CD no leitor e aguarde alguns segundos para que o integrador de


instalao CDELYNQ inicie.

Se a funcionalidade de 'Auto-Play' do Windows se encontrar desativada,


ser necessrio iniciar manualmente a aplicao atravs do Explorador
do Windows.

A instalao de aplicaes no Windows requer privilgios de


administrador. Caso no os possua ou a funcionalidade UAC ('User
Access Control') esteja ativa, a aplicao CDELYNQ informa-o que
necessita elevar o nvel de acesso do utilizador.

Manual de Instalao / Configurao -7-


Execute sempre os procedimentos de instalao atravs do CDELYNQ.
Esta aplicao determina se recomendvel instalar as verses de 64
bits, se h funcionalidades complementares que necessitem igualmente
ser instaladas (.NET Framework, mensagens vocais, plataformas de
converso de texto em voz, proxies, etc.) e qual a ordem apropriada de
instalao.

Operaes disponveis na janela do CDELYNQ:


Instalar os mdulos fundamentais EasyLynq, PBXAgent e TAXDBSrv.
Instalar os mdulos especficos da verso Server e Hotel+.
Instalar o EasyLynq IVTS.
Instalar o EasyLynq Voqqale.
Iniciar a Ajuda do CDELYNQ.
Executar procedimentos avanados tais como consulta dos dados da
licena, instalao de nova licena (upgrade), utilitrios de teste e
configurao, remoo de mdulos instalados, acesso a
documentao tcnica e comercial, etc.

Instalao de mdulos
Todos os mdulos do EasyLynq so instalados atravs do interface padro
Windows Installer.

O Windows Installer inicia os procedimentos de instalao atravs de uma


sucesso de janelas em que solicitado ao utilizador a aceitao das
condies de licenciamento e a pasta de destino. Alguns mdulos requerem
adicionalmente a escolha do idioma de operao e outras configuraes.

Para a maioria das aplicaes, criada no menu Iniciar do Windows uma


entrada denominada EasyLynq que contm os atalhos para os mdulos
instalados.

A instalao dos mdulos bastante simples e rpida. A sua desinstalao


pode ser executada atravs do CDELYNQ (recomendvel) ou da opo
"Programas e funcionalidades" do Painel de Controlo do Windows.

-8-
Opes avanadas

Ferramentas
Acesso a documentao tcnica dos interfaces disponveis na
IfDocs
licena
Teste de portas srie (necessita de fichas DB9 e DB25 com
Serial32
pontes soldadas para verificao dos sinais)
WinComm Emulador de terminal de comunicaes VT100/Minitel
Reposio das palavras-chave padro do servidor TAXDBSrv, do
FreePwd
agente PBXAgent e do administrador root
Migrao da configurao e da base de dados de chamadas do
YtaxLynq
Easytax para o EasyLynq
TrapViewer Mini servidor SNMP para notificaes ('traps') do EasyLynq
Gerao das tabelas de preos e indicativos, em funo do
PTTarif
assinante da instalao, para o operador Portugal Telecom

Aplicaes
Instala os ficheiros de mensagens vocais para o Agente SIP
InstallWaves
Messaging do mdulo PBXAgent
Instala controladores e bibliotecas provenientes dos fabricantes
Lib3Install
de equipamentos
Instala o Microsoft Server Speech Platform Runtime, motores de
MSSpeechPlatform reconhecimento de voz e motores de texto em voz ('Text-To-
Speech') para os diversos idiomas do EasyLynq IVTS

Documentos
Brochuras comerciais dos produtos EasyLynq, IVTS e Voqqale em vrios
idiomas
Apresentaes PowerPoint do EasyLynq Server e do EasyLynq Hotel
Problemas conhecidos em verses antigas do EasyLynq
Manual de instalao do EasyLynq
Notas de instalao do EasyLynq Web .NET
Configurao do IIS para o EasyLynq Web Silverlight (Enterprise Services)
Manuais de Operao do EasyLynq Server e do EasyLynq Hotel

Outros ficheiros disponveis no CD


Tabela dos feriados nacionais fixos, importvel a partir do mdulo
Feriados.etb
de consulta do EasyLynq
'bootstrapers' para descarga das vrias verses do .NET
Pasta NETX
Framework (requerem acesso Internet)

Manual de Instalao / Configurao -9-


Configurao
TAXDBSrv

No menu Iniciar do Windows, dirija-se a Programas > EasyLynq e clique em


TAXDBSrv.

O mdulo gestor do servio TAXDBSrv requer privilgios de


administrador do Windows. Caso no os possua ou a funcionalidade
UAC ('User Access Control') esteja ativa, a aplicao informa-o que
necessita elevar o nvel de acesso do utilizador.

Surge uma janela indicando que o


servio se encontra parado e se
deseja inici-lo. Prima Sim.

Aguarde alguns segundos e ver surgir o cone


deste servio na rea de Notificaes do
Windows.

recomendvel que configure a rea de Notificaes do Windows de


forma a que o cone esteja sempre presente.

Colocando o ponteiro do rato sobre o cone, faa duplo clique com o boto
esquerdo ou clique o boto direito e selecione a opo Configurar do menu
para entrar em modo de configurao.

Introduza, em letra minscula, a palavra-chave


taxdbsrv e clique OK.

- 10 -
Sobre: trata-se de uma janela informativa. Apresenta algumas informaes de
licenciamento e a verso do servidor.

Geral: apresenta informao das datas de instalao e ltimo incio do servio


e dados sobre a memria. Permite alterar a identificao do sistema que se
encontra predefinido com o nome do computador.

Para terminar a aplicao e o servio, clique no boto Sair....

Prima o boto Opes... para aceder a configuraes especficas.

Manual de Instalao / Configurao - 11 -


Geral - Opes: permite-lhe
desativar o gestor do servio
(no recomendado),
ativar/desativar o diagnstico
para ficheiro do gestor e do
servio e alterar a palavra-
chave de acesso
configurao.

Por questes de
segurana, altere
sempre a senha de
instalao.

Comunicaes: permite ativar/desativar a comunicao TCP/IP.

O EasyLynq usa o protocolo RPC para comunicao entre os diversos


mdulos. A comunicao em modo local est sempre disponvel.

Ao iniciar, o servio TAXDBSrv negoceia o porto de comunicao RPC


sobre TCP/IP com o Windows. Num ambiente WAN em que um 'firewall'
se encontre presente, recomendvel ativar a opo Especificar porto.

- 12 -
Definies: permite-lhe configurar as dimenses mximas das tabelas de
canais (linhas de rede), grupos de extenses, contas de projeto, extenses das
centrais telefnicas e extenses virtuais.

Evite sobredimensionar exageradamente estes valores para que o


tamanho dos ficheiros da base de dados se mantenha em valores
aceitveis face dimenso da instalao. O nmero de extenses no
virtuais est limitado pela licena adquirida.

Caso no pretenda criar automaticamente extenses e canais a partir


dos registos de chamada, desative as respetivas caixas de verificao.

O servidor disponibiliza ainda a


opo de reconstruo da
base de dados de chamadas.
Utilize esta funcionalidade
para:
a) Detetar e resolver
inconsistncias aps, por
exemplo, interrupes
inesperadas de
fornecimento de energia
ao computador.
b) Recalcular os custos e os
preos das chamadas.

Manual de Instalao / Configurao - 13 -


PBXAgent

No menu Iniciar do Windows, dirija-se a Programas > EasyLynq e clique em


PBXAgent.

O mdulo gestor do servio PBXAgent requer privilgios de


administrador do Windows. Caso no os possua ou a funcionalidade
UAC ('User Access Control') esteja ativa, a aplicao informa-o que
necessita elevar o nvel de acesso do utilizador.

Surge uma janela indicando que o


servio se encontra parado e se
deseja inici-lo. Prima Sim.

Aguarde alguns segundos e ver surgir o cone


deste servio na rea de Notificaes do Windows.

recomendvel que configure a rea de Notificaes do Windows de


forma a que o cone esteja sempre presente.

Colocando o ponteiro do rato sobre o cone, faa duplo clique com o boto
esquerdo ou clique o boto direito e selecione a opo Configurar do menu
para entrar em modo de configurao.

Introduza, em letra minscula, a palavra-chave


pbxagent e clique OK.

- 14 -
Sobre: trata-se de uma janela informativa. Apresenta algumas informaes de
licenciamento e a verso do servidor.

Geral: apresenta informao das datas de instalao e ltimo incio do servio


e dados sobre a memria.

Introduza o nome ou IP do computador do servidor TAXDBSrv.

Para terminar a aplicao e o servio, clique no boto Sair....

Prima o boto Opes... para aceder a configuraes especficas.

Manual de Instalao / Configurao - 15 -


Geral - Opes: permite-lhe
desativar o gestor do servio
(no recomendado), eliminar
registos pendentes de
interfaces invlidas (por
exemplo, aps mudana do
nome do computador),
ativar/desativar o diagnstico
para ficheiro do gestor e do
servio e alterar a palavra-
chave de acesso
configurao.

Por questes de
segurana, altere
sempre a senha de
instalao.

Interfaces: permite-lhe configurar as diversas interfaces de servidores de voz,


PMS's (na verso Hotel), sistemas de acesso Internet e sistemas de
mensagens unificadas.

Devido aos variados modelos de interfaces, no aqui apresentada a


forma de as configurar. Para o efeito, recomendvel a leitura dos
documentos disponveis na aplicao IfDocs do CD.

- 16 -
Interfaces - Monitorizao: selecione um interface configurado e prima o
boto Monitorizar. Esta janela permite-lhe verificar se as comunicaes com o
equipamento remoto esto corretamente configuradas e, no caso das portas
srie, determinar sinais de controlo ativos e erros de transmisso.

Informao de estado
Clique o boto direito do rato sobre o cone do PBXAgent na rea de
Notificaes do Windows e selecione Status no menu.

Esta janela fornece-lhe informaes pormenorizadas


sobre o estado da ligao ao servidor TAXDBSrv e,
no caso de esta se encontrar inativa, o nmero de
registos de mensagens e eventos que esto
pendentes.

O PBXAgent guarda em ficheiro todos estes registos pelo que a capacidade de


armazenamento est unicamente limitada pelo espao livre no disco local.

Os registos so enviados para o servidor no momento em que so gerados. Se


a ligao se encontra inativa, so efetuadas tentativas de restabelecimento da
comunicao com o TAXDBSrv de 60 em 60 segundos, aproximadamente.

Manual de Instalao / Configurao - 17 -


Mdulo de consulta e administrao EasyLynq

No menu Iniciar do Windows, dirija-se a Programas > EasyLynq e clique em


EasyLynq.

Aps a instalao do EasyLynq, o nico utilizador do sistema o Supervisor,


cuja identificao e senha de acesso so, respetivamente, root e maximlevel.

As palavras-chave so sensveis a maisculas e minsculas pelo que os


utilizadores devem ter em ateno o tipo de letra correntemente definido
no teclado (normalmente visvel atravs do 'Caps Lock').

O utilizador root no possui quaisquer restries na operao do


EasyLynq, devendo o seu uso estar reservado ao tcnico instalador e/ou
ao gestor do sistema.

No campo Servidor, introduza o nome do computador ou endereo IP da


mquina onde se encontra o servidor TAXDBSrv (este campo
automaticamente preenchido com o nome do computador local). O EasyLynq
mantm um registo do ltimo utilizador que se validou no sistema bem como
uma lista dos ltimos cinco servidores.

Pode selecionar a lngua de operao do EasyLynq premindo o boto esquerdo


do rato sobre a bandeira no canto inferior esquerdo.

Por razes de segurana, altere a palavra-chave do utilizador root aps


terminar os procedimentos de instalao.

- 18 -
Aps a correta validao do utilizador root, o EasyLynq determina que a
primeira que est ser executado. iniciado o Assistente de Configurao
Bsica.

Caso a instalao seja consequncia de uma migrao ou substituio


do computador e esteja na posse dos ficheiros de salvaguarda
(backup'), pode cancelar o Assistente e realizar a reposio dos dados.

O Assistente tem como objetivo a simplicidade ao ajudar o instalador na


tarefa de criar uma configurao bsica, a qual suficiente na maioria
das instalaes. Por exemplo, apenas possvel criar um servidor de
voz, um complexo e uma interface de cada tipo. As instalaes mais
complexas necessitaro de configurao mais elaborada
posteriormente.

Prima Seguinte para continuar.

Manual de Instalao / Configurao - 19 -


Introduza o nome do servidor de voz e a sua descrio (opcional). Adicione as
extenses lista conforme sugerido.

Apenas na verso Hotel: introduza o nome do complexo e a sua descrio


(opcional). Adicione os alojamentos lista conforme sugerido.

- 20 -
Ajuste apropriadamente os parmetros apresentados nesta janela.

Configure os interfaces disponveis de forma apropriada.

Manual de Instalao / Configurao - 21 -


Apenas na verso Hotel: ajuste apropriadamente os idiomas sugeridos.

Apenas na verso Hotel: ajuste os parmetros dos estados dos quartos de


acordo com as necessidades do hotel.

- 22 -
Apenas na verso Hotel: ajuste apropriadamente as classes de servio de
acesso exterior de acordo com as necessidades do hotel.

Apenas na verso Hotel: atribua as extenses aos quartos, crie uma classe de
tarifas (recomendado) e, se necessrio, crie um grupo para as extenses.

Manual de Instalao / Configurao - 23 -


Apenas na verso Hotel: caso o hotel disponibilize cabines telefnicas na
receo, adicione-as aqui.

O EasyLynq dispe dos dados necessrios para criar a configurao bsica.


Prima Seguinte para continuar.

- 24 -
O processo de criao da configurao bsica terminou. Poder ser notificado
da ocorrncia de erros, se assim fr, tome as necessrias providncias para os
corrigir.

Configure os restantes parmetros da configurao, tais como rotas, grupos


(centros de custo), operadores de telecomunicaes, utilizadores, contas de
projeto e cdigos de autorizao.

Certifique-se de que o EasyLynq est a processar corretamente os registos de


chamada e, no caso da verso Hotel, que as funcionalidades de check-in,
check-out, despertar e outras tambm se encontram a operar apropriadamente.

O mdulo de consulta do EasyLynq disponibiliza aos seus utilizadores ajuda


direta atravs da tecla F1 ou selecionando a opo Ajuda do menu principal.
Est fora do contexto deste manual apresentar uma descrio exaustiva sobre
as suas caractersticas e funcionalidades.

Instalao de atualizaes
A Eurofluxo disponibiliza regularmente, na sua pgina na Internet em
www.eurofluxo.pt, atualizaes para os diversos mdulos do EasyLynq que
incluem novas funcionalidades e pequenas correes. Depois de
descarregados, os ficheiros devero ser copiados para a pasta Updates do
diretrio onde o servidor TAXDBSrv se encontra instalado. A atualizao dos
mdulos automtica e ser efetuada poucos minutos depois.

Manual de Instalao / Configurao - 25 -


Configurao do EasyLSQL (controlador ODBC)

Esta facilidade encontra-se disponvel apenas nas verses Server e


Hotel+.

O EasyLSQL um interface que permite que aplicaes externas possam


aceder base de dados do EasyLynq via ODBC atravs de comandos SQL
(Structured Query Language).

Aps a instalao do EasyLSQL, necessrio criar e configurar o acesso ao


controlador ODBC.

Criao da origem de dados


Para obter informaes atravs de um controlador ODBC, necessrio primeiro
criar uma nova origem de dados. Esta opo encontra-se disponvel em
Origem de Dados (ODBC) nas Ferramentas Administrativas do Windows.

Caso tenha instalado a verso 32 bits do EasyLSQL num Windows de


64 bits, dever utilizar o gestor de Origem de Dados de 32 bits. Esta
aplicao tem o nome odbcad32.exe est disponvel em
%WinDir%\SysWOW64.

No Administrador
da origem de
dados ODBC,
selecione o
separador DSN de
sistema e clique
Adicionar...

- 26 -
Selecione o
controlador
EasyLynq e
clique Concluir.

Surgir em seguida a primeira janela do assistente de configurao do


controlador ODBC do EasyLynq. Introduza o nome para esta origem de dados,
a descrio (facultativo), o nome ou endereo IP do computador onde o
servidor TAXDBSrv se encontra instalado e o idioma de operao.

Manual de Instalao / Configurao - 27 -


Na segunda janela, indique o perodo e o tipo predefinidos para as consultas
base de dados de chamadas e eventos quando estes parmetros so omitidos
no comando SQL.

Na ltima janela do assistente, indique se pretende criar um histrico de


comandos executados e se deseja desativar a janela de autenticao de
utilizador quando estabelece a ligao ODBC.

A partir deste momento, possvel obter dados a partir de qualquer aplicao


com suporte para ODBC.

- 28 -
Obteno de dados

Os dados so obtidos atravs de comandos SQL. Um comando tpico de SQL


para obter dados da tabela extensao :

select * from extensao

Com este comando obtm-se todos os dados relativos tabela extensao, ou


seja, a lista de todas as extenses configuradas no EasyLynq.

Encontra-se fora do mbito deste manual a explicao da linguagem SQL. Para


utilizadores no familiarizados, aconselhvel a consulta de manuais e outra
documentao disponveis em livrarias especializadas.

Certos aplicaes, como por exemplo Excel, Access, MSQuery e SQL Server
da Microsoft, disponibilizam ajuda ao utilizador para a obteno de dados sem a
necessidade de recorrer introduo manual de comandos SQL.

NVEL DE SQL SUPORTADO


O controlador ODBC do EasyLynq permite fazer consultas e modificaes a
algumas tabelas de configurao e base de dados de chamadas e
eventos no sendo possvel, contudo, inserir novos dados. Os comandos
SQL suportados so:
select
update

No possvel especificar mais que uma tabela nem agregar colunas de


diferentes tabelas numa instruo SQL.

O comando select pode conter vrias clusulas para procura, ordenao e


agregao de dados. As expresses suportadas so:
where
order by
group by

As colunas podem ser especificadas por nome, ordem de apresentao,


ordenadas ascendentemente ou descendentemente, no existindo qualquer
limitao ao nmero de colunas ordenadas.

Manual de Instalao / Configurao - 29 -


As expresses having, union e distinct no so suportadas.

Nos argumentos da clusula where so permitidos os seguintes smbolos:


> < = >= <= AND OR ( )

IN, LIKE, NOT e as expresses aritmticas (+, *, -, /) no so suportadas.

O EasyLSQL permite a utilizao das seguintes funes de agrupamento:


sum, avg e count. Estas funes podem ser usadas em conjuno com a
opo group by para agrupamento pela sequncia de colunas pretendida.
A aplicao de funes de agrupamento sem utilizar a opo group by
equivalente a especificar group by all. O uso destas expresses est
limitado a colunas com dados numricos como, por exemplo, preos das
chamadas e tempos de conversao.

O EasyLSQL no sensvel a maisculas e minsculas nos comandos e


nos nomes das colunas e das tabelas. Excetuam-se os parmetros de
pesquisa, como se pode ver no exemplo seguinte em que se pretende
apenas as chamadas das extenses do grupo 'Armazm':
select * from chamadas where (grupo='Armazm')

So aceites os seguintes formatos de data e hora:


dd/mm/aaaa
dd-mm-aaaa
aaaa/mm/dd
aaaa-mm-dd
hh:mm
hh:mm:ss

Na consulta base de dados de chamadas e eventos, a hora, se


especificada, deve suceder data e separado desta por um espao.

select * from chamadas where datahora > '1-11-2013 9:00'


and datahora < '1-11-2013 12:00'

- 30 -
PARMETROS PREDEFINIDOS
Determinadas colunas possuem possuem valores predefinidos conforme
mostra a tabela seguinte:

EVENTOS
Tabela CHAMADAS EXTENSAO
EVENTOS_UTILIZADOR
Coluna Sucesso Tipo Virtual Tipo
Externa
Entrada Erro
Valores Sim Saida Sim Aviso
suportados Nao Interna Nao Informacao
Int_Org Hotel (apenas verso hotel)
Int_Rec

Estes parmetros podem ser indistintamente introduzidos em maisculas ou


minsculas sendo suficiente a primeira ou primeiras letras (a negrito).

TABELAS E COLUNAS
A seguir apresenta-se a lista de tabelas e colunas acessveis atravs do
controlador ODBC do EasyLynq. Os nomes no possuem carateres acentuados
nem cedilhas.

CHAMADAS EVENTOS PABX EXTENSAO GRUPO


datahora tipo pabx extensao grupo
1, 2 2
sucesso datahora descricao pabx grupopai
2 1, 2
tipo origem grupo descricao
1
extensao descricao virtual
1, 2
pabxext descricao
canal
pabxcanal
numremoto
projecto
toque
conversacao
impulsos
grupo
rota
1
observacoes
3
preco_XXX
3
custo_XXX

Manual de Instalao / Configurao - 31 -


ROTA CANAL PROJECTO EVENTOS_UTILIZADOR
rota canal projecto tipo
telecomop pabx grupo datahora
1, 2 2 1
descricao rota descricao utilizador
1, 2 1
descricao computador
1
descricao

1
Colunas que no podem ser utilizadas como parmetros de procura na
clusula 'where'.

2 Colunas que possvel modificar com o comando 'update'. Todas as outras no so


passveis de modificao atravs do EasyLSQL. No entanto, podem ser usadas
todas as colunas (excepto as indicadas em 1) como parmetros de procura na
clusula 'where' do comando 'update'.
3
Na tabela 'CHAMADAS', as ltimas colunas variam em funo das moedas
utilizadas. Se no EasyLynq se encontrarem configuradas duas moedas, EURO
e USD, ento na consulta obter-se-o duas colunas de preo (preco_EURO e
preco_USD) e duas colunas de custo (custo_EURO e custo_USD).

PERMISSES
As tabelas so acessveis em funo do nvel do utilizador, conforme mostra a
lista seguinte:

Nvel de Administrador Gestor de Gestor de


Operador
acesso Sub-admin. Departamento Grupo e Utilizador
de central
e Operador e Chefe de Chefe de Normal
Tabela telefnica
Geral Departamento Grupo
chamadas 9 9 9 9 9
eventos 9
pabx 9
extensao 9 9 9 9
grupo 9 9 9
rota 9 9
canal 9 9
projecto 9 9 9
eventos_utilizador 9

O comando update apenas se encontra disponvel para os utilizadores com


nvel de acesso Administrador, Gestor de Grupo e Gestor de
Departamento.

- 32 -
FORMATAO DAS COLUNAS
Quase todas as colunas so representadas por cadeias de carateres (CHAR)
existindo, contudo, algumas excees. Por exemplo, para as colunas datahora,
a aplicao cliente pode solicitar ao controlador para fornecer os dados em
formato CHAR ou numa estrutura TIMESTAMP. A tentativa de obteno num
formato no suportado dar origem a uma mensagem de erro. Na tabela
seguinte so apresentados as variantes suportadas pelo EasyLSQL em funo
da coluna.

Coluna Formatos suportados


TIMESTAMP (predefinido)
Datahora
CHAR
ULONG (predefinido)
toque TIME
conversacao TIMESTAMP
CHAR
ULONG (predefinido)
Impulsos DOUBLE
CHAR
preco_XXX DOUBLE (predefinido)
custo_XXX CHAR

ALGUNS EXEMPLOS DE INSTRUES SQL

select datahora,tipo from chamadas where datahora > '20-5-2013'


and tipo = 'E' order by datahora desc

- efetua a consulta de chamadas de entrada desde as 00:00 horas do dia 20


de Maio de 2013 at hoje e ordena-as por ordem decrescente de data/hora.

select grupo, extensao, numchamadas = sum(*), precototal =


sum(preco_EURO) from chamadas where (datahora>'01-5-2013') and
(tipo = 'SAIDA') group by grupo, extensao order by grupo, extensao

- nesta consulta obtm-se quatro colunas: 'grupo', 'extensao', 'numchamadas'


e 'precototal', com os resultados ordenados respetivamente por 'grupo' e
'extensao'. Por cada uma destas apresentado o total de chamadas
efetuadas e a soma dos preos dessas chamadas.

update canal set rota='GSM', descricao='Acesso Bsico' where


canal='123'

- modifica o canal 123, alterando a descrio para 'Acesso Bsico' e


mudando-o para a rota 'GSM'.

Manual de Instalao / Configurao - 33 -


Notificaes SNMP

Esta facilidade encontra-se disponvel apenas nas verses Server e


Hotel+.

O EasyLynq implementa dois tipos bsicos de eventos: de interveno do


utilizador necessria e de auto-recuperao. O primeiro destina-se ao gnero
de notificaes cuja ocorrncia no contra-balanceada por outra posterior e
implica uma ao externa para terminar a condio de anormalidade. O
segundo encontra-se orientado para situaes de irregularidade temporria que
podem eventualmente terminar sem necessidade de interveno do utilizador.

Existem oito nveis de severidade para os eventos, ordenados por ordem de


importncia como se segue:
0 Fim de condio (usado apenas nos eventos de auto-recuperao)
1 Informativo
2 Significativo
3 Aviso
4 Erro
5 Crtico
6 Alerta
7 Emergncia

Consulte a Ajuda do mdulo de consulta do EasyLynq para obter mais


informaes sobre os eventos geradores de notificaes, nveis de severidade
e entidades envolvidas.

Por questes de implementao, o EasyLynq gera apenas notificaes (traps)


SNMPv2c.

Encontam-se disponveis na pasta \UTILITY\SNMP do CD de instalao do


EasyLynq os ficheiros necessrios para a implementao e ensaios das
notificaes SNMP (traps): dois ficheiros MIB (Management Information Base)
e o utilitrio TrapViewer.

Instale o servio SNMP trap service do Windows e configure previamente o


EasyLynq (menu Administrao, Propriedades, separador SNMP) para executar
esta aplicao.

- 34 -
A tabela seguinte apresenta a rvore Eurofluxo/EasyLynq tal como definida nos
ficheiros MIB:

Manual de Instalao / Configurao - 35 -


Notas de instalao
Dados do servidor TAXDBSrv
N srie da licena Identificao da entidade licenciada Localidade

Data de instalao Nome do computador Endereo IP


. . .
Senha de acesso Nome do servidor
Disco / Diretrio
Verso 32 bits 64 bits
Dimenses das tabelas de configurao
Canais / linhas Contas de Extenses
Grupos Extenses
de rede projeto virtuais

Designaes das centrais telefnicas (PABX's)

Interfaces PBXAgent
Prefixo de Prefixo de Pref. locais
Agente N PABX
extenso canal extenses

- 36 -
Dados do PBXAgent

Nome do computador Interface n Senha


Data de instalao Verso 32 bits 64 bits
Modelo do equipamento
Ligao V24 TCP/IP FTP SFTP TFTP HTTP File
Propriedades da comunicao
Dados particulares

Nome do computador Interface n Senha


Data de instalao Verso 32 bits 64 bits
Modelo do equipamento
Ligao V24 TCP/IP FTP SFTP TFTP HTTP File
Propriedades da comunicao
Dados particulares

Nome do computador Interface n Senha


Data de instalao Verso 32 bits 64 bits
Modelo do equipamento
Ligao V24 TCP/IP FTP SFTP TFTP HTTP File
Propriedades da comunicao
Dados particulares

Manual de Instalao / Configurao - 37 -


Nome do computador Interface n Senha
Data de instalao Verso 32 bits 64 bits
Modelo do equipamento
Ligao V24 TCP/IP FTP SFTP TFTP HTTP File
Propriedades da comunicao
Dados particulares

Nome do computador Interface n Senha


Data de instalao Verso 32 bits 64 bits
Modelo do equipamento
Ligao V24 TCP/IP FTP SFTP TFTP HTTP File
Propriedades da comunicao
Dados particulares

Nome do computador Interface n Senha


Data de instalao Verso 32 bits 64 bits
Modelo do equipamento
Ligao V24 TCP/IP FTP SFTP TFTP HTTP File
Propriedades da comunicao
Dados particulares

- 38 -
Nome do computador Interface n Senha
Data de instalao Verso 32 bits 64 bits
Modelo do equipamento
Ligao V24 TCP/IP FTP SFTP TFTP HTTP File
Propriedades da comunicao
Dados particulares

Nome do computador Interface n Senha


Data de instalao Verso 32 bits 64 bits
Modelo do equipamento
Ligao V24 TCP/IP FTP SFTP TFTP HTTP File
Propriedades da comunicao
Dados particulares

Nome do computador Interface n Senha


Data de instalao Verso 32 bits 64 bits
Modelo do equipamento
Ligao V24 TCP/IP FTP SFTP TFTP HTTP File
Propriedades da comunicao
Dados particulares

Manual de Instalao / Configurao - 39 -


Nome do computador Interface n Senha
Data de instalao Verso 32 bits 64 bits
Modelo do equipamento
Ligao V24 TCP/IP FTP SFTP TFTP HTTP File
Propriedades da comunicao
Dados particulares

Nome do computador Interface n Senha


Data de instalao Verso 32 bits 64 bits
Modelo do equipamento
Ligao V24 TCP/IP FTP SFTP TFTP HTTP File
Propriedades da comunicao
Dados particulares

Nome do computador Interface n Senha


Data de instalao Verso 32 bits 64 bits
Modelo do equipamento
Ligao V24 TCP/IP FTP SFTP TFTP HTTP File
Propriedades da comunicao
Dados particulares

- 40 -