Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
en:extensions:workflowdesigner:importer [2014/01/01 17:14]
swarnat
en:extensions:workflowdesigner:importer [2014/03/13 11:25] (current)
swarnat
Line 1: Line 1:
 ====== Importer ====== ====== Importer ======
 +In Verison 1.87 a new feature was integrated, which will help you to Import csv-Files and do individual tasks for every line from the file.
  
-In Verison 1.87 a new feature was integrated, which will help you to Import csv-Files and do individual tasks with entries from the file. +The basic idea behind ​this feature ​is to create a system, which could be used to import data in every possible csv-format. That means the csv don't need to have a default structure like this:
- +
-The basic idea behind ​the system ​is to create a system, which could be used to import data in every possible csv-format. That means the csv don't need to have a default structure like this:+
 row1 => record1 row1 => record1
 row2 => record2 row2 => record2
Line 18: Line 17:
  
 **Please following the following steps to use this feature: (You could integrate other tasks, but this should be the basic structure)** **Please following the following steps to use this feature: (You could integrate other tasks, but this should be the basic structure)**
 +//You could use the first example as start of the workflow.//
  
   - At first you have to create a Workflow with the Trigger "​Import Process"​. This makes the Workflow invisible in situations, different than import.   - At first you have to create a Workflow with the Trigger "​Import Process"​. This makes the Workflow invisible in situations, different than import.
Line 24: Line 24:
   - create a task “Import finished” and connect the bottom output from the next line task. This path will execute if the file was completely imported   - create a task “Import finished” and connect the bottom output from the next line task. This path will execute if the file was completely imported
   - easiest way: create a task "​execute expression with external record"​ to check if there is a record in your crm, which have to be changed by the CSV values (or directly create a record, ...)   - easiest way: create a task "​execute expression with external record"​ to check if there is a record in your crm, which have to be changed by the CSV values (or directly create a record, ...)
-  - Use the two functions wf_setField() and wf_saveRecord() to directly interact with the record you found.+  - Use the two functions wf_setField() and wf_save_record() to directly interact with the record you found
 + 
 +Now you could start the Import from the ListView of the assigned Module. Click on "​**start Workflow**"​ and switch to "​**Importer**"​ to upload your file.
  
 <WRAP info> <WRAP info>
 +=== Example 1 ===
 I have created an example which will reflect this steps and search a Contact with the email from column1 and set the "​title"​ field to the value from column 2. I have created an example which will reflect this steps and search a Contact with the email from column1 and set the "​title"​ field to the value from column 2.
  
 Download: {{:​en:​extensions:​workflowdesigner:​import_workflow.bin|Example Importer}} Download: {{:​en:​extensions:​workflowdesigner:​import_workflow.bin|Example Importer}}
 +
 +CSV-Example:​
 +<​code>​
 +user@domain.com,​newTitleValue
 +user2@domain.com,​newTitleValue2
 +</​code>​
 +</​WRAP>​
 +
 +<WRAP info>
 +=== Example 2 ===
 +{{ :​en:​extensions:​workflowdesigner:​import_searchcontact_create.png?​300|}}
 +This example will search Contacts by eMail (first Column). ​
 +If the Contact exists, update phone and fax (4th and 5th column).
 +If not, create Contact and set eMail, firstname, lastname, phone and lastname from CSV.
 +
 +Download: {{:​en:​extensions:​workflowdesigner:​import_searchcontact_create.bin|Example 2}}
 +
 +CSV-Example:​
 +<​code>​
 +test1@stefanwarnat.de,​Firstname1,​lastname1,​01235551,​01239991
 +test2@stefanwarnat.de,​Firstname2,​lastname1,​01235552,​01239992
 +test3@stefanwarnat.de,​Firstname3,​lastname1,​01235553,​01239993
 +test4@stefanwarnat.de,​Firstname4,​lastname1,​01235554,​01239994
 +test5@stefanwarnat.de,​Firstname5,​lastname1,​01235555,​01239995
 +test6@stefanwarnat.de,​Firstname6,​lastname1,​01235556,​01239996
 +test7@stefanwarnat.de,​Firstname7,​lastname1,​01235557,​01239997
 +test8@stefanwarnat.de,​Firstname8,​lastname1,​01235558,​01239998
 +test1@stefanwarnat.de,​Firstname11,​lastname11,​012355511,​012399911
 +</​code>​
 </​WRAP>​ </​WRAP>​