=  Dodanie nowej osoby kontaktowej =


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

/**
 *  Tworzy nową osobę kontaktową dla podanego klienta
 *   
 *  @param data Array - Tablica z parametrami w formie klucz => wartość, gdzie klucz to nazwa pola z bazy z tabeli contact_persons
 *  natomiast wartość to wartość
 *  
 *  Obsługiwane pola
 *  @param data['contid'] Int - identyfikator klienta
 *  @param data['data__'] String - Dane personalne (imię, nazwisko, stopień naukowy itp) np.: dr. Jan Nowak
 * OD WERSJI 6.0.188 można podać osobno imię i nazwisko jako cpfrnm oraz cplsnm
 *  @param data['ph_num'] String - Telefon
 *  @param data['faxnum'] String - Faks
 *  @param data['email_'] String - Adres email
 *  @param data['dscrpt'] String - Opis (np.: zajmowane stanowisko w pracy itp)
 *  @param data['is_def'] Bool - Wartość TRUE|FALSE czy dana osoba kontaktowa ma być ustawiona jako domyślna
 *  @param data['place_'] String - Stanowisko zajmowane w firmie
 *  @param data['bday__'] String - Data urodzin w formacie YYYY-MM-DD HH:MM:SS np 1982-01-01 08:00:00
 *  @param data['nday__'] String - Data imienin w formacie YYYY-MM-DD HH:MM:SS np 2010-01-01 08:00:00
 *   
 *  @return Int - id osoby kontaktowej jeśli sukces (contact_persons:copeid), 0 w razie niepowodzenia
 *
 *  @throws Exception - SoapFault
 */
Array createContactPerson(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);

$copeid = NULL;

try {
    $data = array(
        'data__' => 'Jan Kowalski',
        'contid' => 123,    
    );
    $copeid = $client->createContactPerson($data);
    var_dump($copeid);

} catch(SoapFault $fault) {
    
    var_dump($fault);
    
    if ($fault->faultcode < 100) {
        trigger_error("SOAP Fault: (faultcode: {$fault->faultcode}, faultstring: {$fault->faultstring})", E_USER_ERROR);
    }
}

?>
}}}