{"title":"Codeunit 131000 Library - Utility, procedures","url":"https://jonas-paprotka.de/ref/codeunit/131000-library-utility/procedures/","author":"JOP-AL","license":"Metadata from Microsoft's symbol packages. AL source MIT, Copyright (c) Microsoft Corporation. Selection and wording © 2026 JOP-AL. https://jonas-paprotka.de/licenses/","subject":"Microsoft Dynamics 365 Business Central","checked":"2026-11-20","changed":"2026-10-05","object":{"type":"codeunit","id":131000,"name":"Library - Utility","app":"Application Test Library","versions":"28-29","url":"https://jonas-paprotka.de/ref/codeunit/131000-library-utility/","json":"https://jonas-paprotka.de/ref/codeunit/131000-library-utility.json"},"aspect":"procedures","total":49,"rows":[{"name":"CreateNoSeries","sig":"(var Record No. Series, Boolean, Boolean, Boolean)","named":"(var NoSeries: Record \"No. Series\"; Default: Boolean; Manual: Boolean; DateOrder: Boolean)","returns":"","kind":"procedure","access":"public","obsolete":null,"range":"28-29","first":28,"last":29,"obsoleteSince":null,"spans":[{"from":28,"to":29,"named":"(var NoSeries: Record \"No. Series\"; Default: Boolean; Manual: Boolean; DateOrder: Boolean)","returns":"","kind":"procedure","access":"public","obsolete":null}]},{"name":"CreateNoSeries","sig":"(Code[20], Boolean, Boolean, Boolean)","named":"(NoSeriesCode: Code[20]; Default: Boolean; Manual: Boolean; DateOrder: Boolean)","returns":"","kind":"procedure","access":"public","obsolete":null,"range":"28-29","first":28,"last":29,"obsoleteSince":null,"spans":[{"from":28,"to":29,"named":"(NoSeriesCode: Code[20]; Default: Boolean; Manual: Boolean; DateOrder: Boolean)","returns":"","kind":"procedure","access":"public","obsolete":null}]},{"name":"CreateNoSeriesLine","sig":"(var Record No. Series Line, Code[20], Code[20], Code[20])","named":"(var NoSeriesLine: Record \"No. Series Line\"; SeriesCode: Code[20]; StartingNo: Code[20]; EndingNo: Code[20])","returns":"","kind":"procedure","access":"public","obsolete":null,"range":"28-29","first":28,"last":29,"obsoleteSince":null,"spans":[{"from":28,"to":29,"named":"(var NoSeriesLine: Record \"No. Series Line\"; SeriesCode: Code[20]; StartingNo: Code[20]; EndingNo: Code[20])","returns":"","kind":"procedure","access":"public","obsolete":null}]},{"name":"CreateRecordLink","sig":"(Variant)","named":"(RecVar: Variant)","returns":"Integer","kind":"procedure","access":"public","obsolete":null,"range":"28-29","first":28,"last":29,"obsoleteSince":null,"spans":[{"from":28,"to":29,"named":"(RecVar: Variant)","returns":"Integer","kind":"procedure","access":"public","obsolete":null}]},{"name":"CreateRecordLink","sig":"(Variant, Option)","named":"(RecVar: Variant; LinkType: Option)","returns":"Integer","kind":"procedure","access":"public","obsolete":null,"range":"28-29","first":28,"last":29,"obsoleteSince":null,"spans":[{"from":28,"to":29,"named":"(RecVar: Variant; LinkType: Option)","returns":"Integer","kind":"procedure","access":"public","obsolete":null}]},{"name":"CheckFieldExistenceInTable","sig":"(Integer, Text[30])","named":"(TableNo: Integer; FieldName: Text[30])","returns":"Boolean","kind":"procedure","access":"public","obsolete":null,"range":"28-29","first":28,"last":29,"obsoleteSince":null,"spans":[{"from":28,"to":29,"named":"(TableNo: Integer; FieldName: Text[30])","returns":"Boolean","kind":"procedure","access":"public","obsolete":null}]},{"name":"CompareTwoRecords","sig":"(RecordRef, RecordRef, Integer, Boolean, var Integer, var Variant, var Variant, var Integer)","named":"(RecRef1: RecordRef; RecRef2: RecordRef; FieldCountsToBeIgnored: Integer; DiscardDateTimeFields: Boolean; var FieldNumbersNotMatched: array[200] of Integer; var Value1: array[200] of Variant; var Value2: array[200] of Variant; var MismatchCount: Integer)","returns":"Boolean","kind":"procedure","access":"public","obsolete":null,"range":"28-29","first":28,"last":29,"obsoleteSince":null,"spans":[{"from":28,"to":29,"named":"(RecRef1: RecordRef; RecRef2: RecordRef; FieldCountsToBeIgnored: Integer; DiscardDateTimeFields: Boolean; var FieldNumbersNotMatched: array[200] of Integer; var Value1: array[200] of Variant; var Value2: array[200] of Variant; var MismatchCount: Integer)","returns":"Boolean","kind":"procedure","access":"public","obsolete":null}]},{"name":"ConvertMilliSecToHours","sig":"(Decimal)","named":"(TimePeriod: Decimal)","returns":"Decimal","kind":"procedure","access":"public","obsolete":null,"range":"28-29","first":28,"last":29,"obsoleteSince":null,"spans":[{"from":28,"to":29,"named":"(TimePeriod: Decimal)","returns":"Decimal","kind":"procedure","access":"public","obsolete":null}]},{"name":"ConvertHoursToMilliSec","sig":"(Decimal)","named":"(TimePeriod: Decimal)","returns":"Decimal","kind":"procedure","access":"public","obsolete":null,"range":"28-29","first":28,"last":29,"obsoleteSince":null,"spans":[{"from":28,"to":29,"named":"(TimePeriod: Decimal)","returns":"Decimal","kind":"procedure","access":"public","obsolete":null}]},{"name":"ConvertNumericToText","sig":"(Text)","named":"(NumericCode: Text)","returns":"Text","kind":"procedure","access":"public","obsolete":null,"range":"28-29","first":28,"last":29,"obsoleteSince":null,"spans":[{"from":28,"to":29,"named":"(NumericCode: Text)","returns":"Text","kind":"procedure","access":"public","obsolete":null}]},{"name":"ConvertCRLFToBackSlash","sig":"(Text)","named":"(TextIn: Text)","returns":"Text","kind":"procedure","access":"public","obsolete":null,"range":"28-29","first":28,"last":29,"obsoleteSince":null,"spans":[{"from":28,"to":29,"named":"(TextIn: Text)","returns":"Text","kind":"procedure","access":"public","obsolete":null}]},{"name":"FindFieldNoInTable","sig":"(Integer, Text[30])","named":"(TableNo: Integer; FieldName: Text[30])","returns":"Integer","kind":"procedure","access":"public","obsolete":null,"range":"28-29","first":28,"last":29,"obsoleteSince":null,"spans":[{"from":28,"to":29,"named":"(TableNo: Integer; FieldName: Text[30])","returns":"Integer","kind":"procedure","access":"public","obsolete":null}]},{"name":"GetFieldLength","sig":"(Integer, Integer)","named":"(TableNo: Integer; FieldNo: Integer)","returns":"Integer","kind":"procedure","access":"public","obsolete":null,"range":"28-29","first":28,"last":29,"obsoleteSince":null,"spans":[{"from":28,"to":29,"named":"(TableNo: Integer; FieldNo: Integer)","returns":"Integer","kind":"procedure","access":"public","obsolete":null}]},{"name":"GetLastTransactionNo","sig":"()","named":"()","returns":"Integer","kind":"procedure","access":"public","obsolete":null,"range":"28-29","first":28,"last":29,"obsoleteSince":null,"spans":[{"from":28,"to":29,"named":"()","returns":"Integer","kind":"procedure","access":"public","obsolete":null}]},{"name":"GetNewRecNo","sig":"(Variant, Integer)","named":"(RecVariant: Variant; FieldNo: Integer)","returns":"Integer","kind":"procedure","access":"public","obsolete":null,"range":"28-29","first":28,"last":29,"obsoleteSince":null,"spans":[{"from":28,"to":29,"named":"(RecVariant: Variant; FieldNo: Integer)","returns":"Integer","kind":"procedure","access":"public","obsolete":null}]},{"name":"GetNewLineNo","sig":"(RecordRef, Integer)","named":"(RecRef: RecordRef; FieldNo: Integer)","returns":"Integer","kind":"procedure","access":"public","obsolete":null,"range":"28-29","first":28,"last":29,"obsoleteSince":null,"spans":[{"from":28,"to":29,"named":"(RecRef: RecordRef; FieldNo: Integer)","returns":"Integer","kind":"procedure","access":"public","obsolete":null}]},{"name":"GetGlobalNoSeriesCode","sig":"()","named":"()","returns":"Code[20]","kind":"procedure","access":"public","obsolete":null,"range":"28-29","first":28,"last":29,"obsoleteSince":null,"spans":[{"from":28,"to":29,"named":"()","returns":"Code[20]","kind":"procedure","access":"public","obsolete":null}]},{"name":"GetNextNoSeriesSalesDate","sig":"(Code[20])","named":"(NoSeriesCode: Code[20])","returns":"Date","kind":"procedure","access":"public","obsolete":null,"range":"28-29","first":28,"last":29,"obsoleteSince":null,"spans":[{"from":28,"to":29,"named":"(NoSeriesCode: Code[20])","returns":"Date","kind":"procedure","access":"public","obsolete":null}]},{"name":"GetNextNoSeriesPurchaseDate","sig":"(Code[20])","named":"(NoSeriesCode: Code[20])","returns":"Date","kind":"procedure","access":"public","obsolete":null,"range":"28-29","first":28,"last":29,"obsoleteSince":null,"spans":[{"from":28,"to":29,"named":"(NoSeriesCode: Code[20])","returns":"Date","kind":"procedure","access":"public","obsolete":null}]},{"name":"GetNextNoFromNoSeries","sig":"(Code[20], Date)","named":"(NoSeriesCode: Code[20]; PostingDate: Date)","returns":"Code[20]","kind":"procedure","access":"public","obsolete":null,"range":"28-29","first":28,"last":29,"obsoleteSince":null,"spans":[{"from":28,"to":29,"named":"(NoSeriesCode: Code[20]; PostingDate: Date)","returns":"Code[20]","kind":"procedure","access":"public","obsolete":null}]},{"name":"GenerateRandomCode","sig":"(Integer, Integer)","named":"(FieldNo: Integer; TableNo: Integer)","returns":"Code[10]","kind":"procedure","access":"public","obsolete":null,"range":"28-29","first":28,"last":29,"obsoleteSince":null,"spans":[{"from":28,"to":29,"named":"(FieldNo: Integer; TableNo: Integer)","returns":"Code[10]","kind":"procedure","access":"public","obsolete":null}]},{"name":"GenerateRandomCodeWithLength","sig":"(Integer, Integer, Integer)","named":"(FieldNo: Integer; TableNo: Integer; CodeLength: Integer)","returns":"Code[10]","kind":"procedure","access":"public","obsolete":null,"range":"28-29","first":28,"last":29,"obsoleteSince":null,"spans":[{"from":28,"to":29,"named":"(FieldNo: Integer; TableNo: Integer; CodeLength: Integer)","returns":"Code[10]","kind":"procedure","access":"public","obsolete":null}]},{"name":"GenerateRandomCode20","sig":"(Integer, Integer)","named":"(FieldNo: Integer; TableNo: Integer)","returns":"Code[20]","kind":"procedure","access":"public","obsolete":null,"range":"28-29","first":28,"last":29,"obsoleteSince":null,"spans":[{"from":28,"to":29,"named":"(FieldNo: Integer; TableNo: Integer)","returns":"Code[20]","kind":"procedure","access":"public","obsolete":null}]},{"name":"GenerateRandomText","sig":"(Integer)","named":"(Length: Integer)","returns":"Text","kind":"procedure","access":"public","obsolete":null,"range":"28-29","first":28,"last":29,"obsoleteSince":null,"spans":[{"from":28,"to":29,"named":"(Length: Integer)","returns":"Text","kind":"procedure","access":"public","obsolete":null}]},{"name":"GenerateRandomUnicodeText","sig":"(Integer)","named":"(Length: Integer)","returns":"Text","kind":"procedure","access":"public","obsolete":null,"range":"28-29","first":28,"last":29,"obsoleteSince":null,"spans":[{"from":28,"to":29,"named":"(Length: Integer)","returns":"Text","kind":"procedure","access":"public","obsolete":null}]},{"name":"GenerateRandomXMLText","sig":"(Integer)","named":"(Length: Integer)","returns":"Text","kind":"procedure","access":"public","obsolete":null,"range":"28-29","first":28,"last":29,"obsoleteSince":null,"spans":[{"from":28,"to":29,"named":"(Length: Integer)","returns":"Text","kind":"procedure","access":"public","obsolete":null}]},{"name":"GenerateRandomNumericText","sig":"(Integer)","named":"(Length: Integer)","returns":"Text","kind":"procedure","access":"public","obsolete":null,"range":"28-29","first":28,"last":29,"obsoleteSince":null,"spans":[{"from":28,"to":29,"named":"(Length: Integer)","returns":"Text","kind":"procedure","access":"public","obsolete":null}]},{"name":"GenerateRandomAlphabeticText","sig":"(Integer, Option)","named":"(Length: Integer; Option: Option Capitalized,Literal)","returns":"Text","kind":"procedure","access":"public","obsolete":null,"range":"28-29","first":28,"last":29,"obsoleteSince":null,"spans":[{"from":28,"to":29,"named":"(Length: Integer; Option: Option Capitalized,Literal)","returns":"Text","kind":"procedure","access":"public","obsolete":null}]},{"name":"GenerateRandomEmail","sig":"()","named":"()","returns":"Text[45]","kind":"procedure","access":"public","obsolete":null,"range":"28-29","first":28,"last":29,"obsoleteSince":null,"spans":[{"from":28,"to":29,"named":"()","returns":"Text[45]","kind":"procedure","access":"public","obsolete":null}]},{"name":"GenerateRandomEmails","sig":"()","named":"()","returns":"Text[80]","kind":"procedure","access":"public","obsolete":null,"range":"28-29","first":28,"last":29,"obsoleteSince":null,"spans":[{"from":28,"to":29,"named":"()","returns":"Text[80]","kind":"procedure","access":"public","obsolete":null}]},{"name":"GenerateRandomPhoneNo","sig":"()","named":"()","returns":"Text[20]","kind":"procedure","access":"public","obsolete":null,"range":"28-29","first":28,"last":29,"obsoleteSince":null,"spans":[{"from":28,"to":29,"named":"()","returns":"Text[20]","kind":"procedure","access":"public","obsolete":null}]},{"name":"GenerateRandomFraction","sig":"()","named":"()","returns":"Decimal","kind":"procedure","access":"public","obsolete":null,"range":"28-29","first":28,"last":29,"obsoleteSince":null,"spans":[{"from":28,"to":29,"named":"()","returns":"Decimal","kind":"procedure","access":"public","obsolete":null}]},{"name":"GenerateRandomDate","sig":"(Date, Date)","named":"(MinDate: Date; MaxDate: Date)","returns":"Date","kind":"procedure","access":"public","obsolete":null,"range":"28-29","first":28,"last":29,"obsoleteSince":null,"spans":[{"from":28,"to":29,"named":"(MinDate: Date; MaxDate: Date)","returns":"Date","kind":"procedure","access":"public","obsolete":null}]},{"name":"GenerateGUID","sig":"()","named":"()","returns":"Code[10]","kind":"procedure","access":"public","obsolete":null,"range":"28-29","first":28,"last":29,"obsoleteSince":null,"spans":[{"from":28,"to":29,"named":"()","returns":"Code[10]","kind":"procedure","access":"public","obsolete":null}]},{"name":"GetEmptyGuid","sig":"()","named":"()","returns":"Guid","kind":"procedure","access":"public","obsolete":null,"range":"28-29","first":28,"last":29,"obsoleteSince":null,"spans":[{"from":28,"to":29,"named":"()","returns":"Guid","kind":"procedure","access":"public","obsolete":null}]},{"name":"GenerateRandomRec","sig":"(var RecordRef)","named":"(var RecRef: RecordRef)","returns":"","kind":"procedure","access":"public","obsolete":null,"range":"28-29","first":28,"last":29,"obsoleteSince":null,"spans":[{"from":28,"to":29,"named":"(var RecRef: RecordRef)","returns":"","kind":"procedure","access":"public","obsolete":null}]},{"name":"GenerateMOD97CompliantCode","sig":"()","named":"()","returns":"Code[10]","kind":"procedure","access":"public","obsolete":null,"range":"28-29","first":28,"last":29,"obsoleteSince":null,"spans":[{"from":28,"to":29,"named":"()","returns":"Code[10]","kind":"procedure","access":"public","obsolete":null}]},{"name":"ExistsDecimalValueInArray","sig":"(Text[250], Decimal)","named":"(RowValueSet: array[250] of Text[250]; Value: Decimal)","returns":"Boolean","kind":"procedure","access":"public","obsolete":null,"range":"28-29","first":28,"last":29,"obsoleteSince":null,"spans":[{"from":28,"to":29,"named":"(RowValueSet: array[250] of Text[250]; Value: Decimal)","returns":"Boolean","kind":"procedure","access":"public","obsolete":null}]},{"name":"FindRecord","sig":"(var RecordRef)","named":"(var RecRef: RecordRef)","returns":"","kind":"procedure","access":"public","obsolete":null,"range":"28-29","first":28,"last":29,"obsoleteSince":null,"spans":[{"from":28,"to":29,"named":"(var RecRef: RecordRef)","returns":"","kind":"procedure","access":"public","obsolete":null}]},{"name":"LineBreak","sig":"()","named":"()","returns":"Text","kind":"procedure","access":"public","obsolete":null,"range":"28-29","first":28,"last":29,"obsoleteSince":null,"spans":[{"from":28,"to":29,"named":"()","returns":"Text","kind":"procedure","access":"public","obsolete":null}]},{"name":"FindOrCreateCodeRecord","sig":"(Integer)","named":"(TableID: Integer)","returns":"Code[10]","kind":"procedure","access":"public","obsolete":null,"range":"28-29","first":28,"last":29,"obsoleteSince":null,"spans":[{"from":28,"to":29,"named":"(TableID: Integer)","returns":"Code[10]","kind":"procedure","access":"public","obsolete":null}]},{"name":"CreateCodeRecord","sig":"(Integer)","named":"(TableID: Integer)","returns":"Code[10]","kind":"procedure","access":"public","obsolete":null,"range":"28-29","first":28,"last":29,"obsoleteSince":null,"spans":[{"from":28,"to":29,"named":"(TableID: Integer)","returns":"Code[10]","kind":"procedure","access":"public","obsolete":null}]},{"name":"UpdateSetupNoSeriesCode","sig":"(Integer, Integer)","named":"(TableID: Integer; FieldID: Integer)","returns":"","kind":"procedure","access":"public","obsolete":null,"range":"28-29","first":28,"last":29,"obsoleteSince":null,"spans":[{"from":28,"to":29,"named":"(TableID: Integer; FieldID: Integer)","returns":"","kind":"procedure","access":"public","obsolete":null}]},{"name":"AddTempField","sig":"(var Record Field, Integer, Integer)","named":"(var TempField: Record Field temporary; FieldNo: Integer; TableNo: Integer)","returns":"","kind":"procedure","access":"public","obsolete":null,"range":"28-29","first":28,"last":29,"obsoleteSince":null,"spans":[{"from":28,"to":29,"named":"(var TempField: Record Field temporary; FieldNo: Integer; TableNo: Integer)","returns":"","kind":"procedure","access":"public","obsolete":null}]},{"name":"GetMaxOptionIndex","sig":"(Text)","named":"(OptionString: Text)","returns":"Integer","kind":"procedure","access":"public","obsolete":null,"range":"28-29","first":28,"last":29,"obsoleteSince":null,"spans":[{"from":28,"to":29,"named":"(OptionString: Text)","returns":"Integer","kind":"procedure","access":"public","obsolete":null}]},{"name":"GetMaxFieldOptionIndex","sig":"(Integer, Integer)","named":"(TableNo: Integer; FieldNo: Integer)","returns":"Integer","kind":"procedure","access":"public","obsolete":null,"range":"28-29","first":28,"last":29,"obsoleteSince":null,"spans":[{"from":28,"to":29,"named":"(TableNo: Integer; FieldNo: Integer)","returns":"Integer","kind":"procedure","access":"public","obsolete":null}]},{"name":"FillFieldMaxText","sig":"(Variant, Integer)","named":"(RecVar: Variant; FieldNo: Integer)","returns":"","kind":"procedure","access":"public","obsolete":null,"range":"28-29","first":28,"last":29,"obsoleteSince":null,"spans":[{"from":28,"to":29,"named":"(RecVar: Variant; FieldNo: Integer)","returns":"","kind":"procedure","access":"public","obsolete":null}]},{"name":"DecStr","sig":"(Text)","named":"(str: Text)","returns":"Text","kind":"procedure","access":"public","obsolete":null,"range":"28-29","first":28,"last":29,"obsoleteSince":null,"spans":[{"from":28,"to":29,"named":"(str: Text)","returns":"Text","kind":"procedure","access":"public","obsolete":null}]},{"name":"GetNoSeriesLine","sig":"(Code[20], var Record No. Series Line)","named":"(noSeriesCode: Code[20]; var noSeriesLine: Record \"No. Series Line\")","returns":"Boolean","kind":"procedure","access":"public","obsolete":null,"range":"28-29","first":28,"last":29,"obsoleteSince":null,"spans":[{"from":28,"to":29,"named":"(noSeriesCode: Code[20]; var noSeriesLine: Record \"No. Series Line\")","returns":"Boolean","kind":"procedure","access":"public","obsolete":null}]}]}