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 mają zostać wstawione. Możesz na przykład utworzyć symbol zastępczy, taki 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. Efektywne wykorzystanie tych symboli zastępczych pozwala na tworzenie dynamicznych i elastycznych Szablonów, 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ą, jeśli zawierają spacje. Aby utworzyć symbol zastępczy dla tytułu wielowyrazowego, 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, dane dynamiczne są wyświetlane tak, jak zostały wprowadzone w docu tools. Jeśli więc w wyświetlanym Tytuł 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 w Raporcie często się powtarzają, 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 pamiętać, że dodatkowy / jest zawarty wyłącznie w tagu zamykającym.
Inne obszary obejmują:
#{{pin-sort}}i#{{/pin-sort}}- Obszar dla symboli zastępczych dla sortowania Pinezek.#{{pin-medias}}i#{{/pin-medias}}- Miejsce dla#{{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ą także 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 jest wyświetlany, gdy odpowiednia treść istnieje, wprowadzono symbole zastępcze If. Te sekcje są umieszczane poza otwierającymi i zamykającymi symbolami zastępczymi i weryfikują obecność treści. Nagłówki są wyświetlane tylko wtedy, gdy istnieje treść odpowiadająca określonemu warunkowi.
Zdefiniowaliśmy następujące sekcje if:
#{{if-tasks}}i#{{end-if-tasks}}- Nagłówki są wyświetlane tylko, gdy w Pinezce jest co najmniej jedno aktywne Zadanie.#{{if-media}}i#{{end-if-media}}- Nagłówki są wyświetlane tylko, gdy rzeczywiście istnieją treści multimedialne.#{{if-task-comment}}i#{{/if-task-comment}}- Nagłówki są wyświetlane tylko, 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ępów w rozwiązywaniu problemów w czasie.#{{weeknumber}}- Wyświetla Numer tygodnia, w którym Raport został utworzony.#{{author}}- Podaje nazwę 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ł, który został nadany Raportowi podczas tworzenia w aplikacji.#{{report-filter}}- Wyświetla Filtr używany do tworzenia Raportu. Działa, gdy Raport jest tworzony w Widok 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 elementy statyczne. 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 jest wydawane w końcowym 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 można wielokrotnie używać w Szablonie Raportu, ważne jest, aby je od siebie odróżnić. Segment "NAME" symbolu zastępczego powinien być zastąpiony opisowym opisem 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 będzie przedstawiał wyniki jak 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 zapewniają dane pogodowe 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ń. Po Kliknięciu przycisku "Edytuj" możesz wybrać lub zmienić datę. Przyciskiem usuwania ustawiasz 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
Za pomocą tych symboli zastępczych możesz organizować Raporty według Planów i Kategorii oraz dodawać Tytuł, aby zapewnić odpowiednie sortowanie w spisie treści.
Jeśli nie ma określonego symbolu zastępczego sortowania, aplikacja używa Domyślnej sortowania z Listy zadań Pinezek. Symbole zastępcze sortowania jednak zastępują 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. Poprawne użycie to:
```
#{{pin-sort}}
...Symbol zastępczy sortowania...
#{{pin}}
...Symbol zastępczy Pinezki...
#{{/pin}}
#{{/pin-sort}}
```
#{{pin-sort}}- Otwiera obszar sortowania Pinezek.#{{/pin-sort}}- Zamyka obszar sortowania Pinezek.#{{sort-by-plan}}- Ta funkcja układa 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 układa 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.