Ft.Datafangst.Tool 2.1.1

FT-Tool 🔧

Is a CLI tool with a few utilites that makes it easier to work with Altinn repos locally.

Installation

dotnet tool install --global Ft.Datafangst.Tool
# or update
dotnet tool update --global Ft.Datafangst.Tool

Usage

Noen av verktøyene under krever at du cd .\App\ fra root.

Summary

Genererer ny summary fil

ft-tool summary

Grid

Legger på grid i alle layout-filer

ft-tool grid

Nynorsk

Lager nynorsk-oversettelse av skjemaet

ft-tool nynorsk

Dersom du trenger at en spesifik tekst ikke blir oversatt kan du legge til en fil som heter ignore.nn.json i samme mappe som språkfilene. Denne må inneholde en liste over de tekstene som ikke skal bli oversatt

[
  "1-2-Input.title",
  "1-4-Input.title"
]

TekstRens

Fjerner ubrukte tekster i tekst ressurs filene. NB: Kan fjerne teksten til tekster som er lagt til programatisk.

ft-tool tekstrens

Validate

Validerer appen

ft-tool validate

Schema Injector

ft-tool schemaInjector

Lager et midlertidig json-schema for layout-filer med hensikt å muliggjøre IntelliSense/auto-complete for paths i DataModelBindings basert på strukturen på datamodell. Skal kun brukes under utvikling. <br>Husk: Endrer $schema-verdien i alle layoutfiler (utenom summary), bruk schemaInjector --revert for å tilbakestille til opprinnelig schema (fra Altinn CDN) og slette midlertidig schema-fil.

Text Resource Generator

ft-tool textGenerator

Genererer en språkfil fra flere delfiler. Dette betyr at du kan jobbe med mindre filer og kombinere dem sammen med dette værktøyet. Du trenger en ny mappe i text mappen med navn "nb". Pathen til denne blir da App/config/texts/nb. Inne i denne kan du skrive så mange språkfiler som du vil så lenge de har strukturen til en standard språkfil. dvs.

{
  "resources": [
    {
      "id": "appName",
      "value": "KRT-1116 Søknad om vedtektsendring for finansforetak og finansstiftelser"
    }
  ]
}

Det er også mulig å legge på "kommentarer" ved å legge på ekstra json attributter for hver språk komponent.

{
  "resources": [
    {
      "id": "1-Header.title",
      "value": "**1. Generelle opplysninger**",
      "comment": "here is a comment"
    }
  ]
}

Man kan også sette "ignore" på språk komponentene som betyr at neste gang man kjører oversetteren vil de komponentene bli ignorert dersom det allerede finnes en oversatt versjon av komponenten på det oversatte språket.

{
  "resources": [
    {
      "id": "1-Header.title",
      "value": "**1. Generelle opplysninger**",
      "ignore": ["nn"]
    }
  ]
}

Lag nuget release

Nuget releaser er basert på git tags, og det er satt opp en workflow som bygger og pusher en ny release til nuget hver gang det kommer en ny tag til github. En ny tag kan enten lages med git lokalt og pushes opp til repo, eller man kan lage en ny release i github gui og i prosessen opprette en ny tag basert på master.

Nuget versjonsnummer hentes fra tag, så det er viktig at man bruker rett format. Tag navn skal starte med v og fortsette med [major].[minor].[patch] Typiske eksempler vil da være v1.0.2 og v1.23.3.

For at workflow deploy skal virke må det være konfigurert en secret NUGET_API_KEY som inneholder en api nøkkel til finanstilsynets nuget bruker.