A docu tools adatok pdf vagy excel Jelentés megjelenítéséhez helykitöltőket használunk. Ezek a helykitöltők jelölések a Sablonon belül, és jelzik, hogy hol kell beilleszteni a docu tools adatokat. Például létrehozhat egy helykitöltőt, mint {{
project-name
}}
a Sablonban, amely a Jelentés generálásakor dinamikusan töltődik be a tényleges projektnévvel a docu tools-ból.
Különböző csoportokban található helykitöltők léteznek Excelhez és Wordhöz, mivel néhány csak az egyikben vagy a másikban érhető el. Ezeknek a helykitöltőknek az hatékony használatával dinamikus és rugalmas Sablonokat hozhat létre, amelyek pontosan ábrázolják projektjei, Jelentései és Feladatai adatait.
Helykitöltők szintaxisa és formázása
Minden helykitöltő dupla kapcsos zárójelek közé {{
}}
van zárva és pontosan követnie kell a megadott szintaxist, függetlenül a Sablon szövegében használt nyelvtől: Például {{
pin-number
}}
egy érvényes helykitöltő, amely lekéri a kiválasztott Pin Számát. Azonban helykitöltők, mint {pin-number}
, {{
pinnummer
}}
vagy {{
pinnumber
}}
érvénytelenek a helytelen szintaxis miatt, és nem működnek.
Helykitöltők nem működnek, ha szóközt tartalmaznak. Többszavas Cím létrehozásához cserélje le a szóközt kötőjelre -
, például használja {{
dataset-room-info
}}
helyett {{
dataset-Room info
}}
.
A kimenet megjelenése a helykitöltő Sablonban történő formázásán alapul. Tehát, ha a Jelentés nem úgy néz ki, ahogy szeretné, meg kell változtatnia a Sablont. Másrészt a dinamikus adatok úgy jelennek meg, ahogy azokat a docu tools-ba beírták. Tehát, ha a megjelenített Pin Címében elütés van, azt a megfelelő Pinben a docu tools-ban kell módosítani.
Helykitöltők hatókörei
Munka közben a Feladatok és Pin helykitöltőkkel egy meghatározott szerkezetet kell figyelembe venni. Mivel a Pinek és Feladatok gyakran ismétlődnek egy Jelentésben, fontos meghatározni azt a konkrét szakaszt, ahol ezek a helykitöltők megjelennek. Ez a korlátozott terület egy Pin vagy Feladat adataival töltődik ki, amelyek olyan gyakran ismétlődnek, ahogy a Jelentésben előfordulnak.
Ezek a szakaszok mindig {{
pins
}}
vagy {{
tasks
}}
-sal kezdődnek és {/pins
}}
vagy {{
/tasks
}}
-sal zárulnak. Minden tartalom ezek között a helykitöltők között annyiszor jelenik meg, ahányszor a Pinek vagy Feladatok előfordulnak a Jelentésben. Fontos megjegyezni, hogy a záró tagban lévő /
kizárólagosan ott szerepel.
További területek:
{{
pin-sort
}}
és{{
/pin-sort
}}
- Terület a Pin rendezési helykitöltők számára.{{
pin-medias
}}
és{{
/pin-medias
}}
- Hely a{{
pin-media-file-name
}}
számára Excel Jelentésekben.{{
comments
}}
és{{
/comments
}}
- Terület a Feladatok megjegyzései számára.{{
attendees
}}
és{{
/attendees
}}
- Szakasz a kapcsolattartó helykitöltők számára.
Vannak olyan szakaszok is, ahol a szöveg csak akkor jelenik meg, ha egy feltétel teljesül. Általában a helykitöltők nem jelennek meg a Jelentésben, ha nincsenek adatok, amelyekkel kitölthetők. Például, ha egy adott Pinben nincsenek Feladatok, a Feladatok helykitöltői nem jelennek meg. Azonban egy címsor hozzáadásához, amely akkor jelenik meg, ha a megfelelő tartalom elérhető, bevezettük az if-helykitöltőket. Ezek a szakaszok a nyitó és záró helykitöltőkön kívül helyezkednek el, és ellenőrzik a tartalom jelenlétét. A címek csak akkor jelennek meg, ha valóban van tartalom, amely megfelel a megadott feltételnek.
Definiáltuk a következő if-szakaszokat:
{{
if-tasks
}}
és{{
end-if-tasks
}}
- A címek csak akkor jelennek meg, ha van legalább egy aktív Feladat a Pinben.{{
if-media
}}
és{{
end-if-media
}}
- A címek csak akkor jelennek meg, ha valóban vannak Médiafájlok.{{
if-task-comment
}}
és{{
/if-task-comment
}}
- A címek csak akkor jelennek meg, ha a Feladat tartalmaz megjegyzéseket.
Ezeket a helykitöltőket például így lehet használni:
```
{{pins
}}
{{if-media
}}
Pin Fotók
{{end-if-media
}}
{{picture-table-small
}}
{{/pins
}}
```
A "Pin Fotók" cím nem jelenik meg a Jelentésben, ha a Pin nem tartalmaz fotókat.
Inaktív tartalmak a Jelentésekben
A Jelentésekben az inaktív Feladatok és Médiafájlok kizárásra kerülnek. Az inaktív Pinek azonban bekerülnek a Jelentésbe.
Helykitöltők Jelentésekhez
{{
today
}}
- A jegyzőkönyv készítésének dátuma az aktualitás egyszerű azonosítása érdekében, ami lehetővé teszi a hibaelhárítás előrehaladásának megfelelő követését és felügyeletét az idő múlásával.{{
weeknumber
}}
- Megjeleníti a hetet, amelyben a Jelentés készült.{{
author
}}
- Megadja a Jelentést készítő felhasználó nevét.{{
author-email
}}
- Megjeleníti a Jelentést készítő felhasználó E-mail címét.{{
author-number
}}
- Megjeleníti a Jelentést készítő felhasználó telefon_számát.{{
author-company
}}
- Megjeleníti a Jelentést készítő cég nevét.{{
report-title
}}
- Megjeleníti a Címet, amelyet a Jelentés készítésekor az alkalmazásban adtak hozzá.{{
report-filter
}}
- Megjeleníti a Szűrőt, amelyet a Jelentés készítésekor használtak. Akkor működik, ha a Jelentés a Jelentések Listanézetében készült.{{
pagebreak
}}
- Oldaltörést ad hozzá Word Jelentésekben.
Tipp: Általános oldaltörések közvetlenül beilleszthetők a Word Sablonba, mint statikus elemek. Ha minden Pin vagy Feladat után oldaltörést szeretne beilleszteni, egyszerűen csak illessze be a {{
pagebreak
}}
helykitöltőt.
Helykitöltők egy aláírási mező létrehozásához
Ezek a helykitöltők lehetővé teszik a közvetlen aláírást az iPad alkalmazásban, és hozzájárulnak a Jelentés végső kimenetéhez:
{{
signature-NAME
}}
- Aláírási mezőt jelenít meg a Jelentés készítése közben, amely aztán a végső Jelentésben jelenik meg.{{
signaturename-NAME
}}
- Aláíró nevének szövegmezőjét hozza létre az iPaden a Jelentés készítésekor, amely aztán bekerül a Jelentésbe.
MEGJEGYZÉS: Mivel ezek a helykitöltők többször is felhasználhatók egy Jelentés Sablonban, fontos, hogy megkülönböztessük őket egymástól. A helykitöltő "NAME" szegmensét egy értelmes leírással kell helyettesíteni, amely megadja a Jelentés azt a helyét, ahol meg szeretné jeleníteni az adott aláírást és nevet.
Például állítson be egy Jelentést két aláírási és névmezővel, a következő szintaxist használva a Sablonban:
A Jelentés az alábbiak szerint jeleníti meg az eredményeket:
Ezek a helykitöltők a mi Standard "Építési napló" Jelentés Sablonunkban találhatók.
Helykitöltők az időjárás-információkhoz
A helykitöltők időjárásra vonatkozó adatokat biztosítanak, amelyek a projektbeállításokban megadott hely alapján készülnek. A funkciók biztosítása érdekében figyeljen az cím validálására a jobb oldalon.
{{
weather-icon-info
}}
- Az adott projekt címére vonatkozó időjárás-előrejelzést jeleníti meg egy kis időjárás-szimbólummal. A helykitöltő táblázatként van formázva, amelynek első oszlopában az időjárás-szimbólum, a második oszlopában pedig az előrejelzés leírása és a hőmérsékleti adatok találhatók.{{
weather
}}
- Ha ezt a helykitöltőt használják egy Jelentés Sablonban, az Jelentés létrehozásának ablakában automatikusan megjelenik egy új szakasz, amely előre kiválasztja az aktuális nap időjárás-adatokat. A "Szerkesztés" gombra Kattintással kiválaszthatja vagy módosíthatja a dátumot. A törlő gombbal visszaállíthatja a dátumot az aktuális napra. Ez a helykitöltő nem tartalmaz időjárás-szimbólumot.{{
pin-weather
}}
Ez a helykitöltő azon a napon adja meg az időjárást, amikor a Pin létrejött.
Helykitöltők a Pinsortáláshoz
Ezekkel a helykitöltőkkel rendezheti a Jelentéseket Térképek és Kategóriák szerint, és hozzáadhat egy Címet a tartalomjegyzék helyes rendezéséhez.
Ha nincs konkrét rendezési helykitöltő, az alkalmazás az alapértelmezett rendezést használja a Pin-/Feladatlista alapján. A rendezési helykitöltők azonban felülírják az alkalmazás alapértelmezett rendezését. MEGJEGYZÉS: Ezek a helykitöltők csak Word Jelentésekhez érhetők el.
MEGJEGYZÉS: A rendezési helykitöltőknek magukban kell foglalniuk a Pin területet a rendezési területen belül. A helyes használat:
```
{{pin-sort
}}
...Rendezési helykitöltők...
{{pin
}}
...Pin helykitöltők...
{{/pin
}}
{{/pin-sort
}}
```
{{
pin-sort
}}
- Megnyitja a Pinrendezési területet.{{
/pin-sort
}}
- Bezárja a Pinrendezési területet.{{
sort-by-plan
}}
- Ez a funkció a Pineket a hozzájuk rendelt Térkép neve szerint rendezi, majd a Pin Számok szerint sorba állítja őket.{{
sort-by-category
}}
- Ezzel a funkcióval a Pineket az egyes Kategóriák szerint rendezi, a Kategóriákat Z-től A-ig abc-sorrendben rendezve.{{
pin-sort-title
}}
- Ezt a helykitöltőt az előző két helykitöltő egyikével együtt használják. Célja, hogy megjelenítse a rendezett Térkép vagy Kategória nevét.