{"title":"Codeunit 419 File Management, extension points 29","url":"https://jonas-paprotka.de/ref/codeunit/419-file-management/points/","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","url":"https://jonas-paprotka.de/ref/codeunit/419-file-management/"},"major":29,"source":{"url":"https://jonas-paprotka.de/ref/codeunit/419-file-management/source/","path":"src/Layers/W1/BaseApp/Modules/System/FileOperations/FileManagement.Codeunit.al","commit":"4303e5e584d3aa5d9e98cbc615525a5396ad6ed7","lines":"a line is <source url>#L<line>"},"steps":{"event":"[line, \"event\", name, handled]: raises an event of this object; handled 1 when it has an IsHandled parameter","call":"[line, \"call\", name, arguments]: calls a procedure of this object","ext":"[line, \"ext\", type, id, name, arguments]: calls a procedure of another object, through a variable declared with that type","write":"[line, \"write\", table id, method, 1 when called with true]: Insert, Modify, ModifyAll, Delete, DeleteAll or Rename","validate":"[line, \"validate\", table id, field name]","run":"[line, \"run\", type, id]: Codeunit.Run, Page.Run, Report.Run and their kin"},"objects":{"codeunit:4100":{"name":"Temp Blob","url":"https://jonas-paprotka.de/ref/codeunit/4100-temp-blob/"},"table:823":{"name":"Name/Value Buffer","url":"https://jonas-paprotka.de/ref/table/823-name-value-buffer/"},"codeunit:419":{"name":"File Management","url":"https://jonas-paprotka.de/ref/codeunit/419-file-management/"},"codeunit:457":{"name":"Environment Information","url":"https://jonas-paprotka.de/ref/codeunit/457-environment-information/"},"codeunit:1299":{"name":"Web Request Helper","url":"https://jonas-paprotka.de/ref/codeunit/1299-web-request-helper/"}},"procs":[{"name":"BLOBImport","line":59,"kind":"procedure","params":2,"steps":[[61,"call","BLOBImportWithFilter",5]]},{"name":"BLOBImportWithFilter","line":64,"kind":"procedure","params":5,"steps":[[81,"call","ValidateFileExtension",2],[83,"ext","codeunit",4100,"CreateOutStream",1]]},{"name":"BLOBExportLocal","line":94,"kind":"procedure","access":"local","params":3,"steps":[[106,"call","GetFileName",1],[108,"call","CreateFileNameWithExtension",2],[108,"call","GetExtension",1],[109,"call","Magicpath",0],[111,"call","GetToFilterText",2]]},{"name":"BLOBExportWithEncoding","line":117,"kind":"procedure","params":4,"steps":[[123,"event","OnBeforeBlobExportWithEncoding",1],[127,"ext","codeunit",4100,"CreateInStream",2],[128,"call","BLOBExportLocal",3]]},{"name":"BLOBExport","line":131,"kind":"procedure","params":3,"steps":[[137,"event","OnBeforeBlobExport",1],[141,"ext","codeunit",4100,"CreateInStream",1],[142,"call","BLOBExportLocal",3]]},{"name":"ServerTempFileName","line":146,"kind":"procedure","params":1,"steps":[[151,"call","CreateFileNameWithExtension",2]]},{"name":"DownloadTempFile","line":157,"kind":"procedure","params":1,"steps":[[163,"call","Magicpath",0]]},{"name":"UploadFile","line":170,"kind":"procedure","params":2,"steps":[[174,"call","GetToFilterText",2],[179,"call","UploadFileWithFilter",4]]},{"name":"UploadFileWithFilter","line":183,"kind":"procedure","params":4,"steps":[[189,"event","OnBeforeUploadFileWithFilter",1],[200,"call","ValidateFileExtension",2]]},{"name":"DownloadHandler","line":216,"kind":"procedure","params":5,"steps":[[221,"event","OnBeforeDownloadHandler",1],[229,"event","OnAfterDownloadHandler",0]]},{"name":"DownloadFromStreamHandler","line":232,"kind":"procedure","params":5,"steps":[[238,"event","OnBeforeDownloadFromStreamHandler",1]]},{"name":"CopyServerFile","line":251,"kind":"procedure","params":3,"steps":[[253,"call","IsAllowedPath",2],[254,"call","IsAllowedPath",2]]},{"name":"DeleteServerFile","line":264,"kind":"procedure","params":1,"steps":[[266,"call","IsAllowedPath",2]]},{"name":"ServerDirectoryExists","line":275,"kind":"procedure","params":1,"steps":[[277,"call","IsAllowedPath",2]]},{"name":"ServerCreateDirectory","line":282,"kind":"procedure","params":1,"steps":[[284,"call","IsAllowedPath",2],[285,"call","ServerDirectoryExists",1]]},{"name":"ServerCreateTempSubDirectory","line":290,"kind":"procedure","params":0,"steps":[[294,"call","ServerTempFileName",0],[295,"call","CombinePath",2],[295,"call","GetDirectoryName",1],[296,"call","ServerCreateDirectory",1],[297,"call","DeleteServerFile",1]]},{"name":"ServerRemoveDirectory","line":301,"kind":"procedure","params":2,"steps":[[303,"call","IsAllowedPath",2],[304,"call","ServerDirectoryExists",1]]},{"name":"GetPathWithSafeFileName","line":325,"kind":"procedure","params":1,"steps":[[330,"call","GetDirectoryName",1],[331,"call","GetSafeFileName",1],[331,"call","GetFileName",1],[332,"call","CombinePath",2]]},{"name":"GetServerDirectoryFilesList","line":365,"kind":"procedure","params":2,"steps":[[371,"write",823,"DeleteAll"],[373,"call","IsAllowedPath",2],[378,"call","GetFileNameWithoutExtension",1],[379,"write",823,"Insert"]]},{"name":"GetServerDirectoryFilesListInclSubDirs","line":384,"kind":"procedure","params":2,"steps":[[387,"write",823,"DeleteAll"],[389,"call","GetServerDirectoryFilesListInclSubDirsInner",2]]},{"name":"GetServerDirectoryFilesListInclSubDirsInner","line":392,"kind":"procedure","access":"local","params":2,"steps":[[399,"call","IsAllowedPath",2],[405,"call","ServerDirectoryExists",1],[410,"call","GetFileNameWithoutExtension",1],[411,"write",823,"Insert"]]},{"name":"GetServerFileProperties","line":418,"kind":"procedure","params":4,"steps":[[423,"call","IsAllowedPath",2]]},{"name":"BLOBImportFromServerFile","line":436,"kind":"procedure","params":2,"steps":[[442,"call","IsAllowedPath",2],[449,"ext","codeunit",4100,"CreateOutStream",1]]},{"name":"BLOBExportToServerFile","line":455,"kind":"procedure","params":2,"steps":[[467,"ext","codeunit",4100,"CreateInStream",1]]},{"name":"InstreamExportToServerFile","line":473,"kind":"procedure","params":2,"steps":[[478,"call","ServerTempFileName",1]]},{"name":"TempBlobToServerFile","line":487,"kind":"procedure","access":"internal","params":2,"steps":[[491,"ext","codeunit",4100,"CreateInStream",2],[492,"call","InstreamExportToServerFile",2]]},{"name":"CreateAndWriteToServerFile","line":496,"kind":"procedure","params":2,"steps":[[501,"call","ServerTempFileName",1]]},{"name":"GetToFilterText","line":508,"kind":"procedure","params":2,"steps":[[515,"call","GetExtension",1],[540,"event","OnAfterGetToFilterTextSetOutExt",0]]},{"name":"IsValidFileName","line":559,"kind":"procedure","params":1,"steps":[[566,"call","GetFileName",1],[570,"call","GetDirectoryName",1]]},{"name":"ValidateFileExtension","line":577,"kind":"procedure","params":2,"steps":[[585,"call","GetExtension",1],[585,"call","GetFileName",1]]},{"name":"StripNotsupportChrInFileName","line":623,"kind":"procedure","params":1,"steps":[[626,"call","GetSafeFileName",1]]},{"name":"ExportImage","line":630,"kind":"procedure","params":2,"steps":[[636,"write",823,"DeleteAll"],[637,"ext","codeunit",419,"GetServerDirectoryFilesList",2],[640,"call","StripNotsupportChrInFileName",1],[642,"ext","codeunit",419,"DeleteServerFile",1]]},{"name":"IsServerDirectoryEmpty","line":654,"kind":"procedure","params":1,"steps":[[656,"call","IsAllowedPath",2]]},{"name":"IsAllowedPath","line":694,"kind":"procedure","params":2,"steps":[[699,"ext","codeunit",457,"IsSaaS",0],[700,"ext","codeunit",1299,"IsHttpUrl",1]]},{"name":"AppendFileNameWithIndex","line":711,"kind":"procedure","params":2,"steps":[[717,"call","GetExtension",1]]}]}