Ft.Datafangst.Utils 1.6.6

Utilities

Contains various utilities related to development of Ft.Datafangst logic.

Add to project

dotnet add package Ft.Datafangst.Utils

NB! Must be in the project folder that it is to be added to!

Installation

To install do the following commands

dotnet tool install --global Ft.Datafangst.Utils

Update

To update do the following commands

dotnet tool update --global Ft.Datafangst.Utils

ModelStateDictionaryExtension

IsConditionInError

Adds or removes a specified errorMessage to the Microsoft.AspNetCore.Mvc.ModelBinding.ModelStateEntry.Errors instance that is associated with the specified key depending on the state.

• Param:
  • modelStateDic:Represents the state of an attempt to bind values from an HTTP Request to an action method, which includes validation information.
  • state: The criteria that gives the state where there is an error or not.
  • key: The key of the Microsoft.AspNetCore.Mvc.ModelBinding.ModelStateEntry to add errors
  • errorMsg: The error message to add
• Return:
  • A representative numerical value for the Language. Basic Example in C#

        ModelStateDictionary validationResults = new ModelStateDictionary();
        var key = "organisasjonsnummer";
        var errorMsg = "testError";
        var someCriteria = 2 + 1 == 4; //Which is false.
        validationResults.IsConditionInError(someCriteria, key, errorMsg);

StringExtensions

IsOrganizationNumberValid

Validates if orgNr is a valid Organization (Business Registration) number

• Param:
  • organizationNumber: The Organization (Business Registration) number that is to be checked if it is valid(9 digits string of numbers)
• Return:
  • Returns true or false depending in if organizationNumber number is valid or not Basic Example in C#

     true = "123456789".ConvertLanguageStringToDecimal();
     false = "123".ConvertLanguageStringToDecimal();

IsIsinValid

Checks if the provided string is a valid ISIN code.

• Param:
  • isinCode: The Organization (Business Registration) number that is to be checked if it is valid(9 digits string of numbers)
• Return:
  • Returns true or false depending in if valid ISIN code Basic Example in C#

     true = "No1234567890".ConvertLanguageStringToDecimal();
     false = "No123".ConvertLanguageStringToDecimal();

IsLeiValid

Checks if the provided string is a valid Legal Entity Identifier (LEI)

• Param: -lei: An LEI is a 20-character alphanumeric code that follows a specific format. (ISO 17442: The Global Standard) It consists of four parts: - Characters 1-4: Prefix used to ensure the uniqueness among codes from LEI issuers (Local Operating Units or LOUs). - Characters 5-18: Entity-specific part of the code generated and assigned by LOUs according to transparent, sound and robust allocation policies. As required by ISO 17442, it contains no embedded intelligence. - Characters 19-20: Two check digits as described in the ISO 17442 standard.
• Return:
  • Returns true or false depending in if valid LEI code Basic Example in C#

     true = "123400ABCDE7810FGH07".ConvertLanguageStringToDecimal();
     false = "7ZW8QJWVPR4P1J".ConvertLanguageStringToDecimal();

ConvertLanguageStringToNumeric

Converts two-letter language identifier from string (eg. "nb") to it's numerical representative. Defaults to english (1033) if no matching language string is found.

• Param:
  • language: To char string (e.g. "nb" for Norwegian)
    • nb: 1044
    • nn: 2068
    • Default: 1033
• Return:
  • A representative numerical value for the Language.

Basic Example in C#

     1044 = "nb".ConvertLanguageStringToDecimal();
     1033 = null.ConvertLanguageStringToDecimal();

GetLanguageAsNumeric

Gets the language that is set up with the user profile and converts

• Param:
  • userProfile: User profile to get language form
• Return:
  • A representative numerical value for the Language.

SetPeriode

Sets up the periode from periode type and year. Year is optional.

• Param:

  • periodeType: A representational code for a part of the year.

    • H1: 1. Halvår
    • H2: 2. Halvår
    • Q1: 1. Kvartal
    • Q2: 2. Kvartal
    • Q3: 3. Kvartal
    • Q4: 4. Kvartal
    • M1: Januar
    • M2: Februar
    • M3: Mars
    • M4: April
    • M5: Mai
    • M6: Juni
    • M7: Juli
    • M8: August
    • M9: September
    • M10: Oktober
    • M11: November
    • M12: Desember
    • Y: År
    • O: Løpende rapportering

  • year:

• Return:
  • Returns a string set together with the string from userProfile code and the year.

Basic Example in C#

     "1. halvår 2023" = "H1".SetPeriode(2023);
     "1. halvår" = "H1".SetPeriode();
     "År 2023" = null.SetPeriode("2023");
     "" = null.SetPeriode("");