1. Data Formats and Recommendations 2. Basic Principle of the Import-Export Tool Explained 3. Opening of and Overview over Import-Export Tool 4. Mapping of Data Sources 3.1 Mapping of Objects 3.2 Mapping of Types 3.3 Mapping of Multiple Values 5. Import Behaviour 6. XML Import 7. Export

1. i-views University
Part 04: Imports & Exports

2. Imports & Exports
2
If you have problems with the sound:
- Check the audio settings in menu item „Communicate“
- Join alternatively by telephone or by dial-in number
from landline phone (for free):
• 000-800-100-8171 for India
• 0800-894627 for Switzerland
from mobile phone
• +41 43456 9564 only for Switzerland
Event-Number: 841 561 659
Event-Password: hello

3. Imports & Exports
3
Today‘s Speaker
Annekathrin Lösche
Knowledge Engineer
intelligent views gmbh

4. Imports & Exports
4
Agenda
1. Data Formats and Recommendations
2. Basic Principle of the Import-Export Tool Explained
3. Opening of and Overview over Import-Export Tool
4. Mapping of Data Sources
3.1 Mapping of Objects
3.2 Mapping of Types
3.3 Mapping of Multiple Values
5. Import Behaviour
6. XML Import
7. Export

5. Imports & Exports
5
Import Data Formats
• Standardized database interface for direct connection to relational databases
• MySQL
• ODBC
• Oracle
• PostgreSQL
• LDAP (available for exchanging user IDs)
• .csv/.xlsx
• .xml
• .rdf
• .owl

6. Imports & Exports
6
Export Data Formats
• Standardized database interface for direct connection to relational databases
• MySQL
• ODBC
• Oracle
• PostgreSQL
• LDAP (available for exchanging user IDs)
• .csv/.xlsx
• .rdf
• .owl
• Further formats (e.g. JSON) can be generated through the i-views programming interface – the programming
interface is not part of the import-export tool

7. Imports & Exports
7
Import-Recommendations
There is no back button!
• To avoid unnessecary fallbacks, imports should first be tested in a local copy of the network
The database structure should not be created via imports!
• Imports should not be used to build the data model
• Relation- and attribute types cannot be defined during the import
Large files should not be imported untested!
• Import mappings should be tested with a small sample file

8. Imports & Exports
8
Basic Principle: Mapping with the Import-Export Tool
• MAPPING = assigning table-columns/ xml-tags to the
data model in i-views
Artist Album
Radiohead The King of limbs
Portishead Artist
Name of the object
Album

9. Imports & Exports
9
Basic Principle: Mapping with the Import-Export Tool
Artist Album
Radiohead The King of limbs
Portishead Artist
Name of the object
Album

10. Demonstration
Import settings

11. Imports & Exports
11
Opening the Import-Export Tool
• Location of the import-export tool:
• Folder -> Working folder or Private
• Technical -> Registered objects -> Data sources

12. Imports & Exports
12
Opening the Import-Export Tool
• Import and export mappings require:
• Name
• Information of the format to be imported

13. Imports & Exports
13
Example File (.csv)
"Band"; “Album”; "Short description album"; "Songs"
“Pink”; "M!ssundaztood"; "Missundaztood is the second studio album by American singer-songwriter Pink."
The album which released worldwide in late 2001 to global commercial and critical success, critics welcoming the new
pop-rock sound pink presented on the record, after urban-influenced R & b debut."; "M!ssundaztood, Don't let
me get me, Just Like a pill, Get the party started, Respect, 18 Wheeler, Family portrait, misery, Dear diary, Eventually,
Lonely Girl, Numb, Gone to California, My Vietnam"

14. Imports & Exports
14
Read Data from Import-File
1. Select file to import
(must correspond to
format of the import)
2. Read / update
structure of the
table

15. Imports & Exports
15
Choose Table File Type
Select file type
(default: .csv)

16. Imports & Exports
16
Identifying Headings
If the first line consists of
headings and the values of
the cells are in “ “ - put a
check mark here
"Band"; 'Album'; "Short description album"; "Songs"
'Pink'; "M! ssundaztood"; "Missundaztood is the second studio
album by American singer-songwriter Pink." The album which released
worldwide in late 2001 to global commercial and critical success, critics
welcoming the new pop-rock sound pink presented on the record,
after urban-influenced R & b debut. ";" "M!ssundaztood, Don't let me
get me, Just Like a pill, Get the party started, Respect, 18 Wheeler,
Family portrait, misery, Dear diary, Eventually, Lonely Girl, Numb,
Gone to California, My Vietnam"

17. Imports & Exports
17
Identifying Columns
The identification of columns is very
that important for one-time imports.
If a mapping is used for importing
various files or periodically recurring
imports, this option is very important.

18. Imports & Exports
18
Identfiy Columns
• If the structure of a file is changed
(columns renamed, sequence changed,
etc.), the mapping has to be adapted
to these changes
• If i-views can identify the columns, the
mapping doesn't have to be adapted
manually
Album Artist
The King of Limbs Radiohead
Dummy Portishead
Artist Album
Radiohead The King of Limbs
Portishead Dummy

19. Imports & Exports
19
Identfiy Columns
• By heading
• When?
• Column headings remain
constant but the order of the
columns doesn’t
• Requirements
• Strings of the column headings
must be identical
Album Artist
The King of Limbs Radiohead
Dummy Portishead
Artist Album
Radiohead The King of Limbs
Portishead Dummy
i-views compares the strings of the
headings and adapts the changes in the
mapping

20. Imports & Exports
20
Identfiy Columns
• By position
• When?
• Column label changes, the type
of information remains the
same
• Requirements
• Column position and
number may not change
Band CD name
Radiohead The King of Limbs
Portishead Dummy
Artist Album
Radiohead The King of Limbs
Portishead Dummy
Content from column 1 always become
artist objects in the network, those
from column 2 are albums objects.

21. Imports & Exports
21
Identfiy Columns
• Über Zeichenposition
• When?
• If the entries are not comma separated
and have a constant length (within a
"column")
• Requirement
• Character position and
number may not change
1 6 7
ID123 F Ida
ID456 M Timmi
ID789 M Max
ID753 F Michaela
Radio h ead
Example data
ID123FIda
ID456MTimmi
ID789MMax
ID753FMichaela
Radiohead
Position of
characters results in
this "table"
The last line makes
little sense, since it
does not
correspond to the
grid

22. Imports & Exports
22
Choosing the Seperator
Indication of the
character that
separates the
values ​​in the CSV
file
"Band"; 'Album'; "Short description album"; "Songs"
'Pink'; "M! ssundaztood"; "Missundaztood is the second studio
album by American singer-songwriter Pink." The album which released
worldwide in late 2001 to global commercial and critical success, critics
welcoming the new pop-rock sound pink presented on the record,
after urban-influenced R & b debut. ";" "M!ssundaztood, Don't let me
get me, Just Like a pill, Get the party started, Respect, 18 Wheeler,
Family portrait, misery, Dear diary, Eventually, Lonely Girl, Numb,
Gone to California, My Vietnam"

23. Imports & Exports
23
Encoding
Character encoding
of text in the .csv
file

24. Imports & Exports
24
Line Seperator
Method by which the
lines are separated
from each other
In Windows you can select
"auto detect" or CR-LF
CR = carriage return
(beginning of the line)
LF = line feed (next line)

25. Imports & Exports
25
Identification of Objects by Seperator
, Table columns that contain
multiple values ​​can be
identified by specifying the
separator
In the "songs" column multiple
entries are separated by
commas. If the comma is
specified as delimiter, the
import tool can create the songs
as individual objects
"Band"; 'Album'; "Short description album"; "Songs"
'Pink'; "M! ssundaztood"; "Missundaztood is the second studio
album by American singer-songwriter Pink." The album which released
worldwide in late 2001 to global commercial and critical success, critics
welcoming the new pop-rock sound pink presented on the record,
after urban-influenced R & b debut. ";" "M!ssundaztood, Don't let me
get me, Just Like a pill, Get the party started, Respect, 18 Wheeler,
Family portrait, misery, Dear diary, Eventually, Lonely Girl, Numb,
Gone to California, My Vietnam"

26. Imports & Exports
26
Creating Logs
For an easy control of the
import results, the imported
objects can be collected in a
folder. This folder must have
been created previously
Create "New Semantic
elements folder" (whether in
the Private or Working Folder)
and select during import
mapping.

27. Imports & Exports
27
Registry
Registry keys for data sources
can be set in the registry.
Registered data sources can be
used again in another context.
Any other use of this data
source can be viewed.

28. Building your import mapping
Demonstration

29. Imports & Exports
29
Mapping Tools
The mappings for imports and exports are
built using these building blocks.
Object
Type
Attribute
Relation
Extension
Delete
mapping
module
For export:
Export the object
inventory of a
folder
For export:
Export results
list of a search
For export:
Modify the value
of a cell with
script
For export:
Export internal i-
views ID
Move Import/
Export Mapping
to another
window
For export of
Search:
Objects with
this identifier
Export! specific objectImport
step by
step!
Import!

30. Imports & Exports
30
Mapping of Data Sources

31. Imports & Exports
31
Object Mapping

32. Imports & Exports
32
Attribute Mapping (1st Column)
• Each column heading can be mapped to an attribute; each cell represents an attribute value (can also
be empty)

33. Imports & Exports
33
Mapping of Data Sources

34. Imports & Exports
34
Mapping of Data Sources
• „Pink“ is singing the song.
• Furthermore, „Pink“ is a Person.
• We know that the Person singing this song is the creator of the song and can therefor link the song to the creater
„Pink“ with a relation of the type „was created by“.
• The relation target (Pink) is an object of type „Person“.
• This object has an an attribute „Name“ with the value of „Pink“.

35. Imports & Exports
35
Relation Mapping
• Each relation needs a source and a target

36. Imports & Exports
36
Attribute Mapping (2nd Column)
• Each column heading can be mapped to an attribute, each of this column‘s cell represents an
attribute value (it can be empty though)

37. Imports & Exports
37
Mapping of Data Sources

38. Imports & Exports
38
Identification of Objects
• Each object needs at least one attribute for identification in the graph database.
• If available, the ID should be used for identification.
If there is no ID, and and one attribute is not
sufficient to uniquely identify an object,
several attributes should be selected (ex.
name and album of the song).
!

39. Imports & Exports
39
Type Illustration
• Types can also be imported and exported. For example, the genres of songs are to be imported as
types. The songs should be specific objects of genre types.

40. Imports & Exports
40
Mapping of Types
!

41. Imports & Exports
41
Mapping of Types

42. Imports & Exports
42
Mapping of Types – Special Case
• Different types can be present in one column of a table. This case can also be mapped.

43. Imports & Exports
43
Attribute Types
• A date/ time can be assigned to an attribute of type
„date“.
• Boolean attributens and selection attributes can be
assigned the corresponding values from the database.

44. Imports & Exports
44
Mapping of Multiple Values for One Object Type
If several values are given for an
object type with an object (in our
example, several „Genres“ for each
album), there are three possible
ways the table could look like.
For two of those, the import has to
be adapted.

45. Imports & Exports
45
Mapping of Multiple Values for One Object Type

46. Imports & Exports
46
Settings for Import Behavior
• For each item its own import behavior can be determined.
• Default setting: "Update or create if not found"
• Existing elements will be overwritten, if they are not present, they will be created
You can specify the
Import behaviour.

47. Imports & Exports
47
Settings for Import Behavior
• Update
• Existing items will be overwritten (updated), no new elements will be created.
• Create new
• Creates a new property / object, without considering whether the attribute value or the object already exists, if
possible (note the setting, can occur several times in the attribute definition).
• Create new if not found (only available on attributes)
• Only if no other attribute of the desired type exists, a new one will be applied. (The import multiple attribute
values ​​simultaneously to an attribute type is not possible, since we can not decide which of the attribute
values ​​should be used.)
• Do not import

48. Imports & Exports
48
Settings for Import Behavior
• Delete
• Used to delete exactly the element.
• Delete all with same value (only properties available)
• All attribute values ​​that match the imported value will be deleted for the respective corresponding objects of the
import table.
• Delete all of same kind
• All attribute values ​​of the selected type are deleted for the corresponding objects of the import table, regardless
of whether the values ​​match or not.
Import

49. Imports & Exports
49
Settings for Import Behavior
• Synchronize
• Caution - Sync is also a form of deletion:
• If objects of a type are synchronized, all objects of that type that don't occur in the import table will be deleted,
• If an existing attribute receives no value from an import, it is deleted for the corresponding object of the import table. If the
existing attribute has a different value than in the import table, it is updated, even if it may appear several times.
Import

50. Imports & Exports
50
XML Import
• All XML files can be imported into i-
views.
• JSON preprocessing possible
• XSLT transformation possible

51. Imports & Exports
51
XML Import
• Options of data source file or URI
• Tags can be read through the button "Read from data source"

52. Imports & Exports
52
XML Import
- Adding an XPath expression

53. Imports & Exports
53
XML Import
• An item may be displayed in each case on one day.
• X-path expressions can be used for a mapping, too.

54. Imports & Exports
54
XPath - Examples
//genre[@label=„Rock“]/@lable
//genre Selects all genres, it does not matter where
they are in the document.
./genre Selects genres, which are a subelement of
the current node.
genre[@label] Selects all genres which hava a lable.
@label Selects the lable itself.

55. Imports & Exports
55
Export
• The export mapping is similar to the import mapping
• Columns must be defined manually.
• Export settings per element: Export All or Do not export

56. Imports & Exports
56
Exporting Query Results
Export of structure
query results
possible.
With identifiers
you can access
individual
elements.

57. Imports & Exports
57
Export Details
• Export of collections of semantic objects is
possible
• Export of individual semantic elements is
possible
• Export of the frame IDs as a string or 64-bit
integer is possible

58. Imports & Exports
58
Exporting with Script
• Script mappings are used when special
columns in the target table have to be
created.
• Scripting language: KScript or Javascript
• Example: three attributes from the semantic
graph data base are to be combined to an ID.
• Example: all attributes of a type should be
written separated by comma in a row in the
target table.

59. Imports & Exports
59
Exercise
musicCSVbeispielEinfach.csv
1. Import all albums of a band (with short description).
2. 1 + all songs of an album
musicCSVbeispiel.csv
1. import all bands, album and songs
2. 1 + genre
spicePersonen2.csv
1. Import all band members and all their alternative
names
musicXMLbeispiel2.xml
1. import all bands and albums
2. 1+ prices of the albums
3. import only bands and albums whose albums
cost more than 10 dollars
Export all songs with the mood pleasant
Export all songs and their duration in minutes

60. Imports & Exports
60
Send your questions to:
contact-webinar@i-views.com
Consultation hours: Every Wednesday
Thank you for visiting
i-views University

61. Imports & Exports
61
Unsere neuen Icons