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 jest dynamicznie wypełniany 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ą, jeśli zawierają spacje. Aby utworzyć symbol zastępczy dla tytułu składającego się z kilku słów, zastąp spacje myślnikiem -, na przykład użyj {{dataset-room-info}} zamiast {{dataset-Room info}}.
Wygląd wyjściowy 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óre mogłyby je wypełnić. Na przykład, jeśli w danej Pinezce nie ma Zadań, symbole zastępcze Zadań nie będą wyświetlane. Aby jednak dodać nagłówek, który jest wyświetlany, gdy odpowiednia treść jest dostępna, 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ść spełniająca określony warunek.
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łączane do Raportu.
Symbole zastępcze dla Raportów
{{today}}- Data utworzenia protokołu dla łatwej identyfikacji aktualności Raportu, co umożliwia odpowiednie śledzenie i monitorowanie postępu w rozwiązywaniu problemów z czasem.{{weeknumber}}- Pokazuje Numer tygodnia, w którym Raport został utworzony.{{author}}- Podaje nazwisko użytkownika, który utworzył Raport.{{author-email}}- Pokazuje Adres e-mail twórcy Raportu.{{author-number}}- Pokazuje numer telefonu użytkownika, który utworzył Raport.{{author-company}}- Pokazuje firmę twórcy Raportu.{{report-title}}- Pokazuje Tytuł, który został nadany Raportowi podczas jego tworzenia w aplikacji.{{report-filter}}- Pokazuje Filtr użyty do utworzenia Raportu. Działa, gdy Raport jest tworzony w Widoku listy Raportów.{{pagebreak}}- Dodaje podział strony w Raportach Word.
Wskazówka: Ogólne podziały stron można bezpośrednio wstawić do Szablonu Word jako statyczne elementy. Jeśli chcesz wstawić podział strony po każdej Pinezce lub każdym Zadaniu, po prostu wstaw symbol zastępczy {{pagebreak}}.
Symbole zastępcze do tworzenia pola podpisu
Te symbole zastępcze umożliwiają bezpośrednie podpisywanie w aplikacji na iPadzie i przyczyniają się do końcowego wyniku Raportu:
{{signature-NAME}}- Pokazuje pole podpisu podczas tworzenia Raportu, które następnie jest wyświetlane 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 mogą być używane wielokrotnie w Szablonie 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, w którym 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 pogodowych
Symbole zastępcze oferują dane pogodowe oparte na miejscu wskazanym w ustawieniach projektu. Aby zapewnić ich funkcjonalność, zwróć uwagę na walidację po prawej stronie adresu.
{{weather-icon-info}}- Pokazuje prognozę pogody dla określonego adresu projektu z małym symbolem pogodowym. Symbol zastępczy jest sformatowany jako tabela, która w pierwszej kolumnie zawiera symbol pogodowy, 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 pogodowego.{{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ą kolejność w spisie treści.
Jeśli nie ma konkretnego 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. 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 układa Pinezki według nazwy Planu, do którego są przypisane, a następnie sortuje je według ich Numerów.{{sort-by-category}}- Ta funkcja układa Pinezki według ich odpowiednich 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świetlenia nazwy posortowanego Planu lub Kategorii.