{"title":"Codeunit 3999 Reten. Pol. Install - BaseApp, extension points 29","url":"https://jonas-paprotka.de/ref/codeunit/3999-reten-pol-install-baseapp/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":3999,"name":"Reten. Pol. Install - BaseApp","app":"Base Application","url":"https://jonas-paprotka.de/ref/codeunit/3999-reten-pol-install-baseapp/"},"major":29,"source":{"url":"https://jonas-paprotka.de/ref/codeunit/3999-reten-pol-install-baseapp/source/","path":"src/Layers/W1/BaseApp/OtherCapabilities/RetentionPolicy/RetenPolInstallBaseApp.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:9999":{"name":"Upgrade Tag","url":"https://jonas-paprotka.de/ref/codeunit/9999-upgrade-tag/"},"codeunit:3905":{"name":"Reten. Pol. Allowed Tables","url":"https://jonas-paprotka.de/ref/codeunit/3905-reten-pol-allowed-tables/"},"table:3901":{"name":"Retention Policy Setup","url":"https://jonas-paprotka.de/ref/table/3901-retention-policy-setup/"},"codeunit:3902":{"name":"Retention Policy Setup","url":"https://jonas-paprotka.de/ref/codeunit/3902-retention-policy-setup/"},"table:472":{"name":"Job Queue Entry","url":"https://jonas-paprotka.de/ref/table/472-job-queue-entry/"}},"procs":[{"name":"OnInstallAppPerCompany","line":31,"kind":"trigger","steps":[[33,"call","AddAllowedTables",0]]},{"name":"AddAllowedTables","line":41,"kind":"procedure","params":1,"steps":[[49,"ext","codeunit",9999,"HasUpgradeTag",1],[49,"call","GetRetenPolBaseAppTablesUpgradeTag",0],[51,"call","AddChangeLogEntryToAllowedTables",1],[52,"ext","codeunit",3905,"AddAllowedTable",2],[53,"ext","codeunit",3905,"AddAllowedTable",1],[54,"ext","codeunit",3905,"AddAllowedTable",1],[55,"ext","codeunit",3905,"AddAllowedTable",1],[56,"ext","codeunit",3905,"AddAllowedTable",1],[58,"ext","codeunit",9999,"SetUpgradeTag",1],[58,"call","GetRetenPolBaseAppTablesUpgradeTag",0],[61,"ext","codeunit",9999,"HasUpgradeTag",1],[61,"call","GetRetenPolDocArchivesTablesUpgradeTag",0],[63,"call","AddDocumentArchiveTablesToAllowedTables",0],[65,"ext","codeunit",9999,"SetUpgradeTag",1],[65,"call","GetRetenPolDocArchivesTablesUpgradeTag",0],[68,"ext","codeunit",9999,"HasUpgradeTag",1],[68,"call","GetRetenPolDataverseEntityChangeUpgradeTag",0],[70,"call","AddDataverseEntityChange",1],[72,"ext","codeunit",9999,"SetUpgradeTag",1],[72,"call","GetRetenPolDataverseEntityChangeUpgradeTag",0],[75,"ext","codeunit",9999,"HasUpgradeTag",1],[75,"call","GetRetenPolActivityLogUpgradeTag",0],[76,"ext","codeunit",3905,"AddAllowedTable",1],[77,"ext","codeunit",9999,"HasUpgradeTag",1],[77,"call","GetRetenPolActivityLogUpgradeTag",0],[78,"ext","codeunit",9999,"SetUpgradeTag",1],[78,"call","GetRetenPolActivityLogUpgradeTag",0],[81,"ext","codeunit",9999,"HasUpgradeTag",1],[81,"call","GetRetenPolProtectedChangeLogUpgradeTag",0],[83,"call","AddChangeLogEntryToAllowedTables",1],[85,"ext","codeunit",9999,"SetUpgradeTag",1],[85,"call","GetRetenPolProtectedChangeLogUpgradeTag",0],[88,"ext","codeunit",9999,"HasUpgradeTag",1],[88,"call","GetRetenPolPostedWhseTablesUpgradeTag",0],[90,"call","AddRegisteredWhseActivityHdrToAllowedTables",1],[91,"call","AddPostedWhseShipmentHeaderToAllowedTables",1],[92,"call","AddPostedWhseReceiptHeaderToAllowedTables",0],[94,"ext","codeunit",9999,"SetUpgradeTag",1],[94,"call","GetRetenPolPostedWhseTablesUpgradeTag",0],[96,"ext","codeunit",9999,"HasUpgradeTag",1],[96,"call","GetRetenPolSentNotifcationEntryUpgradeTag",0],[98,"call","AddSentNotifcationEntryToAllowedTables",0],[100,"ext","codeunit",9999,"SetUpgradeTag",1],[100,"call","GetRetenPolSentNotifcationEntryUpgradeTag",0],[104,"ext","codeunit",9999,"HasUpgradeTag",1],[104,"call","GetRetenPolCRMIntegrationSynchUpgradeTag",0],[106,"call","AddCRMIntegrationSynch",1],[108,"ext","codeunit",9999,"SetUpgradeTag",1],[108,"call","GetRetenPolCRMIntegrationSynchUpgradeTag",0],[111,"ext","codeunit",9999,"HasUpgradeTag",1],[111,"call","GetRetenPolInventoryTablesUpgradeTag",0],[113,"call","AddPostedInvtPickHeaderToAllowedTables",1],[114,"call","AddPostedInvtPutawayHeaderToAllowedTables",1],[115,"call","AddRegisteredInvtMovementHdrToAllowedTables",1],[117,"ext","codeunit",9999,"SetUpgradeTag",1],[117,"call","GetRetenPolInventoryTablesUpgradeTag",0],[120,"ext","codeunit",9999,"HasUpgradeTag",1],[120,"call","GetRetenPolDataExchUpgradeTag",0],[122,"call","AddDataExchangeToAllowedTables",0],[124,"ext","codeunit",9999,"SetUpgradeTag",1],[124,"call","GetRetenPolDataExchUpgradeTag",0],[127,"ext","codeunit",9999,"HasUpgradeTag",1],[127,"call","GetRetenPolFinancialReportExportLogUpgradeTag",0],[129,"call","AddFinancialReportExportLogToAllowedTables",0],[131,"ext","codeunit",9999,"SetUpgradeTag",1],[131,"call","GetRetenPolFinancialReportExportLogUpgradeTag",0],[134,"ext","codeunit",9999,"HasUpgradeTag",1],[134,"call","GetRetenPolTruncateAllowedUpgradeTag",0],[136,"call","SetTruncateAllowedIfTableExists",1],[137,"call","SetTruncateAllowedIfTableExists",1],[138,"call","SetTruncateAllowedIfTableExists",1],[139,"call","SetTruncateAllowedIfTableExists",1],[141,"ext","codeunit",9999,"SetUpgradeTag",1],[141,"call","GetRetenPolTruncateAllowedUpgradeTag",0]]},{"name":"SetTruncateAllowedIfTableExists","line":145,"kind":"procedure","access":"local","params":1,"steps":[[149,"ext","codeunit",3905,"IsAllowedTable",1],[151,"ext","codeunit",3905,"SetTruncateAllowed",2]]},{"name":"AddChangeLogEntryToAllowedTables","line":154,"kind":"procedure","access":"local","params":1,"steps":[[164,"ext","codeunit",3905,"AddTableFilterToJsonArray",6],[169,"ext","codeunit",3905,"AddTableFilterToJsonArray",6],[174,"ext","codeunit",3905,"AddTableFilterToJsonArray",6],[176,"ext","codeunit",3905,"AddAllowedTable",3],[184,"validate",3901,"Table Id"],[185,"write",3901,"Insert",1]]},{"name":"AddRegisteredWhseActivityHdrToAllowedTables","line":188,"kind":"procedure","access":"local","params":1,"steps":[[193,"ext","codeunit",3905,"AddAllowedTable",2],[198,"call","CreateRetentionPolicySetup",2],[198,"call","FindOrCreateRetentionPeriod",1]]},{"name":"AddPostedWhseShipmentHeaderToAllowedTables","line":201,"kind":"procedure","access":"local","params":1,"steps":[[207,"ext","codeunit",3905,"AddAllowedTable",2],[212,"call","CreateRetentionPolicySetup",2],[212,"call","FindOrCreateRetentionPeriod",1]]},{"name":"AddPostedWhseReceiptHeaderToAllowedTables","line":215,"kind":"procedure","access":"local","params":0,"steps":[[225,"ext","codeunit",3905,"AddTableFilterToJsonArray",6],[229,"ext","codeunit",3905,"AddTableFilterToJsonArray",6],[230,"ext","codeunit",3905,"AddAllowedTable",3]]},{"name":"AddDocumentArchiveTablesToAllowedTables","line":233,"kind":"procedure","access":"local","params":0,"steps":[[244,"ext","codeunit",3905,"AddTableFilterToJsonArray",6],[248,"ext","codeunit",3905,"AddTableFilterToJsonArray",6],[249,"ext","codeunit",3905,"AddAllowedTable",6],[254,"ext","codeunit",3905,"AddTableFilterToJsonArray",6],[258,"ext","codeunit",3905,"AddTableFilterToJsonArray",6],[259,"ext","codeunit",3905,"AddAllowedTable",6],[264,"ext","codeunit",3905,"AddTableFilterToJsonArray",6],[265,"ext","codeunit",3905,"AddAllowedTable",6],[267,"event","OnAfterAddDocumentArchiveTablesToAllowedTables",0]]},{"name":"AddPostedInvtPickHeaderToAllowedTables","line":270,"kind":"procedure","access":"local","params":1,"steps":[[275,"ext","codeunit",3905,"AddAllowedTable",2],[280,"call","CreateRetentionPolicySetup",2],[280,"call","FindOrCreateRetentionPeriod",1]]},{"name":"AddPostedInvtPutawayHeaderToAllowedTables","line":283,"kind":"procedure","access":"local","params":1,"steps":[[288,"ext","codeunit",3905,"AddAllowedTable",2],[293,"call","CreateRetentionPolicySetup",2],[293,"call","FindOrCreateRetentionPeriod",1]]},{"name":"AddRegisteredInvtMovementHdrToAllowedTables","line":296,"kind":"procedure","access":"local","params":1,"steps":[[301,"ext","codeunit",3905,"AddAllowedTable",2],[306,"call","CreateRetentionPolicySetup",2],[306,"call","FindOrCreateRetentionPeriod",1]]},{"name":"AddDataverseEntityChange","line":309,"kind":"procedure","access":"local","params":1,"steps":[[314,"ext","codeunit",3905,"AddAllowedTable",2],[319,"call","CreateRetentionPolicySetup",2],[319,"call","FindOrCreateRetentionPeriod",1],[320,"call","EnableRetentionPolicySetup",1]]},{"name":"AddSentNotifcationEntryToAllowedTables","line":323,"kind":"procedure","access":"local","params":0,"steps":[[331,"ext","codeunit",3905,"AddTableFilterToJsonArray",6],[332,"ext","codeunit",3905,"AddAllowedTable",3]]},{"name":"AddCRMIntegrationSynch","line":335,"kind":"procedure","access":"local","params":1,"steps":[[341,"ext","codeunit",3905,"AddAllowedTable",2],[342,"ext","codeunit",3905,"AddAllowedTable",2],[347,"call","CreateRetentionPolicySetup",2],[347,"call","FindOrCreateRetentionPeriod",1],[348,"call","EnableRetentionPolicySetup",1],[350,"call","CreateRetentionPolicySetup",2],[350,"call","FindOrCreateRetentionPeriod",1],[351,"call","EnableRetentionPolicySetup",1]]},{"name":"AddDataExchangeToAllowedTables","line":354,"kind":"procedure","access":"local","params":0,"steps":[[359,"ext","codeunit",3905,"AddAllowedTable",2]]},{"name":"AddFinancialReportExportLogToAllowedTables","line":362,"kind":"procedure","access":"local","params":0,"steps":[[367,"ext","codeunit",3905,"AddAllowedTable",2]]},{"name":"FindOrCreateRetentionPeriod","line":370,"kind":"procedure","access":"local","params":1,"steps":[[374,"ext","codeunit",3902,"FindOrCreateRetentionPeriod",1]]},{"name":"CreateRetentionPolicySetup","line":377,"kind":"procedure","access":"local","params":2,"steps":[[383,"validate",3901,"Table Id"],[384,"validate",3901,"Apply to all records"],[385,"validate",3901,"Retention Period"],[386,"validate",3901,"Enabled"],[387,"write",3901,"Insert",1]]},{"name":"EnableRetentionPolicySetup","line":390,"kind":"procedure","access":"local","params":1,"steps":[[402,"ext","table",472,"HasRequiredPermissions",0],[408,"validate",3901,"Enabled"],[409,"write",3901,"Modify",1]]},{"name":"RegisterPerCompanyUpgradeTags","line":473,"kind":"procedure","access":"local","params":1,"steps":[[475,"call","GetRetenPolFinancialReportExportLogUpgradeTag",0],[476,"call","GetRetenPolTruncateAllowedUpgradeTag",0]]},{"name":"AddAllowedTablesOnRefreshAllowedTables","line":480,"kind":"procedure","access":"local","params":0,"steps":[[482,"call","AddAllowedTables",1]]},{"name":"AddAllowedTablesOnBeforeCompanyInit","line":486,"kind":"procedure","access":"local","params":0,"steps":[[488,"call","AddAllowedTables",0]]}]}