{"title":"Codeunit 419 File Management, changes","url":"https://jonas-paprotka.de/ref/codeunit/419-file-management/changes/","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":419,"name":"File Management","app":"Base Application","versions":"17-29","url":"https://jonas-paprotka.de/ref/codeunit/419-file-management/","json":"https://jonas-paprotka.de/ref/codeunit/419-file-management.json"},"aspect":"changes","total":37,"rows":[{"version":27,"kind":"procedure","change":"added","name":"TempBlobToServerFile","member":{"name":"TempBlobToServerFile","sig":"(var Codeunit Temp Blob, Text)","named":"(var TempBlob: Codeunit \"Temp Blob\"; FileExt: Text)","returns":"Text[250]","kind":"procedure","access":"internal","obsolete":null}},{"version":23,"kind":"event","change":"gone","name":"OnBeforeBlobExport","member":{"name":"OnBeforeBlobExport","sig":"(var Codeunit Temp Blob, Text, Boolean, var Boolean)","named":"(var TempBlob: Codeunit \"Temp Blob\"; Name: Text; CommonDialog: Boolean; var IsHandled: Boolean)","returns":"","kind":"integrationevent","access":"local","obsolete":null}},{"version":23,"kind":"event","change":"added","name":"OnBeforeBlobExport","member":{"name":"OnBeforeBlobExport","sig":"(var Codeunit Temp Blob, Text, Boolean, var Boolean, var Text)","named":"(var TempBlob: Codeunit \"Temp Blob\"; Name: Text; CommonDialog: Boolean; var IsHandled: Boolean; var Result: Text)","returns":"","kind":"integrationevent","access":"local","obsolete":null}},{"version":21,"kind":"event","change":"gone","name":"OnBeforeDownloadHandler","member":{"name":"OnBeforeDownloadHandler","sig":"(var Text, Text, Text, var Boolean)","named":"(var ToFolder: Text; ToFileName: Text; FromFileName: Text; var IsHandled: Boolean)","returns":"","kind":"integrationevent","access":"local","obsolete":null}},{"version":21,"kind":"event","change":"added","name":"OnAfterDownloadHandler","member":{"name":"OnAfterDownloadHandler","sig":"(var Text, Text, Text, var Boolean)","named":"(var ToFolder: Text; ToFileName: Text; FromFileName: Text; var Downloaded: Boolean)","returns":"","kind":"integrationevent","access":"local","obsolete":null}},{"version":21,"kind":"event","change":"added","name":"OnBeforeBlobExportWithEncoding","member":{"name":"OnBeforeBlobExportWithEncoding","sig":"(var Codeunit Temp Blob, Text, Boolean, TextEncoding, var Text, var Boolean)","named":"(var TempBlob: Codeunit \"Temp Blob\"; Name: Text; CommonDialog: Boolean; Encoding: TextEncoding; var Result: Text; var IsHandled: Boolean)","returns":"","kind":"integrationevent","access":"local","obsolete":null}},{"version":21,"kind":"event","change":"added","name":"OnBeforeDownloadHandler","member":{"name":"OnBeforeDownloadHandler","sig":"(var Text, Text, Text, var Boolean, var Boolean)","named":"(var ToFolder: Text; ToFileName: Text; FromFileName: Text; var IsHandled: Boolean; var Downloaded: Boolean)","returns":"","kind":"integrationevent","access":"local","obsolete":null}},{"version":20,"kind":"procedure","change":"gone","name":"ClientTempFileName","member":{"name":"ClientTempFileName","sig":"(Text)","named":"(FileExtension: Text)","returns":"Text","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"IsLocalFileSystemAccessible always returns false and this procedure will always throw an error.","tag":"17.3"}}},{"version":20,"kind":"procedure","change":"gone","name":"CreateClientTempSubDirectory","member":{"name":"CreateClientTempSubDirectory","sig":"()","named":"()","returns":"Text","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"IsLocalFileSystemAccessible always returns false and this procedure will always throw an error.","tag":"17.3"}}},{"version":20,"kind":"procedure","change":"gone","name":"UploadFileSilent","member":{"name":"UploadFileSilent","sig":"(Text)","named":"(ClientFilePath: Text)","returns":"Text","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"IsLocalFileSystemAccessible always returns false and this procedure will always throw an error.","tag":"17.3"}}},{"version":20,"kind":"procedure","change":"gone","name":"UploadFileSilentToServerPath","member":{"name":"UploadFileSilentToServerPath","sig":"(Text, Text)","named":"(ClientFilePath: Text; ServerFilePath: Text)","returns":"Text","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"IsLocalFileSystemAccessible always returns false and this procedure will always throw an error.","tag":"17.3"}}},{"version":20,"kind":"procedure","change":"gone","name":"UploadFileToServer","member":{"name":"UploadFileToServer","sig":"(Text)","named":"(ClientFilePath: Text)","returns":"Text","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"IsLocalFileSystemAccessible always returns false, please use the UploadFile procedure.","tag":"17.3"}}},{"version":20,"kind":"procedure","change":"gone","name":"DownloadToFile","member":{"name":"DownloadToFile","sig":"(Text, Text)","named":"(ServerFileName: Text; ClientFileName: Text)","returns":"","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"IsLocalFileSystemAccessible always returns false, please use the DownloadHandler(ServerFileName, '', '', '', ClientFileName) procedure.","tag":"17.3"}}},{"version":20,"kind":"procedure","change":"gone","name":"AppendAllTextToClientFile","member":{"name":"AppendAllTextToClientFile","sig":"(Text, Text)","named":"(ServerFileName: Text; ClientFileName: Text)","returns":"","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"IsLocalFileSystemAccessible always returns false and this procedure will always throw an error.","tag":"17.3"}}},{"version":20,"kind":"procedure","change":"gone","name":"MoveAndRenameClientFile","member":{"name":"MoveAndRenameClientFile","sig":"(Text, Text, Text)","named":"(OldFilePath: Text; NewFileName: Text; NewSubDirectoryName: Text)","returns":"Text","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"IsLocalFileSystemAccessible always returns false and this procedure will always throw an error.","tag":"17.3"}}},{"version":20,"kind":"procedure","change":"gone","name":"CreateClientFile","member":{"name":"CreateClientFile","sig":"(Text)","named":"(FilePathName: Text)","returns":"","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"IsLocalFileSystemAccessible always returns false and this procedure will always throw an error.","tag":"17.3"}}},{"version":20,"kind":"procedure","change":"gone","name":"DeleteClientFile","member":{"name":"DeleteClientFile","sig":"(Text)","named":"(FilePath: Text)","returns":"Boolean","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"IsLocalFileSystemAccessible always returns false and this procedure will always throw an error.","tag":"17.3"}}},{"version":20,"kind":"procedure","change":"gone","name":"CopyClientFile","member":{"name":"CopyClientFile","sig":"(Text, Text, Boolean)","named":"(SourceFileName: Text; DestFileName: Text; OverWrite: Boolean)","returns":"","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"IsLocalFileSystemAccessible always returns false and this procedure will always throw an error.","tag":"17.3"}}},{"version":20,"kind":"procedure","change":"gone","name":"ClientFileExists","member":{"name":"ClientFileExists","sig":"(Text)","named":"(FilePath: Text)","returns":"Boolean","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"IsLocalFileSystemAccessible always returns false, this procedure will always return false. This procedure will be removed.","tag":"17.3"}}},{"version":20,"kind":"procedure","change":"gone","name":"ClientDirectoryExists","member":{"name":"ClientDirectoryExists","sig":"(Text)","named":"(DirectoryPath: Text)","returns":"Boolean","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"IsLocalFileSystemAccessible always returns false, this procedure will always return false. This procedure will be removed.","tag":"17.3"}}},{"version":20,"kind":"procedure","change":"gone","name":"CreateClientDirectory","member":{"name":"CreateClientDirectory","sig":"(Text)","named":"(DirectoryPath: Text)","returns":"","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"IsLocalFileSystemAccessible always returns false and this procedure will always throw an error.","tag":"17.3"}}},{"version":20,"kind":"procedure","change":"gone","name":"DeleteClientDirectory","member":{"name":"DeleteClientDirectory","sig":"(Text)","named":"(DirectoryPath: Text)","returns":"","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"IsLocalFileSystemAccessible always returns false and this procedure will always throw an error.","tag":"17.3"}}},{"version":20,"kind":"procedure","change":"gone","name":"UploadClientDirectorySilent","member":{"name":"UploadClientDirectorySilent","sig":"(Text, Text, Boolean)","named":"(DirectoryPath: Text; FileExtensionFilter: Text; IncludeSubDirectories: Boolean)","returns":"Text","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"IsLocalFileSystemAccessible always returns false and this procedure will always throw an error.","tag":"17.3"}}},{"version":20,"kind":"procedure","change":"gone","name":"MoveFile","member":{"name":"MoveFile","sig":"(Text, Text)","named":"(SourceFileName: Text; TargetFileName: Text)","returns":"","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"IsLocalFileSystemAccessible always returns false and this procedure will always throw an error.","tag":"17.3"}}},{"version":20,"kind":"procedure","change":"gone","name":"GetClientDirectoryFilesList","member":{"name":"GetClientDirectoryFilesList","sig":"(var Record Name/Value Buffer, Text)","named":"(var NameValueBuffer: Record \"Name/Value Buffer\"; DirectoryPath: Text)","returns":"","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"IsLocalFileSystemAccessible always returns false and this procedure will always throw an error.","tag":"17.3"}}},{"version":20,"kind":"procedure","change":"gone","name":"GetClientFileProperties","member":{"name":"GetClientFileProperties","sig":"(Text, var Date, var Time, var BigInteger)","named":"(FullFileName: Text; var ModifyDate: Date; var ModifyTime: Time; var Size: BigInteger)","returns":"Boolean","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"IsLocalFileSystemAccessible always returns false and this procedure will always throw an error.","tag":"17.3"}}},{"version":20,"kind":"procedure","change":"gone","name":"OpenFileDialog","member":{"name":"OpenFileDialog","sig":"(Text[50], Text, Text)","named":"(WindowTitle: Text[50]; DefaultFileName: Text; FilterString: Text)","returns":"Text","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"The local file system is no longer accessible. Please use the UploadFile procedure.","tag":"17.3"}}},{"version":20,"kind":"procedure","change":"gone","name":"SaveFileDialog","member":{"name":"SaveFileDialog","sig":"(Text[50], Text, Text)","named":"(WindowTitle: Text[50]; DefaultFileName: Text; FilterString: Text)","returns":"Text","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"The local file system is no longer accessible. The procedure will always return an empty string. This procdure will be removed.","tag":"17.3"}}},{"version":20,"kind":"procedure","change":"gone","name":"SelectFolderDialog","member":{"name":"SelectFolderDialog","sig":"(Text, var Text)","named":"(WindowTitle: Text; var SelectedFolder: Text)","returns":"Boolean","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"The local file system is no longer accessible and this procedure will always return false.","tag":"17.3"}}},{"version":20,"kind":"procedure","change":"gone","name":"IsLocalFileSystemAccessible","member":{"name":"IsLocalFileSystemAccessible","sig":"()","named":"()","returns":"Boolean","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"The windows client type has been retired. This procedure will always return false.","tag":"17.3"}}},{"version":20,"kind":"procedure","change":"gone","name":"BrowseForFolderDialog","member":{"name":"BrowseForFolderDialog","sig":"(Text[50], Text, Boolean)","named":"(WindowTitle: Text[50]; DefaultFolderName: Text; ShowNewFolderButton: Boolean)","returns":"Text","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"The procedure uses .NET which does not function on non-Windows client types.","tag":"17.3"}}},{"version":20,"kind":"procedure","change":"gone","name":"GetFileContent","member":{"name":"GetFileContent","sig":"(Text)","named":"(FilePath: Text)","returns":"Text","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"GetFileContent will be replaced with GetFileContents. This currently uses InStream.ReadText() which only returns the stream contents up to the first line break character.","tag":"17.0"}}},{"version":20,"kind":"procedure","change":"gone","name":"SaveStreamToFileServerFolder","member":{"name":"SaveStreamToFileServerFolder","sig":"(var Codeunit Temp Blob, Text, Text, Text)","named":"(var TempBlob: Codeunit \"Temp Blob\"; Name: Text; FileExtension: Text; InnerFolder: Text)","returns":"Text","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Use the DownloadFromStream function to save the content of a stream locally.","tag":"17.0"}}},{"version":20,"kind":"procedure","change":"gone","name":"MoveAndRenameServerFile","member":{"name":"MoveAndRenameServerFile","sig":"(Text, Text, Text)","named":"(AbsolutePathToFile: Text; RelativePathFolder: Text; NewNameFile: Text)","returns":"","kind":"procedure","access":"public","obsolete":{"state":"Pending","reason":"Server files should not be edited directly on the server. Instead, use the DownloadFromStream function to get a local copy of the file on the server.","tag":"17.0"}}},{"version":20,"kind":"procedure","change":"added","name":"GetPathWithSafeFileName","member":{"name":"GetPathWithSafeFileName","sig":"(Text)","named":"(InFilePath: Text)","returns":"Text","kind":"procedure","access":"public","obsolete":null}},{"version":20,"kind":"event","change":"added","name":"OnBeforeBlobExport","member":{"name":"OnBeforeBlobExport","sig":"(var Codeunit Temp Blob, Text, Boolean, var Boolean)","named":"(var TempBlob: Codeunit \"Temp Blob\"; Name: Text; CommonDialog: Boolean; var IsHandled: Boolean)","returns":"","kind":"integrationevent","access":"local","obsolete":null}},{"version":18,"kind":"procedure","change":"added","name":"AppendFileNameWithIndex","member":{"name":"AppendFileNameWithIndex","sig":"(Text, Integer)","named":"(OriginalFileName: Text; AppendIndex: Integer)","returns":"Text","kind":"procedure","access":"public","obsolete":null}}]}