Systemmanual Corda/Instrato 7.0 – administrator
   [For Judith: Variabler « (⇧) » Eget firma]

Variabler eksempler

Eksempel 1:

{{Forhandlernavn}} – {{Adresse}} – Tlf: {{Telefon}} 
Dette er den enkleste formen for variabel. Kun variabeltekst uten ledetekst. Her vil derfor teksten som ikke står i doble hakeklammer være statisk. Dersom brukeren ikke fyller ut feltet Adresse, vil resultatet bli slik:

Forhandlernavn – – Tlf: 999 99 999

Eksempel 2:

Vi oppretter en variabel for firmaet vi jobber med og kaller den «Mobil» (uten anførselstegn). I malen sier jeg at jeg skal ha et nytt ikke-redigerbart tekstfelt. Som verdi gir jeg teksten «{Mobiltelefon: {Mobil}}». Alle brukere får opp elementet «Mobil:» som redigerbart (variabel-navnet). Hvis brukeren setter dette tomt, slettes også teksten «Mobiltelefon: ». Er det ikke tomt, så kommer «Mobiltelefon: detsomskrivesinn» med.

Dette kan også brukes i tekstbokser hvis en ønsker å flytte tekst opp for å unngå blanke linjer når brukere ikke har f.eks. mobiltelefon. Tenk at vi oppretter to variabler: mobiltelefon og e-post. På visittkortet skal det stå:

Telefon: nummer
Mobiltelefon: nummer
E-post: e-postadresse

Om nå brukeren ikke har mobil, vil det bli ei blank linje på visittkortet. Dette løser man ved å ikke bruke tekstfelt, men tekstboks, og legger linjeskiftene inni variablene. Man oppretter en tekstboks med følgende innhold:

{Telefon: {Telefon} }{Mobiltelefon: {Mobil} }{E-post: {E-post}}

Linjeskiftet, fordi det ligger inni variabel-elementet, vil forsvinne om variabelen mobiltelefon ikke har noen verdi!

Merk at dette eksemplet gjelder i bokser der teksten er toppjustert. Dersom teksten skal være bunnjustert (i eksemplet over vil ikke linjeskiftet i nederste linje forsvinne om brukeren ikke fyller inn e-post fordi linjeskiftet ligger i variabelen foran, linjen vil da heller ikke rykke ned om teksten er bunjustert), dvs. at linjeskiftene må plasseres i variablene på følgende måte om teksten er bunnjustert:

{Telefon: {Telefon}}{ Mobiltelefon: {Mobil}}{ E-post: {E-post}}

Eksempel 3:

Noen ganger vil man ha et resultat som ser ut som dette:

Telefon: Mobiltelefon:
E-post:

77 77 77 77
999 99 999
firmapost@dinbedrift.no

  

Her kan man nå bruke CordaFont-taggen Tabulatorstopp, og sette tabulator (\t) inn i variabelen. Slik:

<CordaFont tabstop="25L">
{Telefon: \t{Telefon}
}{Mobiltelefon: \t{Mobil}
}{E-post: \t{E-post}}
<CordaFont tabstop="0">

Man kan ikke bruke tabulator på tastaturet for å sette inn tabulator i teksten i Corda. Man må bruke \t.

Dersom fargene i tillegg skal være forskjellig på ledetekst og nummer, kan vi bruke CordaFont til det også:

<CordaFont tabstop="25L">
{<CordaFont color="Cyan">Telefon: \t<CordaFont color="Svart">{Telefon}
}{<CordaFont color="Cyan">Mobiltelefon: \t<CordaFont color="Svart">{Mobil}
}{<CordaFont color="Cyan">E-post: \t<CordaFont color="Svart">{E-post}}
<CordaFont tabstop="0">

Legg spesielt merke til at fargen «Svart» settes like før variabelnavnet (y), ikke inn i variabelnavnet. På samme måte kan man endre både font, størrelse, kniping etc. Les mer om CordaFont.

3b:

Dersom man ikke ønsker å bruke Tabulatorstopp og CordaFont trengs det to tekstbokser, der den første har ventrejustert tekst med følgende verdi:

{Telefon:{$Telefon$}
}{Mobiltelefon:{$Mobil$}
}{E-post:{$E-post$}}

Og den andre, med x-verdi litt lenger til høyre, har venstrejustert tekst med følgende verdi:

{{Telefon}
}{{Mobil}
}{{E-post}}

3c:

Dersom man i alternativ 3b har en bunnjustert tekstboks, og ikke skal skjule e-postadressen i den første boksen, men e-postadressen skal inn her uten ledetekst, slik som dette:

Telefon: 22 22 22 22
Mobiltelefon: 999 99 999
minepost@example.com

For at Corda skal klare å ta vare på den blanke linjen nederst i boks nummer 2, må man gjøre følgende i den første:

{Telefon:{$Telefon$}}{
Mobiltelefon:{$Mobil$}}{
{E-post}}

Og i den andre, med x-verdi litt lenger til høyre, må man legge inn e-postvariabelen selv om e-posten ikke skal inn her, og skjule den for at ikke linjen skal forsvinne og telefon- og mobilnummeret havne en linje for langt ned:

{{Telefon}}{
{Mobil}}{
{$E-post$}}
Eksempel 4
Eksempel 4.

Dersom brukeren ikke fyller inn noe i feltet «Telefon:» vil linjen rykke opp (eller ned dersom du har satt vertikal justering i tekstboksen til «Bunn») i beggetekstboksene.

Eksempel 4:

Det er ikke noe i veien for å bruke en og samme variabel flere ganger på samme dokument. En variabel kan være en tekst som går igjen flere ganger på ett og samme dokument, kanskje et firmanavn på for- og baksiden av et postkort.

Da vil brukeren fylle ut feltet «Firmanavn» én gang, men resultatet kan bli som illustrasjonen til høyre der Firmanavn har kommet inn på tre forskjellige plasser, med tre forskjellige skriftsnitt.

Eksempel 5:

Flere måter å bruke formatering på:

{Kontonr: {%Konto:%}#### ## #####
}{<CordaFont color="cyan">Org. nr: 
<CordaFont color="Process Black">%NO%{%Org.nr.:%}NO ### ### ### MVA
}{Mobil: %+47%{%Mobil:%}### ## ###
}{Telefon: %+47%{%Telefon:%}<CordaFont color="cyan">+47 
<CordaFont color="Process Black">## ## ## ##}

formatering input-felt
Verdier fyllt ut.

formatering resultat
Resultat

Her har vi fire måter å bruke formatering på. Kontonummer, organisasjonsnummer, telefon- og mobilnummer. Se hva som skjer med det som skrives inn i input-feltene på illustrasjonen til høyre, og resultatet under.

Den første linjen, kontonummer, viser den enkleste formen for formatering. Et kontonummer inneholder 11 siffer som skal skriver ut i grupper på 4+2+5.

I linje to er det lagt inn en CordaFont-tag som gjør ledeteksten cyan. I tillegg er NO satt til å være påkrevd, men kommer ikke dobbelt om brukeren skulle finne på å skrive det inn i input-feltet. Tallene kommer i grupper på 3+3+3, og MVA legges til.

Mobil-linjen viser hvordan +47 blir tatt bort fra teksten dersom brukeren har skrevet det i input-feltet, samt at det siste sifferet (9) ikke kommer med.

Den siste linjen viser at det også en mulig å legge til CordaFont-tag i formateringsgruppen.

 

**********************************************

Eksempel 6: Denne funksjonaliteten er utfaset. Se avsnittet «Fanegrupper».

Utnytte $-tegnet for å samle variabler under én fane.
Du har f.eks. tre tekstfelt eller -bokser med følgende variabler:

Navn: Tekst 1
Verdi: {{Navn}}		 Navn: Tekst 2
Verdi: {{Telefon}}		 Navn: Tekst 3
Verdi: {{E-post}}

Du kan ikke samle de tre varablene i én boks fordi tekstene ligger spredt på dokumentet, så du må ha dem i tre separate bokser. Fanen på brukerens input-side, blir da å se slik ut, med én fane for hver variabel:

For oversiktens skyld ønsker du kanskje å få alle disse tre variablene inn under samme fane (eller på logiske måter samle x antall relaterte variabler under samme fane). For å få flere variabler under én fane, må variablene legges inn i en og samme tekstboks. Men siden vi ikke ønsker at telefonnummeret skal inn på samme sted som navnet, må vi skjule det. Gjør følgende:

Navn: Tekst 1
Verdi: {{Navn}}{{$Telefon$}}{{$E-post$}}
Sorteringskode: aa		 Navn: Tekst 2
Verdi: {{Telefon}}
Sorteringskode: bb		 Navn: Tekst 3
Verdi: {{E-post}}
Sorteringskode: cc

Sorteringskoden på tekstboksene forteller nå Corda hvilken boks som skal prioriteres hvis variabelen finnes i flere tekstfelt/-bokser. En bruker vil bare å tilgang til å fylle ut samme variabel én gang, selv om den finnes flere steder på dokumentet. Corda finner nå boksen «Tekst 1», som inneholder alle variablene, og plasserer dem under samme fane. Det som brukeren eventuelt skriver inn, blir skjult i denne boksen, men plassert der hvor variablene er plassert i boksene Tekst 2/Tekst 3.

Fanen på brukerens input-side ser nå slik ut:

Merk at «Tekst 1» må være en tekstboks for å få variablene inn under samme fane, men de andre kan være både tekstfelt eller tekstboks. Hvordan variablene sorteres inbyrdes på fanen styres av variablenes egen sorteringskoder.

**********************************************

 

Eksempel 7:

Sammen med CordaFont kan du gi brukeren mulighet til å endre fontegenskaper på enkelte tekster.

Den vanlige måten å gi brukeren tilgang til denne funksjonen, er å aktivere «brukeren kan redigere ...» på en redigerbar tekstboks. Å åpne for endring av egenskaper på selve boksen, har noen negative sider: Du får ikke brukt variabler da boksen må være redigerbar; brukeren får velge mellomallefargenen/fontene som er opprettet/aktivert på firmaet, selv om han egentlig kun burde ha tilgang på svart eller hvit på akkurat denne malen; og brukeren må skrive inn føntstørrelse/linjeavstand, noe som veldig mange brukere sliter med å få til.

Men ved å bruke variabler sammen med CordaFont, kan vi få til å endre egenskaper på flere tekster i en og samme boks, uavhengig av hverandre. Her følger et eksempel på endring av farge i en tekstboks:

{{Tekst 1}}

{<CordaFont {Tittelfarge}>}{{Tittel 1}}
<CordaFont color="Process Black">{{Tekst 2}}

{<CordaFont {Tittelfarge}>}{{Tittel 2}}
<CordaFont color="Process Black">{{Tekst 3}}
Eksempel 7
Eksempel 7.

Opprett så disse variablene, og la «Tittelfarge» være en dropplistevariabel. Som alternativer i variablene legger du fargene med verdi «color="fargenavn"» (det eksakte navn slik de ble opprettet på siden «Farger») som brukeren skal ha lov til å velge mellom her, f.eks. «Process Black», «Grønn» og «Lys lilla».

Nå vil brukeren få en droppliste hvor han får velge farge på titlene, og både tittel 1 og tittel 2 vil få samme farge. Hvis de skal kunne ha forskjellige farger lager du en dropplistevariabel til (f.eks. «Tittelfarge 2») med samme alternativer som den første.

I prinsippet kan alle CordaFont-egenskaper gjøres redigerbare på denne måten. Både font, størrelse, farge, linjeavstand. Du kan til og med la brukeren definere sine egne tabulatorer (etter et lite kurs). Eksempel:

<CordaFont{ tabstob="{Tabulatorer}"}>{{Tekst 1}}

Når du oppretter variabelen, kan du enten lage en droppliste med et generelt utvalg av tabulatorer som kan være tilgjengelig, eller bare la det være en vanlig variabel hvor brukeren selv kan skrive inn hvor han vil ha dem. I feltet «Tabulatorer» kan da brukeren skrive inn f.eks.:

10L-20R-22L-50C
Eksempel 7
Bruk av variabler.

Han kan da få et tabelloppsett akkurat slik han vil ha det, og finjustere der det er behov for det.

OBS! Du kan ikke ha en variabel inni en annen variabel. Det vil si at en variabel som skal definere fontegenskaper for variabelen som kommer etter, ikke kan ligge inni den variabelen, men må ligge foran.

Eksempel 8:

Ved hjelp av «$» og «&&» eller «||», kan vi definere om en tekst skal vises basert på om én eller to andre variabler har innhold.

Det enkleste eksemplet, som også vist på forrige side, er:

Tlf: 12 34 56 78 • Mob: 999 99 999

Her ønsker du at «•» kun skal vises dersom både telefon og mobil har innhold. Du ønsker ikke å risikere at det står igjen en enslig prikk verken etter telefon eller før mobil. Før Corda versjon 5.4.72 måtte dette løses ved å lage en egen variabel for bulletpunktet med et dropplistevalg for om det skulle med eller ikke.

Nå kan vi formatere bulletpunktet inn i en kombinasjonsvariabel ved hjelp av «&&» (både og), eller «||» (enten eller). For eksempel slik:

{Tlf: {Telefon}}{ •{$Telefon&&Mobil$} }{Mob: {Mobil}}

Hva om vi legger til en webadresse på slutte en linjen:

Tlf: 12 34 56 78 • Mob: 999 99 999 • www.test.no

Her ønsker vi å unngå at linjen skal begynne med et bulletpunkt dersom verken telefon eller mobil fylles ut. Dette kan vi løse slik:

{Tlf: {Telefon}}{ •{$Telefon&&Mobil$} }{Mob: {Mobil}}{ •{$Telefon||Mobil$} }www.test.no

Bulletpunktet foran webadressen vises nå kun dersom enten telefon eller mobil har innhold.

Per i dag er det ikke mulig å kombinere med en tredje variabel, f.eks. dersom også webadressen er en variabel, og dette bulletpunkt kun skal vises dersom enten telefon og mobil har innhold, i tillegg til at webadresse har innhold.

Eksempel 9:

Ved hjelp av «stryringsvariabler» og «supervariabler» kan vi f.eks. la brukeren velge om plakaten skal inneholder ett stort eller to mindre bilder.

Til dette trenger vi tre variabler:

{{plakat-bildevalg}} som vi legger inn som {{$plakat-bildevalg$}} i en eksisterende tekstboks på malen eller i en ny tekstboks «Bildevalg» som kan plasseres hvor som helst på dokumentet. Siden vi omslutter variablelen med $ vil det ikke komme noe innold på dokumentet.

{{plakat-bilde1-bredde}} som legges inn i breddefeltet på bildeelement 1 på dokumentet. De andre feltene, x, y, høyde osv. fylles ut som vanlig. Variabelen skjules.

{{plakat-bilde2-bredde}} som legges inn i breddefeltet på bildeelement 2 på dokumentet. De andre feltene, x, y, høyde osv. fylles ut som vanlig. Variabelen skjules.

Variabelen «plakat-bildevalg» gjøres om til tekstboks og droppliste med følgende alternativer:

VerdiKortnavn
plakat-bilde1-bredde=[[216]]
plakat-bilde2-bredde=[[0]]

 Bruk ett stort bilde
plakat-bilde1-bredde=[[108]]
plakat-bilde2-bredde=[[108]]		 Bruk to bilder

Når brukeren velger alternativet med ett stort bilde, settes bredden på bilde2 til «0», og bildet blir dermed ikke med.