 Yandex Forms

Integracja z Yandex Forms (dawniej Яндекабрьс Формы) umożliwia automatyczne tworzenie certyfikatów, dyplomów oraz innych dokumentów w DiMaker na podstawie danych wypełnionych w formularzu Yandex Forms.

Obecna integracja pozwala nie tylko na realizację żądania utworzenia i wysłania dokumentu e-mailem, ale także na umożliwienie pobrania dokumentu przez użytkownika zaraz po jego wygenerowaniu.

Tworzenie integracji

Na stronie integracji z Yandex Forms należy utworzyć nową integrację i ją aktywować.

Dla każdego nowego formularza można stworzyć osobną integrację. Jeśli jednak parametry integracji będą identyczne, można użyć tej samej integracji dla wielu formularzy Yandex Forms.

Konfiguracja Yandex Forms

W Yandex Forms należy przejść do sekcji „Integracja” i dodać nowe działanie do grupy działań - żądanie API. Przy tej konfiguracji można pozostawić wysyłanie maili włączone lub je wyłączyć.

Sekcja „Integracja” w Yandex Forms

W menu wyboru metody wysyłania danych przez API należy wybrać „Żądanie z określoną metodą”.

Menu wyboru metody wysyłania danych w Yandex Forms

W oknie konfiguracji żądania należy wskazać:

• URL - https://gramotadel.express/api/v1/yandex-forms/
• Metoda żądania - POST

  URL i metoda żądania w Yandex Forms

• Treść żądania - dane wymagane do stworzenia dokumentu w formacie parametr_wartość=wartość_parametru, gdzie każdy parametr jest w nowej linii.
  • doc_id* - ID dokumentu (ciąg 36 znaków), który zostanie użyty do stworzenia pliku. ID można znaleźć w pasku adresu podczas otworzenia dokumentu. Dokument nie może znajdować się w koszu.

  • mask_* - Dane z ankiety, które zostaną wykorzystane do tworzenia dokumentów. Każdy parametr powinien zaczynać się od „mask_”, a następnie zmienna bez znaku % w dokumencie DiMaker.

    Na przykład dane z mask_name zostaną wstawione do zmiennej %name, a mask_score do %score. Aby określić e-mail, użyj mask_email, a dla nazwy pliku - mask_filename. Wszystkie zmienne w dokumencie muszą być zapisane w łacinie.

  • mail_id - ID szablonu wiadomości e-mail (ciąg 36 znaków). Jeśli brak tej zmiennej, wiadomość nie zostanie wysłana.
  • email_send - Czas wysyłki wiadomości z dokumentem.

  • folder_id - ID folderu, gdzie pliki będą przechowywane. Jeśli folder nie istnieje, zostanie automatycznie utworzony.

  • page_id - Numer strony (liczba lub ciąg znaków) dokumentu, jeśli zawiera on wiele stron. Można podać pojedynczy numer lub wiele (oddzielonych przecinkami).
• Nagłówki - token autoryzacyjny oraz uuid klienta potrzebny do działania formularza. Jeśli użytkownikowi nie udostępniamy opcji pobrania dokumentu, wystarczy token autoryzacyjny:
  • Header: Authorization, wartość: Bearer {token} z DiMaker
  • Header: X-Client-Uuid, wartość: parametr GET uuid
• Wyświetlanie komunikatów o wyniku akcji: wyłączone.

Podłączenie i test

W kolejnym kroku należy skopiować publiczny link do formularza z menu „Udostępnij” w Yandex Forms i wkleić go w pole „Adres formularza” w DiMaker.

Jeśli wszystko zostało skonfigurowane poprawnie, formularz zostanie pomyślnie połączony.

Pobieranie dokumentów

Integracja z Yandex Forms umożliwia udostępnienie użytkownikowi linku do pobrania pliku zaraz po wypełnieniu formularza.

Yandex Forms

W sekcji „Ustawienia” pod „Teksty i logika wysyłki” należy:

• Włączyć opcję „Przekierowanie na stronę”.
• W polu „Link do strony” podać https://dmkr.io/yg/
• W tekście przycisku wpisać np. „Pobierz Certyfikat”.
• Włączyć opcję „Przekierowanie wewnątrz ramki”.

DiMaker

Formularz Yandex Forms musi być otwierany przez kod wstawiony z DiMaker, a nie bezpośrednio przez link Yandex Forms.

Na stronie integracji w DiMaker można skopiować kod osadzania formularza, który powinien być wprowadzony na stronę, gdzie formularz ma się znajdować. W sekcji „Domena” należy podać adres domeny strony hostującej formularz.

Jak to działa

Po wypełnieniu formularza użytkownik zostaje przekierowany na stronę z opcją pobrania swojego pliku z danymi wprowadzonymi do formularza.

Inne integracje