Generovanie linkov

Vo webovom klientovi ERPIO App je možné vygenerovať link na vybrané akcie, pomocou ktorého sa otvorí rovnaký obsah ako bol zobrazený pri generovaní linku. Link vyžaduje prihlásenie používateľa.

Linky je možné generovať pre akcie typu:

NavigateTo – zobrazí tabuľku s údajmi
Edit – zobrazí editor s možnosťou zápisu údajov
Detail – zobrazí vybrané údaje v detailnom zobrazení – POZOR – pre fungovanie linku je potrebné, aby akcia typu Detail mala nastavenú podmienku napr ID = @ID, inak link nebude funkčný a vyvolá chybu

Konfigurácia

Do príslušnej akcie do metadát je potrebné pridať vlastnosť IsPublicLinkAction s hotnodou true.

Následne po spustení akcie pribudne do užívateľského rozhrania ikona , pomocou ktorej je možné vygenerovať link.

Umiestnenie ikony pre akciu typu NavigateTo:

Umiestnenie ikony pre akciu typu Edit:

Umiestnenie ikony pre akciu typu Detail:

Po spusteni akcie na generovanie linku sa zobrazí okno s vygenerovaným linkom. Odtiaľto je možné link skopírovať do schránky, experimentálnou funkciou je možnosť použiť ERPIO skracovač linkov.

Použitím skracovača linkov získate link vo forme https://erpio.link/xxxxx.

V nastaveniach webovej aplikácie je možné zapnúť, aby sa vždy použil skracovač linkov.

Príklad vytvorenia linku v MS SQL

DECLARE @Data VARCHAR(MAX)

SELECT @Data = '{"IDAction":XXXX,"IDObject":XXXX,"IDDash":XXXX,"IDWorkspace":XXXX,"rData":{"ID":'+CAST(TabDokladyZbozi.ID AS VARCHAR(11))+',"FileName":"Doklad'+CAST(TabDokladyZbozi.PoradoveCislo AS VARCHAR(11))+'.pdf"}, "E1Key": "XXXXX", "Embedded": true}'
FROM TabDokladyZbozi WHERE TabDokladyZbozi.ID = @ID

DECLARE @Source VARBINARY(MAX)
        
SET @Source = CONVERT(VARBINARY(MAX), @Data)
SET @Data = CAST('' AS XML).value('xs:base64Binary(sql:variable("@source"))', 'varchar(max)')


SELECT @Data = 'https://web.erpio.app/pub/dataview/act1'+@Data+'?e1key=XXXX&sidebar=collapse'

IDAction – ID akcie, ktorú chcem spustiť
IDObject – ID sady, ku ktorej patrí akcia
IDDash – ID dashboardu, na ktory má práva používateľ
IDWorkspace – ID wokspace, do ktorého patria vyššie uvedené objekty
rData – parametre danej akcie – POZOR – neposielajú sa hodnoty parametrov ako ako keby údaje vybraneho riadku (čize názvy podľa stĺpca Column Value v parametroch akcie)
e1key – voliteľný parameter, ak nie je zadaný, tak otvorením linku sa najprv zobrazí prihlasovacia obrazovka a až po úspešnom prihlásení sa spustí akcia. Ak je vyplnený, tak sa akcia spustí v kontexte používateľa, ktorému patrí daný kľúč. Je možné ho pridať do objektu alebo priamo do url adresy. e1key používajte len v nutných prípadoch, môže spôsobiť bezpečnostné riziko v prípade nesprávneho použitia.
sidebar – toggle/collapse/expand – voliteľný parameter, ktorým je možné ovplyvniť stav hlavného (ľavého) menu vo webovej aplikácii
embedded – ak sa nastaví hodnota 1/true, tak sa skryje menu a horný toolbar webovej aplikácie. Je možné ho pridať do objektu (hodnoty true/false) alebo priamo do url adresy (hodnoty 1/0).

Vlastné linky

webový klient umožňuje vytvoriť vlastné linky vo formáte:

https://web.erpio.app/[IDWorkspace]/view/[Identifier]/[Parameter1]/[Parameter2]/[Parameter2]/[Parameter4]/[Parameter5]/

Namiesto kľúcového slova view je možné použiť aj alternatívu v. Parametre sú nepovinné, momentálne je možné použiť max. 5 parametrov.

Pre vlastné linky platia rovnaké pravidlá ako pre generované linky.

Konfigurácia

Nastavenia sa robia na úvodnej stránke Dashboard, cez voľbu Metadata.

Pridaním nového záznamu s názvom CustomLinks (Prop. Name) je možné zadať potrebnú konfiguráciu.

Konfigurácia sa zadáva ako JSON zápis poľa objektov. Čiže v rámci jedného workspace, môžete používať rôzne identifikátory s rôznymi nastaveniami. Objekt má nasledujúce vlatnosti:

Identifier – jedinečný identifikátor (v rámci workspacu), ktorý sa bude používať v linku
IDDash – ID dashboardu, na ktory má práva používateľ
IDObject – ID sady, ku ktorej patrí akcia
IDAction – ID akcie, ktorú chcem spustiť
E1Key – voliteľná vlastnosť, ak nie je zadaná, tak otvorením linku sa najprv zobrazí prihlasovacia obrazovka a až po úspešnom prihlásení sa spustí akcia. Ak je vyplnená, tak sa akcia spustí v kontexte používateľa, ktorému patrí daný kľúč. Je možné ho pridať do objektu alebo priamo do url adresy. e1key používajte len v nutných prípadoch, môže spôsobiť bezpečnostné riziko v prípade nesprávneho použitia.
Embedded – voliteľná vlastnosť – ak sa nastaví hodnota 1/true, tak sa skryje menu a horný toolbar webovej aplikácie. Je možné ho pridať do objektu (hodnoty true/false) alebo priamo do url adresy (hodnoty 1/0).

Príklad:

[
    {
        "Identifier": "issues",
        "IDAction": 94651,
        "IDDash": 2833,
        "IDObject": 28870
    },
    {
        "Identifier": "addissue",
        "IDAction": 94652,
        "IDDash": 2833,
        "IDObject": 28870,
        "E1Key": "XXXX", 
        "Embedded": true
    }
]

Príklady linkov:

https://web.erpio.app/1836/view/issues/GEN000001
https://web.erpio.app/1836/view/addissue

Hodnoty z Parametrov 1-5 sa napĺňajú do parametrov volanej akcie (podľa poradia). Napríklad link https://web.erpio.app/1836/view/issues/GEN000001 naplní do prvého parametra akcie (v tomto príklade je to parameter @Kod), hodnotu GEN000001.

Je možné do akcie pridať parameter @url, do ktorého sa naplní celá url daného volania. Dá sa to použiť ako napr. callback/redirect url z nejakej inej služby, kde potrebujem získať ďalšie parametre z url, napr. https://web8.erpio.app/213/view/test/aaaa?code=XXXXX&status=XXXX, tak hodnoty url parametrov ?code a &status viem získať len cez parameter akcie @url.

UPOZORNENIE

Generované aj vlastné linky môžu sprístupniť údaje, ktoré by postupnou navigáciou boli odfiltrované. V prípade, že prístupové práva riadite pomocou filtrov dát, je potrebné si urobiť kontrolu v akcii, ktorá sa volá pri spostení akcie (getter alebo OnBeforeEditor). Systémovo sú aj v tomto prípade strážené kategórie nastavené na dashboarde, sade, akcii.

Ako nastavím možnosť generovania linkov

POZOR – funguje len na webovom klientovi!

Generovanie linkov

Konfigurácia

Príklad vytvorenia linku v MS SQL

Vlastné linky

Konfigurácia

UPOZORNENIE