---
title: "Import by scenario (SM206036)"
description: "In this window, you can select an import scenario and prepare and import the data in accordance with the selected scenario."
lang: en
languages:
  en: https://docs.vismasoftware.no/visma-net-erp/help/integration/integration-windows/import-by-scenario-sm206036/index.md
lastmod: 2026-02-23
---

> Documentation index: https://docs.vismasoftware.no/visma-net-erp/help/integration/integration-windows/llms.txt


# Import by scenario (SM206036)

Last modified February 23, 2026

> In this window, you can select an import scenario and prepare and import the data in accordance with the selected scenario.


This topic provides information about the elements in this window in Visma Net, such as fields, field values, buttons, and check boxes.

You create scenarios for import by using the [Manage import scenarios (SM206025)](https://docs.vismasoftware.no/visma-net-erp/help/integration/integration-windows/manage-import-scenarios-sm206025/index.md) window. Alternatively, you can use this form to import data directly from a file, such as an Excel spreadsheet. In this case, upload the file, set up the mapping, and then prepare and import the data.

For more information, see: [Simplified scenarios for data import](https://docs.vismasoftware.no/visma-net-erp/help/integration/importing-and-exporting-records-by-using-scenarios/simplified-scenarios-for-data-import/index.md).

## The window toolbar

<table class="vismanet-table">
  <colgroup>
    <col class="vismanet-table__col--key">
    <col>
  </colgroup>
<thead class="vismanet-table__head">
  <tr class="vismanet-table__header-row">
<th class="vismanet-table__cell vismanet-table__cell--header">Button</th>
<th class="vismanet-table__cell vismanet-table__cell--header">Description</th>
</tr>
</thead>

<tr class="vismanet-table__row">
<td class="vismanet-table__cell"><img src="/media/visma-net-erp/icon-add.png" alt="icon-add"
  loading="lazy"
  decoding="async"
></td>
<td class="vismanet-table__cell"><p>Gives you the ability to add a new simplified import scenario.</p>
<p>Clicking this button first opens the <strong>Select file for import</strong> dialog box, where you can select the file whose data you want to import, and then opens the <strong>Provide new scenario properties</strong> dialog box, where you select the window to be used for data import, name the scenario, and select the data provider type.</p>
</td>
</tr>

<tr class="vismanet-table__row">
<td class="vismanet-table__cell">Prepare and import</td>
<td class="vismanet-table__cell">Prepares the data and imports it.</td>
</tr>

<tr class="vismanet-table__row">
<td class="vismanet-table__cell">Prepare</td>
<td class="vismanet-table__cell">Prepares the data for import.</td>
</tr>

<tr class="vismanet-table__row">
<td class="vismanet-table__cell">Import</td>
<td class="vismanet-table__cell">Imports the prepared data.</td>
</tr>

<tr class="vismanet-table__row">
<td class="vismanet-table__cell">Upload file version</td>
<td class="vismanet-table__cell">Opens the <strong>Upload new revision</strong> dialog box that you can use to update an already uploaded file.</td>
</tr>

<tr class="vismanet-table__row">
<td class="vismanet-table__cell">Get file</td>
<td class="vismanet-table__cell">Downloads the latest file attached to the selected scenario.</td>
</tr>

<tr class="vismanet-table__row">
<td class="vismanet-table__cell">View screen</td>
<td class="vismanet-table__cell">Displays the Visma Net window to which you are importing data with the error occurred during data import. The button is only available if there was an error during data import.</td>
</tr>

</table>


### The Provide new scenario properties dialog box

In this dialog box, you can select the window to be used for importing data, enter the scenario name, and change the data provider.

<table class="vismanet-table">
  <colgroup>
    <col class="vismanet-table__col--key">
    <col>
  </colgroup>
<thead class="vismanet-table__head">
  <tr class="vismanet-table__header-row">
<th class="vismanet-table__cell vismanet-table__cell--header">Element</th>
<th class="vismanet-table__cell vismanet-table__cell--header">Description</th>
</tr>
</thead>

<tr class="vismanet-table__row">
<td class="vismanet-table__cell">Window name</td>
<td class="vismanet-table__cell"><p>Required. The Visma Net form to be used for importing data from the uploaded file.</p>
<p>You select the window name by finding its workspace, finding its section, and selecting the applicable form in the site tree.</p>
</td>
</tr>

<tr class="vismanet-table__row">
<td class="vismanet-table__cell">Scenario name</td>
<td class="vismanet-table__cell"><p>Required. The name of the new simplified import scenario.</p>
<p>The system generates the
name automatically, based on the title of the form you selected in
the <strong>Window name</strong> field.
If required, you can
change the name.</p>
</td>
</tr>

<tr class="vismanet-table__row">
<td class="vismanet-table__cell">Provider type</td>
<td class="vismanet-table__cell">Required. The provider type, which is defined automatically based on the file type.</td>
</tr>

<tr class="vismanet-table__row">
<td class="vismanet-table__cell">OK</td>
<td class="vismanet-table__cell">Creates a new simplified scenario for data import and closes the dialog box.</td>
</tr>

<tr class="vismanet-table__row">
<td class="vismanet-table__cell">Close</td>
<td class="vismanet-table__cell">Closes the dialog box without creating a new simplified scenario for data import.</td>
</tr>

</table>


## The top part

In this area, you can select an existing import scenario and view information about the scenario.

<table class="vismanet-table">
  <colgroup>
    <col class="vismanet-table__col--key">
    <col>
  </colgroup>
<thead class="vismanet-table__head">
  <tr class="vismanet-table__header-row">
<th class="vismanet-table__cell vismanet-table__cell--header">Element</th>
<th class="vismanet-table__cell vismanet-table__cell--header">Description</th>
</tr>
</thead>

<tr class="vismanet-table__row">
<td class="vismanet-table__cell">Name</td>
<td class="vismanet-table__cell">The name of the scenario that should be used for data import.</td>
</tr>

<tr class="vismanet-table__row">
<td class="vismanet-table__cell">Window name</td>
<td class="vismanet-table__cell">A read-only element showing the name of the Visma Net window whose functionality will be used to perform import.</td>
</tr>

<tr class="vismanet-table__row">
<td class="vismanet-table__cell">Status</td>
<td class="vismanet-table__cell"><p>A read-only element that shows the status of the selected scenario, which is
automatically assigned during the processing and can be one of the
following options:</p>
<dl>
<dt>New</dt>
<dd>Indicates either that this scenario is new and has not been used for data preparation or that the history of processing for this scenario has been rolled back.</dd>
<dt>Prepared</dt>
<dd>Indicates that the data has been prepared in accordance with the scenario.</dd>
<dt>Partially processed</dt>
<dd>Indicates that the data for the scenario has been imported only partially.</dd>
<dt>Processed</dt>
<dd>Indicates that the data for the scenario has been imported completely.</dd>
</dl></td>
</tr>

<tr class="vismanet-table__row">
<td class="vismanet-table__cell">Number of records</td>
<td class="vismanet-table__cell">A read-only element that displays the number of records in the external source.</td>
</tr>

<tr class="vismanet-table__row">
<td class="vismanet-table__cell">Simple scenario</td>
<td class="vismanet-table__cell">A read-only check box that, if selected, indicates that the selected scenario is a simplified import scenario. For more information, see: <a href="/visma-net-erp/help/integration/importing-and-exporting-records-by-using-scenarios/simplified-scenarios-for-data-import/index.md">Simplified scenarios for data import</a>.</td>
</tr>

<tr class="vismanet-table__row">
<td class="vismanet-table__cell">Discard previous result</td>
<td class="vismanet-table__cell"><p>A check box that you select to prepare and import data regardless of the status and the results of the previous import.</p>
<p>Generally, you should select this check box if you are scheduling the processing of the selected scenario and you expect errors during the import that do not affect the performance of the scenario.</p>
<p>For example: The system returns an error for a line when it is
trying to import a line that has been imported in the previous
cycle.
If you select the check box, the system can run the
scenario on a schedule, thus importing the new lines.
If you
clear the check box, the system won&rsquo;t be able to run the
scenario on schedule if the previous processing of the scenario
returned errors.</p>
<p>For more information about scheduling, see: <a href="/visma-net-erp/help/automation/about-scheduled-processing/index.md">About scheduled processing</a>.</p>
</td>
</tr>

</table>


## The Prepared data tab

On this tab, you can review the data prepared for import and any errors that have occurred.

The actual list displays the processed data, with as many columns as there are
internal fields mapped to the external data.

<table class="vismanet-table">
  <colgroup>
    <col class="vismanet-table__col--key">
    <col>
  </colgroup>
<thead class="vismanet-table__head">
  <tr class="vismanet-table__header-row">
<th class="vismanet-table__cell vismanet-table__cell--header">Button</th>
<th class="vismanet-table__cell vismanet-table__cell--header">Description</th>
</tr>
</thead>

<tr class="vismanet-table__row">
<td class="vismanet-table__cell">Toggle activation</td>
<td class="vismanet-table__cell">Reverses the value in the <strong>Active</strong> column in the selected line and updates the rest of the lines with this value.</td>
</tr>

<tr class="vismanet-table__row">
<td class="vismanet-table__cell">Clear activation till error</td>
<td class="vismanet-table__cell">Clears the check boxes in the <strong>Active</strong> column for the lines before the line with an error. If there are no errors, clears all the check boxes in the <strong>Active</strong> column.</td>
</tr>

<tr class="vismanet-table__row">
<td class="vismanet-table__cell">Toggle processing</td>
<td class="vismanet-table__cell">Reverses the value in the <strong>Processed</strong> column in the selected line and updates the rest of the lines with this value.</td>
</tr>

<tr class="vismanet-table__row">
<td class="vismanet-table__cell">Clear error</td>
<td class="vismanet-table__cell">Clears the error messages in the <strong>Error</strong> column.</td>
</tr>

</table>


<table class="vismanet-table">
  <colgroup>
    <col class="vismanet-table__col--key">
    <col>
  </colgroup>
<thead class="vismanet-table__head">
  <tr class="vismanet-table__header-row">
<th class="vismanet-table__cell vismanet-table__cell--header">Column</th>
<th class="vismanet-table__cell vismanet-table__cell--header">Description</th>
</tr>
</thead>

<tr class="vismanet-table__row">
<td class="vismanet-table__cell">Number</td>
<td class="vismanet-table__cell">The number of the record in the list of records for import.</td>
</tr>

<tr class="vismanet-table__row">
<td class="vismanet-table__cell">Active</td>
<td class="vismanet-table__cell">A check box that indicates (if selected) that the record is active and will be imported.</td>
</tr>

<tr class="vismanet-table__row">
<td class="vismanet-table__cell">Processed</td>
<td class="vismanet-table__cell">A check box that indicates (if selected) that the information in the row was processed.</td>
</tr>

<tr class="vismanet-table__row">
<td class="vismanet-table__cell">Error</td>
<td class="vismanet-table__cell">The error message, if an error has occurred for this row.</td>
</tr>

</table>


## The Mapping tab

You use this tab, which appears only when you create or open a simplified data
import, to map the data from the external source to the fields of the specified data
entry window in Visma Net for automatic import.
For more details on simplified import scenarios, see: [Simplified scenarios for data import](https://docs.vismasoftware.no/visma-net-erp/help/integration/importing-and-exporting-records-by-using-scenarios/simplified-scenarios-for-data-import/index.md).

<table class="vismanet-table">
  <colgroup>
    <col class="vismanet-table__col--key">
    <col>
  </colgroup>
<thead class="vismanet-table__head">
  <tr class="vismanet-table__header-row">
<th class="vismanet-table__cell vismanet-table__cell--header">Button</th>
<th class="vismanet-table__cell vismanet-table__cell--header">Description</th>
</tr>
</thead>

<tr class="vismanet-table__row">
<td class="vismanet-table__cell">Refresh from file</td>
<td class="vismanet-table__cell">Refreshes the data schema for an existing provider after you have uploaded a new version of the file.</td>
</tr>

</table>


<table class="vismanet-table">
  <colgroup>
    <col class="vismanet-table__col--key">
    <col>
  </colgroup>
<thead class="vismanet-table__head">
  <tr class="vismanet-table__header-row">
<th class="vismanet-table__cell vismanet-table__cell--header">Column</th>
<th class="vismanet-table__cell vismanet-table__cell--header">Description</th>
</tr>
</thead>

<tr class="vismanet-table__row">
<td class="vismanet-table__cell">Active</td>
<td class="vismanet-table__cell">A check box that indicates (if selected) that this field or action is active during import.</td>
</tr>

<tr class="vismanet-table__row">
<td class="vismanet-table__cell">Source field/value</td>
<td class="vismanet-table__cell">An external field (in the source file) whose value should be imported into the
specified internal field, or an expression to be executed on import
to generate the value for an internal field.
Click the <img src="/media/visma-net-erp/Images-SM_20_60_25_SM_20_60_25Icon_DropDownList.jpg" alt="Images-SM_20_60_25_SM_20_60_25Icon_DropDownList"
  loading="lazy"
  decoding="async"
> icon to select from the list
of available fields, or click the <img src="/media/visma-net-erp/Images-SM_20_60_25_SM_20_60_25Icon_CreateNewObject.jpg" alt="Images-SM_20_60_25_SM_20_60_25Icon_CreateNewObject"
  loading="lazy"
  decoding="async"
> icon to open the Formula editor dialog box and
create a formula.</td>
</tr>

<tr class="vismanet-table__row">
<td class="vismanet-table__cell">Key</td>
<td class="vismanet-table__cell">A check box you select to mark the key fields in the uploaded file.</td>
</tr>

<tr class="vismanet-table__row">
<td class="vismanet-table__cell">Target object</td>
<td class="vismanet-table__cell">The name of the functional object of the graph that the Visma Net window is based on. (The functional object can be the top part, the details area, or any of the tabs or dialog boxes available for the window.)</td>
</tr>

<tr class="vismanet-table__row">
<td class="vismanet-table__cell">Field name</td>
<td class="vismanet-table__cell">The name of the field or action of the functional object selected in the <strong>Target object</strong> column. Click the field to display the list of available values.</td>
</tr>

</table>


## The History tab

You use this tab to view the history of processing for the selected scenario.

A history
record is inserted in the table after the import operation is completed.

Therefore, if an application server restarts during processing of an import
scenario (for example, if the session was timed out), no history record is
inserted in the table.

<table class="vismanet-table">
  <colgroup>
    <col class="vismanet-table__col--key">
    <col>
  </colgroup>
<thead class="vismanet-table__head">
  <tr class="vismanet-table__header-row">
<th class="vismanet-table__cell vismanet-table__cell--header">Button</th>
<th class="vismanet-table__cell vismanet-table__cell--header">Description</th>
</tr>
</thead>

<tr class="vismanet-table__row">
<td class="vismanet-table__cell">Roll back</td>
<td class="vismanet-table__cell">Clears the history of scenario execution and clears the prepared data. Clicking <strong>Roll back</strong> doesn&rsquo;t reverse records that have already been imported.</td>
</tr>

</table>


<table class="vismanet-table">
  <colgroup>
    <col class="vismanet-table__col--key">
    <col>
  </colgroup>
<thead class="vismanet-table__head">
  <tr class="vismanet-table__header-row">
<th class="vismanet-table__cell vismanet-table__cell--header">Column</th>
<th class="vismanet-table__cell vismanet-table__cell--header">Description</th>
</tr>
</thead>

<tr class="vismanet-table__row">
<td class="vismanet-table__cell">Status date</td>
<td class="vismanet-table__cell">The date when the status of the data had changed as a result of the processing being performed.</td>
</tr>

<tr class="vismanet-table__row">
<td class="vismanet-table__cell">Status</td>
<td class="vismanet-table__cell">The status of the data as a result of processing being performed.</td>
</tr>

<tr class="vismanet-table__row">
<td class="vismanet-table__cell">Number of records</td>
<td class="vismanet-table__cell">The number of records processed.</td>
</tr>

<tr class="vismanet-table__row">
<td class="vismanet-table__cell">Version</td>
<td class="vismanet-table__cell">The version of the uploaded external file.</td>
</tr>

<tr class="vismanet-table__row">
<td class="vismanet-table__cell">Description</td>
<td class="vismanet-table__cell">The description of the operation.</td>
</tr>

</table>


## The Details tab

On this tab, you can view additional information about the selected scenario.

### The Information section

<table class="vismanet-table">
  <colgroup>
    <col class="vismanet-table__col--key">
    <col>
  </colgroup>
<thead class="vismanet-table__head">
  <tr class="vismanet-table__header-row">
<th class="vismanet-table__cell vismanet-table__cell--header">Element</th>
<th class="vismanet-table__cell vismanet-table__cell--header">Description</th>
</tr>
</thead>

<tr class="vismanet-table__row">
<td class="vismanet-table__cell">Provider</td>
<td class="vismanet-table__cell"><p>A read-only box that displays the data provider of the selected import scenario.</p>
<p>To view the details of the provider, click the button to the right of the field to open the <a href="/visma-net-erp/help/integration/integration-windows/data-providers-sm206015/index.md">Data providers (SM206015)</a> window.</p>
</td>
</tr>

<tr class="vismanet-table__row">
<td class="vismanet-table__cell">Sync type</td>
<td class="vismanet-table__cell"><p>A read-only box that shows the type of synchronisation for the
selected scenario, which can be one of the following options:</p>
<dl>
<dt>Full</dt>
<dd>Performs export of all the data in accordance with the scenario.</dd>
<dt>Incremental: all records</dt>
<dd>Performs partial export, including only the data (mentioned in the scenario) that has changed in the Visma Net records.</dd>
<dt>Incremental: new only</dt>
<dd>Performs partial export, including only those records that have appeared in the Visma Net database since the previous export took place.</dd>
</dl></td>
</tr>

<tr class="vismanet-table__row">
<td class="vismanet-table__cell">Prepared on</td>
<td class="vismanet-table__cell">A read-only box displaying the date when the data was prepared or the export was performed.</td>
</tr>

<tr class="vismanet-table__row">
<td class="vismanet-table__cell">Completed on</td>
<td class="vismanet-table__cell">A read-only box that shows the date and time when the export was completed.</td>
</tr>

</table>


### The Site map section

<table class="vismanet-table">
  <colgroup>
    <col class="vismanet-table__col--key">
    <col>
  </colgroup>
<thead class="vismanet-table__head">
  <tr class="vismanet-table__header-row">
<th class="vismanet-table__cell vismanet-table__cell--header">Element</th>
<th class="vismanet-table__cell vismanet-table__cell--header">Description</th>
</tr>
</thead>

<tr class="vismanet-table__row">
<td class="vismanet-table__cell">Site map location</td>
<td class="vismanet-table__cell">The location of the scenario on the site map. Select the location if you want to add the scenario to the site map.</td>
</tr>

<tr class="vismanet-table__row">
<td class="vismanet-table__cell">Site map title</td>
<td class="vismanet-table__cell">The title of the scenario on the site map. Provide the title if you want to add the scenario to the site map.</td>
</tr>

</table>


### The Options section

<table class="vismanet-table">
  <colgroup>
    <col class="vismanet-table__col--key">
    <col>
  </colgroup>
<thead class="vismanet-table__head">
  <tr class="vismanet-table__header-row">
<th class="vismanet-table__cell vismanet-table__cell--header">Element</th>
<th class="vismanet-table__cell vismanet-table__cell--header">Description</th>
</tr>
</thead>

<tr class="vismanet-table__row">
<td class="vismanet-table__cell">Break on error</td>
<td class="vismanet-table__cell"><p>A check box that indicates (if selected) that the processing will be cancelled if an error occurs.</p>
<p>You specify this option for a particular execution
of a scenario.
That is, the selected value is discarded after
each execution of the scenario or each refresh of the
page.</p>
<p>This check box affects the order in which the
records are imported.
For example: Suppose that you are
importing documents with auto-numbering of documents, and each
line of the source contains one document.</p>
<p>If you clear the <strong>Break on error</strong> check box, all correct documents will be imported first, and then you will review all errors at once and import the corrected records. The order in which the reference numbers are assigned to the imported documents will be different than in the situation if you import documents one by one and stop after each error.</p>
<p>If the order of record processing is not important, you can clear the <strong>Break on error</strong> check box.</p>
</td>
</tr>

<tr class="vismanet-table__row">
<td class="vismanet-table__cell">Break on incorrect target</td>
<td class="vismanet-table__cell"><p>A check box that indicates (if selected) that the system will stop processing records at the first error that occurs for a record that violates the target restrictions.</p>
<p>You specify this option for a particular execution
of a scenario.
That is, the selected value is discarded after
each execution of the scenario or each refresh of the
page.</p>
</td>
</tr>

<tr class="vismanet-table__row">
<td class="vismanet-table__cell">Validate data (no saving)</td>
<td class="vismanet-table__cell"><p>A check box you select to validate the selected import scenario.
The scenario
processing emulates data import and is cancelled if an error occurs.
If you want to save the imported data after successful validation,
select the <strong>Save if data is valid</strong> check box.</p>
<p>You specify this option for a particular execution of a
scenario.
That is, the selected value is discarded after each
execution of the scenario or each refresh of the
page.</p>
</td>
</tr>

<tr class="vismanet-table__row">
<td class="vismanet-table__cell">Save if data is valid</td>
<td class="vismanet-table__cell"><p>A check box you select to save the data if the import validation is successful.
Clear
the check box if you don&rsquo;t want to save the data after import
validation.</p>
<p>This option is available only when you select the <strong>Validate data (no saving)</strong> check box to switch to import validation mode.</p>
<p>You specify this option for a
particular execution of a scenario.
That is, the selected value
is discarded after each execution of the scenario or each
refresh of the page.</p>
</td>
</tr>

<tr class="vismanet-table__row">
<td class="vismanet-table__cell">Skip headers</td>
<td class="vismanet-table__cell"><p>A check box that you select to not import the titles of the elements in the window.</p>
<p>You specify this option for a particular execution of a
scenario.
That is, the selected value is discarded after each
execution of the scenario or each refresh of the
page.</p>
</td>
</tr>

</table>


Parent topic:

[Integration windows - overview](https://docs.vismasoftware.no/visma-net-erp/help/integration/integration-windows/integration-windows-overview/index.md)


---

[View this page](https://docs.vismasoftware.no/visma-net-erp/help/integration/integration-windows/import-by-scenario-sm206036/)
