ESO9 wiki

Pokud je implementováno napojení ESHOPu přes obecný konektor (dokumentace: Konektor ESO9-eshop) je možné modifikovat jeho chování PROFI procedurami.

V metodách pro čtení doplněn aparát pro tzv. BlackBox – text s libovolným obsahem pro PROFI implementace rozhraní. Na obsahu atributu BlackBox se domluví implementátor ESO9 a implementátor ESHOPu, bez potřeby měnit rozhraní konektoru.

CREATE OR ALTER function fnESHOP_BlackBox_ALL (
@IDESHOP	int = NULL,
@ID		int = NULL,
@Tabulka    	varchar(30) = NULL)
returns varchar(max)

V zapisujících metodách (ZapisObj, ZapisSubjektVse) je možné zpracovat i vstupní Blackbox z ESHOPU a předat tak další specifické údaje do ESO9.

CREATE OR ALTER PROCEDURE spESHOP_BlackBoxZapis 
	@ID		int		= NULL, -- ID v tabulce
	@Tabulka    	varchar(30)	= NULL, -- jméno tabulky, do které ESHOP zapisuje
	@BlackBox	varchar(max)	= NULL, -- obsah Blackboxu, volá se jen když není NULL
	@IDESHOP	int		= NULL, -- ID eshopu, ze kterého je voláno
	@vlNalezena	smallint	= NULL	 -- 0-nenalezena, vložení; 1-nalezena

Pokud existuje procedura s názvem spESHOP_ZapisSubjekt_After, zavolá se po založení subjektu v metodě ZapisSubjektVse (tedy ještě před založením osoby a adresy v tomto subjektu).
Zároveň musí procedura mít právo EXECUTE v roli/účtu, pod kterým webová služba na SQL server přistupuje (nebo se do ní dopíše WITH EXECUTE AS OWNER).

CREATE OR ALTER PROCEDURE dbo.spESHOP_ZapisSubjekt_After
 @IDSUBJEKT int = NULL,     -- zakladany / modifikovany subjekt
 @IDESHOP   int = NULL,     -- ESHOP ze ktereho bylo volano
 @vlTypOper smallint = NULL -- typ operace: 
                                     1=insert, 
                                     2=update, (3=delete-nenastane), 
                                     10=po založení všeho

Procedura volá ještě jednou po založení všeho, co přišlo v metodě ZapisSubjektVse, tedy i po založení osob a adres. Volá se s parametrem @vlTypOper = 10.

V metodě zakládání objednávky (ZapisObj) se ještě před založením objednávky volá procedura spESHOP_ZapisObjHDOK_Before, pokud v databázi existuje.
Může se například použít pro vyhledání vzoru dokladu, pokud nestačí jeho určení zařazením do číselníku ESHOP nebo do parametru ESX_VZOROBJ.

CREATE OR ALTER PROCEDURE dbo.spESHOP_ZapisObjHDOK_Before
	@IDESHOP	int		= NULL, 
	@IDHDOK		int		= NULL, -- má hodnotu, jen pokud se dohledalo podle @FGUID_OBJ
	@FGUID_OBJ	varchar(40) 	= NULL, -- od verze 2.0
	@KOD_MENY	varchar(10) 	= NULL,	-- 
	@CIS_DOK	varchar(20) 	= NULL,	-- pokud se má převzít číslo dokladu z ESHOPU
	@CIS_DOK_ESHOP	varchar(30) 	= NULL,	-- do JEJICH_CISDOK
	@V_SYM		varchar(30) 	= NULL,	-- VAR SYMBOL, 
	@BlackBox	varchar(max) 	= NULL,-- obsah black boxu z ESHOPU
	@vlNalezena	smallint	= NULL, -- 0=nenalezena, 1=nalezena
	@IDHDOK_VZOR	integer 	= NULL OUT, -- pripadna upravena hodnota
	@ERRTEXT	varchar(4000) 	= NULL OUT, 
	@vlResult	smallint 	= NULL OUT  -- 0=pokračovat, 
                                                       1=chyba, text chyby v @ERRTEXT, 
                                                       -1=nepokračovat v zakládání dokladu, ale nekončit chybou

Od verze 2.7.3 lze parametry procedury rozšířit o ID přicházející do objednávky:

	@IDSUBJEKT	INT         = NULL,
	@IDSUBJOSOBA	INT         = NULL,
	@IDSUBJADR_F	INT         = NULL,
	@IDSUBJADR_D	INT         = NULL

Pokud existuje procedura s názvem spESHOP_ZapisObjHDOK_After, zavolá se po založení objednávky v metodě ZapisObj. Zavolá se 2x. Popis u metody ZapisObj.

CREATE OR ALTER PROCEDURE dbo.spESHOP_ZapisObjHDOK_After
 @IDHDOK     int, -- ID založené objednávky
 @IDESHOP    int, -- ID eshopu, ze kterého je voláno
 @vlNalezena smallint, -- 0-nenalezena, proběhlo vložení objednávky; 
                          1-nalezena, neproběhla akce v datech existující objednávky
 @vlAkce     smallint  -- 0=po založení hlavičky, 
                          1=po založení poslední složky (neproběhne pokud @vlNalezena=1)

Rozšířená verze procedury spESHOP_ZapisObjHDOK_After, pro volání @vlAkce = 1, tedy po založení objednávky (od verze 2.7.2):

@VLUHRAZENO  smallint  -- Například: 0=ne, 1=ano, 2=částečně – podle domluvy s eshopem 
@HDKUHRADEKC money     -- celková cena objednávky