Eksport/import av Compose-prosesser – Beste praksis
Dette gjelder for eksport/import av prosesser mellom Compose-miljø og mellom arbeidsområder innad i et miljø. Hvis man kun ønsker å flytte filer mellom mapper i samme arbeidsmiljø kan dette gjøres uten eksport/import. Dette er beskrevet i https://composetogo.atlassian.net/wiki/spaces/DNO/pages/1236074512
Dette er en generell dokumentasjon av beste praksis for å flytte skjema og prosesser mellom Compose-miljø eller arbeidsområder, og hvordan man unngår duplikate filer og overholder en ryddig mappestruktur.
Generelt sett anbefales det at man planlegger mappestruktur og forvaltning av arbeidsområder før man begynner migrering av filer og elementer mellom miljø.
Eksport - Hva følger med
I Compose kan du eksportere filer og elementer som .cng-filer. Disse kan importeres i andre Compose-miljøer, for eksempel ved migrering. Eksport kan også brukes til sikkerhetskopi.
Når du eksporterer et element, følger tilhørende elementer automatisk med. Hvilke elementer som inkluderes, avhenger av hva du eksporterer. Her er noen eksempler:
Prosess: Tilhørende design, skjema, integrasjoner, valideringer og tekstgeneratorer, samt lister og andre elementer som brukes i skjemaet, blir med i eksporten.
Skjema: Tilhørende elementer, som valideringer, lister og integrasjoner som brukes i skjemaet, blir med. Prosesser som bruker skjemaet, blir ikke inkludert.
Ved eksport av et Compose-element medfølger alle elementer som det eksporterte elementet er avhengig av for å kjøre. Avhengigheter blir med, men overordnede elementer (som prosesser) blir ikke inkludert når du eksporterer et underliggende element (som et skjema).
Unntak ved eksport
Noen elementer følger ikke automatisk med ved eksport, særlig når du eksporterer en prosess. Dette gjelder prosess-elementer som er satt opp via et «Tilkoblingspunkt», altså ID-generator og Filoverføring. Disse elementene må enten eksporteres separat eller settes opp på nytt i det nye miljøet.
Prosess-elementer som settes opp i prosessen via et «Tilkoblingspunkt» følger ikke automatisk med over når prosessen eksporteres.
ID-generator
ID-generator blir ikke automatisk inkludert ved eksport og import av en prosess. Den må derfor eksporteres og importeres separat, eller settes opp på nytt i det nye miljøet.
Hvis du bruker ID-generator med stigende nummerering, blir verdien for «Neste nummer» nullstilt ved eksport. Dette kan føre til duplikate ID-er i det nye miljøet.
Du kan unngå dette på flere måter:
Bruk tilfeldige ID-er i stedet for stigende nummerering.
Sett «Neste nummer» i det nye miljøet til samme eller en høyere verdi enn i det opprinnelige miljøet. Dette kan gi hull i nummerserien, men hindrer overlapp.
Legg til et pre- eller postfiks i ID-ene i det nye miljøet for å skille dem fra eksisterende verdier.
Se brukerveiledningen for mer informasjon om oppsett av ID-generator: https://composetogo.atlassian.net/wiki/x/BQA-Ug
Hvis generert ID skal brukes som saksnummer (metadataet uniqueId) ved publisering til CCM/MultiSak anbefales det å følge en egen beste praksis for å unngå dupliserte saksnumre: https://composetogo.atlassian.net/wiki/x/DAD6w
Filoverføring (FlowRemote)
Filoverføringer kan ikke eksporteres og må settes opp på nytt i det nye miljøet.
Det anbefales å opprette filoverføringene før eksport og import av tilhørende prosess. Bruk samme verdi for «Tilkoblingspunkt», slik at alt er klart når den migrerte prosessen skal versjoneres.
Import - Hva legges inn
Ikke alle elementer som følger med i en eksport, blir lagt til i det nye miljøet ved import.
Elementer som allerede finnes i miljøet, blir ikke opprettet på nytt. For eksempel blir eksisterende integrasjoner ikke importert igjen, selv om de ligger i en annen mappe.
Det anbefales derfor å organisere elementer i felles mapper. Opprett egne mapper for eksempel for skjema, lister, integrasjoner og design.
Unntak ved import
Design-filer
Hvis samme design brukes i flere prosesser, vil design-filer bli importert på nytt selv om de allerede finnes i miljøet. Dette kan føre til duplikater. Det anbefales derfor å samle design-filer i en egen mappe, og rydde bort duplikater etter import.
Under følger en anbefalt fremgangsmåte for å unngå duplikater og holde miljøet ryddig:
Fremgangsmåte:
Importer første prosess.
Design følger med og opprettes i miljøet. Flytt design over i egen mappe.
Du finner nå design-filene ved å navigere til mappen.
Importer neste prosess som bruker samme design.
Duplikater av design-filer opprettes i samme mappe som prosessen. Åpne siste prosess.
Gå til «Innstililnger».
Velg opprinnelig skjema-design. Dette er nå den øverste i lista. Velg evt. «Standard» hvis skjema-designet heller skal defineres i prosessen.
Gå til «Startpunkt» i prosessen.
Velg samme skjema-design her. Velg evt. «Samme som prosessinnstillinger» hvis samme skjemadesign brukes i hele prosessen og dette allerede er definert under «Innstillinger».
Velg skjema-aktiviteten i prosessen. Hvis «Vis utskrift til PDF» er i bruk og et eget PDF-design benyttes, velg øverste PDF-design under «Stilsett».
Velg øverste versjon av skjema-design under «Design», med mindre «Layout/Skin» hentes fra tidligere i prosessen eller fra innstillinger.
Velg PDF-aktivitet og gå til «Layout».
Hvis et eget PDF-design benyttes, velg øverste PDF-design under «Stilsett».
Trykk på «Lagre kladd» for å lagre endringene.
De dupliserte design-filene kan nå slettes.
Oppsummering:
Importer første prosess. Design følger med og opprettes i miljøet.
Flytt design over i egen design-mappe.
Importer neste prosess som bruker samme design. Duplikater av design-filer opprettes i samme mappe som prosessen.
Åpne den sist importerte prosessen og koble til riktig design fra design-mappen. Dette kobler samtidig fra det dupliserte designet. Gå gjennom følgende steder i prosessen:
Innstillinger-panelet (skjema-design)
Startpunkt (skjema-design)
Skjema-aktiviteter:
Vis utskrift til PDF (PDF design)
Skjemavisning (skjema-design)
PDF-aktiviteter, under layout (PDF-design)
Når det dupliserte designet ikke lenger er i bruk, kan det slettes fra mappen det ble importert til.
Merk: Det er ikke mulig å slette et design som er i bruk i en prosess i arbeidsområdet, uavhengig av om prosessen er versjonert eller ikke. Hvis du får en feilmelding ved sletting, betyr det at designet fortsatt er i bruk. Feilmeldingen oppgir i så fall prosessen hvor designet fortsatt brukes.
For å unngå rot og forvirring bør denne rutinen følges hver gang det oppstår duplikater ved import av nye prosesser, før man importerer flere.
Import - Sjekkliste
Under følger en oppsummering av det som er gjennomgått ovenfor, og anbefalt rekkefølge for eksport og import mellom Compose-miljøer og arbeidsområder:
1. Sett opp nytt arbeidsmiljø
Opprett ønsket mappestruktur før import. Planlegg hvordan elementene skal organiseres, og bruk egne mapper for for eksempel skjema, integrasjoner, design og lister.
2. Sett opp ID-generator og Filoverføring
Disse elementene følger ikke med i eksporten og må opprettes på forhånd i det nye arbeidsområdet. Bruk samme «Tilkoblingspunkt» som i det opprinnelige miljøet.
Hvis opprinnelig ID-generator bruker stigende nummerering, er det viktig å unngå dupliserte ID-er i det nye arbeidsområdet.
3. Importer første prosess og sorter i mapper
Importer først én prosess, gjerne en som inneholder design-filer og andre elementer felles for kommende prosesser.
Flytt design og andre elementer til egne mapper, og rydd arbeidsområdet før import av flere prosesser.
4. Importer resterende prosesser
Importer øvrige prosesser. Nye elementer som følger med, bør fortløpende flyttes til riktig mappe.
Det anbefales å importere på prosessnivå for å sikre at alle nødvendige elementer blir med, med mindre man f.eks. kun ønsker å importere et skjema som ennå ikke inngår i en prosess. Elementer som allerede finnes i arbeidsområdet, blir ikke importert på nytt (med unntak av design-filer).
Følg alltid rutinen for håndtering av dupliserte design-filer når du importerer en ny prosess som bruker eksisterende design. Gjør dette før du importerer flere prosesser.