(Delphi DLL) Peoplevox SaveData

Demonstrates how to call the Peoplevox SaveData SOAP method. This example adds a new carrier (DHL) to the system.

Chilkat for Delphi Downloads Chilkat non-ActiveX DLL for Delphi Chilkat ActiveX DLL for Delphi * The examples here use the non-ActiveX DLL.

uses
    Winapi.Windows, Winapi.Messages, System.SysUtils, System.Variants, System.Classes, Vcl.Graphics,
    Vcl.Controls, Vcl.Forms, Vcl.Dialogs, Vcl.StdCtrls, Http, StringBuilder, HttpResponse, HttpRequest, Xml;

...

procedure TForm1.Button1Click(Sender: TObject);
var
success: Boolean;
sbSoapXml: HCkStringBuilder;
sbCsvData: HCkStringBuilder;
numReplacements: Integer;
req: HCkHttpRequest;
http: HCkHttp;
resp: HCkHttpResponse;
xmlResponse: HCkXml;
reference: PWideChar;
status: PWideChar;

begin
// This example requires the Chilkat API to have been previously unlocked.
// See Global Unlock Sample for sample code.

// Sends a POST that looks like this:

// 	POST /PEOPLEVOX_CLIENT_ID/resources/integrationservicev4.asmx HTTP/1.1
// 	Content-Type: text/xml;charset=UTF-8
// 	SOAPAction: http://www.peoplevox.net/SaveData
// 	Content-Length: (automatically computed and added by Chilkat)
// 	Host: qac.peoplevox.net
// 
// 	<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:peop="http://www.peoplevox.net/">
// 	   <soap:Header>
// 	      <peop:UserSessionCredentials>
// 	         <peop:UserId>PEOPLEVOX_USER_ID</peop:UserId>
// 	         <peop:ClientId>PEOPLEVOX_CLIENT_ID</peop:ClientId>
// 	         <peop:SessionId>PEOPLEVOX_SESSION_ID</peop:SessionId>
// 	      </peop:UserSessionCredentials>
// 	   </soap:Header>
//         <soap:Body>
//           <peop:SaveData>
//              <peop:saveRequest>
//                 <peop:TemplateName>Carriers</peop:TemplateName>
//                 <peop:CsvData>CSV_DATA</peop:CsvData>
//                 <peop:Action>0</peop:Action>
//              </peop:saveRequest>
//           </peop:SaveData>
//        </soap:Body>
// 	</soap:Envelope>
// 

// Notice that a UserId is needed here.  This is different than the username required for Peoplevox authentication.
//    The UserId for the admin account is 1.
//     
sbSoapXml := CkStringBuilder_Create();
CkStringBuilder_Append(sbSoapXml,'<?xml version="1.0" encoding="utf-8"?>' + #13#10);
CkStringBuilder_Append(sbSoapXml,'<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:peop="http://www.peoplevox.net/">' + #13#10);
CkStringBuilder_Append(sbSoapXml,'   <soap:Header>' + #13#10);
CkStringBuilder_Append(sbSoapXml,'      <peop:UserSessionCredentials>' + #13#10);
CkStringBuilder_Append(sbSoapXml,'         <peop:UserId>PEOPLEVOX_USER_ID</peop:UserId>' + #13#10);
CkStringBuilder_Append(sbSoapXml,'         <peop:ClientId>PEOPLEVOX_CLIENT_ID</peop:ClientId>' + #13#10);
CkStringBuilder_Append(sbSoapXml,'         <peop:SessionId>PEOPLEVOX_SESSION_ID</peop:SessionId>' + #13#10);
CkStringBuilder_Append(sbSoapXml,'      </peop:UserSessionCredentials>' + #13#10);
CkStringBuilder_Append(sbSoapXml,'   </soap:Header>' + #13#10);
CkStringBuilder_Append(sbSoapXml,'   <soap:Body>' + #13#10);
CkStringBuilder_Append(sbSoapXml,'      <peop:SaveData>' + #13#10);
CkStringBuilder_Append(sbSoapXml,'         <peop:saveRequest>' + #13#10);
CkStringBuilder_Append(sbSoapXml,'            <peop:TemplateName>Carriers</peop:TemplateName>' + #13#10);
CkStringBuilder_Append(sbSoapXml,'            <peop:CsvData>CSV_DATA</peop:CsvData>' + #13#10);
CkStringBuilder_Append(sbSoapXml,'            <peop:Action>0</peop:Action>' + #13#10);
CkStringBuilder_Append(sbSoapXml,'         </peop:saveRequest>' + #13#10);
CkStringBuilder_Append(sbSoapXml,'      </peop:SaveData>' + #13#10);
CkStringBuilder_Append(sbSoapXml,'   </soap:Body>' + #13#10);
CkStringBuilder_Append(sbSoapXml,'</soap:Envelope>');

sbCsvData := CkStringBuilder_Create();
CkStringBuilder_Append(sbCsvData,'Name,Reference' + #13#10);
CkStringBuilder_Append(sbCsvData,'DHL,D0001');
numReplacements := CkStringBuilder_Replace(sbSoapXml,'CSV_DATA',CkStringBuilder__getAsString(sbCsvData));

req := CkHttpRequest_Create();
CkHttpRequest_putHttpVerb(req,'POST');
CkHttpRequest_putSendCharset(req,True);
CkHttpRequest_putCharset(req,'utf-8');
CkHttpRequest_AddHeader(req,'Content-Type','text/xml');
CkHttpRequest_AddHeader(req,'SOAPAction','http://www.peoplevox.net/SaveData');
CkHttpRequest_putPath(req,'/PEOPLEVOX_CLIENT_ID/resources/integrationservicev4.asmx');
success := CkHttpRequest_LoadBodyFromString(req,CkStringBuilder__getAsString(sbSoapXml),'utf-8');

http := CkHttp_Create();
CkHttp_putFollowRedirects(http,True);

resp := CkHttp_SynchronousRequest(http,'qac.peoplevox.net',443,True,req);
if (CkHttp_getLastMethodSuccess(http) <> True) then
  begin
    Memo1.Lines.Add(CkHttp__lastErrorText(http));
    Exit;
  end;

// We should expect a 200 response if successful.
if (CkHttpResponse_getStatusCode(resp) <> 200) then
  begin
    Memo1.Lines.Add('Response StatusCode = ' + IntToStr(CkHttpResponse_getStatusCode(resp)));
    Memo1.Lines.Add('Response StatusLine: ' + CkHttpResponse__statusLine(resp));
    Memo1.Lines.Add('Response Header:');
    Memo1.Lines.Add(CkHttpResponse__header(resp));
    Memo1.Lines.Add(CkHttpResponse__bodyStr(resp));
    Exit;
  end;

xmlResponse := CkXml_Create();
success := CkXml_LoadXml(xmlResponse,CkHttpResponse__bodyStr(resp));
Memo1.Lines.Add(CkXml__getXml(xmlResponse));
CkHttpResponse_Dispose(resp);

// A successful response is shown below.
// To parse a successful response:
reference := CkXml__chilkatPath(xmlResponse,'soap:Body|SaveDataResponse|SaveDataResult|Statuses|IntegrationStatusResponse|Reference|*');
Memo1.Lines.Add('Reference = ' + reference);
status := CkXml__chilkatPath(xmlResponse,'soap:Body|SaveDataResponse|SaveDataResult|Statuses|IntegrationStatusResponse|Status|*');
Memo1.Lines.Add('Status = ' + status);

// <?xml version="1.0" encoding="utf-8" ?>
// <soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
//     <soap:Body>
//         <SaveDataResponse xmlns="http://www.peoplevox.net/">
//             <SaveDataResult>
//                 <ResponseId>0</ResponseId>
//                 <TotalCount>1</TotalCount>
//                 <Detail />
//                 <Statuses>
//                     <IntegrationStatusResponse>
//                         <Reference>D0001</Reference>
//                         <Status>Success</Status>
//                         <LineNo>0</LineNo>
//                     </IntegrationStatusResponse>
//                 </Statuses>
//                 <ImportingQueueId>0</ImportingQueueId>
//                 <SalesOrdersToDespatchIds />
//             </SaveDataResult>
//         </SaveDataResponse>
//     </soap:Body>
// </soap:Envelope>

CkStringBuilder_Dispose(sbSoapXml);
CkStringBuilder_Dispose(sbCsvData);
CkHttpRequest_Dispose(req);
CkHttp_Dispose(http);
CkXml_Dispose(xmlResponse);

end;