Aby przedstawić dane z docu tools w raporcie pdf lub excel, używamy symboli zastępczych. Te symbole zastępcze służą jako znaczniki wewnątrz Twojego Szablonu i wskazują, gdzie dane z docu tools powinny zostać wstawione. Możesz na przykład utworzyć symbol zastępczy takie jak #{{project-name}} w Szablonie, który podczas generowania Raportu zostanie dynamicznie wypełniony rzeczywistą nazwą projektu w docu tools.
Istnieją różne grupy symboli zastępczych dla Excela i dla Worda, ponieważ niektóre są dostępne tylko w jednym z nich. Dzięki efektywnemu wykorzystaniu tych symboli zastępczych możesz tworzyć dynamiczne i elastyczne Szablony, które dokładnie przedstawiają dane z Twoich projektów, Raportów i zadań.
Składnia i projektowanie symboli zastępczych
Wszystkie symbole zastępcze są umieszczone w podwójnych nawiasach klamrowych #{{ }} i muszą dokładnie przestrzegać określonej składni, niezależnie od języka używanego w tekście Szablonu: Na przykład #{{pin-number}} jest prawidłowym symbolem zastępczym, który pobiera Numer wybranej Pinezki. Symbole zastępcze takie jak {pin-number}, #{{pinnummer}} czy #{{pinnumber}} są jednak nieprawidłowe z powodu błędnej składni i nie będą działać.
Symbole zastępcze nie działają, gdy zawierają spacje. Aby utworzyć symbol zastępczy dla tytułu składającego się z wielu słów, zastąp spację myślnikiem -, na przykład użyj #{{dataset-room-info}} zamiast #{{dataset-Room info}}.
Wygląd wynikowy jest definiowany na podstawie formatowania symbolu zastępczego w Szablonie. Jeśli więc Twój Raport nie wygląda tak, jak chcesz, musisz zmienić Szablon. Z drugiej strony, dynamiczne dane są wyświetlane tak, jak zostały wprowadzone do docu tools. Jeśli więc w wyświetlanym Tytule Pinezki jest błąd, należy go zmienić w odpowiedniej Pinezce w docu tools.
Obszary symboli zastępczych
Pracując z symbolami zastępczymi dla zadań i Pinezek, należy przestrzegać określonej struktury. Ponieważ Pinezki i zadania często powtarzają się w Raporcie, ważne jest, aby zdefiniować konkretny obszar, w którym te symbole zastępcze się pojawiają. Ten ograniczony obszar jest wypełniany danymi z Pinezki lub zadania, które powtarzają się tak często, jak pojawiają się w Raporcie.
Te sekcje zawsze zaczynają się od #{{pins}} lub #{{tasks}} i kończą na {/pins}} lub #{{/tasks}}. Wszystkie treści pomiędzy tymi symbolami zastępczymi są wyświetlane wielokrotnie w zależności od liczby Pinezek lub zadań. Ważne jest, aby zauważyć, że dodatkowy / jest zawarty wyłącznie w tagu zamykającym.
Inne obszary obejmują:
#{{pin-sort}}i#{{/pin-sort}}- obszar dla symboli zastępczych sortowania Pinezek.#{{pin-medias}}i#{{/pin-medias}}- miejsce na#{{pin-media-file-name}}w Raportach Excel.#{{comments}}i#{{/comments}}- obszar dla komentarzy do zadań.#{{attendees}}i#{{/attendees}}- sekcja dla symboli zastępczych kontaktów.
Istnieją również sekcje, w których tekst jest wyświetlany tylko wtedy, gdy spełniony jest warunek. Zazwyczaj symbole zastępcze w Raporcie nie są wyświetlane, jeśli nie ma danych, którymi można je wypełnić. Na przykład, jeśli w danej Pinezce nie ma zadań, symbole zastępcze dla zadań nie będą wyświetlane. Aby jednak dodać nagłówek, który zostanie wyświetlony, gdy odpowiednia zawartość jest dostępna, wprowadzono symbole zastępcze if. Te sekcje są umieszczane poza otwierającymi i zamykającymi symbolami zastępczymi i weryfikują obecność zawartości. Nagłówki są wyświetlane tylko wtedy, gdy istnieje rzeczywista zawartość odpowiadająca określonemu warunkowi.
Zdefiniowaliśmy następujące sekcje if:
#{{if-tasks}}i#{{end-if-tasks}}- nagłówki są wyświetlane tylko wtedy, gdy w Pinezce jest co najmniej jedno aktywne zadanie.#{{if-media}}i#{{end-if-media}}- nagłówki są wyświetlane tylko wtedy, gdy rzeczywiście istnieją treści multimedialne.#{{if-task-comment}}i#{{/if-task-comment}}- nagłówki są wyświetlane tylko wtedy, gdy zadanie zawiera komentarze.
Te symbole zastępcze można na przykład użyć w następujący sposób:
#{{pins}}#{{if-media}}Zdjęcia Pinezki#{{end-if-media}}#{{picture-table-small}}#{{/pins}}
Nagłówek "Zdjęcia Pinezki" nie zostanie wyświetlony w Raporcie, jeśli Pinezka nie zawiera zdjęć.
Nieaktywne treści w Raportach
W Raportach wykluczone są nieaktywne zadania i Multimedia. Nieaktywne Pinezki są jednak włączone do Raportu.
Symbole zastępcze dla Raportów
#{{today}}- Data sporządzenia protokołu dla łatwej identyfikacji aktualności Raportu, co umożliwia odpowiednie śledzenie i monitorowanie postępu w rozwiązywaniu problemów w czasie.#{{weeknumber}}- Pokazuje Numer tygodnia, w którym Raport został utworzony.#{{author}}- Podaje nazwisko użytkownika, który utworzył Raport.#{{author-email}}- Wyświetla Adres e-mail twórcy Raportu.#{{author-number}}- Wyświetla numer telefonu użytkownika, który utworzył Raport.#{{author-company}}- Wyświetla firmę twórcy Raportu.#{{report-title}}- Wyświetla Tytuł nadany Raportowi podczas jego tworzenia w aplikacji.#{{report-filter}}- Wyświetla Filtr używany do tworzenia Raportu. Działa, gdy Raport jest tworzony w Widoku listy Raportów.#{{pagebreak}}- Dodaje przerwę stron w Raportach Word.
Wskazówka: Ogólne przerwy stron można bezpośrednio wstawić do Szablonu Word jako statyczne elementy. Jeśli chcesz wstawić przerwę stron po każdej Pinezce lub każdym zadaniu, po prostu wstaw symbol zastępczy #{{pagebreak}}.
Symbole zastępcze dla tworzenia pola podpisu
Te symbole zastępcze umożliwiają bezpośrednie podpisywanie w aplikacji na iPadzie i przyczyniają się do ostatecznego wyniku Raportu:
#{{signature-NAME}}- Wyświetla pole podpisu podczas tworzenia Raportu, które następnie pojawia się w ostatecznym Raporcie.#{{signaturename-NAME}}- Tworzy pole tekstowe dla nazwiska osoby podpisującej podczas tworzenia Raportu na iPadzie, które następnie jest włączane do Raportu.
UWAGA: Ponieważ te symbole zastępcze mogą być używane wielokrotnie w ramach Szablonu Raportu, ważne jest, aby je od siebie odróżnić. Segment "NAME" symbolu zastępczego powinien być zastąpiony opisowym określeniem wskazującym miejsce w Raporcie, gdzie chcesz wyświetlić konkretny podpis i nazwisko.
Na przykład skonfiguruj Raport z dwoma polami podpisu i nazwiska, używając następującej składni w Szablonie:
Raport przedstawi wyniki, jak pokazano poniżej:
Te symbole zastępcze są zawarte w naszym Domyślnym Szablonie Raportu "Dziennik budowy".
Symbole zastępcze dla informacji o pogodzie
Symbole zastępcze oferują dane dotyczące pogody, które są oparte na miejscu wskazanym w ustawieniach projektu. Aby zapewnić ich funkcjonalność, zwróć uwagę na walidację po prawej stronie adresu.
#{{weather-icon-info}}- Wyświetla prognozę pogody dla określonego adresu projektu z małym symbolem pogody. Symbol zastępczy jest sformatowany jako tabela, która w pierwszej kolumnie zawiera symbol pogody, a w drugiej opis prognozy oraz informacje o temperaturze.#{{weather}}- Gdy ten symbol zastępczy jest używany w Szablonie Raportu, w oknie tworzenia Raportu pojawia się nowa sekcja, która automatycznie wybiera dane pogodowe na bieżący dzień. Klikając przycisk "Edytuj", można wybrać lub zmienić datę. Przyciskiem usuwania ustawia się datę na bieżący dzień. Ten symbol zastępczy nie zawiera symbolu pogody.#{{pin-weather}}Ten symbol zastępczy podaje pogodę z dnia, w którym Pinezka została utworzona.
Symbole zastępcze dla sortowania Pinezek
Dzięki tym symbolom zastępczym możesz organizować Raporty według Planów i Kategorii oraz dodawać Tytuł, aby zapewnić odpowiednią organizację w spisie treści.
Jeśli nie ma określonego symbolu zastępczego sortowania, aplikacja używa Domyślnej sortowania z listy Pinezek/zadań. Symbole zastępcze sortowania jednak unieważniają Domyślną sortowanie aplikacji. UWAGA: Te symbole zastępcze są dostępne tylko dla Raportów Word.
UWAGA: Symbole zastępcze sortowania powinny obejmować obszar Pinezki wewnątrz obszaru sortowania. Prawidłowe użycie to:
#{{pin-sort}}...Symbole zastępcze sortowania...#{{pin}}...Symbole zastępcze Pinezki...#{{/pin}}#{{/pin-sort}}
#{{pin-sort}}- Otwiera obszar sortowania Pinezek.#{{/pin-sort}}- Zamyka obszar sortowania Pinezek.#{{sort-by-plan}}- Ta funkcja organizuje Pinezki według nazwy Planu, do którego są przypisane, a następnie sortuje je według ich Numerów Pinezek.#{{sort-by-category}}- Ta funkcja organizuje Pinezki według ich Kategorii, sortując Kategorie w kolejności alfabetycznej od Z do A.#{{pin-sort-title}}- Ten symbol zastępczy jest używany w połączeniu z jednym z dwóch poprzednich symboli zastępczych. Służy do wyświetlania nazwy posortowanego Planu lub Kategorii.