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 Worda, ponieważ niektóre są dostępne tylko w jednym z nich. Dzięki skutecznemu 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ą zamknięte w podwójne nawiasy klamrowe {{}} i muszą dokładnie przestrzegać określonej składni, niezależnie od używanego języka 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 wielu słów, zastąp spacje 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 w 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 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 mię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, gdy spełniony jest warunek. Zazwyczaj symbole zastępcze w Raporcie nie są wyświetlane, jeśli nie ma danych, którymi można by je wypełnić. Na przykład, jeśli w danej Pinezce nie ma żadnych 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 faktycznie 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 uwzględniane w Raporcie.
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 z czasem.{{weeknumber}}- Pokazuje Numer tygodnia, w którym Raport został utworzony.{{author}}- Podaje imię i nazwisko użytkownika, który stworzył Raport.{{author-email}}- Pokazuje Adres e-mail twórcy Raportu.{{author-number}}- Pokazuje numer telefonu użytkownika, który stworzył Raport.{{author-company}}- Pokazuje firmę twórcy Raportu.{{report-title}}- Pokazuje Tytuł nadany Raportowi podczas jego tworzenia w aplikacji.{{report-filter}}- Pokazuje Filtr użyty do stworzenia 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 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}}- Pokazuje pole podpisu podczas tworzenia Raportu, które następnie jest wyświetlane 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 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, gdzie chcesz wyświetlić konkretny podpis i nazwisko.
Na przykład skonfiguruj Raport z dwoma polami podpisu i nazwisk, używając następującej składni w Szablonie:
Raport będzie przedstawiał 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 zapewniają dane pogodowe oparte na lokalizacji określonej 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 kolumnie opis prognozy oraz dane temperaturowe.{{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żna wybrać lub zmienić datę. Przyciskiem usuwania ustawia się 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ą organizację 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. 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świetlenia nazwy posortowanego Planu lub Kategorii.