Ast-Rubrica 1.4

Manuale

Del 26 Aprile 2009

Documento riservato ai Clienti Asterweb.

Tutti i diritti riservati – Asterweb – Servizi Integrati. E' vietata la riproduzione anche parziale del presente documento.

Pagina 1

Pagina 2

I N D I C E

Descrizione sintetica 3

Procedura di installazione 4

Amministrazione Rubrica 5

- Parametri Generali 6

- Aggiornamento DB 8

- Gestione Parametri per Utenti/Interni 9

Interfaccia Utente 10

- Accesso Interfaccia Utente 10

- Descrizione Interfaccia Utente 11

- Impostazioni Generali 12

- Rubrica Condivisa 13

- Rubrica Personale 16

- Gestione VM 17

- Codici Servizi 18

Questo Software si caratterizza per la semplicità e la funzionalità.

Concentrando l'attenzione sulla Rubrica (ci sono altre funzionalità descritte nel presente

manuale, come la gestione dei codici di DND, Follw Me, etc) ogni utente potrà effettuare le

chiamate facendo un semplice Click sul numero di telefono da chiamare.

Squillerà il suo telefono e non appena alzata la cornetta (o attivato il vivavoce) il programma

effettuerà direttamente la chiamata.

Descrizione sintetica

Pagina 3

La condivisione della Rubrica è, inoltre, gestita in modo tale che solo gli utenti autorizzati

possano inserire, modificare e/o cancellare i dati.

Questo garantisce una gestione ottimale dei dati ed evita i classici problemi aziendali relativi

alla gestione dei dati.

Una volta in possesso del file ast-rubrica-1.4.tar è necessario scompattare il file e copiare il

contenuto sul PBX, nella directory /var/www/html. Ecco 2 possibili modalità:

1) Da un PC Windows, scompattare il file ast-rubrica-1.4.tar in locale utilizzando un

“comune” software come Winzip o Winrar e quindi copiare la cartella ottenuta sul PBX, nella

directory /var/www/html, con l'utilizzo di un software tipo Winscp o Filezilla.

2) Da un PC Windows copiare il file ast-rubrica-1.4.tar sul PBX con l'utilizzo di un software

tipo Winscp o Filezilla nella cartella /tmp, accedere alla console di Linux sul PBX

(direttamente sul PBX o in ssh ad esempio con Putty) e quindi scompattare il file tar col

comando: tar -xvf ast-rubrica-1.4.tar -C /var/www/html

A questo punto:

- Rinominare la directory (è possibile assegnare un qualsiasi nome alla directory):

Da console di Linux: mv /var/www/html/ast-rubrica-1.4 /var/www/html/ast-rubrica

- Creare le tabelle mysql, lanciando da browser:

http://[ip-centralino]/[directory-rubrica]/update/update.php

Es. Se l'IP del PBX è 192.168.1.100 e il nome della directory scelto è ast-rubrica, lanciare

da browser:

http://192.168.1.100/ast-rubrica/update/update.php

- Rimuovere la directory update:

Da console di Linux: rm -f /var/www/html/[directory-rubrica]/update

- Modificare il file session.php che si trova in /var/www/html/[directory-rubrica]/session:

- inserire l'indirizzo IP del PBX

- inserire la directory di esecuzione (es. ast-rubrica)

Procedura di installazione

Pagina 4

Accedere da browser: http://[ip-pbx]/[directory-rubrica]/admin/

Per il primo accesso utilizzare come UserID: admin come Password: password (fig. 1)

Amministrazione Rubrica

Pagina 5

Effettuato l'accesso, viene visualizzato l'elenco degli interni con i parametri configurabili e

due possibili scelte di settaggio: “Parametri Generali” e “Aggiornamento DB” (fig. 2)

fig. 1 – Pagina di accesso all'interfaccia di amministrazione

fig. 2 – Pagina di amministrazione per la gestione dei singoli Utenti/Interni

“Parametri Generali”In questa pagina, oltre a poter modificare i dati di accesso all'interfaccia di amministrazione

(UserID e password), è possibile definire i parametri generali che caratterizzeranno la

Rubrica (fig. 3).

Amministrazione Rubrica

Pagina 6

“Speedy Call Iniziale” e “Speedy Call Finale”Numero iniziale e finale delle Speedy Calls, utilizzabili dai telefoni, assegnabili ai nominativi

in Rubrica. La gestione delle Speedy Calls segue lo schema di default di FreePBX che, di

default, è *0+speedycall.

“Numero per Chiamata in Uscita”E' l'eventuale numero che deve essere utilizzato per “impegnare la linea” sia nel caso di

Click-to-call (che si effettua da interfaccia web sui nominativi in rubrica) sia per le Speedy

Calls (da telefono).

“Abilita inserimento 'Numero per Chiamata in Uscita' diverso da default”Mettendo questo parametro a “Si”, in fase di inserimento/modifica dei nominativi in rubrica, si

ha la possibilità di assegnare ai numeri di telefono, un numero specifico per “impegnare la

linea”.

fig. 3 – Pagina di gestione dei Parametri Generali della Rubrica

“Parametri Generali”

Facciamo qualche esempio per il settaggio ed il funzionamento dei campi:

- “Numero per Chiamata in Uscita”

- “Abilita inserimento 'Numero per Chiamata in Uscita' diverso da default”

“Numero per Chiamata in Uscita”Se per “impegnare le linee in uscita” si utilizza lo “0” (definito nelle rotte in uscita), si dovrà

inserire lo stesso valore (“0”) in questo campo, in modo tale che sia il Click-to-Call sia le

Speedy Calls lo utilizzino per generare le chiamate in uscita.

“Abilita inserimento 'Numero per Chiamata in Uscita' diverso da default”Abilitando questo campo a “Si”, in fase di inserimento dei numeri in Rubrica si potrà

specificare un numero, per “impegnare la linea”, diverso da quello definito in “Numero per

Chiamata in Uscita”.

Quindi, se lo “0” è il numero che si utilizza normalmente, ma si è in presenza anche di altre

rotte in uscita che utilizzano altre numerazione (es. 9 per chiamare i cellulari aziendali), in

fase di inserimento/modifica dei numeri in rubrica, si potrà specificare la numerazione

appropriata (nel nostro esempio “9”) (fig. 4).

Amministrazione Rubrica

Pagina 7

9

fig. 4 – Finestra di inserimento/modifica dei nominativi in Rubrica

“Aggiornamento DB”

Amministrazione Rubrica

Pagina 8

Questa utility è da utilizzare nel caso in cui si modifichino i dati relativi a “Numero per

Chiamata in Uscita” e/o “Abilita inserimento 'Numero per Chiamata in Uscita' diverso da

default”. L'utility provvede a modificare il database, aggiornando le numerazioni con i nuovi

“prefissi” inseriti in “Parametri Generali”.

NOTA: Nel caso in cui non si utilizzino le Speedy Calls, l'utility non è eseguire, anche nel

caso di modifica dei “Parametri Generali” (fig. 5).

fig. 5 – Finestra di esecuzione della utility “Aggiornamento DB”

“Gestione Parametri per Utenti/Interni”

Amministrazione Rubrica

Pagina 9

Nella pagina principale di amministrazione della Rubrica (fig. 6), vengono visualizzati gli

interni del PBX (presenti su FreePBX). Per ogni interno si possono definire, cliccando sul link

corrispondente all'interno stesso, i seguenti parametri (fig. 7):

- Password Web: la password per l'accesso alla Rubrica (la UserID corrisponde all'interno)

- Rubrica Inserimento: “Si”, se l'interno può fare inserimenti nella Rubrica Condivisa

- Rubrica Modifica: “Si”, se l'interno può fare modifiche nella Rubrica Condivisa

- Rubrica Cancellazione: “Si”, se l'interno può fare cancellazioni nella Rubrica Condivisa

- Icona VM: “Si”, se l'icona relativa alla gestione dei parametri della VM deve essere visibile.

- VM Modifica Setup: “Si”, se l'interno può modificare i propri parametri della VM, definiti su

FreePBX

- Icona Rubrica Personale: “Si”, se l'icona relativa alla gestione delle Rubrica Personale deve

essere visibile (quindi l'interno potrà avere anche una sua Rubrica Personale).

- Icona Codici: “Si”, se l'icona relativa alla gestione dei Codici (DND, Follow Me, etc) deve

essere visibile.

fig. 6 – Elenco interni visualizzato nella pagina principale di amministrazione

fig. 7 – Finestra per il setup dei parametri dell'interno

“Accesso all'interfaccia Utente”

Interfaccia Utente

Pagina 10

Accedere da browser: http://[ip-pbx]/[directory-rubrica]/

Per l'accesso, utilizzare come UserID il proprio numero di interno e come Password quella

assegnata dall'Amministratore (fig. 8).

fig. 8 – Pagina di accesso alla Rubrica

“Descrizione Interfaccia Utente”

Interfaccia Utente

Pagina 11

Una volta effettuato l'accesso verrà visualizzata la pagina contenente le Icone abilitate

dall'amministratore. In dettaglio:

- Icona Rubrica Condivisa: sempre visibile

- Icona Rubrica Personale: visibile se autorizzata

- Icona VM: visibile se autorizzata

- Icona Codici: visibile se autorizzata

- Icona Impostazioni Generali: sempre visibile

Si potranno avere, quindi, icone di scelta complete (fig. 9) o minime (fig. 10).

fig. 9 – Menù di scelta con tutte le icone

fig. 10 – Menù di scelta con il minimo delle icone

RubricaCondivisa

RubricaPersonale

GestioneVM

CodiciServizi

ImpostazioniGenerali

“Impostazioni Generali”

Interfaccia Utente

Pagina 12

In questa pagina l'utente può modificare la propria password di accesso all'interfaccia e

definire 2 parametri per la visualizzazione delle Rubriche (fig. 11):

- Righe per pagina: se si lascia “0”, il valore di default sarà di 15 righe per pagina

- Tipo Ricerca:

Inizia con: verranno ricercati i nominativi e/o i numeri di telefono che iniziano con quanto

ricercato

Contiene: verranno ricercati i nominativi e/o i numeri di telefono che contengono

quanto ricercato

Fig. 11Sezione dedicata al setup di:

password, righe per pagina

e tipo di ricerca

E', inoltre, possibile definire alcuni settaggi relativi alla visualizzazione dei dati in Rubrica,

come il colore delle righe alternate, il colore del carattere, le dimensioni del font e l'altezza

delle righe (fig. 12).

Fig. 12Sezione dedicata

ai settaggi relativi

alla visualizzazione

dei dai in Rubrica.

“Rubrica Condivisa”

Interfaccia Utente

Pagina 13

Una volta cliccato sull'icona relativa alla “Rubrica Condivisa”, viene visualizzato l'elenco dei

nominativi presenti in archivio in ordine alfabetico (fig. 13) oltre ai seguenti link:

- Inserimento in rubrica

NOTA: questa icona sarà visibile solo se in fase di amministrazione si è abilitato l'interno a

poter fare inserimenti sulla Rubrica Condivisa.

- Ricerca

- Ricerca rapida ...

Fig. 13 – Visualizzazione in Rubrica Condivisa

“Rubrica Condivisa - Inserimento”

Interfaccia Utente

Pagina 14

Fig. 14 – Inserimento/Modifica dati Rubrica

In Rubrica è possibile, per ogni nominativo, i seguenti dati (fig. 14):

- Telefono

- Cellulare

- Fax

- E-mail ...

I campi “Prefix” si riferiscono rispettivamente a “Telefono” e “Cellulare”. Tali campi vengono

visualizzati solo se abilitati in fase di amministrazione e rappresentano il numero per

“impegnare la linea” (utilizzare la rotta in uscita prevista, configurata su FreePBX).

“Rubrica Condivisa – Altre funzioni”

Interfaccia Utente

Pagina 15

Fig. 15 – Elenco nominativi in Rubrica e funzioni utilizzabili

Dall'elenco dei nominativi (fig. 15) sono possibili le seguenti operazioni:

- Click-to-call: cliccando sull'icona corrispondente ai numeri di “Telefono” e “Cellulare”

- Invio mail: cliccando sull'indirizzo e-mail (funzione mailto)

- Modifica nominativo (*)

- Cancellazione nominativo (*)

(*) NOTA: questa icona sarà visibile solo se in fase di amministrazione si è abilitato l'interno

a poter fare inserimenti sulla Rubrica Condivisa.

E' inoltre possibile, clicclando sull'intestazione della colonna, fare gli ordinamenti dei

nominativi in Rubrica su tutte le colonne, sia con ordinamento crescente sia decrescente.

SPEEDY CALLS (utilizzo da Telefono)

L'assegnazione di una “Speedy Call” ad un nominativo, genera sul DB di Asterisk (a cui fa

riferimento la gestione stessa delle Speedy Calls) 2 diversi codici:

- il numero della speedy call, al “numero di telefono” (Es. speedy call 15)

- il numero della speedy call + “*”, al “numero di cellulare” (Es. speedy call 15*)

Con questa gestione, a più numeri relativi ad uno stesso nominativo, viene quindi assegnato

uno stesso codice. Da telefono, quindi, per effettuare la chiamata con “Speedy Call” al

“numero di telefono” bisognerà digitare “*015” mentre per il “cellulare” bisognerà digitare

“*015*”.

“Rubrica Personale”

Interfaccia Utente

Pagina 16

L'icona relativa alla “Rubrica Personale” sarà visibile solo se in fase di amministrazione si è

abilitato l'interno a poter gestire tale rubrica.

Una volta cliccato sull'icona relativa alla “Rubrica Personale”, viene visualizzato l'elenco dei

nominativi presenti in archivio in ordine alfabetico (fig. 16).

I link e le funzioni sono le stesse descritte per la “Rubrica Condivisa”.

Fig. 16 – Visualizzazione in Rubrica Personale

“Gestione VM”

Interfaccia Utente

Pagina 17

L'icona relativa alla “Gestione VM” sarà visibile solo se in fase di amministrazione si è

abilitato l'interno a poter effettuare tale gestione.

Se per l'interno non è abilitata la VM (su FreePBX) verrà visualizzata questa pagina:

e di conseguenza non sarà possibile effettuare alcuna operazione.

Se per l'interno, invece, non è abilitata la VM (su FreePBX) si potranno avere 2 diverse

visualizzazioni in conseguenza del setup, effettuato in fase di amministrazione, relativo alla

possibilità per l'interno di modificare o meno i dati relativi alla prorpia VM.

Se la modifica non è abilitata avremo questa visualizzazione:

Se la modifica è, invece, abilitata avremo questa visualizzazione:

“Codici Servizi”

Interfaccia Utente

Pagina 18

L'icona relativa alla “Codici Servizi” sarà visibile solo se in fase di amministrazione si è

abilitato l'interno a poter effettuare tale gestione.

Una volta cliccato sull'icona “Codici Servizi”, verrà visualizzato lo status dei servizi stessi per

l'interno con la possibilità di modificarli (fig. 17).

I “Codici Servizi” sono gli stessi settabili da telefono secondo quanto configurato su FreePBX

(Es. *78 e *79 per il DND, *72 e *73 per il Follow Me, etc.)

Fig. 17 – Codici servizi dell'interno

Su tutte le pagine, nella sezione delle “Icone/Menù”, viene sempre visualizzato lo status dei

servizi siano questi gestiti da telefono sia da interfaccia.