{"title":"Codeunit 3904 Apply Retention Policy Impl., extension points 29","url":"https://jonas-paprotka.de/ref/codeunit/3904-apply-retention-policy-impl/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":3904,"name":"Apply Retention Policy Impl.","app":"System Application","url":"https://jonas-paprotka.de/ref/codeunit/3904-apply-retention-policy-impl/"},"major":29,"source":{"url":"https://jonas-paprotka.de/ref/codeunit/3904-apply-retention-policy-impl/source/","path":"src/System Application/App/Retention Policy/src/Apply Retention Policy/ApplyRetentionPolicyImpl.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:3908":{"name":"Retention Policy Log","url":"https://jonas-paprotka.de/ref/codeunit/3908-retention-policy-log/"},"codeunit:3904":{"name":"Apply Retention Policy Impl.","url":"https://jonas-paprotka.de/ref/codeunit/3904-apply-retention-policy-impl/"},"codeunit:8703":{"name":"Feature Telemetry","url":"https://jonas-paprotka.de/ref/codeunit/8703-feature-telemetry/"},"codeunit:3912":{"name":"Reten. Policy Telemetry Impl.","url":"https://jonas-paprotka.de/ref/codeunit/3912-reten-policy-telemetry-impl/"},"codeunit:3905":{"name":"Reten. Pol. Allowed Tables","url":"https://jonas-paprotka.de/ref/codeunit/3905-reten-pol-allowed-tables/"},"codeunit:3910":{"name":"Apply Retention Policy","url":"https://jonas-paprotka.de/ref/codeunit/3910-apply-retention-policy/"},"table:3901":{"name":"Retention Policy Setup","url":"https://jonas-paprotka.de/ref/table/3901-retention-policy-setup/"},"codeunit:3917":{"name":"Record Reference","url":"https://jonas-paprotka.de/ref/codeunit/3917-record-reference/"},"codeunit:152":{"name":"User Permissions","url":"https://jonas-paprotka.de/ref/codeunit/152-user-permissions/"},"codeunit:3906":{"name":"Reten. Pol. Allowed Tbl. Impl.","url":"https://jonas-paprotka.de/ref/codeunit/3906-reten-pol-allowed-tbl-impl/"}},"procs":[{"name":"OnRun","line":68,"kind":"trigger","steps":[[73,"call","ApplyRetentionPolicy",1],[80,"call","ApplyRetentionPolicy",3]]},{"name":"ApplyRetentionPolicy","line":85,"kind":"procedure","params":1,"steps":[[91,"ext","codeunit",3908,"LogInfo",2],[91,"call","LogCategory",0],[91,"call","AppendStartedByUserMessage",2],[109,"call","SafeApplyRetentionPolicy",1],[115,"ext","codeunit",3908,"LogInfo",2],[115,"call","LogCategory",0],[115,"call","AppendStartedByUserMessage",2],[118,"run","codeunit",3904]]},{"name":"ApplyRetentionPolicy","line":121,"kind":"procedure","params":3,"steps":[[132,"call","IsSystemEnabledPolicy",1],[133,"ext","codeunit",8703,"LogUptake",3],[134,"call","CanApplyRetentionPolicy",2],[143,"ext","codeunit",3908,"LogInfo",2],[143,"call","LogCategory",0],[143,"call","AppendStartedByUserMessage",2],[146,"call","GetExpiredRecords",3],[147,"call","DeleteExpiredRecords",1],[149,"ext","codeunit",3912,"SendTelemetryOnRecordsDeleted",4],[151,"ext","codeunit",3908,"LogInfo",2],[151,"call","LogCategory",0],[151,"call","AppendStartedByUserMessage",2],[156,"call","CheckAndContinueWithRerun",1],[158,"call","IsSystemEnabledPolicy",1],[159,"ext","codeunit",8703,"LogUsage",3]]},{"name":"GetExpiredRecordCount","line":162,"kind":"procedure","params":2,"steps":[[170,"ext","codeunit",3908,"LogInfo",2],[170,"call","LogCategory",0],[172,"call","GetExpiredRecords",3],[177,"ext","codeunit",3908,"LogInfo",2],[177,"call","LogCategory",0],[178,"ext","codeunit",3908,"LogInfo",2],[178,"call","LogCategory",0]]},{"name":"SafeApplyRetentionPolicy","line":182,"kind":"procedure","access":"local","params":1,"steps":[[190,"run","codeunit",3904],[191,"ext","codeunit",3908,"LogError",3],[191,"call","LogCategory",0]]},{"name":"CanApplyRetentionPolicy","line":197,"kind":"procedure","access":"local","params":2,"steps":[[202,"call","ConfirmApplyRetentionPolicies",0],[208,"call","TableExists",1],[209,"call","DisableRetentionPolicySetup",1],[217,"ext","codeunit",3905,"IsAllowedTable",1],[218,"ext","codeunit",3908,"LogError",2],[218,"call","LogCategory",0]]},{"name":"DeleteExpiredRecords","line":223,"kind":"procedure","access":"local","params":1,"steps":[[239,"call","FillTempRetenPolDeletingParamTable",2],[242,"ext","codeunit",3905,"GetRetenPolDeleting",1],[246,"ext","codeunit",3910,"OnApplyRetentionPolicyIndirectPermissionRequired",2],[248,"ext","codeunit",3908,"LogError",2],[248,"call","LogCategory",0],[252,"call","Count",1],[256,"ext","codeunit",3908,"LogInfo",2],[256,"call","LogCategory",0],[257,"ext","codeunit",3912,"SendTelemetryOnRecordsDeleted",4],[260,"call","RaiseRecordLimitExceededEvent",2]]},{"name":"CheckAndContinueWithRerun","line":263,"kind":"procedure","access":"local","params":1,"steps":[[270,"call","ApplyRetentionPolicy",3]]},{"name":"FillTempRetenPolDeletingParamTable","line":274,"kind":"procedure","access":"local","params":2,"steps":[[277,"call","VerifyIndirectDeletePermission",1],[279,"call","MaxNumberOfRecordsToDelete",0],[281,"call","MaxNumberOfRecordsToDelete",0]]},{"name":"RaiseRecordLimitExceededEvent","line":285,"kind":"procedure","access":"local","params":2,"steps":[[292,"ext","codeunit",3908,"LogWarning",2],[292,"call","LogCategory",0],[293,"ext","codeunit",3910,"OnApplyRetentionPolicyRecordLimitExceeded",5],[296,"call","MaxNumberOfRecordsToDelete",0]]},{"name":"DisableRetentionPolicySetup","line":308,"kind":"procedure","access":"local","params":1,"steps":[[312,"validate",3901,"Enabled"],[313,"write",3901,"Modify",1],[314,"ext","codeunit",3908,"LogInfo",2],[314,"call","LogCategory",0]]},{"name":"ConfirmApplyRetentionPolicies","line":317,"kind":"procedure","access":"local","params":0,"steps":[[332,"ext","codeunit",3908,"LogError",2],[332,"call","LogCategory",0]]},{"name":"GetExpiredRecords","line":337,"kind":"procedure","access":"local","params":3,"steps":[[347,"ext","codeunit",3905,"GetRetenPolFiltering",1],[352,"ext","codeunit",3908,"LogWarning",2],[352,"call","LogCategory",0],[360,"ext","codeunit",3917,"Initialize",2],[362,"ext","codeunit",3908,"LogWarning",2],[362,"call","LogCategory",0]]},{"name":"VerifyIndirectDeletePermission","line":369,"kind":"procedure","access":"local","params":1,"steps":[[374,"ext","codeunit",152,"GetEffectivePermission",2]]},{"name":"SetWhereOlderExpirationDateFilter","line":378,"kind":"procedure","params":5,"steps":[[384,"ext","codeunit",3908,"LogError",2],[384,"call","LogCategory",0]]},{"name":"SetWhereNewerExpirationDateFilter","line":396,"kind":"procedure","params":5,"steps":[[402,"ext","codeunit",3908,"LogError",2],[402,"call","LogCategory",0]]},{"name":"SetSingleDateExpirationDateFilter","line":414,"kind":"procedure","params":5,"steps":[[420,"ext","codeunit",3908,"LogError",2],[420,"call","LogCategory",0]]},{"name":"TruncateTableRecords","line":477,"kind":"procedure","params":1,"steps":[[488,"ext","codeunit",3906,"IsTruncateAllowed",1],[492,"ext","codeunit",3908,"LogInfo",2],[492,"call","LogCategory",0],[493,"ext","codeunit",8703,"LogUsage",3],[498,"ext","codeunit",3908,"LogInfo",2],[498,"call","LogCategory",0],[499,"ext","codeunit",8703,"LogUsage",3],[505,"ext","codeunit",152,"GetEffectivePermission",2],[507,"ext","codeunit",3910,"OnTruncateRecordsIndirectPermissionRequired",2],[509,"ext","codeunit",3908,"LogError",2],[509,"call","LogCategory",0],[515,"ext","codeunit",3908,"LogInfo",2],[515,"call","LogCategory",0],[517,"ext","codeunit",8703,"LogUsage",3]]}]}