BeyondERP.Newsletter
Menu

Setup step on the Migrate lease records page · Asset leasing

Migrate staged leases

Apply the process type of many staged imports at once.

Business process
Lease assets
Menu item
AssetLeaseLeaseDataMigration
Setup steps
1 on this page
Show what matters for
SETUP GUIDEHow to set it up8 sections. Choose a role to highlight what matters to you.
Everyone

1What it is and why

What it isA periodic dialog that migrates many staged lease records at the same time.
What you do hereUse this dialog to bring imported leases into Asset leasing in one run; each lease is processed according to its process type.
ExampleFor example, migrating leases with the Add record process type creates those leases in the system.
Migrate lease records page in Dynamics 365
The page in Dynamics 365. page title tab to open what to set or check
Functional consultant · Solution architect

2Where it fits

Business processAcquire assets › Lease assets
Menu pathAsset leasing › Lease import framework › Periodic › Migrate lease records
Set up firstValidate Microsoft Learn Compare Microsoft Learn
Used next byLease summary Microsoft Learn Confirmation batch Microsoft Learn
Related pagesImport header Microsoft Learn
In this process Validate staged leases · Clear import errors before migrating
End user · Functional consultant

3How to do it

About the examples: Examples and screenshots in this guide use BEAT, a demo company in a Dynamics 365 test environment. Use your own company's codes and values instead of copying them.

When to run it

When to run itAfter the staged lease data is imported through Data management, validated and compared, and the Differences report has been reviewed.
How oftenOn demand, once for each import ID that is ready to bring into Asset leasing.
Batch settingsRun it in the background for large imports with Process all set to Yes, so all leases of the import ID are migrated without blocking your session.
What the output showsLeases created, updated or adjusted in Asset leasing according to each staged record's process type. Added and adjusted leases have a new payment schedule that is not yet confirmed and no posted journal entry. A field that didn't change on an Update record lease usually means it isn't in the Selected fields list on Update field selection.

Source: Microsoft Learn

Setup steps on this page

Migrate staged leases

Apply the process type of many staged imports at once.

Steps from Microsoft

  1. Go to Asset leasing > Lease import framework > Periodic > Migrate lease records.
  2. Select the Import ID, or set Process all to Yes.
  3. Optionally filter on Lease ID under Records to include.
  4. Select OK, or run it in the background for a large import.
  5. For Add record, confirm each payment schedule and post initial recognition; for Adjust record, confirm the new schedule and post the adjustment journal.

Source: Microsoft Learn

Fields on the page

FieldWhat it meansExample
Import IDThe import, as listed on Import header.Microsoft Learn
Lease IDOne lease of the import, to run it for that lease only.Microsoft Learn
Process allYes runs every lease of the selected import.Checked in Dynamics 365No
Records to include (Leases: Lease ID)A filter on the leases to process.Checked in Dynamics 365

Common errors and fixes

MessageWhat to do
Migrated leases have no posted entriesThat's by design. Confirm the schedules (Confirmation batch) and create the journals (Batch journal creation). Microsoft Learn

Test checklist

  1. Migrate the import.
  2. Open Lease summary.
  3. Check: Both leases exist with schedules still to be confirmed and no posted journals.

Source: Microsoft Learn

Functional consultant

4Setup decisions

Setup stepRecommended value and whyDecision, common mistake and test
Migrate staged leasesMigrate one import at a time after Validate is clean, then run Confirmation batch and Batch journal creation for the new leases.Migration performs the process type: Add record creates leases, Update record overwrites the selected fields, Adjust record creates an unconfirmed new schedule. Nothing posts until you confirm and create journals.How are leases that are already running loaded at go-live?Expecting migrated Add record leases to be on the balance sheet: their schedules still need confirming and initial recognition posting.Test: Add record creates unconfirmed leases

Feature management and licence

Feature to turn onAsset leasing (Must be on)
Licence or add-inAsset leasing must be turned on in Feature management (feature Asset leasing). Microsoft Learn describes three Asset leasing roles: Maintain lease (add, edit and post leases), View lease (view leases and schedules and run reports) and Lease clerk (create new leases only). Maintain lease users run it.

Microsoft Learn

Solution architect

5Design impact

Shared or per companyPer company: leases with their books, schedules and journals belong to the legal entity you are working in, and Lease ID numbers come from a number sequence set per company. Turn on Cross entity batch in Asset leasing parameters to create journals for other legal entities from the current one. Microsoft Learn
Can it be undoneHard to reverse: Migrated changes are on the leases. A confirmed lease can be deleted only with Allow deletion of confirmed leases and no transactions, and a deleted lease can't be restored.
If you change it laterMigration changes leases: Add record creates them, Update record overwrites the selected fields without adjusting, Adjust record creates a new payment schedule that isn't confirmed and an adjustment journal that isn't posted. Microsoft Learn
Technical architect

6Technical

Menu itemAssetLeaseLeaseDataMigration Checked in Dynamics 365
FormDialog Checked in Dynamics 365
Roles to set it up and use itTo use itLease accountant AssetLeaseLeaseMaintainAccountant LedgerAccountantGive people one of these roles. On this system, 2 roles can run this page.Checked in Dynamics 365
Developer

7Developer

Open it by URLhttps://<your-environment>/?mi=AssetLeaseLeaseDataMigration
Data migrationLoad order: This job has no data entity in Data management, so it can't be loaded from a file or a configuration template. It processes imports already staged through the Lease staging, Payment contract staging and Executory contract staging entities.Microsoft Learn
Everyone

8Sources

To cite this step: AL-IMPORT-030, Migrate staged leases. Beyond ERP Atlas Hub, 2026-11-11. https://www.beyonderp.cloud/atlas/step/AL-IMPORT-030