Skip to content

tmachyshyn/espocrm-data-tools

Repository files navigation

Data Tools for EspoCRM

Tools that help you to get data information or fix data before import.

1. Skipping invalid email addresses for .csv

This tool helps to find invalid email addresses and skip them in the .csv file. After running this tool will be created two .csv files:

  • the first will contain the list of correct records.
  • the second will contain the list of invalid records.

Example of input data

First name Last name ... Email Address Work Email
Joe Coyle .... [email protected] [email protected]
Paul Jones .... paul@tester [email protected]
Tom Richmond .... [email protected] tom
Connie Patterson .... [email protected] [email protected]

Result

Valid list

First name Last name ... Email Address Work Email
Joe Coyle .... [email protected] [email protected]
Connie Patterson .... [email protected] [email protected]

Invalid list

First name Last name ... Email Address Work Email
Paul Jones .... paul@tester [email protected]
Tom Richmond .... [email protected] tom

Usage

php command.php data-tool skipInvalidEmails --src="data/contacts.csv" --dest="data/valid.csv" --invalidDest="data/invalid.csv" --cells="Email Address, Work Email" --delimiter=","
  • src: Input .csv file, e.g. "data/src.csv".
  • dest: Valid list saved to .csv file, e.g. "data/valid.csv".
  • invalidDest: Invalid list saved to .csv file, e.g. "data/invalid.csv".
  • delimiter: Delimiter of your .csv file.
  • cells: List of cells which data should be fixed, e.g. "Email Address, Work Email".

2. Fixing multiple data in one cell for .csv

This tool help to fix data when one cell contains multiple data.

Example of input data

First name Last name ... Email Address Phone Number
Test Tester .... [email protected], [email protected], [email protected] 089 123 123 12, 075 111 222 33

Result

First name Last name ... Email Address Email Address 2 Email Address 3 Phone Number Phone Number 2
Test Tester .... [email protected] [email protected] [email protected] 089 123 123 12 075 111 222 33

Usage

php command.php data-tool fixCellData --src="data/contacts.csv" --dest="data/converted.csv" --cells="Work Email, Mobile Phone" --delimiter=";" --delimiterInsideCell=","
  • src: Input .csv file, e.g. "data/src.csv".
  • dest: Output .csv file, e.g. "data/dest.csv".
  • delimiter: Delimiter of your .csv file.
  • delimiterInsideCell: Delimiter inside a cell, e.g. "," for the data "[email protected], [email protected]".
  • cells: List of cells which data should be fixed, e.g. "Phone Number, Work Email".

3. Get a column list of deleted fields

In case of deleting a field from Administration > Entity Manager, the field still exists in the database.

Usage

php command.php data-tool deletedColumns
  • dest: Output .csv file, e.g. --dest="data/list.csv".
  • delimiter: Delimiter of generated .csv file, e.g. --delimiter=",".
  • entityTypes: List of checked entities, e.g. --entityTypes="Account, Contact".

License

Change a license in LICENSE file. The current license is intended for scripts of this repository.