Artykuły w kategorii

🟢 Walidacja za pomocą formuł

Zaktualizowano miesiąc temu

Zanim zaczniesz pracować z naszymi formułami w Google Sheets, dodatek Email and Phone validation by Foxentry musi zostać najpierw połączony z Twoim kontem. Ten przewodnik krok po kroku przeprowadzi Cię przez cały proces instalacji.

Na wstępie wyjaśnijmy terminologię: Do komórki w arkuszu zawsze wpisujesz formułę (zaczyna się od znaku =). Formuła wykorzystuje następnie konkretną funkcję Foxentry (np. EMAIL_VALIDATE), która wykonuje właściwe działanie.

⚠️ Ważne ostrzeżenie dotyczące pracy z formułami

Podczas korzystania z walidacji za pomocą formuł arkusza kalkulacyjnego, po zakończeniu weryfikacji należy zawsze nadpisać wyniki jako wartości statyczne. Jeśli tego nie zrobisz, formuły wyślą nowe żądanie do API przy każdej edycji arkusza, co spowoduje niepotrzebną utratę kredytów. Dlatego zawsze po walidacji skopiuj uzyskane wyniki (Ctrl + C) i wklej je w to samo miejsce wyłącznie jako wartości statyczne (Ctrl + Shift + V).

Walidacja adresów e-mail

Aby rozpocząć pracę z formułami, upewnij się, że masz połączony dodatek w Google Sheets za pomocą prawidłowego klucza API.
W celu walidacji e-maili zbuduj formułę, która wykorzystuje funkcję EMAIL_VALIDATE (1.). Przy użyciu bez dodatkowych parametrów automatycznie stosowana jest walidacja rozszerzona. Aby w pełni ją wykorzystać, wpisz formułę tak (2.):

=EMAIL_VALIDATE(e-mail, "extended", true, true)

Oprócz walidacji rozszerzonej dostępna jest również walidacja podstawowa ("basic"). Nie weryfikuje ona istnienia skrzynki, ale poprawia literówki i sprawdza format.

Pierwszy parametr "true" w formule określa, czy podczas rozszerzonej walidacji zezwalać na skrzynki tymczasowe; drugi dotyczy darmowych kont (freemail).
Rozpocznij walidację naciskając Enter. Następnie możesz łatwo przeciągnąć formułę w dół na wszystkie komórki, które chcesz zweryfikować.
Po przeprowadzeniu walidacji zaznacz komórki z odpowiedzią z API, skopiuj je za pomocą Ctrl + C i wklej z powrotem jako czyste wartości używając Ctrl + Shift + V. Zapobiega to powtarzaniu żądań przy każdej zmianie w pliku.

Rozpoznasz, że skopiowano poprawnie, jeśli na pasku formuły u góry zamiast polecenia =EMAIL_VALIDATE(...) zobaczysz statyczny tekst z odpowiedzią.

Z zwalidowanymi danymi możesz pracować dalej, dodając kolejne formuły z funkcjami pomocniczymi. Przetwarzają one już tylko pobraną odpowiedź API. Zalecamy rozpoczęcie od formuły =GET_PROPOSAL(API_odpowiedź), która przedstawi ostateczny werdykt dla danego wpisu.

Propozycja (Proposal)	Znaczenie
`valid`	Żądanie jest ważne (poprawne).
`validWithSuggestion`	Żądanie jest ważne, ale może istnieć lepszy wariant.
`invalid`	Żądanie jest nieważne.
`invalidWithPartialCorrection`	Żądanie jest nieważne, ale może zostać częściowo poprawione. Jednak poprawiona wartość nadal pozostaje nieważna.*
`invalidWithCorrection`	Żądanie jest nieważne, ale może zostać automatycznie poprawione do stanu poprawnego.
`invalidWithSuggestion`	Żądanie jest nieważne, ale system nie ma 100% pewności, czy powinno zostać automatycznie poprawione.
`invalidWithCorrectionWithSuggestion`	Żądanie jest nieważne i może zostać automatycznie poprawione, ale istnieje kilka prawidłowych opcji.
`unknown`	Żądanie nie mogło zostać przetworzone lub trwało to zbyt długo.

* Przykład: E-mail „[email protected]” zostaje poprawiony na „[email protected]”, jednak ta konkretna skrzynka nie istnieje, więc całkowity wynik pozostaje nieważny.

Aby zweryfikować aktualną ważność e-maila, użyj formuły z funkcją IS_VALID. Za pomocą parametru w formule decydujesz, którą część odpowiedzi sprawdzić:

• oryginalny e-mail ("result")
• poprawiona wersja ("resultCorrected")
• sugerowana poprawka ("suggestion")

Przykład formuły: =IS_VALID(API_odpowiedź, "resultCorrected"). Jeśli formuła zwraca błąd N/A, prawdopodobnie brakuje danych w oryginalnej odpowiedzi API.
Aby wydobyć poprawiony e-mail do oddzielnej komórki, wpisz formułę =GET_CORRECTED(API_odpowiedź) i odwołaj się do komórki zawierającej surową odpowiedź.
Jeśli chcesz wyświetlić tylko sugerowaną alternatywę (jeśli istnieje), użyj formuły =GET_SUGGESTION(API_odpowiedź).
Dzięki kolejnym funkcjom zagnieżdżonym w formułach łatwo sprawdzisz, czy dany adres to:

• =EMAIL_IS_FREEMAIL(...) – Freemail to darmowa usługa pocztowa publicznych dostawców, takich jak Gmail lub Yahoo.
• =EMAIL_IS_DISPOSABLE(...) – Jednorazowa skrzynka przeznaczona do krótkotrwałego użytku. Stanowi ryzyko ze względu na niską jakość kontaktów.
• =EMAIL_IS_CATCH_ALL_SERVER(...) – Serwer, który akceptuje e-maile wysyłane na dowolny adres w domenie, nawet jeśli konkretna skrzynka nie istnieje.
W przypadku trzech wyżej wymienionych funkcji możesz dodatkowo określić w parametrze formuły, dla której wersji adresu sprawdzasz status – oryginalnej ("result"), poprawionej ("resultCorrected") lub sugerowanej ("suggestion").

Zalecamy zawsze sprawdzać najpierw wynik formuły GET_PROPOSAL (2.), która podpowie, z którą częścią odpowiedzi API warto pracować.

Walidacja numerów telefonów

Aby rozpocząć pracę z formułami dla telefonów, ponownie upewnij się, że dodatek jest prawidłowo połączony z Twoim kluczem API.
Aby sprawdzić numer telefonu, zbuduj w komórce formułę używając jednej z dwóch głównych funkcji:

• =PHONE_VALIDATE(...) – jeśli masz numer wraz z numerem kierunkowym w jednej komórce,
• =PHONE_VALIDATE_WITH_PREFIX(...) – jeśli numer kierunkowy i właściwy numer są w dwóch oddzielnych komórkach.

Domyślnie używana jest walidacja rozszerzona. Aby użyć walidacji podstawowej, dodaj do formuły parametr "basic". Rozpocznij walidację naciskając Enter.
Podobnie jak w przypadku e-maili, zaznacz komórki z odpowiedzią, skopiuj je (Ctrl + C) i od razu wklej z powrotem jako wartości (Ctrl + Shift + V). Chroni to Twoje kredyty przed niepożądanym zużyciem. Formuła znika z komórki i zostaje zastąpiona statycznym tekstem odpowiedzi.
Do dalszej pracy z odpowiedzią zalecamy rozpoczęcie od formuły =GET_PROPOSAL(API_odpowiedź), która zwięźle podsumowuje ostateczny wynik weryfikacji.
Ważność numeru telefonu zweryfikujesz funkcją IS_VALID. Parametrem w formule decydujesz, którą część sprawdzić:

• ważność oryginalnego numeru ("result")
• ważność poprawionej wersji w formacie międzynarodowym ("resultCorrected")
• sugerowaną poprawkę ("suggestion")
Jeśli interesuje Cię konkretny tekst poprawionego numeru lub proponowany wariant, odwołaj się do komórki odpowiedzi w formułach GET_CORRECTED lub GET_SUGGESTION.
Foxentry potrafi formatować telefony według standardów. Zbuduj formułę z funkcją PHONE_GET_FORMAT, która przyjmuje jeden z czterech argumentów:

• "RAW" – surowy format numeryczny bez spacji
• "National" – format lokalny stosowany w danym kraju
• "E.123" – międzynarodowy standard formatowania
• "E.164" – domyślny format międzynarodowy
Przy włączonej rozszerzonej walidacji (extended), formuła =PHONE_GET_TYPE(API_odpowiedź) od razu podpowie Ci, czy masz do czynienia z numerem komórkowym, czy stacjonarnym.
Podobnie, w trakcie rozszerzonej walidacji, formuła =PHONE_GET_CARRIER(API_odpowiedź) potrafi wykryć operatora obsługującego dany numer telefonu.