{"title":"Import Worksheet","url":"https://jonas-paprotka.de/docs/dev-itpro/cside/cside-import-worksheet/","by":"JOP-AL","license":"Copyright (c) Microsoft Corporation. CC BY 4.0, https://creativecommons.org/licenses/by/4.0/; code samples MIT. From https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/cside/cside-import-worksheet, MicrosoftDocs/dynamics365smb-devitpro-pb at 828b6ee (2026-11-19). Changed: includes filled in, links to this site, and for agents shortened without dropping a fact.","credit":"Microsoft Corporation, CC BY 4.0","origin":"https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/cside/cside-import-worksheet","source":{"name":"Business Central developer and IT pro docs","repo":"https://github.com/MicrosoftDocs/dynamics365smb-devitpro-pb","commit":"828b6ee72fcd75755627cd6011f3d20899217ab2","date":"2026-11-19"},"checked":"2026-11-19","date":"2023-12-22","meta":{"topic":"article"},"outline":[{"level":2,"title":"Default actions in the import file","slug":"default-actions-in-the-import-file","at":574,"chars":468},{"level":2,"title":"The Import Worksheet","slug":"the-import-worksheet","at":1042,"chars":2425},{"level":2,"title":"Using the Import Worksheet","slug":"using-the-import-worksheet","at":3467,"chars":476}],"text":"When you import objects from a binary file \\(.fob\\), if there are conflicts with objects that exist in the database with the same ID, then you use the Import Worksheet to resolve the conflicts. If the import file contains only objects that are new, then the objects are imported.\nIf you import objects from a .txt file, then the objects in the file overwrite any existing objects in the database.\nYou use the Import Worksheet when you import objects by using the UI in the development environment. For more information about how to import objects, see cside-import-objects.\n## Default actions in the import file\nThe value of the Action column for each object in the Import Worksheet can be saved in the .fob file with the objects by choosing the Save As button in the Import Worksheet. When you import a .fob file, in the dialog box, you can choose the Yes button to import all objects and use the actions that are saved in the .fob file, or choose the No button to open the Import Worksheet and revise the action for any object in the file.\n## The Import Worksheet\nEach line in the Import Worksheet displays information about one object. You decide how to handle the conflict by choosing an action in the Action column. The following table shows the information that is displayed about each object in the import file.\nObject|Description\nType|The type of this object. The type is one of the following:<br /><br /> * TableData<br /><br /> * Table<br /><br /> * Report<br /><br /> * Codeunit<br /><br /> * XMLport<br /><br /> * MenuSuite<br /><br /> * Page<br /><br /> * Query<br /><br /> * System<br /><br /> * FieldNumber\nNo.|The ID of the object.\nName|The name of the object.\nNew Object|Specifies if the object to import is a new object that doesn't exist already in the database.\nNew Object Changed|Specifies if the new object to import has been marked as changed.\nExisting Object Changed|Specifies if the object to import is an existing object that has been changed, for example, the Modified field is set or the Version List is changed.\nWarning|Specifies if there's a conflict that must be resolved before this object can be imported.\nAction|Specifies how the conflict is resolved. This is the only field that you can change The options are the following:<br /><br /> Create: The new object is added to the database. This option is only valid if no such object already exists.<br /><br /> Replace: The existing object will be replaced by the new object.<br /><br /> Delete: The existing object is deleted and no new object created. This option is only valid if the new object has size 0. The intended use is to remove obsolete objects from the database.<br /><br /> Skip: This object won't be imported.<br /><br /> Merge: Existing\\<-New: Only valid for tables. All fields in the existing table remain and any additional fields from the new object will be added.<br /><br /> Merge: New\\<-Existing: Only valid for tables. All fields in the new table will be imported and any additional fields in the existing table will be added to the new table.\nExisting Object Modified|Specifies if the existing object has the Modified field set.\nExisting Object Version List|The version of the existing object.\nNew Object Modified|Specifies if the new object has the Modified field set.\nNew Object Version List|The version of the new object.\nIn addition, the Name, Modified, Version list, Size, Date, and Time fields are displayed in the window for the object that is selected.\n## Using the Import Worksheet\nFor each object, you can choose an action, given the constraints outlined in the preceding table. You can apply these actions by choosing the appropriate buttons.\nAction|Definition\nOK|Perform the import according to the current settings in the worksheet.\nCancel|Cancel the import.\nReplace All|Set Action for all objects in the worksheet to Replace.\nSave As|Save the current settings in the worksheet in the import file, together with the objects."}