Przejdź do głównej zawartości

Podstawy symboli zastępczych

Zaktualizowano w tym tygodniu

Aby przedstawić dane z docu tools w Raport w formacie 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ą 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 wybranego Pinezki. Symbole zastępcze takie jak {pin-number}, {​{pinnummer}​} lub {​{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 wielosłownego, 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 dla Zadań i Pinezek, należy zwrócić uwagę na określoną strukturę. 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 dodatkowe / jest zawarte 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 Zadań nie będą wyświetlane. Aby jednak dodać nagłówek, który jest wyświetlany, gdy odpowiednia zawartość istnieje, 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 będzie wyświetlany 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 utworzenia 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}​} - Wyświetla 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 Widok listy Raportów.

  • {​{pagebreak}​} - Dodaje przerwę strony 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ę strony 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 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 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 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:

Szablon podpisu

Raport będzie wyświetlał wyniki, jak pokazano poniżej:

Podpis w Raporcie

Te symbole zastępcze są zawarte w naszym Domyślna Szablonie Raportu "Dziennik budowy".

Symbole zastępcze dla informacji o pogodzie

Symbole zastępcze zapewniają dane dotyczące pogody, które są oparte na lokalizacji określonej w ustawieniach projektu. Aby zapewnić ich funkcjonalność, należy zwrócić 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 dołączać Tytuł, aby zapewnić odpowiednią organizację w spisie treści.

Jeśli nie ma określonego symbolu zastępczego sortowania, aplikacja używa Domyślna sortowania z Listy zadań Pinezek. Symbole zastępcze sortowania jednak zastępują Domyślna sortowanie aplikacji. UWAGA: Te symbole zastępcze są dostępne tylko dla Raportów Word.

UWAGA: Symbole zastępcze sortowania powinny obejmować obszar Pinezki w obrębie obszaru sortowania. Poprawne 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.

Czy to odpowiedziało na twoje pytanie?