Dodaj nową sprawe

Definicja Funkcji

Int createProcess(Array $data)

Definicja parametrów

Metoda przyjmuje 1 argument, jako tablica lub string JSON. Dostępne klucze:

Nazwa parametru	Typ parametru	Opis
dscrpt	string(wymagany)	Opis sprawy
rspuid	int	Identyfikator osoby odpowiedzialnej w sprawie (users.usr_id). Parametr zamienny z rspoid
briefcase_symbol	string(wymagany)	Symbol teczki. Parametr zamienny z dsexid
dsexid	int(wymagany)	Identyfikator teczki (doss_exctract_list.dsexid). Parametr zamienny z briefcase_symbol
rspoid	int	Identyfikator stanowiska osoby odpowiedzialnej w sprawie (organization_units:orunid). Parametr zamienny z rspuid
symbol	string	Symbol sprawy. Jeśli nie zostanie podany system nada go automatycznie
orunid	int	Identyfikator jednostki organizacyjnej, pod którą zostanie utworzona sprawa (organization_units:orunid).
prtpid	int	Identyfikator procedury (procedures_def.prtpid). Domyślnie sprawa jest tworzona z procedurą przypisaną do teczki
prtype	int	Typ sprawy: terminowa stała Domyślnie 2 czyli stała
comnts	string	Uwagi
contact_symbol	string	Symbol kontaktu (contacts:symbol). Parametr zamienny z contid
contid	int	Identyfikator kontaktu (contacts.contid). Parametr zamienny z contact_symbol
copeid	int	Identyfikator osoby kontaktowej (contact_persons:copeid)
is_fix	bool	Stan sprawy jeśli podamy TRUE automatycznie zostanie załatwiona (FALSE domyślna wartość)
fxtrid	int	To ilość dni na zakończenie sprawy począwszy od Daty wszczęcia
rel_to	int	Identyfikator sprawy nadrzędnej, jeżeli chcemy podpiąć sprawę jako podrzędną
pr_sta	string	Kod statusu właściwy dla sprawy. Jeśli przypisano statusy per teczka kod musi wskazywać na status przypisany do podanej teczki
forepa	numeric(12,2)	Prognozowana wartość wpływów.
currpa	numeric(12,2)	Waluta dla pola forepa
foreda	string	Prognozowana data sprzedaży
foreco	numeric(12,2)	Prognozowany koszt zlecenia
currco	string	Waluta dla pola foreco
credib	string	Szacunek (prawdopodobieństwo otrzymania zlecenia). Dane: 10%, 25%, 50%, 75%, 100%
devcid	int	Identyfikator urządzenia (devices.devcid) jeśli sprawa dotyczy urządzenie z serwisu
projid	int	Identyfikator projektu (processes.projid) jeśli sprawa należy do projektu
campid	int	Identyfikator kampanii (campaigns.campid) jeśli sprawa należy do projektu
optime	string	Data wszczęcia w formacie YYYY-MM-DD
cltime	string	Data zakończenia w formacie YYYY-MM-DD. Datę tę ustawia system podczas załatwiania sprawy (Opcja zakończ sprawę)
symgen	bool	Czy ma generować numer sprawy. Domyślnie generuje
proprg	bool	Propaguj uprawnienia przy zakładaniu podspraw. Opcja na zakładce Uprawnienia. Jeśli zostanie zaznaczona wtedy wszyscy pracownicy lub grupy uprawnieni w tej sprawie zostaną automatycznie dodani do podspraw w momencie ich zakładania pod warunkiem, że nie zadziałała żadna z pozostałych masek uprawnień
inidoc	int	Identyfikator dokumentu wszczynającego sprawę
cnt_nr	string	Numer konspektu np 1.4.8, 56.89.44
rspuid	int	Identyfikator pracownika odpowiedzialnego za sprawę (users.usr_id)
RUN_RIGHT_SETTER	bool	Czy ma dodawać uprawnionych do sprawy według masek uprawnień. Przyjmuje: FALSE - Nie TRUE Tak Domyślnie TRUE

Przykład użycia

 require_once('./classes/eDokumentyApi/EDokApi.inc');
$api = new \EDokApi();
try {
    $data = [
        'dscrpt' => 'przykładowa sprawa',
        'briefcase_symbol' => 'BZ.41',
        'rspuid' => 4,
    ];
    $prc_id = $api->createProcess($data);
} catch(\Exception $e) {
    throw new \Exception($e->getMessage());
}

Zwracane dane lub wyjątki

Metoda zwraca id sprawy (processes.prc_id) w przypadku sukcesu. Jeśli wystąpi błąd wtedy, zostanie zwrócony wyjątek.

Zwracane wyjątki w zależności od wywołania

• SOAP - SoapFault
• Lokalnie - Exception