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

DigiCall c 2.x Configuração do Driver genérico (DgcGen32.dll 2.3.0.470 e seguintes) (http://www.digirede.pt) E-Mail: 30 de Maio de 2001

Conteúdo 1 Opções e Campos de Configuração 3 1.1 Opções da secção Config.................... 4 1.1.1 End of Record....................... 4 1.1.2 Minimum Record Len.................. 4 1.1.3 Maximum Record Len.................. 4 1.1.4 Ignore Chars....................... 5 1.1.5 Filter Chars........................ 5 1.1.6 Date From Buffer..................... 5 1.1.7 Node From Buffer..................... 6 1.1.8 Default Node....................... 6 1.1.9 Record Lines....................... 6 1.1.10 Record Start Selector................... 6 1.1.11 Record Start When.................... 7 1.1.12 Record Start Not When................. 7 1.1.13 Record Start Ignore.................... 7 1.1.14 Record Start Ignore When................ 8 1.2 Campos de chamadas....................... 8 1.2.1 Extension [In, Out].................... 9 1.2.2 Extension Origin [Int].................. 9 1.2.3 Extension Destination [Int]................ 9 1.2.4 Access [In, Out, Int, Net]................. 10 1.2.5 Auth Code [Out]..................... 10 1.2.6 Account Code [Out]................... 11 1.2.7 Dialed [Out, Net]..................... 11 1.2.8 Caller Id [In]....................... 11 1.2.9 Duration [In, Out, Int, Net]............... 12 1.2.10 Meter [Out]........................ 12 1.2.11 Duration Ring [In, Out, Int, Net]............ 13 1.2.12 Node [In, Out, Int, Net]................. 13 1.2.13 Time [In, Out, Int, Net]................. 14 1

Conteúdo Conteúdo 2 1.2.14 Date [In, Out, Int, Net].................. 14 1.2.15 Month [In, Out, Int, Net]................. 15 1.2.16 Day [In, Out, Int, Net].................. 15 1.2.17 Year [In, Out, Int, Net].................. 15 1.2.18 Trunk In [In, Int, Net].................. 16 1.2.19 Trunk Out [Out, Int, Net]................ 16 1.2.20 Trunk Internal [Int].................... 17 1.2.21 Dialed Filter [Out].................... 17 1.2.22 Duration Filter [In, Out, Int, Net]............ 17 1.2.23 Meter Filter [In, Out, Int, Net]............. 18 1.2.24 Charge Call [Net]..................... 18 1.2.25 Duration Includes Ring Time [In, Out, Int, Net].... 18 1.2.26 Selector [In, Out, Int, Net]................ 18 1.2.27 When [In, Out, Int, Net]................. 19 1.2.28 Not When [In, Out, Int, Net].............. 19 1.2.29 Ignore [In, Out, Int, Net]................. 19 1.2.30 Ignore When [In, Out, Int, Net]............. 20 1.2.31 Transfered Selector [In, Out, Int, Net].......... 20 1.2.32 Transfered When [In, Out, Int, Net]........... 20 1.2.33 Not Transfered When [In, Out, Int, Net]........ 21 1.2.34 Unanswer Selector [Int].................. 21 1.2.35 Unanswer When [Int]................... 21 1.2.36 Not Unanswer When [Int]................ 22 A Caracteres especiais 23 B Formatos 24 B.1 Númerico............................. 24 B.2 Tempo............................... 24 http://www.digirede.pt 2

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

1.1. Opções da secção Config 4 1.1 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] 1.1.1 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 1.1.2 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=50 1.1.3 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 http://www.digirede.pt 4

1.1. Opções da secção Config 5 1.1.4 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=# % & 1.1.5 Filter Chars Filter Chars=<lista> Todos os caracteres indicados na lista serão substituidos por espaços na linha recebida do PPCA. Filter Chars=# % & 1.1.6 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 http://www.digirede.pt 5

1.1. Opções da secção Config 6 1.1.7 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=1 1.1.8 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 1.1.9 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=1 1.1.10 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. http://www.digirede.pt 6

1.1. Opções da secção Config 7 Record Selector Pos=34 Record Selector Size=2 1.1.11 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 1.1.10 na página 6). Record Selector When=A0 A1 a0 a1 1.1.12 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 1.1.10 na página 6). RecordSelector Not When=A3 1.1.13 Record Start Ignore Record Start Ignore Pos=<número> Record Start Ignore Size=<número> Caso a opção descrita em 1.1.10 (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 http://www.digirede.pt 7

1.2. Campos de chamadas 8 1.1.14 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=5 7 1.2 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. http://www.digirede.pt 8

1.2. Campos de chamadas 9 1.2.1 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=1 1.2.2 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=2 1.2.3 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 http://www.digirede.pt 9

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=2 1.2.4 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=1 1.2.5 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 http://www.digirede.pt 10

1.2. Campos de chamadas 11 1.2.6 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. 1.2.7 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=2 1.2.8 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. http://www.digirede.pt 11

1.2. Campos de chamadas 12 Caller Id Pos=20 Caller Id Size=20 Caller Id Format=N Caller Id Line=3 1.2.9 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=1 1.2.10 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 http://www.digirede.pt 12

1.2. Campos de chamadas 13 1.2.11 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=3 1.2.12 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 http://www.digirede.pt 13

1.2. Campos de chamadas 14 1.2.13 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=3 1.2.14 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 http://www.digirede.pt 14

1.2. Campos de chamadas 15 1.2.15 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=3 1.2.16 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=3 1.2.17 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. http://www.digirede.pt 15

1.2. Campos de chamadas 16 Year Pos=46 Year Size=4 Year Format=N Year Line=3 1.2.18 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=3 1.2.19 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 http://www.digirede.pt 16

1.2. Campos de chamadas 17 1.2.20 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=3 1.2.21 Dialed Filter [Out] Dialed Filter=<lista> Indica uma lista de prefixos a remover do número de destino. Dialed Filter=4662 4663 6432 1.2.22 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 http://www.digirede.pt 17

1.2. Campos de chamadas 18 1.2.23 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=1 1.2.24 Charge Call [Net] Charge Call=<booleano> O custo das chamadas de rede só é calculado se este campo for verdadeiro. Charge Call=1 1.2.25 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=1 1.2.26 Selector [In, Out, Int, Net] Selector Pos=<número> Selector Size=<número> Selector Format=<texto> Selector Line=<número> http://www.digirede.pt 18

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=1 1.2.27 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 1.2.28 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 1.2.29 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. http://www.digirede.pt 19

1.2. Campos de chamadas 20 Ignore Pos=40 Ignore Size=2 Ignore Format= Ignore Line=2 1.2.30 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 1.2.31 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=2 1.2.32 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. http://www.digirede.pt 20

1.2. Campos de chamadas 21 Transfered When=T 1.2.33 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 1.2.34 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=3 1.2.35 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 http://www.digirede.pt 21

1.2. Campos de chamadas 22 1.2.36 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=: http://www.digirede.pt 22

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

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

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 :. http://www.digirede.pt 25