Dlaczego warto opisać nawet prosty scenariusz
Automatyzacja, która dziś wydaje się oczywista, za kilka miesięcy może być zagadką. Ktoś zmieni formularz, przeniesie skrzynkę pocztową albo poprawi treść wiadomości i nie będzie wiedział, które dalsze kroki zależą od tej decyzji. Sam widok połączonych bloków w narzędziu zwykle nie wyjaśnia, po co powstał proces ani kiedy nie powinien się uruchamiać.
Pomaga krótka karta automatyzacji: opis przeznaczenia, przebiegu i zasad wprowadzania zmian. Nie musi być rozbudowaną instrukcją techniczną. Powinna pozwolić osobie, która nie budowała scenariusza, odpowiedzieć na trzy pytania: co ma się wydarzyć, skąd pochodzą potrzebne informacje i jak rozpoznać, że wynik jest poprawny. Najlepiej przechowywać ją w miejscu dostępnym osobom odpowiedzialnym za proces, a nie wyłącznie na prywatnym koncie jego autora.
Zacznij od celu i granic działania
Na początku zapisz nazwę scenariusza oraz jednozdaniowy cel, na przykład: „Po przesłaniu formularza zapytanie trafia do wspólnej kolejki”. Dopisz zdarzenie uruchamiające, oczekiwany rezultat i sytuacje wyłączone z procesu. Jeśli automatyzacja obsługuje tylko jeden formularz, wskaż to wprost. Dzięki temu późniejsza zmiana na stronie nie zostanie omyłkowo uznana za część istniejącego rozwiązania.
Wymień narzędzia biorące udział w procesie i opisz ich role zwykłymi słowami: formularz zbiera zapytanie, system zapisuje je w kolejce, a poczta wysyła powiadomienie pracownikowi. Zaznacz, kto odpowiada za treść komunikatu, a kto za ustawienia techniczne. Jeśli jedna osoba pełni obie role, również warto to zapisać. Celem nie jest tworzenie formalnej struktury, lecz uniknięcie sytuacji, w której nikt nie wie, do kogo zgłosić potrzebną poprawkę.
Opisz dane i wynik bez kopiowania informacji klientów
Karta powinna wskazywać, jakie pola są potrzebne do działania scenariusza i dokąd trafiają. Wystarczy opis typu: „adres e-mail służy do odpowiedzi, temat wiadomości trafia do kolejki”. Nie wklejaj do dokumentacji prawdziwych zapytań, danych logowania ani kluczy dostępu. Jeśli potrzebny jest przykład, użyj wymyślonych danych. Dokument ma ułatwiać zrozumienie procesu, a nie tworzyć kolejne miejsce przechowywania informacji o klientach.
Zapisz również, po czym można poznać poprawny rezultat. Może nim być nowy wpis w kolejce o określonym statusie albo powiadomienie zawierające numer zapytania, lecz nie pełną treść wiadomości. Taki opis pomaga sprawdzić jakość działania bez przeglądania większej ilości danych, niż jest to konieczne. Jeżeli scenariusz ma ograniczenia, na przykład nie obsługuje załączników, umieść je obok opisu wyniku.
Prowadź krótki rejestr zmian
Przy każdej istotnej poprawce dopisz, co zmieniono, dlaczego i kto to zrobił. Przydatna jest również informacja o tym, jaki rezultat sprawdzono po zmianie. Nie trzeba opisywać każdego kliknięcia. Zapis „zmieniono adres odbiorcy powiadomień; sprawdzono dostarczenie przykładowego zapytania” będzie bardziej użyteczny niż długa lista ustawień bez kontekstu.
Przed edycją zanotuj poprzednią wartość ważnego ustawienia lub zachowaj kopię konfiguracji, jeśli narzędzie na to pozwala. Ułatwi to powrót do wcześniejszego sposobu działania, gdy poprawka przyniesie nieoczekiwany skutek. Po zmianie sprawdź nie tylko to, czy scenariusz się uruchamia, ale też czy końcowy wpis lub wiadomość ma właściwą treść i trafia do właściwej osoby.
Utrzymuj dokumentację na tyle małą, by była aktualna
Najprostszy szablon może zmieścić się na jednej stronie: cel, wyzwalacz, kolejne kroki, używane pola, oczekiwany wynik, osoba odpowiedzialna i historia zmian. Jeśli firma ma kilka scenariuszy, nadaj im czytelne nazwy i trzymaj karty w jednym miejscu. Unikaj szczegółów, które szybko się starzeją, o ile nie są potrzebne do obsługi procesu.
Warto przyjąć prostą zasadę: zmiana automatyzacji jest zakończona dopiero wtedy, gdy poprawiono również jej kartę. Przy okazji okresowego przeglądu można sprawdzić, czy opis nadal zgadza się z ustawieniami i czy wskazana osoba wciąż zajmuje się procesem. Taka dokumentacja nie zastąpi kontroli działania, ale sprawi, że poprawki będą mniej zależeć od pamięci jednej osoby.
