Første steg for å komme i gang med å generere dokumenter på produkter er å lage en dokumentmal.  Hvis dere ikke kan dette selv, så er vi i iSYS klare til å hjelpe dere med å lage en dokumentmal basert på deres design-ønsker.

Hvis dere har nødvendig kompetanse så kan dere også lage malen selv og laste den opp direkte i feed®. Hvis dere har en eksisterende mal tilgjengelig, kan dere enkelt gjøre justeringer og endringer på denne, men husk å ta en backup av malen før dere gjør endringer så dere har en fungerende kopi i tilfelle dere trenger å gå tilbake til gammel versjon.

Opprett en dokumentmal

feed® DocPro -modul benytter Word maler (.docx filer) som basis for å generere PDF-dokumentet. Så for å lage en dokumentmal så må du ha et tekstbehandlingsverktøy som kan lagre dokumentet som et Word dokument (.docx).
Hvis du ikke har Word fra Office pakken tilgjengelig, er Libre Office et godt alternativ.

Hvordan malen lages for å knytte inn informasjon fra varekort i feed® er et lite kurs i seg selv. Her kan vi bistå med å lage mal for dere basert på designforslag, eller hvis dere ønsker å lære dere dette selv så ta en titt på brukerdokumentasjon som ligger på Docmosis:

Brukerdokumentasjon for Docmosis

Sørg for at valget er på Tornado og dokument versjonen står på (Latest) for å få mest mulig oppdatert dokumentasjon.

Se etter Template Guide (om du er ny til Docmosis) eller Quick reference (om du ønsker kortfattet funksjonalitetsoversikt)

Noen enkle tips for å komme i gang:

Det er viktig å vite at navnene på feltene du ønsker å kartlegge fra feed ikke trenger å ha samme navn som i malen.

Du trenger heller ikke å ha importkoder i feedattributtene du ønsker å mappe til Docmosis, og hvis du senere legger til importkode eller endrer navnet på feedattributtet, vil det fortsatt være koblet i mappingen.

Feltnavnene (variabel navnene) du bruker i malen må være uten mellomrom.

Navngivningen på variabler er det som kommer frem som Docmosis navn du må koble til feed tekster, attributter, feed hodedata, relasjoner osv. 

Navnene som settes, sorteres alfabetisk i mappingen. Vi anbefaler å bygge opp navn etter type stamdata, så understrek og logisk navn på felt så du raskt finner det i feed. 

Hvordan dere gjør dette er helt fritt, men det kan spare tid på koblingsjobben i etterkant da alt av attributter havner under hverandre, alt av tekster havner under hverandre osv. 

Forslag: 

• ATTR_Atributtgruppe_Atributt
• FP_Forpakningsnavn_Atributt
• MR_Mediarollenavn
• PRODUKT_Feltnavn_språkkode (hvis tekstfelt)
• TXT_Textnavn_språkkode

Variabler: For å lage et dynamisk felt i malen som kommer frem i mapping dokumentet for kobling mot feed® så benyttes følgende syntaks: <<Mitt_variabel_navn>> (se forslag til oppbygging av faktisk navn over). 

Slik kommer det frem når man har lagt til malen i feed og skal koble feltene med feed

Bilder: Hvis du skal hente et bilde fra varekortet i feed® så må du først legge til et bilde i malen på ønsket sted og justere størrelse.

Bildet du legger til er ikke bildet som blir vist. Det er kun rammene/"placeholder" for bildet som skal inn. Tenk igjennom høyde breddeforhold på det som normalt skal inn i placeholderen. "Placeholderen" setter grensen for hvor mye plass feed bildet får lov til å ta i malen. Setter du inn ett breddebilde, men normalt får inn høydebilder, får bildet mye luft på sidene som ikke blir brukt. 

Du kan strekke bildet, men får da forvrengninger som normalt sett ikke ser bra ut (mer om det lenger ned). 

Etter bildet er lagt til gjør du følgende for å få et DocPro felt i mappingen som du kan koble feed mediarolle til

Word: 

1. Markere bildet
2. Trykk på "Sett inn"
3. Trykk på Bokmerke
4. Navnet på bokmerket må følge en gitt navnestandard (viktig!!)
   1. Man må først starte med funksjonen: "imgfit_" eller "imgstretch_" før man setter inn variabelnavn som kommer frem som Docpro navn man skal knytte medierolle til.
      1. Velg om bildet skal strekkes (forvrenges) ut til hver kant av Plassholderen (imgstretch_), 
      2. eller om det skal beholde høyde/bredde proposjoner (imgfit_) og stoppe ved første grense på Plassholderen. 
   2. Etter at man har skrevet inn imgfit_ eller imgstretch_ følger navnet man setter som skal vises i mappingen. Her kan det være lurt å skrive MEDIAROLLE_ eller MR_ etterfulgt av medierolle navnet.
      
      

LibreOffice:

1. Dobbelklikk på bildet
2. Gå til options fanen om den ikke starter med denne
3. Skriv inn imgfit_ eller imgstretch_ etterfulgt av variabelnavn du ønsker å benytte (som forklart over under Word gjennomgangen), og trykk på OK for å aktivere. 

Viktig: Medierollen som blir mappet henter kun første bildet i feed. Hvis du har flere "placeholdere" med samme medierolle så vil den vise samme bildet flere ganger. 

Betinget <<cs_>>:

Innholdet mellom åpningselementet <<cs_ og avslutningselementet inkluderes eller ekskluderes avhengig av verdien knyttet til "name" eller uttrykket "expr". Slutt taggen må stemme eksakt, eller kan være anonym: <<es_>>.

<<cs_my_variable>> (velg én attributt, tekst som kobles til dette elementet. Kun verdien vil vises, ikke feltnavnet. Hvis verdien er tom, vil den ikke vises).

<<cs_{my_variable}>> (Lar deg legge til attributt og forhåndsdefinert tekst. Hvis produktet har en tom/null-verdi for attributten, vil ingenting vises (hverken forhåndsdefinert tekst eller verdi).

• eksempel:
  <<cs_{f_pak_gtin!=null&&f_pak_gtin!=’’}>>
  F-Pak
  GTIN: <<f_pak_gtin>>
  <<es_>>
• Eksempelet over lar deg skjule attributter med tomme verdier (null-verdier). Oppsettet over vil vise den forhåndsdefinerte teksten "F-Pak", deretter et linjeskift med den forhåndsdefinerte teksten "GTIN:" etterfulgt av GTIN-verdien. Hvis verdien er tom, vil ingen tekst eller verdi vises.

Dynamisk avsnitt:

Hvis du mapper en tekst eller et attributt i malen din, og du manuelt skriver en overskrift for dette feltet i malen. Da ønsker du ikke at overskriften skal vises hvis teksten eller attributtverdien er tom på produktet.

Du kan bruke syntaksen <<op:name>> for å oppnå dette.

Eksempel:

Produktbeskrivelse (overskrift)

<<op:productDescription>> (syntaks:feltnavn)

Feil håntering: Hvis du trykker på enter på tastaturet etter å ha skrevet overskriften, vil ikke overskriften bli fjernet hvis produktet mangler verdi i tekst/attributt.

Riktig håndtering: Hvis du trykker SHIFT+Enter på tastaturet etter å ha skrevet overskriften, vil du opprette et mykt linjeskift, og syntaksen <<op:productDescription>> vil være innenfor samme avsnitt. På denne måten vil både overskriften og tekst/attributt bli fjernet dynamisk i dokumentet.

Dynamiske rader:

Hvis et kartlagt attributt i en rad ikke har noen verdi for et produkt, kan du dynamisk skjule det ved å bruke <<cr_-syntaksen.

Du må ha en start- og sluttsyntaks for hvert attributt, som vist i eksemplet nedenfor.

Startsyntaks: <<cr_{ATTRIBUTE!=null&&ATTRIBUTE!=’’}>>

Sluttsyntaks: <<er_>>

ETIM-funksjoner i DocPro

Legg til variantene dine i et DocPro-dokument ved å bruke segmentet "repeating row" som vist i eksemplet nedenfor.

Slik fungerer det:

En tabell settes opp der den første linjen indikerer at en gjentakende rad vil følge, ved å starte taggen med "rr_", som står for Repeating Row.
[*] angir at den inkluderer alt.

Deretter kommer linjen som vil bli gjentatt.
I eksemplet nedenfor er id, name, valueId, value, unitName og unitAbbr lagt til i linjen som vil bli gjentatt for alle ETIM-funksjoner for en gitt versjon for produktet.
For å avslutte den gjentakende raden, bruk "er_" som står for End Row.

I mappingoversikten vil du se "etim_features" som et felt som kan mappes.

I eksemplet nedenfor er det mappet til ETIM-funksjoner for versjon 9.

Når dette feltet er mappet, vil de underliggende feltene bli synlige og tilgjengelige for mapping. Disse underliggende feltene vil da motta verdier fra funksjonene.

feed Variant produkter i DocPro

Legg til variantene dine i et DocPro-dokument ved å bruke segmentet "gjentakende rad" slik det vises i eksempelet nedenfor.

Metoden fungerer ved at en tabell settes opp hvor den første linjen indikerer at en gjentakende rad vil følge ved å starte taggen med "rr_", som står for Repeating Row.

[*] angir at det inkluderer alt.

Deretter kommer linjen som vil bli gjentatt. I eksempelet nedenfor legges produktnummer, navn og pris til på linjen som vil bli gjentatt for alle varianter av produktet. For å avslutte gjentakende rad, bruk "er_" for End Row.

Variants

I oversikten over mapping vil du se at "varianter" er et felt som kan mappes.

Varianter kan deretter mappes til "Variant" i feed.

Når dette feltet er mappet, vil de underliggende feltene bli synlige og tilgjengelige for mapping. Disse underliggende feltene vil deretter motta verdier fra variantene.

Resultatet i det genererte dokumentet vil da være, for eksempel:

Relasjoner i DocPro

Relasjoner fungerer på akkurat samme måte som Varianter og ETIM data i Docpro. Bruk "Repeating Row" funksjonen "rr_"

Inkluder attributtene fra de relaterte produktene som du ønsker å vise i tabellen i raden under, og avslutt Repeating Row med <<er_>> segmentet.

Dato:

<<{dateFormat($nowUTC, 'EEEE, dd MMMM yyyy')}>>

• • Syntax for tidsstempel som viser datoen dokumentet ble opprettet eller sist oppdatert.