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

Účel článku

Zdokumentování exportu zákazníka a aktivních služeb pomocí web services. Metoda vychází z exportu seznamu zákazníků a aktivních služeb, ale umožňuje export pouze jednoho zákazníka a jeho služeb.

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_user_service_export	export zákazníka a aktivních služeb
ws_users_export	export zákazníků a jejich 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_user_service_export). Po zpracování výsledků je třeba provést odhlášení operátora (ws_session_logout).

---

ws_users_export

Vrací všechny zákazníky (aktivní i neaktivní) v dané lokaci. Vstupní parametr services_state pak už jen ovlivňuje to, kolik a jaké služby se zobrazí u zákazníka. Pokud se použije services_state = BLOCKED, pak jsou ve výpisu všichni zákazníci, ale jen u malého množství z nich je nějaká služba (protože jen malé množství z nich má službu blokovánu).

-- volání
<soapenv:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
   <soapenv:Header/>
   <soapenv:Body>
      <ws_users_export soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
         <session xsi:type="xsd:string">a7d0dfab-ade0-11e9-9298-5cf3fc37b8bd</session>
         <services_state xsi:type="xsd:string">BLOCKED</services_state>
      </ws_users_export>
   </soapenv:Body>
</soapenv:Envelope>

---

ws_user_service_export

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

---

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

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

$login = 'jmeno'; // jméno
$password = 'heslo'; // heslo
$host = 'https://adresa/ws_cibs.php?wsdl'; // url
$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_user_service_export', array('session'=>$session, 'user_id'=>$userId, 'services_state'=>'ACTIVE')));
  $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

---

Analýzy a CIT

Analýza [[Cibs.CibsWsUserServicesExportAnalysis]CibsWsUserServicesExportAnalysis]]

CIT #12174

Zpět na:

• Rozhraní API