Revision: 3a38ee0c86

+<p>The Data Import Tool allows you to bring in records from a CSV/Excel file.</p>

+<p>The Data Import Tool simplifies the process of uploading or editing large amounts of data, particularly master data, into the system.</p>

+

+<h3>1. Pre-requisite</h3>

+<p>No Pre-requisite required </p>

+

+<h3>2. How to use Data Import </h3>

+<p>To use Data Import go to </p>

+<blockquote>Self Services > Import New Data </blockquote>

+<div style="position: relative; padding-bottom: 56.25%; height: 0; overflow: hidden;">

+    <iframe src="https://app.tango.us/app/embed/4bc9684e-1170-4aec-aa9a-724291706beb" style="min-height:640px" sandbox="allow-scripts allow-top-navigation-by-user-activation allow-popups allow-same-origin" security="restricted" title="Importing New Data via Employee Self Services" width="100%" height="100%" referrerpolicy="strict-origin-when-cross-origin" frameborder="0" webkitallowfullscreen="webkitallowfullscreen" mozallowfullscreen="mozallowfullscreen" allowfullscreen="allowfullscreen"></iframe>

+</div>

+

+Or 

+<p>Go to the document you want to improt data from </p>

+<div style="position: relative; padding-bottom: 56.25%; height: 0; overflow: hidden;">

+  <iframe src="https://app.tango.us/app/embed/b983b1d2-c7cf-44d1-b3af-44e1c96cd0a2?iframe=true" sandbox="allow-scripts allow-top-navigation-by-user-activation allow-popups allow-same-origin" security="restricted" title="Importing data from Document In StrideERP" style="position: absolute; top: 0; left: 0; width: 100%; height: 100%;" referrerpolicy="strict-origin-when-cross-origin" frameborder="0" webkitallowfullscreen="webkitallowfullscreen" mozallowfullscreen="mozallowfullscreen" allowfullscreen="allowfullscreen"></iframe>

+</div>

+

+<h3>3. Inserting New Records</h3>

+<p>Suppose you wish to transfer the list of Customers from your previous system to StrideERP. To begin, you need to download a template where you can input your data.</p>

+

+<h3>3.1 Download the Template</h3>

+<p></p>

+

+<div style="position: relative; padding-bottom: 56.25%; height: 0; overflow: hidden;">

+    <iframe src="https://app.tango.us/app/embed/5dadb97c-6251-4a92-b564-de4312089aef" style="min-height:640px" sandbox="allow-scripts allow-top-navigation-by-user-activation allow-popups allow-same-origin" security="restricted" title="Guide to Download Data Import Template" width="100%" height="100%" referrerpolicy="strict-origin-when-cross-origin" frameborder="0" webkitallowfullscreen="webkitallowfullscreen" mozallowfullscreen="mozallowfullscreen" allowfullscreen="allowfullscreen"></iframe>

+</div>

+

+<h3>3.2 Entering Data in the Template</h3>

+<p>The template you downloaded will resemble something like this:</p>

+<img src="/files/blank-template-file.png">

+

+<p>Open the downloaded template in a spreadsheet application (such as Excel, Numbers, or Libre Office) and input the data below the column headings as indicated below:</p>

+<img src="/files/customer-template-with-data.png">

+<p>Now, save your template as an Excel or Comma Separated Values (CSV) file.</p>

+

+<blockquote>You can leave the ID column as blank while inserting new records.</blockquote>

+<p>When you import this template, each row will make a Customer record in the system.</p>

+

+<h3>3.3 Importing the Template</h3>

+

+<div style="position: relative; padding-bottom: 56.25%; height: 0; overflow: hidden;">

+    <iframe src="https://app.tango.us/app/embed/19f0dfad-ee6c-47c4-beae-487e33a378fb" style="min-height:640px" sandbox="allow-scripts allow-top-navigation-by-user-activation allow-popups allow-same-origin" security="restricted" title="Importing Data from Excel" width="100%" height="100%" referrerpolicy="strict-origin-when-cross-origin" frameborder="0" webkitallowfullscreen="webkitallowfullscreen" mozallowfullscreen="mozallowfullscreen" allowfullscreen="allowfullscreen"></iframe>

+</div>

+<br>

+<p>If there are any errors in your template, they will be shown in the Warnings section. The warnings will be categorized by Row or Column with their number so that you can easily track them down in the template and resolve them. You must resolve all the warnings before you can import the data.</p>

+

+<p>After you have resolved the warnings, click on Start Import again to import the data. On successful import of the data, you'll see a log of each record that was created in the Import Log section.</p>

+

+<h3>4. Updating Existing Records</h3>

+

+<p>Suppose you need to update customer data in bulk in your system. The initial step is to download the template containing the data.</p>

+<h3>4.1 Download the Template</h3>

+<div style="position: relative; padding-bottom: 56.25%; height: 0; overflow: hidden;">

+  <iframe src="https://app.tango.us/app/embed/60f08e27-f082-4316-8a09-0b443ead1472?iframe=true" sandbox="allow-scripts allow-top-navigation-by-user-activation allow-popups allow-same-origin" security="restricted" title="Download the Template from data import in StrideERP" style="position: absolute; top: 0; left: 0; width: 100%; height: 100%;" referrerpolicy="strict-origin-when-cross-origin" frameborder="0" webkitallowfullscreen="webkitallowfullscreen" mozallowfullscreen="mozallowfullscreen" allowfullscreen="allowfullscreen"></iframe>

+</div>

+<h3>4.2  Updating Data in the Template</h3>

+<p>Your downloaded template will look something like this:</p>

+<img src="/files/customer-template-for-update.png">

+<p>Now, change the values in your template and save the file as Excel or CSV.</p>

+<blockquote>When exporting records for updates, it is important to include the ID column without making any changes to it. The ID column values are used to identify the records in the system. You can modify values in other columns, but not in the ID column. If you delete a row from a child table, the system will interpret it as a deletion action.</blockquote>

+

+<h3>4.3 Importing the Template</h3>

+<div style="position: relative; padding-bottom: 56.25%; height: 0; overflow: hidden;">

+  <iframe src="https://app.tango.us/app/embed/35c6acb3-bc94-4425-ae40-f2ecccfcca9a?iframe=true" sandbox="allow-scripts allow-top-navigation-by-user-activation allow-popups allow-same-origin" security="restricted" title="Importing Data with Attached Document" style="position: absolute; top: 0; left: 0; width: 100%; height: 100%;" referrerpolicy="strict-origin-when-cross-origin" frameborder="0" webkitallowfullscreen="webkitallowfullscreen" mozallowfullscreen="mozallowfullscreen" allowfullscreen="allowfullscreen"></iframe>

+</div>

+

+<h3>5. Importing Child Records</h3>

+<p>Data in StrideERP is organized in tables similar to spreadsheets, with columns and rows. Each form, such as Sales Order, consists of various fields like Customer, Company, etc. Additionally, there are tables within the form, such as the item table or tax table. During data import, the main table is considered to be the set of fields in the Sales Order, while the rows within the child table (e.g., item table) are treated as the child table for importing data.</p>

+<p>In StrideERP, each form can have multiple child tables connected to it. These child tables are linked to the parent tables and are used when there are multiple values for a specific property. For instance, an Item can have multiple prices, a Sales Invoice can have multiple Items, Taxes, and so on.</p>

+<p>When exporting a document with child tables, each child row will be displayed on a separate row, but it will be linked to a single parent row. The parent columns in the subsequent rows will be empty. It is important to maintain this order and linkage when importing the data using Data Import.</p>

+<img src="/files/child-table-export.png">

+

+<h3>6. Import Options</h3>

+<h3>6.1 Import from Google Sheets</h3>

+<p>

+You also have the option to import data from Google Sheets. Simply import your template into Google Sheets and enter the data. It's important to ensure that the Google Sheet is set to public. You can test this by opening the Google Sheets URL in an incognito browser window.</p>

+

+<h3>6.2 Submit After Import</h3>

+<p>In StrideERP, there are two main types of document types: masters and transactions. Masters include records like Customers and Tasks, which can only be saved but not submitted. On the other hand, transactions such as Sales Orders and Purchase Invoices are submittable documents and can be submitted.</p>

+<p>

+When you choose a submittable document type for import, you have the option to select "Submit After Import." By ticking this option, the document will be automatically submitted once it is imported.</p>

+<h3>6.3 Don't Send Emails</h3>

+<p>Suppose you have set up a notification in your system to send an email whenever a lead is created. If you are importing leads in bulk, this could result in a large number of emails being sent, which may not be desirable. To prevent this, you can disable this option and avoid sending emails during the bulk import process.</p>

+

+<h3>7. Additional Notes</h3>

+<h3>7.1 Upload Limit</h3>

+<p>There is no strict restriction on the number of records you can import, but it is recommended to upload only a few thousand records at a time. Importing a large number of records, such as 50,000, can significantly slow down the system for other users.</p>

+

+<h3>7.2 CSV Files</h3>

+<p>A CSV (Comma Separated Value) file is a type of data file that can be uploaded to ERPNext for updating various data. It can be created by saving a spreadsheet file from applications like MS Excel or Open Office Spreadsheet as a CSV file.</p>

+<p>If you are using Microsoft Excel and have non-English characters in your file, ensure that you save the file with UTF-8 encoding.</p>

+<p>For older versions of Excel, there is no straightforward method to save files as UTF-8. Therefore, you can save your file as CSV, open it in Notepad, and then save it as "UTF-8" to ensure compatibility. Alternatively, you can consider upgrading your Excel version.</p>