| 1 | = Dodaj komentarz = |
| 2 | |
| 3 | |
| 4 | ''' Definicja parametrów: ''' |
| 5 | {{{ |
| 6 | #!php |
| 7 | <?php |
| 8 | |
| 9 | /** |
| 10 | * Dodaje komentarz do wskazanego obiektu. |
| 11 | * |
| 12 | * @param array $data - Tablica z parametrami. Poniżej obsługiwane klucze. |
| 13 | * Int $data['prc_id'] - Identyfikator sprawy (processes.prc_id) |
| 14 | * Int $data['doc_id'] - Identyfikator dokumentu (documents.doc_id) |
| 15 | * String $data['commnt'] - Treść komentarza |
| 16 | * String $data['adddat'] - Data dodania komentarza (nie jest wymagana w razie braku zostanie użyta bieżąca data) |
| 17 | * Int $data['adduid'] - Identyfikator pracownika dodającego komentarz (users.usr_id). Parametr nie jest wymagany i |
| 18 | * ma znaczenie tylko wtedy jeśli API uruchominono z poziomou użytkownika EDOK_API. Jeśli API uruchominono z poziomu użytkownika systemu eDokumenty wtedy parametr usr_id jest pomijany |
| 19 | * Int $data['sendNotifies'] - 1 lub 0 czy ma wysyłać powiadomienie |
| 20 | * |
| 21 | * Parametry 'prc_id', 'doc_id' są zamienne wystarczy podać 1. W przypadku podania kilku zostanie użyty pierwszy. |
| 22 | * |
| 23 | * @access public |
| 24 | * @return Int - id komentarza jeśli sukces, 0 w razie niepowodzenia |
| 25 | * @throws Exception |
| 26 | * @since 2.5.2 |
| 27 | */ |
| 28 | Int addComment(Array data); |
| 29 | |
| 30 | ?> |
| 31 | }}} |
| 32 | |
| 33 | ''' Przykłady wywołań: ''' |
| 34 | {{{ |
| 35 | #!php |
| 36 | |
| 37 | // Plik MyService.php umieszczony w apps/edokumenty. |
| 38 | // MyService.php |
| 39 | <?php |
| 40 | |
| 41 | define('EDOK_API_LOGIN', 'developer'); |
| 42 | define('EDOK_API_PASSWORD', 'developer'); |
| 43 | define('DEFAULT_ENTITY_SYMBOL', 'demo'); |
| 44 | |
| 45 | require_once('./classes/eDokumentyApi/EDokApiClient.inc'); |
| 46 | |
| 47 | $options = array( |
| 48 | 'location' => 'http://{host}:{port}/eDokumentyApi.php', |
| 49 | "uri" => "eDokumentyAPI", |
| 50 | 'encoding'=>'UTF-8' |
| 51 | ); |
| 52 | |
| 53 | $client = new EDokApiClient(NULL, $options); |
| 54 | $client->setUser(EDOK_API_LOGIN); |
| 55 | $client->setPass(md5(EDOK_API_PASSWORD)); |
| 56 | $header = new SoapHeader('eDokumentyAPI', 'entity_symbol', DEFAULT_ENTITY_SYMBOL); |
| 57 | $client->__setSoapHeaders($header); |
| 58 | |
| 59 | $data = array( |
| 60 | 'doc_id' => 1, |
| 61 | 'commnt' => 'Ważna wiadomość', |
| 62 | 'adduid' => 666 |
| 63 | ); |
| 64 | |
| 65 | |
| 66 | try { |
| 67 | $out = $client->addComment($data); |
| 68 | var_dump($out); |
| 69 | } catch(SoapFault $fault) { |
| 70 | var_dump($fault); |
| 71 | |
| 72 | if ($fault->faultcode < 100) { |
| 73 | trigger_error("SOAP Fault: (faultcode: {$fault->faultcode}, faultstring: {$fault->faultstring})", E_USER_ERROR); |
| 74 | } |
| 75 | } |
| 76 | |
| 77 | ?> |
| 78 | }}} |