Konfigurationsfil-liste

Denne side kommer frem, når man i Konfigurationsfil-oversigt klikker på en folder. Siden viser de underfoldere og filer (rapporter, test-scripts mm), der ligger i den valgte folder. Nogenlunde ligesom når man arbejder i Windows Explorer / Stifinder.

Top-niveauet åbnes ved at klikke på linket i toppen af siden Konfigurationsfil-oversigt (dette link har forskellige tekstre afhængigt af om man det er rapporter, test-scripts el. lign., der vises).

Sidens indhold

Indholdet på siden afhænger af den aktuelle brugers rettigheder:

• Som "almindelig" bruger (der ikke har rettighed til at rette i konfigurationen) kan man kun:
  • Gå ned i underfoldere ved at klikke på underfolder-navnene.
  • Ekskvere filer ved at klikke på filnavnet.
  Det vil sige, at som "almindelig" bruger, der "kun" skal køre rapporter, får man ikke yderligere muligheder ud over dem der er i Konfigurationsfil-oversigt.
• Når brugeren har rettighed til at rette i konfigurationen, er der mange flere muligheder:
  • Man kan oprette ny underfoldere ved at klikke på knappen Opret folder.
  • Man kan slette såvel underfoldere (med indhold!) som enkelte filer, også selvom de er skrivebeskyttede (har read-only attribut er sat)! Man kan slette på flg. måder:
    • Slet enkelt fil/folder ved at klikke på ikonet . Man kan også klikke på egenskabs-ikonet , og klikke på knappen Slet i den dialog, der popper op.
    • Slet alle filer/underfoldere i en folder ved at klikke på knappen Slet alt.
    • Slet udvalgte filer/underfoldere ved sætte flueben i checkboxene ud for de objekter, der ønskes slettet, og klik på knappen Slet valgte.
  • Man kan rette navn på filer (omdøbe) ved at klikke på egenskabs-ikonet .
  • Man kan oprette zip-filer, der indholder alle underfoldere og filer på det valgte niveau og "nedefter". Den resulterende zip-fil placeres i den aktuelle folder, hvorfra den efterfølgende kan downloades (højreklik på linket "Åbn").
  • Man kan både upload'e og download'e filer. En fil kan være
    • en enkelt fil (f.eks. en rapport-definition)
    • en zip-fil
  • For at downloade skal man højre-klikke på linket "Åbn" og vælge "Gem destination som...".
  • For at uploade skal man klikke på knappen Upload. Dette åbner en dialog, hvor man skal vælge en fil i sit lokale filsystem.
    • Hvis der allerede findes en fil med samme navn som den der uploades, bliver den overskrevet - også selvom den den er skrivebeskyttet (har read-only-attribut sat)!
    • Når man upload'er en zip-fil, bliver alle filerne i denne zip-fil automatisk pakket ud og lagt ind i folderstrukturen på det aktuelle niveau. Eksisterende filer bliver automatisk overskrevet, også selvom read-only attribut er sat på filerne.
    • NB: Det er op til konfiguratøren at holde styr på, at den rigtige zip-fil bliver uploadet i den rigtige folder. Eller bliver folderstrukturen i det miljø, man uploader til, anderledes end i det miljø man downloader fra, En sikker måde at styre dette, er at arbejde på så højt niveau som muligt. Hvis man kun ønsker at deployere filer på et lavere niveau, er det vigtigt at man "står" på samme folder når man uploader, som da man dannede zip-filen og downloadede den.
  Ovenstående funktionalitet kan bruges til at konfigurere i et miljø, hvor man ikke har direkte adgang til filsystemet på webserveren. Ofte er situationen dog den, at man konfigurerer rapporter i lokalt udviklingsmiljø, hvor man HAR adgang filsystemet på webserveren - og at man så har behov for at kopiere konfigurationen fra udviklingsmiljøet til et eller flere andre miljøer (f.eks. test-, undervisnings- og drifts-miljøer). I sådanne tilfælde er det mere formålstjenligt at bruge deployerings-funktionen, som også er tilgængelig fra denne side (fra og med datamodel-version 4.12). Man kan deployere enkelte filer eller hele foldere ad gangen.
  Bemærk at denne funktion KUN omhandler upload/download/deployering af filer i konfigurationen. Deployering af rapporter indebærer ofte også andre trin, såsom oprettelse af views i databasen og/eller deployering af Reporting Services-rapporter. Disse opgaver hjælper den her beskrevne funktion IKKE med.

Filtyper (extensions)

Som konfiguratør kan man upload'e, slette, omdøbe, deployere osv. filer af alle filtyper (extensions). Men kun "kendte" filtyper genererer links, brugeren kan klikke på (ekskvere).

Følgende filtype er kendt af systemet:

De samme filtyper kan også ses i Konfigurationsfil-oversigt.

Eksekver batch

Når en folder indeholder én eller flere filer af en type, der tillader batch-afvikling (gælder pt. kun filtypen sql), er der mulighed for batch-afvikling. Dvs. man kan køre alle scripts i en folder - eller udvalgte scripts (som man har markeret med flueben i checkboxene).

• Den funktion bruger sqlcmd til at køre scripts'ene med. Kører et SQL-script i SQL Server Management Studio eller sqlcmd, så kører det også i TOPICA. Dog understøttes kommandoline-parametre til sqlcmd ($(xxx)) ikke.
• Det output, SQL'en genererer f.eks. v.hj.a. SELECT eller PRINT (samt ikke mindst fejlmeddelelser!), vises for hvert script.
• Der kan vælges mellem følgende strategier for håndtering af fejl i SQL-scripts'ene:
  • Fejl i scripts ignores - hvert script fortsætter efter fejl, og exit code bliver 0 = OK.
    Husk at kigge i SQL-output'et for at checke, om der er opstået fejl!
  • Ved fejl i et script stoppes videre processering af dette script, og exit code for dette script bliver 1 = fejl.
    Batch-kørslen fortsætter med de følgende scripts.
  • Ved fejl i et script stoppes videre processering af dette script, og exit code for dette script bliver 1 = fejl.
    De efterfølgende scripts i batch-kørslen processeres IKKE.