Malpakkekatalog

Malpakkekatalogen lar porteføljeadministrator hente nye prosjektmaler, prosjekttillegg og standardinnhold direkte inn i Prosjektportalen, uten å vente på en ny versjon av selve løsningen. Pakkene publiseres i et sentralt mallager som Prosjektportalen-teamet vedlikeholder, og katalogen viser alltid det som er tilgjengelig der akkurat nå.

Katalogen er tilgjengelig fra Prosjektportalen versjon 1.14.0.

Begreper

Malpakke er en pakke som inneholder alt som trengs for å ta noe nytt i bruk i Prosjektportalen. Katalogen har tre typer pakker:

Type	Hva pakken inneholder	Hvor den havner
Mal	En komplett prosjektmal med oppsett av prosjektområdet, gjerne med tilhørende kolonner, innholdstyper, termsett, prosjekttillegg og standardinnhold	Maloppsett på porteføljenivå, og blir valgbar i oppsettveiviseren for nye prosjekter
Tillegg	Et prosjekttillegg som kan legges på et prosjekt, for eksempel en ekstra visning eller en ny side	Biblioteket Prosjekttillegg på porteføljenivå
Innhold	Standardinnhold som kan kopieres inn i nye prosjekter, for eksempel et bibliotek med ferdige risikoer	Listen Listeinnhold på porteføljenivå

En mal kan tas i bruk på to måter, og katalogen viser status på hver pakke:

Status	Betydning
(ingen)	Pakken er ikke tatt i bruk i din installasjon
Importert	Malen er kopiert inn i din installasjon. Du eier kopien og kan tilpasse den lokalt
Sentral	Malen er tilgjengeliggjort som skymal. Innholdet hentes fra det sentrale mallageret hver gang et prosjekt settes opp
Oppdatering!	Det finnes en nyere versjon av en pakke du allerede har tatt i bruk
Finnes lokalt	Et tillegg med samme navn finnes allerede i installasjonen, men ble ikke installert fra katalogen

Maler som er laget direkte i din installasjon, uten kobling til katalogen, kalles lokale maler. De vises ikke i katalogen og påvirkes ikke av den.

Slik åpner du katalogen

Katalogen åpnes fra listen Maloppsett på porteføljenivå.

1. Gå til Konfigurasjon av Prosjektportalen. Se Standardinnhold og endringer for hvordan du kommer dit.
2. Under Prosjektmaler og oppsett velger du Maloppsett.
3. Trykk på Malpakkekatalog i kommandolinjen over listen.

Knappen vises bare for brukere som har Full kontroll på porteføljeområdet. Ser du ikke knappen, mangler du enten tilgang, eller du står ikke i Maloppsett-listen.

Oversikten

Når katalogen åpnes, får du en oversikt over alle tilgjengelige malpakker til venstre, og detaljer om valgt pakke til høyre.

1. Søk finner pakker på navn, beskrivelse og nøkkelord.

2. Filtre lar deg avgrense på Type (Mal, Tillegg, Innhold), Kategori (utledet fra pakkenes nøkkelord), Status (Importert, Sentral, Oppdatering tilgjengelig) og Språk. Med Kun kompatible skjules pakker som krever en nyere versjon av Prosjektportalen enn du har.

3. Sortering kan settes til Nyeste eller Navn (A-Å).

4. Visning kan byttes mellom rutenett og liste.

5. Pakkekort viser bilde, navn, kort beskrivelse, nøkkelord, versjon, publiseringsdato og hvem som har laget pakken. Trykk på et nøkkelord for å vise alle pakker med samme nøkkelord.

6. Statusmerker på kortet viser om pakken er Importert, Sentral eller har en Oppdatering! tilgjengelig.

Tøm filtre nullstiller søk og alle filtre. Antall treff vises fortløpende.

Detaljer om en malpakke

Trykk på et pakkekort for å se detaljene. Her får du alt du trenger for å vurdere pakken før du tar den i bruk.

• Beskrivelse forteller hva pakken er laget for og hvem den passer for.
• Krav viser hvilken versjon av Prosjektportalen pakken krever, og om den forutsetter Bestillingsportalen eller oppsett i Microsoft Azure for full bruk. Hold pekeren over merkene for forklaring.
• Språk viser hvilke språk pakken er tilgjengelig på.
• Skjermbilder viser hvordan pakken ser ut i bruk. Bla med pilene, eller trykk på bildet for full størrelse.
• Innhold i malen lister opp det pakken faktisk legger til, gruppert på Standardinnhold, Lister, Innholdstyper, Sitekolonner, Taksonomi (termsett), Sider, Listeinnhold, Prosjekttillegg og Filer. Trykk på Se detaljer for å ekspandere, og bruk Forhåndsvis innhold for å se innholdet i en fil før du installerer.
• Historikk viser versjonshistorikken for pakken, nyeste versjon først, slik at du ser hva som er endret siden sist.

Nederst i detaljvisningen ligger knappene for å ta pakken i bruk. Hvilke knapper som vises avhenger av pakketype og status.

Ta i bruk en mal

For pakker av typen Mal kan du velge mellom to måter å ta den i bruk. Begge gjør malen tilgjengelig i oppsettveiviseren for nye prosjekter, men de skiller seg på hvor malinnholdet ligger og hvordan det holdes oppdatert.

	Kopier til min installasjon	Tilgjengeliggjør som skymal
Status i katalogen	Importert	Sentral
Hvor ligger malinnholdet?	Kopiert inn i Maloppsett, Malfiler, Prosjekttillegg og Listeinnhold på porteføljenivå	I det sentrale mallageret. Kun det som trengs på porteføljenivået (kolonner, innholdstyper, termsett og konfigurasjon) settes opp lokalt
Kan tilpasses lokalt?	Ja, som en hvilken som helst annen mal	Nei, malen brukes slik den er publisert
Hva skjer når nytt prosjekt settes opp?	Innholdet hentes fra din installasjon	Pakken lastes ned fra det sentrale mallageret av den som setter opp prosjektet
Ved ny versjon	Du velger selv om og når du oppdaterer. Lokale tilpasninger overskrives ved oppdatering	Du velger selv om og når du går over til ny versjon, ved å fjerne og tilgjengeliggjøre skymalen på nytt
Passer best når	Dere vil tilpasse malen, eller vil være uavhengige av internettilgang til mallageret ved oppsett av prosjekter	Dere vil bruke malen som den er, og ha lite å vedlikeholde lokalt

Kopier til min installasjon

1. Velg pakken og trykk Kopier til min installasjon.
2. Katalogen laster ned pakken, kontrollerer at den er gyldig og at den passer din versjon av Prosjektportalen, og kjører en kompatibilitetssjekk mot det som allerede finnes i installasjonen.
3. Finner sjekken konflikter, får du en oversikt over dem før noe endres. Hver konflikt er merket med hva som vil skje: Overskrives, Hoppes over eller Blokkert. Du kan Avbryte og rette opp manuelt, eller trykke Fortsett likevel.
4. Deretter settes innholdet opp steg for steg: kolonner, innholdstyper og lister på porteføljeområdet, termsett i termlageret, prosjektmalen som lagres for oppsettveiviseren, prosjekttillegg og listeinnhold, og til slutt oppføringen i Maloppsett. Hvert steg viser status Venter, Pågår, Fullført, Hoppet over eller Feilet.
5. Når alt er fullført, vises meldingen Malpakke importert. Malen er nå tilgjengelig i oppsettveiviseren.

Bruk Avansert logg for å se nøyaktig hva som ble gjort i hvert steg. Feiler importen underveis, vises feilen sammen med stegene, slik at du ser hva som ble fullført før feilen oppstod. Noen endringer kan da allerede være utført. Du kan kjøre Installer på nytt for å prøve igjen.

Etter import kan malen tilpasses på samme måte som andre maler i Maloppsett. Husk at lokale tilpasninger overskrives dersom du senere oppdaterer malen fra katalogen.

Tilgjengeliggjør som skymal

1. Velg pakken og trykk Tilgjengeliggjør som skymal.
2. Katalogen setter opp det malen trenger på porteføljeområdet: kolonner, innholdstyper, termsett og konfigurasjonsrader. Kompatibilitetssjekken kjøres på samme måte som ved import.
3. Malen registreres i Maloppsett med en peker til pakken i det sentrale mallageret. Selve prosjektinnholdet kopieres ikke inn.
4. Når alt er fullført, vises meldingen Skymalen er nå tilgjengelig i oppsettveiviseren.

I oppsettveiviseren vises skymaler med merket Skymal. Når en bruker velger en skymal, lastes pakken ned og leses automatisk før prosjektet settes opp. Dette krever at brukeren har internettilgang til det sentrale mallageret fra nettleseren.

Ikke alle maler kan tilgjengeliggjøres som skymal. Krever malen innhold på porteføljeområdet som ikke settes opp ved tilgjengeliggjøring, for eksempel filer i biblioteker, er knappen deaktivert. Hold pekeren over knappen for å se forklaringen. Slike maler må kopieres til installasjonen i stedet.

Ta i bruk tillegg og innholdspakker

Prosjekttillegg legges til med Legg til som prosjekttillegg. Tillegget lastes ned og legges i biblioteket Prosjekttillegg på porteføljenivå, og kan deretter velges i oppsettveiviseren. Det opprettes ingenting i Maloppsett. Ønsker du at tillegget skal være forhåndsvalgt eller låst for en bestemt mal, knytter du det selv til malen i Maloppsett.

Finnes det allerede et tillegg med samme navn i installasjonen som ikke kommer fra katalogen, vises merket Finnes lokalt, og knappen heter Erstatt med katalogversjon. Du får da en advarsel om at eventuelle lokale tilpasninger i tillegget går tapt dersom du fortsetter.

Innholdspakker legges inn på samme måte som en importert mal. Innholdet legges i en kildeliste på porteføljenivå og registreres i Listeinnhold, slik at det kan velges som standardinnhold i oppsettveiviseren.

Oppdatere en pakke

Når det finnes en nyere versjon av en pakke du har tatt i bruk, vises merket Oppdatering! på kortet, og du kan filtrere på status Oppdatering tilgjengelig. Se under Historikk hva som er nytt før du oppdaterer.

• For importerte maler heter knappen Oppdater til vX. Oppdateringen kjører samme flyt som en import, og overskriver den lokale kopien. Lokale tilpasninger går tapt.
• For skymaler peker registreringen til den versjonen som ble tilgjengeliggjort. For å gå over til ny versjon trykker du først Fjern skymal, og deretter Tilgjengeliggjør som skymal på nytt. Det som trengs på porteføljeområdet, settes da opp på nytt ved behov. Merk at knappen Oppdater til vX på en skymal i stedet kopierer malen inn i installasjonen, slik at den går fra Sentral til Importert.
• For tillegg heter knappen Oppdater tillegg til vX, og filen i Prosjekttillegg erstattes.

Er du allerede på nyeste versjon, kan du bruke Installer på nytt eller Legg til på nytt for å legge inn pakken på nytt og overskrive det som ligger lokalt.

Eksisterende prosjekter påvirkes ikke av en oppdatering. De har allerede fått innholdet sitt da de ble satt opp.

Fjerne en pakke

• Fjern installasjon fjerner en importert mal fra Maloppsett. Malen blir borte fra oppsettveiviseren, men kolonner, innholdstyper og annet som allerede er satt opp på porteføljeområdet, beholdes.
• Fjern skymal fjerner skymal-registreringen fra Maloppsett.
• Fjern på et tillegg fjerner det fra biblioteket Prosjekttillegg. Maler i Maloppsett som peker på tillegget, mister koblingen.

Du blir alltid bedt om å bekrefte før noe fjernes. Eksisterende prosjekter påvirkes ikke, og du kan legge pakken til igjen fra katalogen senere.

Krav og tilganger

• Prosjektportalen 1.14.0 eller nyere. Hver pakke angir hvilken minimumsversjon den krever. Er din versjon for gammel, vises meldingen Ikke kompatibel med din versjon, og pakken kan ikke tas i bruk før Prosjektportalen er oppgradert.
• Full kontroll på porteføljeområdet for å se knappen og gjøre endringer.
• Skrivetilgang til termlageret dersom pakken inneholder termsett. Mangler du tilgangen, stoppes operasjonen før noe endres, slik at du unngår et halvferdig resultat.
• Internettilgang til det sentrale mallageret (GitHub) fra nettleseren, både for administratoren som bruker katalogen og for brukere som setter opp prosjekter med skymaler.
• Enkelte pakker krever i tillegg Bestillingsportalen eller oppsett i Microsoft Azure for full bruk. Dette er merket under Krav i detaljvisningen.

Feilsøking

Problem	Mulig årsak og løsning
Knappen Malpakkekatalog vises ikke	Du står ikke i Maloppsett-listen, eller du mangler Full kontroll på porteføljeområdet
Kunne ikke laste katalogen	Nettleseren får ikke kontakt med det sentrale mallageret. Sjekk nettverk, proxy eller brannmur, og trykk Prøv igjen
Importen feilet	Åpne Avansert logg for å se hvilket steg som feilet. Rett opp årsaken og kjør Installer på nytt
Du har ikke tilgang til å provisjonere til hub-området	Du mangler tilstrekkelig tilgang på porteføljeområdet
Pakken krever skrivetilgang til termlageret	Be en administrator gi deg tilgang i termlageret, eller la en som har tilgangen kjøre importen
Kunne ikke laste ned skymalen i oppsettveiviseren	Brukeren som setter opp prosjektet får ikke kontakt med det sentrale mallageret. Prøv på nytt, eller vurder å kopiere malen til installasjonen i stedet

Bruksstatistikk

For å gi Prosjektportalen-teamet innsikt i hvilke pakker som brukes, sender katalogen en anonymisert hendelse hver gang en pakke installeres, oppdateres, fjernes eller tilgjengeliggjøres som skymal. Hendelsen inneholder pakke, versjon, utfall, installert versjon av Prosjektportalen og hvilken tenant og hub den gjelder. Ingen opplysninger om sluttbrukere eller prosjektinnhold sendes, og statistikken påvirker aldri om en operasjon lykkes.

Ønsker dere ikke å sende bruksstatistikk, settes innstillingen Send bruksstatistikk for malpakkekatalogen til 0 i listen Globale innstillinger på porteføljenivå.