🟢 Validace pomocí vzorců

Než začnete v tabulkách Google Sheets pracovat s našimi vzorci, je nutné mít doplněk E-mail and Phone Validation by Foxentry propojený s vaším účtem. Pokud jste to ještě neudělali, celým procesem vás provede tento návod na instalaci.

Pojďme si na úvod ujasnit terminologii: Do buněk v tabulce vždy zapisujete vzorec (začíná znakem =). Vzorec pak v sobě využívá konkrétní Foxentry funkci (např. EMAIL_VALIDATE), která provede samotnou akci.

Validace e-mailových adres

1. Pro zahájení práce se vzorci se nejprve ujistěte, že máte doplněk v Google Sheets propojený platným API klíčem.
   

   
   

2. K samotné validaci e-mailů sestavte vzorec, který využívá funkci EMAIL_VALIDATE (1.). Při použití bez dalších parametrů se automaticky aplikuje rozšířená validace. Pro její plné využití zadejte vzorec takto (2.):
   
   =EMAIL_VALIDATE(e-mail, "extended", true, true)
   
   Kromě rozšířené validace existuje i základní ("basic"). Ta vám sice neposkytne detaily o schránce ani neověří, zda reálně přijímá zprávy, ale opraví překlepy a zkontroluje formát.
   
   První parametr "true" ve vzorci určuje, zda má systém při rozšířené validaci povolit dočasné schránky, druhý parametr "true" se týká freemailů.
   

   
   

3. Validaci spusťte stisknutím klávesy Enter. Vzorec pak můžete snadno roztáhnout dolů na všechny buňky s e-maily, které potřebujete ověřit.
   

   
   

4. Po dokončení validace označte buňky s odpovědí API, zkopírujte je pomocí Ctrl + C a vložte zpět jako čisté hodnoty pomocí Ctrl + Shift + V. Zabráníte tím opakovanému volání API při každé změně souboru.
   
   Že se to povedlo, poznáte tak, že v řádku pro vzorce nahoře uvidíte místo příkazu =EMAIL_VALIDATE(...) statický text s odpovědí.
   

   
   

5. S validovanými daty můžete dále pracovat zadáváním dalších vzorců se sekundárními funkcemi. Ty už pouze zpracovávají staženou API odpověď. Doporučujeme začít vzorcem =GET_PROPOSAL(API_odpoved), který vám sdělí jasný verdikt nad daným údajem.
   

   
   

   Návrh (Proposal)	Význam
   valid	Požadavek je platný.
   validWithSuggestion	Požadavek je platný, ale může existovat lepší varianta.
   invalid	Požadavek je neplatný.
   invalidWithPartialCorrection	Požadavek je neplatný, ale lze jej částečně opravit. I po opravě je však hodnota stále neplatná.*
   invalidWithCorrection	Požadavek je neplatný, ale lze jej automaticky opravit do platného stavu.
   invalidWithSuggestion	Požadavek je neplatný a validátor si není 100% jistý, zda by se měl automaticky opravit.
   invalidWithCorrectionWithSuggestion	Požadavek je neplatný a lze jej automaticky opravit, ale existuje více platných možností.
   unknown	Požadavek se nepodařilo zpracovat nebo to trvalo příliš dlouho.

   * Příklad: E-mail „[email protected]“ je opraven na „[email protected]“, nicméně tato konkrétní schránka neexistuje, takže celkový výsledek zůstává neplatný.

6. Pro ověření aktuální platnosti e-mailu slouží vzorec s funkcí IS_VALID. Sami si ve vzorci určíte, u jaké části odpovědi chcete platnost zkoumat:
   
   • původní e-mail ("result")
   • opravená verze ("resultCorrected")
   • navrhovaná oprava ("suggestion")
   
   Příklad vzorce: =IS_VALID(API_odpoved, "resultCorrected"). Pokud vzorec vrátí chybovou hodnotu N/A, pravděpodobně chybí data v původní odpovědi API.
   

   
   

7. K získání konkrétního opraveného e-mailu do čisté buňky napište vzorec =GET_CORRECTED(API_odpoved) a jako parametr odkažte na buňku se surovou odpovědí.
   

   
   

8. Pokud chcete vypsat pouze navrhovanou alternativu údaje (pokud existuje), využijte vzorec =GET_SUGGESTION(API_odpoved).
   

   
   

9. Díky dalším funkcím vloženým do vzorců snadno zjistíte, zda je daná e-mailová adresa:
   
   • =EMAIL_IS_FREEMAIL(...) – Freemail je bezplatná služba od veřejných poskytovatelů jako Seznam, Gmail nebo Yahoo.
   • =EMAIL_IS_DISPOSABLE(...) – Jednorázová dočasná schránka pro krátkodobé použití. Přináší riziko nekvalitních kontaktů a častého zneužití.
   • =EMAIL_IS_CATCH_ALL_SERVER(...) – Nastavení serveru, které přijme e-mail zaslaný na jakoukoli adresu v doméně, i když daná konkrétní schránka fyzicky neexistuje.
   

   
   

10. U výše zmíněných tří funkcí můžete navíc ve vzorci jako parametr specifikovat, pro kterou verzi adresy chcete stav ověřit – původní ("result"), opravenou ("resultCorrected") nebo navrhovanou ("suggestion").
    
    Doporučujeme vždy nejprve zkontrolovat výsledek vzorce s GET_PROPOSAL (2.), který vám napoví, s jakou částí odpovědi API má smysl dále pracovat.
    

    
    

Validace telefonních čísel

1. Pro zahájení práce se vzorci pro telefony se opět ujistěte, že je doplněk správně propojen s vaším API klíčem.
   

   
   

2. K validaci čísel můžete v buňce sestavit vzorec pomocí jedné ze dvou hlavních funkcí:
   
   • =PHONE_VALIDATE(...) – pokud máte číslo i předvolbu v jedné společné buňce,
   • =PHONE_VALIDATE_WITH_PREFIX(...) – pokud máte předvolbu a samotné číslo oddělené ve dvou buňkách.
   
   V základu se automaticky používá rozšířená validace. Pokud chcete pouze základní, přidejte do vzorce parametr "basic". Validaci odstartujete klávesou Enter.
3. Stejně jako u e-mailů, označte buňky s odpovědí, zkopírujte je (Ctrl + C) a ihned je vložte zpět jako hodnoty (Ctrl + Shift + V). Chráníte tím své kredity před nechtěným propálením. Vzorec se z buňky vymaže a nahradí ho statický text odpovědi.
   

   
   

4. Pro další práci s odpovědí opět doporučujeme začít vzorcem =GET_PROPOSAL(API_odpoved), který vám jasně shrne konečný výsledek kontroly.
   

   
   

5. Platnost telefonního čísla zjistíte funkcí IS_VALID. Parametrem ve vzorci si určíte, kterou část odpovědi prověřit:
   
   • platnost původního čísla ("result")
   • platnost opravené verze v mezinárodním formátu ("resultCorrected")
   • navrhovanou opravu ("suggestion")
   

   
   

6. Pokud vás zajímá konkrétní text opraveného čísla nebo navrhované varianty, vložte odkaz na buňku s odpovědí do vzorce s funkcí GET_CORRECTED nebo GET_SUGGESTION.
   

   
   

7. Foxentry umí telefony formátovat podle standardů. Pro jejich vypsání sestavte vzorec s funkcí PHONE_GET_FORMAT, která jako další parametr přijímá tyto čtyři formáty:
   
   • "RAW" – surový číselný formát bez mezer
   • "National" – lokální formát obvyklý v dané zemi
   • "E.123" – mezinárodní standardizovaný formát
   • "E.164" – výchozí mezinárodní formát
   

   
   

8. Máte-li aktivní rozšířenou validaci (extended), vzorec =PHONE_GET_TYPE(API_odpoved) vám ihned prozradí, zda se jedná o mobilní telefon nebo pevnou linku.
   

   
   

9. Podobně vám při rozšířené validaci dokáže vzorec =PHONE_GET_CARRIER(API_odpoved) detekovat operátora, pod kterého dané telefonní číslo spadá.