Blog / Jak obejít omezení formulářů SAP FSM pomocí Google Forms

6. dubna 2022

Jak obejít omezení formulářů SAP FSM pomocí Google Forms

Inteligentní formuláře SAP FSM stále nejsou tak chytré, jak bychom si přáli. V případech, kdy je nabídka možností odpovědí závislá na hodnotě předchozího pole formuláře, má nástroj SAP FSM omezení. Naštěstí lze použít jednoduché a bezplatné Google forms.

FSM sice nabízí možnost vytvářet Smartformuláře přímo prostřednictvím nativního editoru, nicméně tento způsob má jednu velkou limitaci a tou je absence dynamického generování těchto protokolů na základě vyplněných údajů. (Mimo skrytí a zobrazení některých sekcí, přičemž dokáže reagovat pouze na data obsažená přímo ve Smartformuláři, ne např. na Materiál vytvořený na Aktivitě).

V případě jednoho z našich zákazníků z oblasti telekomunikací jsme se tak během tohoto projektu rozhlédli, po jiných flexibilnějších možnostech generování těchto protokolů. Jako nejideálnější řešení jsme zvolili integraci na Google Forms, která zpracovává a dynamicky doplňuje potřebné sekce, určuje design daného protokolu a ve výsledku generuje jeho PDF verzi spolu s jejím odesláním na zákazníka.

Pro odeslání potřebných informací do tohoto nástroje jsme proto vytvořili v SAP FSM byznys pravidlo, shromažďující všechny potřebné informace zajišťující také jejich příslušný formát očekávaný nástrojem Google Forms.

Definice byznys pravidla:

Nejdůležitějším nastavením v definici tohoto pravidla, je v tomto případě výběr možnosti použití plné podpory Javascriptových výrazů. Hned ze dvou důvodů:

Výběr možnosti bez podpory těchto výrazů je zastaralý (deprecated)
V dalších sekcích tohoto pravidla budeme potřebovat aktivně využívat Javascriptové funkce, pro správné naformátování dat odesílaných do Google Forms

overcoming-fsm-form-limitations-with-google-forms-1

Trigger (Spouštěč):

overcoming-fsm-form-limitations-with-google-forms-2

Je možné podle potřeb použít jakýkoli. V našem případě jsme z několika důvodů, ať už procesních, tak optimalizace výkonu, zvolili následující:

Variables (proměnné)

overcoming-fsm-form-limitations-with-google-forms-3

V tomto blogu se nebudeme věnovat všem, ale soustředíme se pouze na ty, které zajišťují odeslání podpisů technika a zákazníka.

Definice a komentář jednotlivých proměnných

Název proměnné: elements

Typ proměnné: Array

Definice CoreSQL:

SELECT cie.value, cie.elementId, cie.description FROM ChecklistInstance ci

JOIN ChecklistInstanceElement cie ON ci.id = cie.checklistInstance

WHERE cie.elementId IN (‚z_f_sf_podpisucas‘, ‚z_f_sf_podpistech‘, ‚z_f_sf_typvyjazdu‘, ‚z_f_sf_techpoznamka‘) AND ci.object.objectId = ${activity.id}

DTO: ChecklistInstance.18;ChecklistInstanceElement.17

Komentář: V rámci zadání od našeho zákazníka bylo nezbytné, aby výsledný PDF protokol obsahoval podpisy obou stran (technika a zákazníka). Pro jejich odeslání do Google Forms, jsme tak potřebovali z datatabáze systému FSM načíst jejich data v binární podobě enkódovaná, jako base64 řetězec. Pro tento účel nejprve vytahujeme ze smartformuláře (checklistu) ID záznamů těchto obrázků uložených v objektu Attachment, na základě názvů těchto elementů (‚z_f_sf_podpistech‘ a ‚z_f_sf_podpisucas‘), které jsme zadefinovali v rámci SmartServu. Pomocí těchto ID

Jako část requirement z našeho customer, to bylo necessary, že v důsledku dokumentu protokolu protokolu byly uvedeny signatures of both parties (technické and customer). To send them do Google formuláře, we needed to retrieve their data from the FSM database v binární formě-encoded jako base64 string. Pro tento purpose, jsme první extrakt z inteligentního formuláře (checklist) záznamu ID těchto obrazů zastoupených v objektu objektu, založeného na názvech těchto prvků (‚z_f_sf_podpistech‘ and ‚z_f_sf_podpisucas‘), které jsou definované out by the technician executing the Service call. Pomocí těchto ID, jsou získány jejich záznamy z objektu objektu pomocí „signatureCustomer“ and „signatureTechnician“ variables:

Název proměnné (Variable Name): signatureCustomer

Typ proměnné (Variable Type): Object

Typ objektu (Object Type): Attachment

Definice CoreSQL (CoreSQL WHERE Clause):

id = ${elements.filter(function (e) { return e.elementId === ‚z_f_sf_podpisucas‘ })[0].value}
(proměnná signatureTechnician se liší pouze v CoreSQl WHERE Clause:

signatureTechnician.id = ${elements.filter(function (e) { return e.elementId === ‚z_f_sf_podpistech‘ })[0].value}

Poznámka: V případě, že nám stačí pouze ID objektu Attachment pro dotažení binárních dat podpisů a nepotřebujeme zasílat dál, žádnou jinou informaci nacházející se v záznamu objektu Attachment, můžeme tyto dvě proměnné vynechat.

Pro načtení dat jednotlivých podpisů v pravidle, používáme dvě akce typu FSM Webhook volající /data API systému FSM:

Akce dotahující podpis zákazníka do proměnné „signatureCustomerContent“
Akce dotahující podpis technika do proměnné „signatureTechnicianContent“, vypadá stejně, jako signatureCustomerContent, liší se pouze v použitém ID pro načítání podpisu.

Komentář: V této akci využíváme proměnnou ${signatureCustomer.id} – ID záznamu podpisu v tabulce Attachment (Přílohy), pro vytažení podpisu zákazníka z aktuálně zpracovávané aktivity.

Kromě této proměnné pak pro snadnější přenositelnost pravidla mezi systémy využíváme systémové proměnné – ${account.name} a ${company.name} + naše vlastní ${clientID} a ${clientSecret} o kterých se můžete více dočíst tu.

Vrácené hodnoty „signatureCustomerContent“ a „signatureTechnicianContent“ obsahují binární data podpisů ve znakové sadě Latin1, které následnou akcí odešleme do Google Forms. V dané akci data ještě upravujeme do formátu dle požadavků Google Forms.

Akce pro odeslání dat do Google Forms

Action: Webhook

Execution Count: 1

Method: Post

URL: ${google-forms-api-url}

Headers: žádné

Content-Type: application/json

Body:

//github.com/beatgammit/base64-js

function latin1ToUint8Array(str) {
return Array.prototype.map.call(str, function (c) { return c.charCodeAt(0) });
}

function findWithFallback(arr, fn) {
var item = arr.filter(fn);
return item.length ? item[0] : {};
}

function MissingValue() { return this.constructor === MissingValue ? this : new MissingValue() }
MissingValue.ensure = function(value) { return value || MissingValue() }
MissingValue.prototype.toString = function() { return ‚[object MissingValue]‘ }
MissingValue.prototype.toJSON = function() { return null }

// fallbacks – we want to avoid ‚cannot read property … of undefined‘ error
serviceCall = MissingValue.ensure(serviceCall);
contract = MissingValue.ensure(contract);
businessPartner = MissingValue.ensure(businessPartner);
address = MissingValue.ensure(address);
technician = MissingValue.ensure(technician);
signatureTechnician = MissingValue.ensure(signatureTechnician);
signatureCustomer = MissingValue.ensure(signatureCustomer);
elements = elements || [];
creds = creds || [];
devices = devices || [];

JSON.stringify({
„event“: „pdf“,
„podpis_obrazok_1“: signatureTechnician instanceof MissingValue
? null
: base64js.fromByteArray(latin1ToUint8Array(signatureTechnicianContent)),
„podpis_typ_1“: signatureTechnician.type,
„podpis_obrazok_2“: signatureCustomer instanceof MissingValue
? null
: base64js.fromByteArray(latin1ToUint8Array(signatureCustomerContent)),
„podpis_typ_2“: signatureCustomer.type,
})
}

(Zkrácený příklad s vynecháním mapování zbylých proměnných)

Tato akce může na první pohled vypadat hrozivě, avšak po jejím vysvětlení v následujících řádcích na ni podle nás rychle změníte názor.

Jako první do očí hned udeří blok kódu v úvodu těla této akce: https://github.com/beatgammit/base64-js

Tato část definuje javascriptovou funkci, pro enkódování binárních dat obrázků podpisů do base64 formátu, ve kterém posíláme podpisy do Google Forms. Tuto konverzi provádíme, aby během odesílání těchto dat byla zachována jejich integrita. Jelikož systém SAP FSM, v rámci pravidel nepodporuje import, zda instalaci javascriptových modulů, tak jak jsme na to zvyklí při standardním vývoji aplikací, bylo v našem případě třeba zadefinovat relevantní funkce, takto na začátku body akce. Pro zachycení zdroje této definice obsahuje naše body v zakomentované sekci odkaz na GitHub repository ze které pochází – https://github.com/beatgammit/base64-js.

Funkce latin1ToUint8Array pak zajišťuje správnou znakovou sadu pro použití base64 enkódování přes funkci fromByteArray:

function latin1ToUint8Array(str) {
return Array.prototype.map.call(str, function (c) { return c.charCodeAt(0) });
}

Pro úspěšné sběhnutí metody JSON.stringify() je třeba zadefinovat záložní hodnoty, pro případ, že by byly použity proměnné prázdné, jinak by při této metodě mohlo dojít k chybě – ‚cannot read property … of undefined‘, jejímž následkem by bylo odeslání dat do Google Forms neúspěšné. Záložní hodnoty zajišťují následující odstavce:

function findWithFallback(arr, fn) {
var item = arr.filter(fn);
return item.length ? item[0] : {};
}

// fallbacks – we want to avoid the ‚cannot read property … of undefined‘ error
serviceCall = MissingValue.ensure(serviceCall);
contract = MissingValue.ensure(contract);
businessPartner = MissingValue.ensure(businessPartner);
address = MissingValue.ensure(address);
technician = MissingValue.ensure(technician);
signatureTechnician = MissingValue.ensure(signatureTechnician);
signatureCustomer = MissingValue.ensure(signatureCustomer);
elements = elements || [];
creds = creds || [];
devices = devices || [];

V závere body našej akcie potom už iba ostáva namapovať jednotlivé premenné na atribúty API vytvorenej na strane Google Forms, spolu s konverziou Javascriptových objektov na JSON string pomocou metódy JSON.stringify():

Zkrácený příklad s vynecháním mapování zbylých proměnných)

Jak můžete vidět, tak právě v tomto posledním kroku využíváme výše zadefinované funkce „fromByteArray“ a „latin1ToUint8Array“, pro správné enkódování dat podpisů, tak aby mohly být z těchto informace na druhé straně opět zrekonstruovány do jejich grafické podoby, kterou lze použít ve finálním vygenerovaném .pdf protokolu.

Tomáš Potzy, CX Consultant

Blog

8. března 2022

Jak obejít omezení formulářů SAP FSM pomocí Google Forms

Variables (proměnné)

Akce pro odeslání dat do Google Forms

Blog

Omnichannel 101: o co jde a jaké jsou výhody?

Proč prodejní týmy zaostávají za rostoucími očekáváními zákazníků: Průvodce

Zvýšená zákaznická zkušenost a očekávání zůstanou i po pandemii