In dit artikel wordt het gebruik van samenvoegcodes uitgelegd.Samenvoegcodes gebruik je in een document template, zodat bij het genereren van een document deze samenvoegcodes ingevuld worden met data uit Coachview. De samenvoegcodes herken je door de blokhaken [ ]. Welke beschikbaar zijn hangt af van de gekozen datagroep in tab ‘Algemeen’.

INHOUDSOPGAVE


Samenvoegcodes 3.0:

Open de documenttemplate en klik op de tab ‘Editor’ en volledig scherm. Je kunt direct aan

de slag. Klik met je muis in het ontwerp.


Klik met je muis in het ontwerp op de plaats waar je de samenvoegcode wilt invoegen.

Klik in de knoppenbalk op het samenvoegicoontje.
Of type het karakter [ (blokhaak) in.

Lijst met samenvoegcodes:

Daarmee open je het scherm met samenvoegcodes die beschikbaar zijn voor de gekozen datagroep, onderverdeeld in mappen.

In het scherm heb je ook een mogelijkheid om naar samenvoegcodes te zoeken.

De samenvoegcodes die je het meest gebruikt worden standaard getoond. Wil je alle samenvoegcodes tot je beschikking hebben? Vink dan deze optie uit.


Met behulp van een achtergrondkleur wordt een verschil gemaakt. De meest gebruikte samenvoegcodes hebben een iets donkere achtergrond.


Betekenis van de onderdelen van de lijst:
De verschillende onderdelen in het scherm hebben de volgende betekenis.
Mappen.
Mappen voor het herhalen van gegevens. Denk bijvoorbeeld aan het weergeven van het lesrooster, het aantal onderdelen van de opleiding.
De samenvoegcodes. Een samenvoegcode wordt bij het genereren van het document vertaald naar Coachview informatie.
Elke map kan extra mappen, herhalingen of  samenvoegcodes bevatten.

Zoeken:
Met behulp van zoeken kun je in het scherm gemakkelijk een samenvoegcode terugvinden. Zoek je op ‘datum’? Dan vind je allerlei samenvoegcodes voor datums terug. Maar zoek je op begindatum, de startdatum van de opleiding? Dan krijg je snel de juiste samenvoegcode.

Selecteer je een datum. Dan heb je nog de mogelijkheid de opmaak van de datum aan te passen. Je kunt kiezen uit een aantal datumformaten.


Berekenen van datum en tijd:
Je kunt ook de datum laten berekenen. Stel dat je de startdatum van de opleiding als uitgangspunt gebruikt en aan wilt geven dat één week voor de startdatum de e-learning gemaakt moet zijn. Dan kun je deze datum laten berekenen.
Dit geldt ook voor een tijd. Stel dat je de deelnemer wilt laten weten dat deze 30 minuten voor aanvang van de les aanwezig moet zijn. Dan kun je deze specifieke tijd laten berekenen.


Samenvoegcodes 2.0:
Ga met de cursor in de editor staan op de plaats waar de samenvoegcode moet komen en selecteer in het menu de gewenste samenvoegcode.

In een menu vind je 3 verschillende soorten samenvoegcodes:
  1. in wit, de 'normale' samenvoegcodes.
  2. in grijs, de 'vrije velden' samenvoegcodes
  3. in geel, de 'loop (herhaling)' samenvoegcodes.
De eerste twee type samenvoegcodes zijn erg vergelijkbaar, het enige verschil is dat vrije velden klant specifiek zijn. Verder werken ze op dezelfde manier. Selecteer het juiste menu, kies een samenvoegcode en deze wordt in je document geplaatst. Deze samenvoegcodes zijn te herkennen aan dat ze een dubbele punt in de code hebben staan, bijvoorbeeld: [Persoon:NaamVolledig] De loop samenvoegcodes zijn iets ingewikkelder, en zal ik daarom hieronder in een apart menu uitleggen.

Toevoegen van herhalingen:
De 'herhaling' samenvoegcodes heb je nodig wanneer je een samenvoegcode uit een van de menu's met een niveau indicatie wil halen. Het wordt een herhaling genoemd omdat je een serie van items raadpleegt waarvan je de samenvoegcode wil ophalen van ieder item.

Bijvoorbeeld: je wil een lijst met namen van deelnemers in een e-mail genereren die gestuurd moet worden naar de docent. Er zijn 4 deelnemers, je gebruikt datagroep:OpleidingsDocent en je wilt dat Coachview de voornaam en het geslacht toont.
Herhaling:Resultaat:
1e item plaatsen
Samenvoegcodes ophalen voor [voornaam] en [geslacht]
Volgend item plaatsen (item 2)
Samenvoegcodes ophalen voor [voornaam] en [geslacht]
Volgend item plaatsen (item 3)
Samenvoegcodes ophalen voor [voornaam] en [geslacht]
Laatste item plaatsen (item 4)
Samenvoegcodes ophalen voor [voornaam] en [geslacht]

Piet Man

Janneke Vrouw

Mick Man

Marloes Vrouw

Omdat we vooraf niet weten hoeveel items er zijn zetten we alleen het start en eind signaal in een herhaling en daartussen de samenvoegcodes. Coachview weet dat eerst gekeken moet worden bij het eerste item en wanneer we het 'einde herhaling signaal' tegenkomen, kijken we of er nog een item is en beginnen we weer bovenaan in de herhaling. Is er geen volgend item meer, dan wordt de herhaling afgesloten. Je zou bovenstaande herhaling dus kunnen herschrijven naar een verkorte versie, zoals hieronder:
Herhaling:
Resultaat:
Start herhaling
Samenvoegcodes ophalen: [voornaam] en [geslacht]
Eind herhaling
Piet - Man
Janneke - Vrouw
Sandra - Vrouw

Het enige wat we nu nog moeten doen is bovenstaande herhaling omzetten naar codering die Coachview begrijpt. En dat kunnen we doen met behulp van het 'herhaling' samenvoegcode uit het menu. Bij het kiezen van een dergelijk veld verschijnt er namelijk het volgende in je editor:
Herhaling:
Uitleg:
[OpleidingDeelnemer]Geeft het samenvoegcode voor de start van de herhaling (een 'herhaling samenvoegcode ' herken je doordat er géén dubbele punt : in staat).

/* Hier kunnen niveau 1 OpleidingDeelnemer velden ingevoegd worden */

Geeft een opmerking aan waarin je de gewenste tekst en/of samenvoegcodes kan zetten. Deze regel mag je verwijderen.
[Persoon:Voornaam] [Persoon:Geslacht_]
De samenvoegcodes voor voornaam en geslacht.
[/OpleidingDeelnemer]
Geeft het einde van de herhaling aan.
(een 'herhaling samenvoegcode ' herken je doordat er géén dubbele punt : in staat)

Let op: het lijkt dezelfde samenvoegcode, maar je mag niet de '/' vergeten!
We zijn bijna klaar, nog even de 'herhaling samenvoegcodes' voorzien van een extra stukje codering. Let op zodra je deze codering toevoegt, zul je zien dat de 'loop samenvoegcodes ' niet meer zichtbaar is in de editor. Geen nood, als je naar de broncode gaat zul je hem nog zien staan! Hieronder dan nog een laatste voorbeeld van hoe je herhaling eruit ziet:
Herhaling:
Uitleg:
[OpleidingDeelnemer]

[Persoon:Voornaam] - [Persoon:Geslacht_]<br>

De <br> betekent in HTML code een enter, de volgende naam wordt op de volgend regel geschreven.
Piet - Man
Janneke - Vrouw
Sandra - Vrouw

[/OpleidingDeelnemer]


Herhaling plaatsen in een tabel:
Zorg dat je eerst weet hoe een tabel wordt opgebouwd in html (info). We gebruiken hetzelfde voorbeeld als hierboven, zodat we al weten welke samenvoegcodes we moeten gebruiken. Bedenk welke informatie in een herhaling moet komen staan, en welke informatie niet. Waarschijnlijk wil je de tabel-titels niet in de herhaling, deze hoeven namelijk niet steeds herhaalt te worden. Waarschijnlijk zal de herhaling dus in de Tbody zitten (ofwel de vulling van de tabel):
Broncode:Resultaat:
<table>
<thead>
<tr>
<th><strong>Naam</strong></th>
<th><strong>Geslacht</strong></th>
</tr>
</thead>
   <tbody>

      <!--[OpleidingDeelnemer]-->
         <tr>

            <td>[Persoon:NaamVolledig]</td>
            <td>[Persoon:Geslacht_]</td>
         </tr>
       <!--[/OpleidingDeelnemer]-->
</tbody>
</table>


Datumnotaties:
Datumnotatie kun je alleen toevoegen via de broncode (HTML).
Code:Voorbeeld:
d
dd
ddd
dddd

9
09
wo; vr
woensdag; vrijdag

M
MM
MMM
MMMM

3
03
mrt
maart
y
yy
yyyy

7
07
2007
Voorbeelden:
[Opleiding:BeginDatum \@ "dd-MM-yyyy"]
[Opleiding:BeginDatum \@ "ddd d MMM yy"]
[Opleiding:BeginDatum \@ "d MMMM"]
[Opleiding:BeginDatum \@ "yyyy/M/d"]
09-03-2007
do 9 mrt 07
9 maart
2007/3/9

Tijdnotaties:
Code:
Voorbeeld:
h
hh
H
HH

Uur kort (schaal 0-12) -> 3
Uur lang (schaal 0-12 -> 03
Uur kort (schaal 0-23) -> 15
Uur lang (schaal 0-23) -> 15

m
mm

8
08
s
ss

2
02

Voorbeelden:
[OpleidingsOnderdeel:TijdVan \@ "HH:mm:ss"]
[OpleidingsOnderdeel:TijdVan \@ "H:m:s]
15:08:02
15:8:2
Combinaties van datum- en tijdnotaties zijn ook mogelijk.
Bijvoorbeeld "dd-MM-yyyy / HH:mm:ss" wordt getoond als "09-03-2007 / 15:08:02"

Overige mogelijkheden:
Als de eerste letter een hoofdletter moet zijn:
[Persoon:Adressering \* "FirstCap"
Als het hele veld uit hoofdletters moet bestaan:
[Persoon:Plaats \* "Upper"]

Notities persoonsnamen:

Persoon:NaamVolledig

Persoon:Naam

Persoon:NaamFormeel

Persoon:Adressering

Persoon:Aanhef

Annemarie van der Aa

Aa, A.G.M van der

A.G.M van der Aa

mevrouw Ing A.G.M van der Aa

mevrouw Van der Aa