Partner  /  3 - Area Partner  /  Come personalizzare i Servizi Esterni

3.5 Come personalizzare i Servizi Esterni

Il servizio Aruba Cloud mette a disposizione dei propri Partner un utile strumento per essere avvisati quando il proprio credito (o fido qualora sia presente) è inferiore ad una soglia stabilita o è esaurito.

Per poter configurare i valori procedere come indicato:
  • effettuare il login ad "Area Partner"
  • accedere alla sezione "Personalizza"

  • selezionare dal menù di sinistra "Personalizzazione" la voce "Servizi Esterni"

  • si aprirà una sezione con due aree: "Impostazioni API" e "Test"

Impostazioni API



Dalla sezione "Impostazioni API" è possibile configurare l'Url del Web Service implementato dal Partner per la gestione degli eventi, nonché le relative credenziali di autenticazione (User Name e Password).

Una volta effettuate tutte le modifiche desiderate è necessario cliccare sul tasto "Salva"



per renderle attive. Al termine delle modifiche comparirà un messaggio di conferma come il seguente:

Test



Dalla sezione "Test" è possible effettuare le prove di funzionamento del servizio di notifica, sia per "Raggiungimento Soglia" che per "Esaurimento Credito".
Le due funzioni sono selezionabile tramite l'apposita lista iniziale alla voce "Tipo Test"

 
N.B. In caso di Fido la Soglia di avviso di fine credito viene calcolata sul valore del Fido stesso. Ovvero se il cliente ha un Fido di 100 € e la soglia è impostata a 20 €, l'avviso partirà quando il credito sarà a - 80 € ovvero 20 € prima che i suoi servizi vengano staccati.
Una volta effettuate tutte le modifiche desiderate è necessario cliccare sul tasto "Salva"



per renderle attive. Al termine delle modifiche comparirà un messaggio di conferma come il seguente:

Documentazione di esempio

Il file CreditEventReceiver.wsdl definisce il contratto che deve essere implementato dal webservice da implementare per ricevere eventi di notifica riguardanti il credito degli utenti. Il webservice definisce 2 metodi:
  1. ReceiveThresholdReached: questo metodo viene richiamato nel caso in cui venga oltrepassata la soglia del credito definita dall'utente
  2. ReceiveCreditExhausted: questo metodo viene richiamato quando l'utente finisce il credito disponibile
Viene anche allegato un esempio di implementazione di tale webservice CreditEventReceiver-Sample. Tale esempio è realizzato in .Net, pertanto è consigliabile la pubblicazione su una macchina Windows dotata di IIS e del framework .Net 4.0 installato.
Nel file CreditEventReceiver.asmx.cs sono presenti 2 commenti "// TODO: Add logic here" che indicano il punto in cui deve essere inserita la logica per la gestione della segnalazione. Inoltre per la gestione dell'autenticazione l'esempio autentica con le credenziali cablate nel file AuthHeader.cs:
  • "required username"
  • "required password"
Devono essere modificate le proprietà AuthUserName e AuthPassword al fine di recuperare più correttamente le credenziali in maniera dinamica. Scarica il file .zip.