DigiCall c 2.x Configuração do Driver genérico

Transcrição

1 DigiCall c 2.x Configuração do Driver genérico (DgcGen32.dll e seguintes) ( de Maio de 2001

2 Conteúdo 1 Opções e Campos de Configuração Opções da secção Config End of Record Minimum Record Len Maximum Record Len Ignore Chars Filter Chars Date From Buffer Node From Buffer Default Node Record Lines Record Start Selector Record Start When Record Start Not When Record Start Ignore Record Start Ignore When Campos de chamadas Extension [In, Out] Extension Origin [Int] Extension Destination [Int] Access [In, Out, Int, Net] Auth Code [Out] Account Code [Out] Dialed [Out, Net] Caller Id [In] Duration [In, Out, Int, Net] Meter [Out] Duration Ring [In, Out, Int, Net] Node [In, Out, Int, Net] Time [In, Out, Int, Net]

3 Conteúdo Conteúdo Date [In, Out, Int, Net] Month [In, Out, Int, Net] Day [In, Out, Int, Net] Year [In, Out, Int, Net] Trunk In [In, Int, Net] Trunk Out [Out, Int, Net] Trunk Internal [Int] Dialed Filter [Out] Duration Filter [In, Out, Int, Net] Meter Filter [In, Out, Int, Net] Charge Call [Net] Duration Includes Ring Time [In, Out, Int, Net] Selector [In, Out, Int, Net] When [In, Out, Int, Net] Not When [In, Out, Int, Net] Ignore [In, Out, Int, Net] Ignore When [In, Out, Int, Net] Transfered Selector [In, Out, Int, Net] Transfered When [In, Out, Int, Net] Not Transfered When [In, Out, Int, Net] Unanswer Selector [Int] Unanswer When [Int] Not Unanswer When [Int] A Caracteres especiais 23 B Formatos 24 B.1 Númerico B.2 Tempo

4 Capítulo 1 Opções e Campos de Configuração Nas opções e campos de configuração são utilizados os seguintes tipos de parâmetros: <booleano> Um parâmetro lógico. Os caracteres T, S, Y e 1 são considerados como verdadeiros. Qualquer outro valor (ou a ausência de valor) é considerado como falso. <número> Um parâmetro numérico. <lista> Uma lista de parâmetros alfanuméricos. Cada elemento da lista é separado dos outros pelo caracter e é constituido por uma ou mais letras e/ou algarismos. Podem ser utilizados os caracteres especiais descritos no apêndice A na página 23. <texto> Uma sequência de uma ou mais letras ou algarismos. Podem também ser utilizados os caracteres especiais do apêndice A na página 23. Algumas opções e campos são ainda sub-divididos nas seguintes partes: Pos Posição do campo na linha, contada a partir de 1. Size Largura (em caracteres) do campo. Line Linha do registo em que o campo aparece. A primeira linha tem o número 1. Caso esta parte não seja indicada, é assumido que o campo está na linha 1. Format Formato do campo. Para mais informações ver o apêndice B na página 24. 3

5 1.1. Opções da secção Config Opções da secção Config As seguintes opções podem ser utilizados na secção Config. Esta secção é identificada no ficheiro de configuração pelo seguinte cabeçalho: [<nome do PPCA> Config] End of Record End of Record=<texto> Indica qual a sequência de caracteres que marca o fim de uma linha recebida do PPCA. End of Record=\r\n Minimum Record Len Minimum Record Len=<número> Indica o número minimo de caracteres para que a linha enviada pelo PPCA seja aceite. Caso não seja indicado, não é testado o tamanho minimo da linha. Minimum Record Len= Maximum Record Len Maximum Record Len=<número> Indica o número máximo de caracteres para que a linha enviada pelo PPCA seja aceite. Caso não seja indicado, não é testado o tamanho máximo da linha. Nota O tamanho máximo de linha suportado pelo driver é de 1024 caracteres. Maximum Record Len=80 4

6 1.1. Opções da secção Config Ignore Chars Ignore Chars=<lista> Todos os caracteres indicados serão removidos da linha recebida do PPCA. Nota É necessário cuidado ao utilizar esta opção, pois a remoção de caracteres pode alterar a localização dos vários campos do registo. Para fazer desaparecer caracteres indesejados da linha é melhor utilizar a opção seguinte. Ignore Chars=# % & Filter Chars Filter Chars=<lista> Todos os caracteres indicados na lista serão substituidos por espaços na linha recebida do PPCA. Filter Chars=# % & Date From Buffer Date From Buffer=<booleano> Quando se usa o buffer (local ou remoto), pode-se usar esta opção para indicar que se vai usar o mês e o dia inseridos pelo buffer no registo. Nota Esta opção só influencia os campos Day (pág. 15) e Month (pág. 15) Date From Buffer=1 5

7 1.1. Opções da secção Config Node From Buffer Node From Buffer=<booleano> Quando se usa o buffer (local ou remoto), pode-se usar esta opção para indicar que se vai usar o nó inserido pelo buffer no registo. Node From Buffer= Default Node Default Node=<texto> Especifica o nó a usar quando não se consegue obter o nó a partir do registo. Default Node=VNG Record Lines Record Lines=<número> Indica quantas linhas tem cada registo do PPCA. Caso não seja indicado, é assumido um valor por defeito de 1 linha por registo. Record Lines= Record Start Selector Record Start Selector Pos=<número> Record Start Selector Size=<número> Juntamente com a opção seguinte, serve para identificar a primeira linha de cada registo, indicando esta opção a posição e tamanho do selector. Nota Esta opção e as seguintes só são necessárias caso o registo tenha mais de uma linha. Para registos de uma linha, estas opções são opcionais. 6

8 1.1. Opções da secção Config 7 Record Selector Pos=34 Record Selector Size= Record Start When Record Start When=<lista> Esta opção indica quais os valores que o selector da primeira linha do registo do PPCA pode ter para que a linha recebida do PPCA seja reconhecida como a primeira linha de um registo (para mais informações ver a opção na página 6). Record Selector When=A0 A1 a0 a Record Start Not When Record Start Not When=<lista> Esta opção serve para indicar valores que o selector da primeira linha do registo não pode ter (para mais informações ver a opção na página 6). RecordSelector Not When=A Record Start Ignore Record Start Ignore Pos=<número> Record Start Ignore Size=<número> Caso a opção descrita em (pág. 6) não chegue para indicar a primeira linha do registo, pode-se usar esta opção e a seguinte para indicar um selector que, caso seja encontrado, indica que a linha recebida do PPCA não é a primeira linha do registo. Record Start Ignore Pos=23 Record Start Ignore Size=1 7

9 1.2. Campos de chamadas Record Start Ignore When Record Start Ignore When=<lista> Esta opção indica quais os valores que o selector anterior deve ter para que a linha recebida não seja considerada como a primeira linha do registo. Record Start Ignore When= Campos de chamadas Os campos relativos a cada tipo de chamada são colocados nas secções correspondentes. Os nomes de cada uma destas secções são os seguintes: Chamadas de entrada [<nome do PPCA> Incoming] Chamadas de saída [<nome do PPCA> Outgoing] Chamadas internas [<nome do PPCA> Internal] Chamadas de rede [<nome do PPCA> Network] As seguintes abreviaturas são utilizadas para indicara a que tipos de chamadas pertence cada campo: In - Chamadas de entrada Out - Chamadas de saída Int - Chamadas internas Net - Chamadas de rede Nota Os tamanhos máximos indicados correspondem ao número máximo de caracteres que o DigiCall processa. Caso um campo seja definido com um tamanho superior ao máximo, apenas serão considerados os primeiros caracteres até atingir o tamanho máximo. Se o tamanho for indicado como N/D, indica que não é apropriado indicar um tamanho máximo. 8

10 1.2. Campos de chamadas Extension [In, Out] Extension Pos=<número> Extension Size=<número> Extension Format=<texto> Extension Line=<número> Tamanho máximo: 10 caracteres Indica a localização da extensão de origem (para chamadas de saída) ou de destino (para chamadas de entrada). Extension Pos=1 Extension Size=4 Extension Format=N Extension Line= Extension Origin [Int] Extension Origin Pos=<número> Extension Origin Size=<número> Extension Origin Format=<texto> Extension Origin Line=<número> Tamanho máximo: 10 caracteres Indica a localização da extensão de origem nas chamadas internas. Extension Origin Pos=1 Extension Origin Size=4 Extension Origin Format=N Extension Origin Line= Extension Destination [Int] Extension Destination Pos=<número> Extension Destination Size=<número> Extension Destination Format=<texto> Extension Destination Line=<número> Tamanho máximo: 10 caracteres 9

11 1.2. Campos de chamadas 10 Indica a localização da extensão de destino nas chamadas internas. Extension Destination Pos=6 Extension Destination Size=4 Extension Destination Format=N Extension Destination Line= Access [In, Out, Int, Net] Access Pos=<número> Access Size=<número> Access Format=<texto> AccessLine=<número> Tamanho máximo: 10 caracteres Indica a localização do código de acesso da chamada. Access Pos= 11 Access Size=1 Access Format=N Access Line= Auth Code [Out] Auth Code Pos=<número> Auth Code Size=<número> Auth Code Format=<texto> Auth Code Line=<número> Tamanho máximo: 10 caracteres Indica a localização do código de autorização (código de conta) da chamada. Auth Code Pos=15 Auth Code Size=6 Auth Code Format=N Auth Code Line=3 10

12 1.2. Campos de chamadas Account Code [Out] Account Code Pos=<número> Account Code Size=<número> Account Code Format=<texto> Account Code Line=<número> Tamanho máximo: 10 caracteres Nota Este campo não é utilizado. Para indicar a localização do código de conta, usar o campo anterior Dialed [Out, Net] Dialed Pos=<número> Dialed Size=<número> Dialed Format=<texto> Dialed Line=<número> Tamanho máximo: 25 caracteres Indica a localização do número de destino. Dialed Pos=20 Dialed Size=20 Dialed Format=N Dialed Line= Caller Id [In] Caller Id Pos=<número> Caller Id Size=<número> Caller Id Format=<texto> Caller Id Line=<número> Tamanho máximo: 25 caracteres Indica a localização do número do chamador. 11

13 1.2. Campos de chamadas 12 Caller Id Pos=20 Caller Id Size=20 Caller Id Format=N Caller Id Line= Duration [In, Out, Int, Net] Duration Pos=<número> Duration Size=<número> Duration Format=<texto> Duration Line=<número> Indica a localização duração da chamada. Duration Pos=50 Duration Size=8 Duration Format=T HH:MM:SS Duration Line= Meter [Out] Meter Pos=<número> Meter Size=<número> Meter Format=<texto> Meter Line=<número> Indica a localização do número de impulsos da chamada. Meter Pos=60 Meter Size=3 Meter Format=N Meter Line=1 12

14 1.2. Campos de chamadas Duration Ring [In, Out, Int, Net] Duration Ring Pos=<número> Duration Ring Size=<número> Duration Ring Format=<texto> Duration Ring Line=<número> Indica a localização do tempo de toque da chamada. Duration Ring Pos=10 Duration Ring Size=5 Duration Ring Format=T MM:SS Duration Ring Line= Node [In, Out, Int, Net] Node Pos=<número> Node Size=<número> Node Format=<texto> Node Line=<número> Indica a localização do nó da chamada. Nota Nos casos de instalações multi-site (DigiCall Net), este campo é indispensável para identificar qual o site de origem da chamada. Node Pos=20 Node Size=6 Node Format= Node Line=3 13

15 1.2. Campos de chamadas Time [In, Out, Int, Net] Time Pos=<número> Time Size=<número> Time Format=<texto> Time Line=<número> Indica a localização da hora de realização da chamada. Time Pos=30 Time Size=8 Time Format=T HH:MM:SS Time Line= Date [In, Out, Int, Net] Date Pos=<número> Date Size=<número> Date Format=<texto> Date Line=<número> Indica a localização da data de realização da chamada. Nota Para indicar a data de realização da chamada é preferivel utilizar os três seguintes campos. Date Pos=40 Date Size=8 Date Format= Date Line=3 14

16 1.2. Campos de chamadas Month [In, Out, Int, Net] Month Pos=<número> Month Size=<número> Month Format=<texto> Month Line=<número> Indica a localização do mês de realização da chamada. Month Pos=43 Month Size=2 Month Format=N Month Line= Day [In, Out, Int, Net] Day Pos=<número> Day Size=<número> Day Format=<texto> Day Line=<número> Indica a localização do dia de realização da chamada. Day Pos=40 Day Size=2 Day Format=N Day Line= Year [In, Out, Int, Net] Year Pos=<número> Year Size=<número> Year Format=<texto> Year Line=<número> Indica a localização do ano de realização da chamada. 15

17 1.2. Campos de chamadas 16 Year Pos=46 Year Size=4 Year Format=N Year Line= Trunk In [In, Int, Net] Trunk In Pos=<número> Trunk In Size=<número> Trunk In Format=<texto> Trunk In Line=<número> Tamanho máximo: 10 caracteres Indica a localização da linha de entrada da chamada. Trunk In Pos=50 Trunk In Size=5 Trunk In Format= Trunk In Line= Trunk Out [Out, Int, Net] Trunk Out Pos=<número> Trunk Out Size=<número> Trunk Out Format=<texto> Trunk Out Line=<número> Tamanho máximo: 10 caracteres Indica a localização da linha de saída da chamada. Trunk Out Pos=61 Trunk Out Size=5 Trunk Out Format= Trunk Out Line=3 16

18 1.2. Campos de chamadas Trunk Internal [Int] Trunk Internal Pos=<número> Trunk Internal Size=<número> Trunk Internal Format=<texto> Trunk Internal Line=<número> Tamanho máximo: 10 caracteres Indica a localização da linha interna utilizada na chamada. Trunk Internal Pos=71 Trunk Internal Size=5 Trunk Internal Format= Trunk Internal Line= Dialed Filter [Out] Dialed Filter=<lista> Indica uma lista de prefixos a remover do número de destino. Dialed Filter= Duration Filter [In, Out, Int, Net] Duration Filter=<booleano> Se este campo for verdadeiro, todas as chamadas com duração igual a zero serão eliminadas. Duration Filter=1 17

19 1.2. Campos de chamadas Meter Filter [In, Out, Int, Net] Meter Filter=<booleano> Se este campo for verdadeiro, todas as chamadas com o número de impulsos igual a zero serão eliminadas. Meter Filter= Charge Call [Net] Charge Call=<booleano> O custo das chamadas de rede só é calculado se este campo for verdadeiro. Charge Call= Duration Includes Ring Time [In, Out, Int, Net] Duration Includes Ring=<booleano> Se este campo for verdadeiro, a duração do tempo de toque é subtraido à duração da chamada, para obter a verdadeira duração de conversação e o custo correcto da chamada. Duration Includes Ring Time= Selector [In, Out, Int, Net] Selector Pos=<número> Selector Size=<número> Selector Format=<texto> Selector Line=<número> 18

20 1.2. Campos de chamadas 19 Indica a localização dos dados que serão utilizados para validar o tipo de chamada. Selector Pos=1 Selector Size=2 Selector Format= Selector Line= When [In, Out, Int, Net] When=<lista> Indica quais os valores que o selector deve ter para validar a chamada como sendo do tipo indicado. When=Ea ea Not When [In, Out, Int, Net] Not When=<lista> Indica os valores que o selector não pode ter para validar a chamada como sendo do tipo indicado. Not When=eA Ignore [In, Out, Int, Net] Ignore Pos=<número> Ignore Size=<número> Ignore Format=<texto> Ignore Line=<número> Indica a localização dos dados que são utilizados para verificar se esta chamada não pertence ao tipo indicado. 19

21 1.2. Campos de chamadas 20 Ignore Pos=40 Ignore Size=2 Ignore Format= Ignore Line= Ignore When [In, Out, Int, Net] Ignore When=<lista> Indica os valores que o selector anterior deve ter para que a chamada não seja considerada como do tipo indicado. Ignore When=43 ab Transfered Selector [In, Out, Int, Net] Transfered Selector Pos=<número> Transfered Selector Size=<número> Transfered Selector Format=<texto> Transfered Selector Line=<número> Indica a localização dos dados utilizados para verificar se a chamada foi transferida. Transfered Selector Pos=34 Transfered Selector Size=1 Transfered Selector Format= Transfered Selector Line= Transfered When [In, Out, Int, Net] Transfered When=<lista> Indica os dados que o selector anterior deve ter para que a chamada seja considerada como transferida. 20

22 1.2. Campos de chamadas 21 Transfered When=T Not Transfered When [In, Out, Int, Net] Not Transfered When=<lista> Indica os dados que o selector anterior não pode ter para que a chamada seja considerada como transferida. Not Transfered When=Z Unanswer Selector [Int] Unanswer Selector Pos=<número> Unanswer Selector Size=<número> Unanswer Selector Format=<texto> Unanswer Selector Line=<número> Indica a localização dos dados utlizados para verificar se a chamada foi atendida ou não. Unanswer Selector Pos=54 Unanswer Selector Size=1 Unanswer Selector Format= Unanswer Selector Line= Unanswer When [Int] Unanswer When=<lista> Indica os valores que o selector anterior deve ter para que a chamada seja considerada como não antendida. Unanswer When=\s 21

23 1.2. Campos de chamadas Not Unanswer When [Int] Not Unanswer When=<lista> Indica os valores que o selector anterior não pode ter para que a chamada seja considerada como não antendida. Not Unanwer When=: 22

24 Apêndice A Caracteres especiais Os seguintes caracteres podem ser utilizados nos campos e parametros em que esteja indicado que podem usar caracteres especiais: \nnn O caracter cujo código em octal é nnn \a Bell \xnn O caracter cujo código em hexadecimal é nn \r Carriage return \n New Line \f Form feed \b Backspace \t Horizontal tab \v Vertical tab \s Espaço \\ O caracter \ 23

25 Apêndice B Formatos Nos campos onde seja utilizado a opção Format, são utilizáveis os formatos indicados a seguir. Este formatos servem para validar certos campos de modo a se ter a certeza que o driver do PPCA consegue ler correctamente os dados. B.1 Númerico Este formato é utilizado para indicar que o campo indicado só aceita valores númericos, ou seja só pode ter os seguintes caracteres: espaço, dígitos de 0 a 9, e o ponto decimal. Caso o campo tenha qualquer outro caracter, o registo será ignorado. Este formato é identificado pela letra N, conforme o seguinte exemplo: Extension Format=N B.2 Tempo Este formato é utilizado nos campos em que os valore são expressos em horas, minutos e segundos. Caso o campo não corresponda ao formato indicado, o registo será ignorado. Este formato é identificado por um T, seguido de um espaço e da máscara de formatação, a qual é composta dos seguintes caracteres: H - Posição de um dígito das horas. M - Posição de um dígito dos minutos. S - Posição de um dígito dos segundos. 24

26 Apêndice B. Formatos B.2. Tempo 25 F - Posição de um dígito de???. * - Aceita qualquer caracter nesta posição. Para os caracteres H, M, S e F, só são aceites espaços e dígitos de 0 a 9. Qualquer outro caracter da máscara obriga a que o campo tenha o mesmo caracter nessa posição. Exemplos: Time Format=T HH:MM:SS O formato deste campo é de dois dígitos para horas, minutos e segundos, separados pelo caracter :. Duration Format=T MMM:SS Três digitos para os minutos e dois para os segundos, separados por :. Duration Format=T HH*MM:SS Quando o formato é de HH:MM:SS mas, se a duração for inferior a 1 hora, o PPCA só envia MM:SS (ou seja, não envia o : separador das horas e minutos), usa-se * em vez de : para separar as horas dos minutos, de modo ao registo não ser rejeitado por o driver encontrar um espaço em vez de :. 25