Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

 

This method creates and automatically starts an import process for the contacts listed in the xmlDoc parameter. You can use this method instead of calling a sequence of NewImportProcess and StartProcess methods. StartImportProcesses can also be used to update fields of an existing contact. 

...

Parameter 

listsIDs
string 

Mandatory - List identifiers. You can include multiple list IDs, separated by semicolons.
(See "Lists and Groups" section below for more information and examples.)

Example:  1;2;3

listsGUIDs
string 

Mandatory - List GUIDs. You can include multiple list GUIDs, separated by semicolons.
(See "Lists and Groups" section below for more information and examples.)

Example:  abc-123-def-456;ghi-789-jkl-123;mno-456-pqr-789

xmlDoc
string 

When specified: An XML string containing the recipients to be imported to the specified lists and groups. In this case the method Does not import any pending lists that were previously submitted using NewImportProccess

If not specified (NULL): method sequentially imports all pending XML structures that have been previously submitted using NewImportProccess. This option is available only starting from MailUp 8.2.1 or higher

See "Best Practices" and "XML Structure" sections below for known restrictions, more information and examples.

groupsIDs
string 

Mandatory - Group identifiers for each list, separated by semicolons. You can specify multiple groups for each list as well, separated by commas.
(See "Lists and Groups" section below for more information and examples.)

Example:  22,23;24;25

importType
integer 

Mandatory - Import type.

 

Any empty field is ignored if importType is equal to 1,2 or 3

  • 1 = import occur only on email channel (mobile number, if present, is discarded)
  • 2 = subscriptions occur only on SMS channel (email address, if present, is discarded)
  • 3 = subscriptions occur on both email and SMS channels (no field is discarded)

 

Any empty field overwrites the value on MailUp if importType is equal to 4, 5 or 6

  • 4 = import occur only on email channel (mobile number, if present, is discarded)
  • 5 = subscriptions occur only on SMS channel (email address, if present, is discarded)
  • 6 = subscriptions occur on both email and SMS channels (no field is discarded)


mobileInputType
integer 

Mandatory - Mobile number input type.

  • 1 = Entire number in a single field
  • 2 = Prefix and Number separated into different fields

(See "XML Structure" section below for more information and examples.)

asPending
boolean 
Mandatory - If "true" it subscribes (or unsubscribes, if "asOptOut=true") also the recipients that were pending in specified MailUp list before import. Please note that the name of this parameter is misleading, see table in Best Practices for details
(Default = false) 
ConfirmEmail
boolean 

Mandatory - If "true" sets subscription status of specified recipients as "pending" and sends them a confirmation email. Status change to "pending" and email sending applies to either brand new recipients or to recipients that were already subscribed or pending to the specified list before import. See table in Best Practices for details.
(Default = false) 

asOptOut
boolean 
Mandatory - Imports recipients as "unsubscribed" when set to "true", regardless if they were previously subscribed into specified MailUp list. If you want to cancel subscription (i.e. unsubscribe) also for the recipients that were previously pending, you should set both "asOptOut=true" and "asPending=true". See table in Best Practices for details.
(Default = false) 
forceOptIn
boolean 
Mandatory - If "true" itenables change of subscription status even if a recipient was "unsubscribed" before import. It can be used to force "subscribed" or "pending" status for previously unsubscribed recipients, please note that this status change does not apply when recipient was automatically unsubscribed due to hard bounce or complaints feedback loop. See table in Best Practices for details. 
(Default = false) 
replaceGroups
boolean 
Mandatory - Replace existing groups when set to "true". The system will automatically remove previously subscribed groups and keep only the groups specified in the groupsIDs parameter.
(Default = false) 
Note

The following table shows the most common combinations for the parameters that manage subscription status of imported recipients that are already present on MailUp

Action required on already existing recipientsConfirmEmailAsOptoutAsPendingForceOptIn 
No changes on subscription statusFalseFalseFalseFalseDefault case
Pending become Subscribed FalseFalseTrueFalseBad practice, please take care with it
Unsubscribed become SubscribedFalseFalseFalseTrueExcept for recipients that were unsubscribed due to hard bounce
or complaints feedback loop
Subscribed become PendingTrueFalseFalseFalseWith this configuration the confirmation email is sent to both
previously subscribed and previously pending
Unsubscribed become PendingTrueFalseAnyTrueExcept for recipients that were unsubscribed due to hard bounce
or complaints feedback loop
Despite of its name, "AsPending" value is ignored here.
Subscribed become UnsubscribedFalseTrueFalseFalse 
Pending become UnsubscribedFalseTrueTrueFalse 


...

Code Block
languagehtml/xml
linenumberstrue
<ws:listsIDs>1;2</ws:listsIDs>
<ws:listsGUIDs>66af9900-7dd7-4cca-9125-beadaf3a3a59;0e591119-xxxx-yyyy-zzzz-6ac75384b564</ws:listsGUIDs>
<ws:groupsIDs>;</ws:groupsIDs>
 Add recipients to multiple lists (one group per list)

In this example values are provided for both listsIDs and  listsGUIDs parameters (mandatory fields). Each of the parameters must have the same number of elements (separated by semi-colons). In this case, we are also specifying group 22 for list 1, and group 13 for list 2.

Code Block
languagehtml/xml
linenumberstrue
<ws:listsIDs>1;2</ws:listsIDs>
<ws:listsGUIDs>66af9900-7dd7-4cca-9125-beadaf3a3a59;0e591119-xxxx-yyyy-zzzz-6ac75384b564</ws:listsGUIDs>
<ws:groupsIDs>22;13</ws:groupsIDs>

...

Code Block
languagephp
linenumberstrue
<?php

class MailUpWsImport {
  protected $ns = "http://ws.mailupnet.it/";
  //replace <console host name> with the host name of your console
  protected $WSDLUrl = "http://<console host name>/services/WSMailUpImport.asmx?WSDL";
  protected $headers = array("User" => "user", "Password" => "password");
  protected $rCode;
  private $soapClient;
  private $xmlResponse;
  protected $domResult;

  function __construct() {
    $this->header = new SOAPHeader($this->ns, "Authentication", $this->headers);
    $this->soapClient = new SoapClient($this->WSDLUrl,array("trace"      => 1,"exceptions" => 0));
    $this->soapClient->__setSoapHeaders($this->header);
  }

  function __destruct() {
    unset($this->soapClient); 
  }

  //...
	
  public function startImportProcesses($processData) {
    try {
      echo $processData."<br/><br/>";
      $this->soapClient->StartImportProcesses($processData);
    } catch (SoapFault $soapFault) {
      var_dump($soapFault);
    }
  }

  //...
	
}

$WsImport = new MailUpWsImport();
$xmlData = <<<EOT
<subscribers><subscriber email="test@example.com" Prefix="+39" Number="3351234567" Name="Test">
<campo1>Luigi</campo1><campo2>Rossi</campo2><campo3>Rossi consulting</campo3><campo4>Parma2</campo4><campo5>PR</campo5>
<campo6>43102</campo6><campo7></campo7><campo8>ITA</campo8><campo9>Via Garibaldi, 1</campo9><campo10>0521123456</campo10>
<campo11>0521123457</campo11></subscriber></subscribers>
EOT;

$startImportProcessData = array(
  "listsIDs" => "4",
  "listsGUIDs" => "3c5cb08c-f0b5-4bd6-9c2a-b687ecdac8b4",
  "xmlDoc" => $xmlData,
  "groupsIDs" => "22",
  "importType" => "3",
  "mobileInputType" => "2",
  "asPending" => '0',
  "ConfirmEmail" => "0",
  "asOptOut" => "0",
  "forceOptIn" => "0",
  "replaceGroups" => "0"
);
 
$WsImport->startImportProcesses($startImportProcessData);

?>

 

C#

Code Block
languagecsharp
WSMailUpImport toTest = new WSMailUpImport();

Authentication auth = new Authentication();
auth.User = tbLoginUserImport.Text;
auth.Password = tbLoginPasswordImport.Text;
auth.encType = string.Empty;

toTest.AuthenticationValue = auth;

string xmlString = "<subscribers><subscriber email=\"mike@example.com\" Prefix=\"\" Number=\"\" Name=\"\"><campo1>Mike</campo1><campo2>Brown</campo2><campo3>Example Company</campo3><campo4>Los Angeles</campo4><campo5></campo5><campo6>90125</campo6><campo7>CA</campo7><campo8>US</campo8><campo9>555 Some Street</campo9><campo10></campo10><campo11>555-123-1234</campo11></subscriber></subscribers>";

string myListId = "8";
string myListGuid = "CC9C4CBD-567B-4248-B56F-7C8364F11C5";
string myGroupsIDs = "45";
int importType = 3;
int mobileInputType = 2;
bool asPending =  false;
bool ConfirmEmail =  false;
bool asOptOut =  false;
bool forceOptIn =  false;
bool replaceGroups =  false;
string retVal = toTest.StartImportProcesses(myListId ,myListGuid, xmlString, myGroupsIDs, importType, mobileInputType, asPending , ConfirmEmail, asOptOut, forceOptIn, replaceGroups);

...