Export seznamu zákazníků a aktivních služeb (SOAP)

Účel článku

Zdokumentování exportu seznamu zákazníků a aktivních služeb pomocí web services.

Registrované metody

Seznam registrovaných metod s referenčním popisem je k dispozici na https://is.cibs.cz/ws_cibs.php.

Metoda	Popis
ws_session_login	přihlášení operátora
ws_session_logout	odhlášení operátora
ws_session_set_ct	nastavení lokace
ws_users_export	export zákazníků a aktivních služeb

Posloupnost volání metod

Pro tuto funkcionalitu je nutné se nejprve přihlásit do CIBS (ws_session_login) a nastavit číslo lokace (ws_session_set_ct). Poté je teprve možné zavolat příslušnou metodu (ws_users_export). Po zpracování výsledků je třeba provést odhlášení operátora (ws_session_logout).

Čas generování exportního souboru je závislý na počtu záznamů v databázi. Z toho důvodu je potřeba v klientu nastavit dostatečný timeout.

Příklad použití metod v php skriptu

Příklad obsahuje timeout 300 vteřin. Vyzkoušejte, jaký timeout bude vhodný s ohledem na počet exportovaných zákazníků.

<?php
require_once 'libs/nusoap/nusoap.php';

$login = 'jmeno'; // jméno
$password = 'heslo'; // heslo
$host = 'https://adresa/ws_cibs.php?wsdl'; // url ostré verze: https://is.cibs.cz/ws_cibs.php?wsdl, testovací verze: https://test.cibs.cz/ws_cibs.php?wsdl
$ct = lokace; // číslo lokace

$client = new nusoap_client($host, null, null, null, null, null, null, 300);
$err = $client->getError();
if ($err) {
  echo '<p><b>Constructor error: ' . $err . '</b></p>';
}

function ws_simple_call($client, $method, $input) {
  $res = $client->call($method, $input);
  if ($client->fault) {
    echo '<p><b>$method - fault:</b> ' . $res . '</p>';
    $res = false;
  } else {
    $err = $client->getError();
    if ($err) {
      echo '<p><b>$method - error:</b> ' . $err . '</p>';
      $res = false;
    } else {
      echo '<p><b>$method - result:</b> ' . $res . '</p>';
    }
  }
  return $res;
}

$session = ws_simple_call($client, 'ws_session_login', array('login' => $login, 'password' => $password));
if ($session) {
  $r = ws_simple_call($client, 'ws_session_set_ct', array('session' => $session, 'ct' => $ct));
  $r = ws_simple_call( $client, 'ws_users_export', array('session'=>$session));
  $r = ws_simple_call( $client, 'ws_session_logout', array('session'=>$session));
}
?>

Práva a nastavení:

Název	Účel	Popis	Hodnoty
USER_LIST.EXPORT	nastavení operátora	povoluje operátorovi provádět export seznamu zákazníků a jejich aktivních služeb	1
CT	nastavení operátora	právo zpřístupňuje lokaci	id lokace

Seznam zákazníků a aktivních služeb

Metoda ws_users_export vrací xml soubor odpovídající XML schématu https://is.cibs.cz/specific/xsd/customers_services.xsd.

Analýzy a CIT

Analýza CibsUserDataAccessWebServicesAnalysis

CIT #6043

Zpět na:

• Rozhraní API
• Export zákazníka a aktivních služeb (SOAP)