Integrazione tramite SOAP (lato server) integration-via-soap-server-side
I servizi web dell’SOAP forniti per la gestione delle offerte sono diversi da quelli solitamente utilizzati in Adobe Campaign. È possibile accedervi tramite l’URL di interazione descritto nella sezione precedente e presentare o aggiornare le offerte per un determinato contatto.
Proposta di offerte offer-proposition
Per una proposta di offerta tramite SOAP, aggiungi il comando nms:proposition#Propose seguito dai seguenti parametri:
- targetId: chiave primaria del destinatario (può essere una chiave composita).
- maxCount: specifica il numero di proposte di offerta per il contatto.
- contesto: consente di aggiungere informazioni di contesto nello schema dello spazio. Se lo schema utilizzato è nms:interface, aggiungere
<empty>. - categorie: specifica le categorie a cui devono appartenere le offerte.
- temi: specifica i temi a cui le offerte devono appartenere.
- uuid: valore del cookie permanente di Adobe Campaign ("uuid230").
- nli: valore del cookie di sessione di Adobe Campaign ("nlid").
- noProp: utilizzare il valore "true" per disattivare l'inserimento della proposta.
NOTE
Le impostazioni targetId e maxCount sono obbligatorie. Le altre sono facoltative.
In risposta alla richiesta, il servizio SOAP restituirà i seguenti parametri:
- interfaceId: ID dell'interazione.
- propositions: elemento XML, contiene l'elenco delle proposte, ciascuna con il proprio ID e la propria rappresentazione HTML.
Aggiornamento offerta offer-update
Aggiungi il comando nms:interface#UpdateStatus all'URL, seguito dai seguenti parametri:
- proposition: stringa di caratteri, contiene l'ID della proposta fornito come output durante una proposta di offerta. Consulta Proposta di offerte.
- status: tipo di stringa che specifica il nuovo stato dell'offerta. I valori possibili sono elencati nell'enumerazione propositionStatus nello schema nms:common. Ad esempio, il numero 3 corrisponde allo stato Accettato.
- contesto: elemento XML, che consente di aggiungere informazioni di contesto nello schema dello spazio. Se lo schema utilizzato è nms:interface, aggiungere
<empty>.
Esempio di utilizzo di una chiamata SOAP example-using-a-soap-call
Ecco un esempio di codice per una chiamata SOAP:
<%
var space = request.parameters.sp
var cnx = new HttpSoapConnection(
"https://" + request.serverName + ":" + request.serverPort + "/interaction/" + env + "/" + space,
"utf-8",
HttpSoapConnection.SOAP_12)
var session = new SoapService(cnx, "nms:interaction")
var action = request.parameters.a
if( action == undefined )
action = 'propose'
try
{
switch( action )
{
case "update":
var proposition = request.parameters.p
var status = request.parameters.st
session.addMethod("UpdateStatus", "nms:interaction#UpdateStatus",
["proposition", "string",
"status", "string",
"context", "NLElement"],
[])
session.UpdateStatus(proposition, status, <undef/>)
var redirect = request.parameters.r
if( redirect != undefined )
response.sendRedirect(redirect)
break;
case "propose":
var count = request.parameters.n
var target = request.parameters.t
var categorie = request.parameters.c
var theme = request.parameters.th
var layout = request.parameters.l
if( count == undefined )
count = 1
session.addMethod("Propose", "nms:proposition#Propose",
["targetId", "string",
"maxCount", "string",
"categories", "string",
"themes", "string",
"context", "NLElement"],
["interactionId", "string",
"propositions", "NLElement"])
response.setContentType("text/html")
var result = session.Propose(target, count, category, theme, <empty/>)
var props = result[1]
%><table><tr><%
for each( var propHtml in props.proposition.*.mdSource )
{
%><td><%=propHtml%></td><%
}
%></tr></table><%
break;
}
}
catch( e )
{
}
%>
recommendation-more-help
601d79c3-e613-4db3-889a-ae959cd9e3e1