= [wiki:DeployerGuide Przewodnik wdrożeniowca] > Zwraca listę zdarzeń według zadanych parametrów =


''' Definicja parametrów: '''
{{{
#!php
<?php

/**
 *  Zwraca listę zdarzeń według zadanych parametrów
 *   
 *  @param data Array  - Tablica z parametrami
 *  @param from__ Date - data w formacie YYYY-MM-DD (np 2010-01-01) z jakiego dnia ma pobrać zdarzenia
 *  @param to____ Date - data w formacie YYYY-MM-DD (np 2010-01-10) do jakiego dnia ma pobrać zdarzenia, jeśli brak parametru do ustawiany na from__
 *  @param usr_id Int  - Id praconwika (users:usr_id)
 *  @param contid Int  - Id kontaktu (contacts:contid)
 *   
 *  @return Array - tablica zdarzeń (może być pusta jeśli nie ma takich, które spełniają kryterium wyszukiwania) 
 *                  jeśli sukces, SoapFault w razie niepowodzenia
 *   
 *  @throws Exception - SoapFault
 */
Array getEvents(Array data)

?>
}}}

''' Przykłady wywołań: '''
{{{
#!php

// Plik MyService.php umieszczony w apps/edokumenty.
// MyService.php
<?php

define('EDOK_API_LOGIN', 'developer');
define('EDOK_API_PASSWORD', 'developer');
define('DEFAULT_ENTITY_SYMBOL', 'demo');

require_once('./classes/eDokumentyApi/EDokApiClient.inc');

$options = array(
    'location' => 'http://{host}:{port}/eDokumentyApi.php',
    "uri" => "eDokumentyAPI",
    'encoding'=>'UTF-8'
);
        
$client = new EDokApiClient(NULL, $options);
$client->setUser(EDOK_API_LOGIN);
$client->setPass(md5(EDOK_API_PASSWORD));
$header = new SoapHeader('eDokumentyAPI', 'entity_symbol', DEFAULT_ENTITY_SYMBOL);
$client->__setSoapHeaders($header);

$events = array();

try {
    $data = array(
        'from__' => '2011-10-10',
        'to____' => '2011-10-11',
        'contid' => 123,    
    );
    $events = $client->getEvents($data);
    var_dump($events);
} catch(SoapFault $fault) {
    var_dump($fault);
    
    if ($fault->faultcode < 100) {
        trigger_error("SOAP Fault: (faultcode: {$fault->faultcode}, faultstring: {$fault->faultstring})", E_USER_ERROR);
    }
}

?>
}}}