JackSMS - Creare Configurazioni
Ecco una
piccola guida che vi potrā aiutare nella creazione di un servizio per
JackSMS.
Iniziamo il nostro service:
Subito dopo, nel tag <description> troviamo <info> , dove indicare in poche parole la descrizione del servizio (con, ad esempio, fonte e limiti). In <config> vanno indicati i dati che devono essere inseriti dall'utente
Chiudiamo quindi i due tag aperti </config> e </description>
Inizia ora la vera e propria <procedure>
A questo punto potrebbe essere necessario prelevare del contenuto dalla pagina oppure inviare alcune informazioni.
Per prelevare del contenuto:
Per inviare informazioni (deve essere effettuato un POST)
<vars>
Apriamo il TAG
una volta sola per tutte le var.
<var
Indica una variabile.
name="valore"
Indica il nome della variabile
value="valore"
Indica il valore della variabile.
/>
Con questo chiudiamo ciascuna
var.
</vars>
Con questo chiudiamo il TAG
dopo l'elenco di tutte le var.
Utilizziamo i vari TAG per eseguire le operazioni necessarie al login e all'invio di sms.
Per far apparire un messaggio di errore e quindi interrompere la procedura d'invio:
Per comunicare l'esito positivo della procedura d'invio:
In caso di avvenuto invio si indica una sola var.
A questo punto chiudiamo il TAG della pagina con </page> ed infine quello del servizio </service>
Iniziamo il nostro service:
| <service | |
| id="valore" | Indica il numero associato al servizio. |
| name="valore" | Indica il nome del servizio. |
| v="valore" | Indica la versione del servizio. |
| maxsms="valore" | Indica il numero di sms che si possono inviare con questo servizio. |
| keepsession="valore" | Indica la frequenza con cui vengono effettuare richieste al server per mantenere attiva la sessione. Il valore č espresso in secondi. |
| keepsessionurl="valore. | Indica l'indirizzo al quale viene effettuata la richiesta per mantenere attiva la sessione. |
| singlelen="valore" | Indica il valore del contatore dei caratteri per il quale viene conteggiato un solo sms. |
| maxlen="valore" | Indica il valore massimo di lunghezza di un sms. Č la somma di tutti i singlelen. |
| reset="monthly" | Indica la frequenza di azzeramento del contatore di sms inviati. Č da impostare solamente nel caso in cui questa frequenza sia mensile. |
| /> |
Subito dopo, nel tag <description> troviamo <info> , dove indicare in poche parole la descrizione del servizio (con, ad esempio, fonte e limiti). In <config> vanno indicati i dati che devono essere inseriti dall'utente
| <required | Indica che il dato da inserire č obbligatorio. | |
| <optional | Indica che il dato da inserire č facoltativo. | |
| name="valore" | Indica il nome della variabile (solo lowercase). | |
| desc="valore" | Indica la descrizione per la variabile che sarā visibile ed utile all'utente per completare il campo. | |
| default="valore" | Indica un valore predefinito variabile. | |
| /> | Con questo chiudiamo ciascun optional o required. | |
Chiudiamo quindi i due tag aperti </config> e </description>
Inizia ora la vera e propria <procedure>
| <page | |
| uri="valore" | Indica l'indirizzo dove dovranno essere compiute le operazioni. |
| method=.post. | Serve per effettuare un POST all'indirizzo indicato in uri. |
| captcha="1" | Indica la presenza del captcha in quell'uri. |
| condition="%%variabile%%" | |
| > |
A questo punto potrebbe essere necessario prelevare del contenuto dalla pagina oppure inviare alcune informazioni.
Per prelevare del contenuto:
| <contents> | |
| <var | Indica una variabile. |
| name="valore" | Indica il nome della variabile |
| left="valore" | Indica la parte di testo a sinistra della stringa che ci interessa prendere. |
| right="valore" | Indica la parte di testo a destra della stringa che ci interessa prendere. |
| /> | Con questo chiudiamo ciascuna var. |
Per inviare informazioni (deve essere effettuato un POST)
Utilizziamo i vari TAG per eseguire le operazioni necessarie al login e all'invio di sms.
Per far apparire un messaggio di errore e quindi interrompere la procedura d'invio:
| <errors> | Apriamo il TAG una volta sola per tutte le var. |
| <var | Indica una variabile. |
| errstr="valore" | Indica una stringa da cercare nella pagina. Se tale stringa č presente verrā visualizzato il messaggio di errore contenuto in errmsg. |
| errmsg="valore" | Mostra all'utente un messaggio di errore dove viene specificata la causa del fallito invio. |
| /> | Con questo chiudiamo ciascuna var. |
| </errors> | Con questo chiudiamo il TAG dopo l'elenco di tutte le var. |
Per comunicare l'esito positivo della procedura d'invio:
| <accept> | Apriamo il TAG una volta sola per tutte le var. |
| <var | Indica una variabile. |
| acceptstr= "valore" | Indica una stringa da cercare nella pagina. Se tale stringa č presente verrā visualizzato un messaggio di avvenuto invio. |
| /> | Con questo chiudiamo ciascuna var. |
| </accept> | Con questo chiudiamo il TAG dopo l'elenco di tutte le var. |
In caso di avvenuto invio si indica una sola var.
A questo punto chiudiamo il TAG della pagina con </page> ed infine quello del servizio </service>