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 (variabelnavnene) du bruker i malen må være uten mellomrom.

Variabler: For å lage et dynamisk felt i malen som skal hente data fra feed® så benyttes følgende syntaks: <<Mitt_variabel_navn>>. "Mitt_variabel_navn" vil da bli tilgjengelig senere i konfigurasjonen som et felt som kan mappes mot data i feed®

Bilder: Hvis du skal hente et bilde fra varekortet i feed® så må du først legge inn et "placeholder" bilde i malen på ønsket sted og størrelse.  Deretter må du markere bildet (viktig!) og legge til et bokmerke for bildet. Navnet på bokmerket må følge en gitt navnestandard (viktig!!) "imgfit_min_variabel" hvor "imgfit_" er et nøkkelord som sier at bildet skal tilpasses størrelsen på angitt område for bilde i malen. "min_variabel" blir da variabelen du i konfigurasjonen knytter til ønsket medierolle.

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_>>

Varianter 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.

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:

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.

Dato:

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

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