IBM i2 iBase 8 Quick Start Guide

Transcription

IBM i2 iBase 8 Quick Start Guide
IBM i2 iBase 8
Quick Start Guide
Provided with IBM i2 iBase 8.9
May 2012
Copyright
0.1
This edition applies to version 8, release 9 of IBM® i2® iBase (product number 5725G15) and to all subsequent
releases and modifications until otherwise indicated in new editions.
This edition replaces part number 2144.
© Copyright International Business Machines Corporation 2008, 2012.
US Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule
Contract with IBM Corp.
Publication number GC19-3742-00
Copyright
2
If you are new to iBase
Introduction
Modes: User and Designer
Populating the Database
Creating Entities
Finding Entities
Linking Entities
Importing Data
Editing Entities and Links
Deleting Items
Merging Entities
Exploring & Creating Data with Analyst’s Notebook
Analyzing the Data
Categories and Notes
Queries
Sets
Browsing
Word Searching
Charting
Reporting
Mapping
Learning More About iBase
6
9
10
11
14
16
21
23
25
27
28
34
35
36
40
43
45
46
48
50
51
New features in this version
Importing Files from a Folder
Using Charts and Chart Item Data in iBase
Transforming Data on Import
Data Sources Task Pane in Analyst’s Notebook
Database Subsets
Alerting
Audit History
Searching with Search 360
Exporting and Importing Data as XML
Notices
IBM i2 iBase 8 Quick Start Guide
54
55
58
59
60
61
63
64
65
66
3
4
IBM i2 iBase 8 Quick Start Guide
Quick Start:
If you are new to
iBase
Welcome to IBM® i2® iBase 8.9.
iBase provides powerful solutions for accumulating, investigating, analyzing and
displaying complex information and relationships in link and entity data.
This guide aims to introduce you to the key concepts and basic operations of
iBase. Read this guide to familiarize yourself with the software before you start to
read the other product documentation to learn more about iBase.
What is iBase? iBase is both a database application and a modeling and analysis tool.
As a database application you can do all the things you would expect, such as
adding records, deleting records and importing/exporting records.
The modeling and analysis facilities are based upon the concepts of entities and
links. Entities are the things that are being represented, such as people and
addresses. Links represent relationships between entities, such as 'shareholder'
and 'account holder'. For each entity and link there is a database record.
iBase is closely integrated with other IBM i2 products and is a key component of
IBM i2 Analyst’s Workstation, an integrated suite of tools that supports a wide
range of analytical activities at strategic and tactical levels.
Help
If you need more information or help using a specific feature you can press the F1
key at any time to access the help.
IBM i2 Base 8 Quick Start Guide
5
Introduction
Introduction
Starting iBase
0.1
Start iBase as a user from the Start menu, typically:
Start ➧ All Programs ➧ IBM i2 iBase 8 ➧ IBM i2 iBase
Opening a Database
To open a database click the Open Database toolbar button. Choose a database
(.idb file) from the dialog that is displayed. If you do not know where the database
is located, ask your database administrator. Select a database and click Open.
You may find that are logged on automatically using your Windows user name and
password. Alternatively, you may need to enter a different user name and
password in the Logon dialog.
Note: Your database administrator will tell you what User Name and Password to use.
If you have previously opened one or more databases, their names may appear on
the File menu in the most-recently used (MRU) list. You will be offered the
opportunity to open the last database you used when you log on, if you want to
open a different database, click Cancel and then use the Open Database toolbar
button.
Cases
Some databases may contain separate cases, you may need to choose a case in
which to work. Cases allow you to focus only on those records that relate to a
particular investigation or series of investigations. If you select a particular case,
then all the operations you perform will apply only to that case. For example, if you
create a new record, it will be associated with the case you selected and will not be
visible in future when you elect to work in a different case.
User Guide
database
The User Guide database is supplied with iBase. You can reset the User Guide
database to its original state at any time so there is no need to worry if you delete
records or make mistakes as you are learning how to use iBase; you can always
get back to where you started.
To start iBase and open the User Guide database automatically, from the Start
menu, select:
All Programs ➧ IBM i2 iBase 8 ➧ Documentation ➧ iBase User Guide Database
Note: Both the User Name and Password for the User Guide database is general.
6
IBM i2 Base 8 Quick Start Guide
Introduction
Database
Explorer
When the database is opened, the screen will look similar to that below with the
Database Explorer window to the left and a blank area to the right:
Toolbar
Database Explorer
lists all the items in
your database
Database Explorer
Detail window displays
details of the item
selected
Status Bar
Dialog boxes and other information is displayed in the area to the right.
Some of the most common commands are available from the main toolbar, and
these are shown below:
New Entity
or Link
Browse Create
Report
Find
Open
Database
New
Query
Add to
Chart
New
Set
Add to
Map
Load Text
Chart Visualization
Window
Commands
Note: Some commands may not be visible if the database designer has not made them
available to you.
IBM i2 Base 8 Quick Start Guide
7
Introduction
Operations
Usually, all general functions are available from the menus or the toolbar; object
specific functions are available with a right-click.
iBase follows standard Windows conventions. If you are familiar with other
Windows based applications, you will be familiar with how to perform the iBase
actions below.
Action
Sequence
Select
Click on the object with the left mouse button.
Move
Select the object, hold down the left mouse button
and drag it to the required position.
Using the online help
Use the iBase help and use it to get answers to any questions that you may have.
Viewing the help
You can view the iBase help in the following ways:
•
from the Help menu, select Contents
•
press the F1 key (when the pointer is over the dialog)
In dialogs, you can display a help topic about a specific item by clicking the Help
button on a dialog to display information about that particular dialog.
For further information on how to use the help, select Help on Help from the Help
menu in iBase.
Tooltips
To see the name of a toolbar button, hold the pointer over it. A pop-up hint, referred
to as a tooltip, appears.
8
IBM i2 Base 8 Quick Start Guide
Modes: User and Designer
Modes: User and Designer
0.2
iBase can be used by both Designers and by Users. Designers are responsible for
designing databases and setting up the properties of entities and links and for
configuring security, these tasks are referred to as administrative tasks. Users can
use databases, add or import records, and manipulate or analyze the data. For
example if you wanted to add a new type of entity to your database, say an airport,
then the Designer would do that and set up all the required properties of an airport.
But if you wanted to add a new instance of an airport, and then run queries about
airports, these would be user tasks. Typically a database would have maybe one
or two people who carry out the administrative tasks but may have many people
who can carry out user tasks.
iBase has separate modules for Designers and Users so you log on to whichever is
appropriate for you. There may be one or both of the modules available as
shortcuts on your desktop.
The roles of Users and Designers can be summarized as follows:
Users
•
Add, modify and delete records.
•
Create sets and queries to find data of particular interest.
•
Analyze the data using a variety of tools.
•
Create reports or charts based upon the data.
This manual concentrates on the tasks performed by Users, and assumes that
your database has been created and configured for you by a Designer.
Designers
•
Design databases – this process usually involves consulting with the intended
users to decide exactly what information is to be stored and in what form.
•
Create new databases – includes creating all the required entity and link types.
•
Update databases – adding new entity and link types as requirements arise.
•
Configure databases – setting up code lists, labeling schemes and all the other
things that affect how the database is used.
•
Administer the database – for example: adding users, setting security, deleting
old records, and backing up the data.
If you are a Designer and Database Administrator then the online Administration
Center provide the information you need to get started.
IBM i2 Base 8 Quick Start Guide
9
Populating the Database
Populating the Database
0.3
There are two ways in which data is added to your database: manual entry and
importing. Most databases use a combination of the two methods. Once data has
been stored in your database it can be analyzed and reported on in iBase and
other applications such as IBM i2 Analyst’s Notebook®.
Manual entry
Entities and links can be added or edited on an individual basis. This approach is
particularly suited to an application such as an intelligence database where
information is being received regularly and database records are added or
amended as required.
Importing
The database can be populated by importing records, for either entities or links,
from other applications or sources, either within your organization or from outside.
Importing can effectively be used for small amounts of data up to very large
batches; telephone call records and bank account transaction records are
examples where you may need to import large volumes of data, maybe for case
analysis. iBase allows fine control over the way in which imported data is
interpreted and can accept data from a wide variety of sources. See Importing
Data on page 21 for more information.
When you have set up a successful session you can save all the settings in an
import specification so that it can be used again when similar data is received.
Imported data can be included in a specific set so that you can keep track of the
imported data and analyze or report on it on its own (see Sets on page 40 for more
information).
If you have IBM i2 Text Chart installed, unstructured text from a variety of source
documents can be added to your database using iBase Live, or by importing a Text
Chart visualization; see the Text Chart documentation for more details.
Exporting
10
Data can be exported from iBase in a variety of useful formats; as with importing,
once you have set up a successful export in the format you require, you can save
the export specification for re-use in the future.
IBM i2 Base 8 Quick Start Guide
Creating Entities
Creating Entities
0.4
One of the most common tasks in iBase is to add a new entity. This can be any of
the entity types that the database designer has made available to you; these could
be for example a person, a telephone, an address, or a vehicle.
The range of entities that are available in a particular database is shown if you click
on the plus sign to the left of Entities in the Database Explorer window.
Note: The examples in this manual are taken from the User Guide database. You can
experiment with iBase using this example database. See page 6 for details.
Right-click on the entity type you want to add, and from the shortcut menu, select
New.
IBM i2 Base 8 Quick Start Guide
11
Creating Entities
A dialog will be displayed where you can add properties to the new entity: in the
following example a new Event entity is being added to the database, and a dialog
is displayed ready for you to add all the details.
Mandatory fields, those that you must fill in, are shown with a blue label. Number
and date fields that are calculated from other data automatically are unavailable. If
you hold the pointer over the field labels you will see a tooltip that will tell you
something about the type of data to enter (if the Designer has made this facility
available).
12
IBM i2 Base 8 Quick Start Guide
Creating Entities
Datasheets
Your database designer may have set up a datasheet for some entities that
replaces the standard dialog with a customized dialog designed especially for your
application.
Datasheets show only the items that you need, arranged in pages that reflect your
way of working. Datasheets can also be used to enter data for related entities and
links. Administrative information, for example the age or source of information, can
be hidden if you do not need to enter such information yourself.
In the example below, the designer has set up a datasheet to enter the details of
an automobile crime. There are pages for entering the details of the crime and an
area where you can specify a link to the vehicle involved.
IBM i2 Base 8 Quick Start Guide
13
Finding Entities
Finding Entities
0.5
Many operations require that you locate and work with a specific record. Use the
Find Entity (or Find Link) command on the Edit menu.
Alternatively, click the Find toolbar button to display the Find dialog.
In the Find dialog, select the type of entity or link using the drop-down list at the top
and then enter some search criteria into the boxes below. You do not have to enter
all the data, perhaps the first few letters of a last name or the first few digits of an
account number would be sufficient, then click Find to display all the matching
records.
The found records are displayed in the Record List.
First few
letters
of required
name
Find
button
Record
List
Note: You can use wildcards to find last characters and so on. Click Help for details.
14
IBM i2 Base 8 Quick Start Guide
Finding Entities
From the Record List you can choose the record that you want. Either double-click
on the record to show the details or right-click, and from the shortcut menu, select
Show.
You can select more than one record at a time (using Shift+click and Ctrl+click) in
which case different options are available on the shortcut menu.
Monitoring
records of
interest
Perhaps the record you found is of particular interest to you or your colleagues, in
which case, you can add an alert to it so that you, and optionally your colleagues,
will be warned when someone else changes, or even views, this record. There is
more about alerting on page 61, however not all iBase databases will support this
feature. Ask your system administrator for details.
Browse or
Find?
You generally use Find when you are searching for a specific record; when you
want to look at lots of records, browsing may be more appropriate. (There is more
on browsing on page 43.) As is often the case in iBase, there are many ways to
accomplish the same task, it does not matter how you locate a particular record,
you can still perform all the normal iBase operations on it once it has been found.
IBM i2 Base 8 Quick Start Guide
15
Linking Entities
Linking Entities
0.6
Many of the entities in a database will be linked together. People may be linked to
companies as shareholders, directors, or employees; a pair of telephones may be
linked by a specific call made between them. Relationships between entities, and
the characteristics of those relationships, are defined by links. The types of link that
are available in a particular database are shown if you click on the plus sign to the
left of the word Links in the Database Explorer window.
Adding a link can be achieved in a number of different ways. Methods for creating a
link include:
16
•
From the New menu, select Link, choose a link type, and then find the entities
to link.
•
Find and view the two records to be linked, then drag and drop.
•
View an entity record and find the second entity, then drag and drop.
•
Select two entities and then, from the shortcut menu, select Create Link.
•
Select a link type in Database Explorer and, from the shortcut menu, select
New, then find the entities to link.
•
Using a datasheet, if one has been set up (see Datasheets on page 13).
IBM i2 Base 8 Quick Start Guide
Linking Entities
Linking entities
The simplest way to create a link between two entities is to create a new link and
then find the two entities to be connected.
For example you may decide to create an Employee link type and then find the
person and the organization that will be linked.
A new link dialog is displayed, you can fill in the details of the link at this stage.
Select the entities at either end of the new link and click Save to finish creating the
link and add it to the database.
IBM i2 Base 8 Quick Start Guide
17
Linking Entities
Linking entities using “drag and drop”
Another way to link two records is to display the two records and drag the icon
picture from one to the other. The pointer displays a plus sign when it is over the
second icon picture showing that a link will be created if you release the mouse
button. A link is created and you can then set its type and add any properties you
require.
Drag to the tab showing the other link end
When the tab for the other link end comes to the front,
drag the pointer over the icon picture
Pointer displays with
a plus sign
18
IBM i2 Base 8 Quick Start Guide
Linking Entities
The Multiple Links dialog is displayed, choose a link type from the list, and click
OK.
The link is created and the New dialog is displayed, where you can add the details
of the link.
IBM i2 Base 8 Quick Start Guide
19
Linking Entities
When you show links, the details are displayed in a Links dialog that allows you to
see what is linked and how many other links are connected to the same entity.
20
IBM i2 Base 8 Quick Start Guide
Importing Data
Importing Data
0.7
You may already have the data you wish to analyze in electronic form, for example
in a spreadsheet, in a file exported from some other database, or as a text file. You
can import the data into iBase and control exactly how the data is interpreted using
a comprehensive import specification. As part of the specification, you can choose
how to deal with duplicate records, or what to do if existing data is updated. The
import specification can be saved for future use if required (see also Categories
and Notes on page 35).
Create a new import specification in one of two ways:
•
From the File menu, select Data ➧ Import.
•
Right-click on Import Specifications in Database Explorer and select New.
The Import Wizard is started on the first of its five steps; select the type of data to
import and specify a source.
IBM i2 Base 8 Quick Start Guide
21
Importing Data
Click Next and fill in the details and go through each of the steps in turn; at any
time you can go backwards or forwards through the wizard steps to make changes
as required. The final step allows you to specify how errors are dealt with and
whether to include the newly imported data in a specified set so that you can keep
track of the newly created or updated data.
Click Run to run the import specification using the settings you have chosen.
22
IBM i2 Base 8 Quick Start Guide
Editing Entities and Links
Editing Entities and Links
0.8
Records in the database can be edited if you have permission to do so, either
individually or collectively.
Editing
individual
records
To edit the details on an individual record, browse for or find the record you want to
change and show the record. Click Edit and all fields that you can change are
displayed with a white background. Make your changes and click Save to store the
changes in the database.
Note that on some text fields your database designer may have set permissions
such that you may not be able to modify the current contents, only append new
text. These fields are shown in the Windows tooltip color (usually pale yellow)
rather than white. You can double-click on multi-line text fields to display a larger
window in which to read and edit the text.
Note: You may be able to see the edits made by other users by clicking History, however,
not all iBase databases will support this feature—ask your system administrator if
you are unsure. There is more about the history feature on page 63.
IBM i2 Base 8 Quick Start Guide
23
Editing Entities and Links
Batch editing
You can make changes to many records at a time. All the records need to be of the
same entity or link type and the changes can apply to all records of that type, or
only to those records returned by a query or contained in a set. From the Edit
menu, select Batch Edit.
The field names are displayed in the Update Field area. You can only edit one field
at a time. When you have specified the changes to be made, click Update to
continue. You will be asked to confirm that you really do want to make the edit, you
will see a message stating how many records have been affected.
Audit logging
Before you perform some operations in iBase, you may be asked for a reason
before you will be able to proceed. This is set up by your database administrator
who can decide which operations are affected; batch edit and batch delete (see
page 25) are types of operations where this is most likely to apply.
When you are asked to enter a reason, you must do so to continue with the
operation. The text you enter, along with the date, time, and your user ID, is
recorded in an audit log which can be examined by the database administrator.
24
IBM i2 Base 8 Quick Start Guide
Deleting Items
Deleting Items
0.9
Database records can be deleted individually at any time by selecting the record,
viewing it in a Show dialog, and clicking the Delete button. The only way to delete
more than one record at a time is to use the Batch Delete facility described below.
Note: Your database administrator may not allow you permission to carry out all the
delete, restore, and purge operations described in this section.
Batch delete
To delete more than one record at a time, from the Edit menu, select Batch
Delete. You can delete all records of a specified type, all records retrieved as the
result of a query, or all records in a specified set. You may want to construct a set
or query especially to define a group of records to be deleted.
Warning: Batch Delete is very powerful and, if your administrator has not enabled Soft
Delete, it is easy to delete large numbers of records permanently.
Soft delete
Your database administrator may have decided that iBase users may only use a
soft delete for database records. In this case you can delete records either
individually or by using batch delete but the records can be restored at any time.
When you are sure that you want to make the deletion permanent, you purge the
deleted records. Purged records cannot be restored.
You can check whether Soft Delete is turned on by looking at the database
properties: from the File menu, select Properties ➧ Database Properties and
click the Advanced tab to display the Advanced page.
Soft Delete turned on
IBM i2 Base 8 Quick Start Guide
25
Deleting Items
At any time between a deletion and a purge operation, some or all of the deleted
records can be restored to the database in exactly the state they were in at the time
of being deleted. From the Edit menu, select Restore Deleted Records.
When you are sure that deleted records are no longer required (or perhaps at
regular intervals) you can purge deleted records. From the Edit menu, select
Purge Deleted Records.
26
IBM i2 Base 8 Quick Start Guide
Merging Entities
Merging Entities
0.10
When you have two or more entity records that you decide actually relate to the
same person or object, you can merge entities to keep all of your data together in a
single record. From the Edit menu, select Merge Entities to display the Merge
Entities dialog.
On merging record 1 (the merge record in the upper pane of the dialog) with record
2 in the lower pane (there can be more than one record in the lower pane):
•
If the check box is turned on, blank fields in the merge record will be filled with
any data from record 2
•
Link information in record 2 will be transferred to the merge record.
•
Record 2 will be deleted.
IBM i2 Base 8 Quick Start Guide
27
Exploring & Creating Data with Analyst’s Notebook
Exploring & Creating Data with Analyst’s Notebook0.11
In Analyst’s Notebook, the Data Sources Task Pane, contains common tasks to
enable you to use an iBase database with Analyst's Notebook, for example, to find
and query records and to add them to your chart and then to expand them to see
the items to which they are connected.
To open an iBase database from Analyst’s Notebook, start Analyst’s Notebook and
in the Data Sources panel, displayed at the top of the Data Sources Task Pane,
click Open Database.
Note: You may find that the location of the required database is already included in the
list of recently opened databases, click on the name to open it directly. Log on to
the database using your iBase user name and password.
Creating entities and searching the iBase database
When you have opened at least one database, the tab changes to show that you
have an open database, and the New, Selection and Options pages are displayed.
In the Data Sources panel, an icon is displayed next to the database name to
indicate that it is open.
Use the New page of the Data Sources Task Pane, for example, to create entities
or links and to search for records in your iBase database.
Note: The New page is only displayed when one or more databases are opened in the
iBase session.
Selecting an iBase option combination
An iBase option combination contains information, such as how the records in the
iBase database are displayed in Analyst’s Notebook, for example, the entity or link
type to use, or to specify charting schemes, charting styles, labeling schemes and
connection multiplicity.
From the Association & Timeline Options drop-down list, select a Combination.
28
IBM i2 Base 8 Quick Start Guide
Exploring & Creating Data with Analyst’s Notebook
Use the New page, for example, to create new entities or search for entities in your
database:
•
In the Create panel, click New Entity to display the entity types that are
available in the iBase database. Select an entity type and add information to
that entity in the New Entity dialog. For further information about using the New
dialog, see page 12.
•
In the Search panel, click Find to find one or more entities in the iBase
database. For further information, about using the Find dialog, see page 14.
You can also use the following commands on this page, for example to create links
and manage sets and queries:
•
New Link
Creates new links between selected chart items. For further information about
links, see Linking Entities on page 16.
•
iBase Palette
Displays the palette for the iBase database in the Add Chart Items Task Pane,
from where you can add items to a chart.
•
Query Manager
Displays the Query Manager dialog, which lists the existing queries in the
iBase database. For further information about queries, see Queries on page
36.
•
New Query
Creates a new query. For further information about queries, see Queries on
page 36
•
Set Manager
Displays the Set Manager dialog, which lists the existing sets in the iBase
database. For further information about sets, see Sets on page 40.
•
Timeline Assistant
Displays the Timeline Assistant dialog which guides you through the steps to
create, or add to, a timeline chart. For further information about the timeline
assistant, see page 47.
IBM i2 Base 8 Quick Start Guide
29
Exploring & Creating Data with Analyst’s Notebook
Viewing and working with iBase chart items
Use the Selection page of the Data Sources Task Pane, for example, to show, view,
chart and expand records.
Note: The Selection page is only displayed when one or more databases are opened in
the iBase session.
Selecting an iBase option combination
An iBase option combination contains information, such as how the records in the
iBase database are displayed in Analyst’s Notebook, for example, the entity or link
type to use, or to specify charting schemes, charting styles, labeling schemes and
connection multiplicity.
From the Association & Timeline Options drop-down list, select a Combination.
Working with the chart items
Use the commands in the Chart panel, for example, to expand, explore and
populate cards and to use queries to filter the contents of your chart.
Select at least one chart item and select one of the available commands:
•
Expand
You can expand one or more iBase entities on an Analyst’s Notebook chart in
order to chart their links and link end entities. The number of links and linked
entities that are shown (the expansion levels), and the types that are shown, is
determined by the filter and expand drop-down panels. By default, only the
links from the selected entity and their link end entities are shown.
•
Expand to New Chart
If you want to start a new chart click Expand to New Chart. The entities and
links that are added are determined by the current charting settings. Expand
the selected item(s) to a new chart.
•
Find Path
Finds the chain of intermediate links and entities that connect two entities on
the chart, taking the link direction into account, and/or selecting the shortest
path (depending how the options are set).
30
IBM i2 Base 8 Quick Start Guide
Exploring & Creating Data with Analyst’s Notebook
•
Explore
Displays the Explore window, allowing you to interactively browse through your
database, expanding from one entity to the next. While you are exploring, you
can choose to concentrate on specific entity and link types and ignore others.
This can help to simplify the information you are trying to understand at any
given time.
•
Find Connecting Links
Finds all the links that connect two or more entities on the chart. You can use
this as a quick way of selecting multiple links between entities.
•
Find Common Neighbors
Finds any entities that have connecting links to at least two of the selected
items.
•
Find Common Neighbors Linked to All
Finds any entities that have connecting links to all of the selected items.
•
Populate Cards
Click on this to populate cards for item(s) selected on the chart.
Working with the View panel
Use the commands in the View panel, for example, to show records, edit item
properties, open hyperlinks and find matching records.Select at least one chart
item and select one of the available commands:
•
Select Items from Current Database
Selects items from the currently-connected database, on the chart.
•
Filter Selection by Query
You can filter the currently selected chart entities or links using either an
existing iBase query or a new one that you define specifically for this task. After
filtering, only those items within the current selection that match the query
conditions will remain selected on the chart.
IBM i2 Base 8 Quick Start Guide
31
Exploring & Creating Data with Analyst’s Notebook
•
Show
Displays the Show dialog for a selected item, or the Show List dialog if more
than one item is selected.
•
Links
Displays the iBase Links dialog. For further information about completing the
Links dialog, see page 17.
•
Edit Item Properties OR Combined Properties
Displays either the Item Properties dialog, for one selected chart item, or
Combined Properties dialog, for more than one selected chart items. These are
Analyst’s Notebook dialogs
•
Open Hyperlink(s)
If the selected entit(ies) have a hyperlink field, then you can find any other
entities or documents to which it is linked by a hyperlink. The hyperlink may be
to a document stored on a file server or a Web site.
•
Matching Records
Finds any entities that have connecting links to two or more entities, or to all
entities, on the chart (depending how the charting settings are set).
Working with records in the database
Use the commands in the Database panel, to add records to a set and merge
selected items in the iBase database.
Select at least one chart item and select one of the available commands:
•
Add to Set
Displays the Add to Set dialog to add the selected item(s) to either a new or
existing set. For further information about sets, see Populating a Set on page
40.
•
Merge in iBase
Merges selected items in an iBase database. For further information about
merging items, see Merging Entities on page 27.
32
IBM i2 Base 8 Quick Start Guide
Exploring & Creating Data with Analyst’s Notebook
Mapping records
Use the commands in the Map panel to add them to a map or select them in
Google Earth:
•
Add to Map
Adds selected items with coordinates to Google Earth.
•
Select on Map
Selects items with coordinates on a Google Earth map.
For further information about mapping, see Mapping on page 50.
Specifying iBase Options in Analyst’s Notebook
Use the Options page of the Data Sources Task Pane, to specify the options to use
when working with items that were added to a chart from an iBase database.
IBM i2 Base 8 Quick Start Guide
33
Analyzing the Data
Analyzing the Data
0.1
Once data has been entered in the database a wide range of analysis tools are
available to analyze and present your data. A number of methods are described on
the following pages.
34
•
Queries (page 36)
•
Sets (page 40)
•
Browsing (page 43)
•
Word searching (page 45)
•
Charting in Analyst’s Notebook (page 46)
•
Reporting (page 48)
•
Mapping (page 50)
IBM i2 Base 8 Quick Start Guide
Categories and Notes
Categories and Notes
0.2
You can manage your queries, sets, and browse definitions by displaying them in
categories arranged in hierarchies. In this way you can keep analysis tools
together by user or by case, or make useful sets available for general use.
When you save a query definition, for example, you will be asked to categorize the
definition in a dialog like this:
Create new categories by simply typing in the names you want separated by a
backslash (\). For example:
Operation Crest\Unit B
Adding notes
You can add notes to sets, queries, browse definitions, import/export
specifications, and so on, to provide extra information for yourself or other users.
Click the Description icon to enter a description.
IBM i2 Base 8 Quick Start Guide
35
Queries
Queries
0.3
Powerful query facilities allow you to identify the records you want to find quickly
and easily. Saving your query definitions allows you to run the query on a regular
basis or to use the results of one query as the source for another. You can define
parameterized queries so you can change the query details each time it is run; you
will be prompted for the values to use.
From the Analysis menu, select Queries ➧ New to display the Query dialog.
Query definitions are constructed in two parts: conditions at the top of the dialog
and a structure below. The structure defines the entities and links to query and
what sort of output is required. The condition defines exactly which records of that
type are retrieved.
Constructing a You start by defining the structure. Use drag and drop to place entity icons, from
new query
the palette bar on the left, onto the Structure area. Then use the toolbar and draw
links as required. Finally you decide which items will be output.
Tools
Set link type
Draw link
Assign source
Set output Delete
Set count
36
IBM i2 Base 8 Quick Start Guide
Output all
Queries
Here are some examples of structures:
A
B
C
D
E
Structure
Description
Output
A
Addresses that are linked, in any way, to
both people and organizations.
List of addresses
B
Any entities that are linked to a crime.
List of entities
C
People who are linked to an address.
List of people
D
Calls between telephones.
List of calls
E
People linked to an address.
List of people and
addresses that are
linked
As you can see from the examples above, some structures can be very general
and would retrieve a great many records from a large database; a condition can be
applied to narrow the search and retrieve exactly the records you want. Conditions
can specify things like particular text contained in a field, or the items in a list of
values.
More than one part of the structure can be set to provide output, this can be
particularly useful when you want to see the results on an Analyst’s Notebook
chart.
IBM i2 Base 8 Quick Start Guide
37
Queries
Conditions are set in the top part of the query dialog.
Conditions are set on the entity or link that is selected in the Structure area. You
can include AND and OR statements to set a number of conditions, use brackets
(parentheses) to set the priority of conditions, and use a wide variety of operators.
The example shown above will retrieve records, based upon the structure, where
the selected entity (Person 1 in this case) has facial hair, wears glasses, and has a
last name that starts with either of H or M.
Parameters in
queries
38
You can prompt for information when you run a query or use certain system
information (for example the current date or time) by using the following characters
when specifying field values in the Query dialog:
Value
Meaning
@(default value)
There will be a prompt for this field value when the
query is run. If you specify the optional default value,
for example '@BMW', there will be no user input
required when the query is run to specify 'BMW'
(apart from a confirmation).
@#USER
This represents the logged-on username.
@#NOWDATE(+N/-N)
This represents the current date. Optionally you can
include '+N' which represents a date 'N' days in the
future, or you can include '-N' which represents a date
'N' days in the past.
@#NOWTIME(+N/-N)
This represents the current time. Optionally you can
include '+N' which represents a time 'N' hours in the
future, or you can include '-N' which represents a date
'N' hours in the past.
IBM i2 Base 8 Quick Start Guide
Queries
Counting in
queries
You can set a count on a link or item in the structure. Items must have a link, and
only one link, before you can set a count on them. You can only set one count in
the structure.
For example, if the structure featured two Account entities linked by a Financial
Transaction link type, the results might include any accounts that have had
transactions between them. By setting a count of, say 'more than 20' on the link
item, then the results will only include accounts that have had more than twenty
transactions with another bank account; this would indicate the most active
accounts.
Counts can be set on the link ends too, for example to find entities that have many
links to several different entities. Click the Set Count button to display the Count
dialog.
Source
records
Setting the source records, or specifying records that are not to be included, in a
query can be a powerful analysis tool. For example you can query records that are
included in a specified import set. Click the Assign Source button to display the
Source Records dialog.
Monitoring
queries
You can add an alert to a query so that you, and optionally your colleagues, will be
warned when someone makes a change that results in a record being added to or
removed from the results found by this query. There is more about alerting on page
61, however not all iBase databases will support this feature. Ask your system
administrator for details.
IBM i2 Base 8 Quick Start Guide
39
Sets
Sets
0.4
A set is a user specified collection of entities and/or links. Entities and links can
belong to more than one set. Sets can be combined together to form other sets.
When you delete a set, you do not delete the individual records contained in it, you
only delete the definition of the set.
Sets can be used for a variety of analytical tasks, for example:
Populating a
Set
•
keep the entities found as the result of a query together as a group
•
analyze only those records that were imported together
•
define a group of records that you want to add to a chart
•
group records together on a temporary basis; later you can analyze the group
of records or combine it with other sets to form new groupings
•
identify the new records added as a result of importing data
There are two ways to add entities or links to a set, you can add records
individually or you can add groups of records that are the results of a query or
found by a browse definition. In each case you highlight the record or records you
want to add and right-click, from the shortcut menu, select Add To Set.
A dialog is displayed that allows you to create a new set or to append the selected
records to any of the existing sets:
40
IBM i2 Base 8 Quick Start Guide
Sets
Combining
Sets
You can combine two existing sets, in any way that you want, to isolate exactly the
records that you require, the resulting combination is placed into a new set. From
the Analysis menu, select Sets ➧ Combine to combine sets.
In the example below, two sets are combined to find out which members of the set
called “Key Players” are male, in other words, which records belong in both sets.
The combination you specify is illustrated by the Venn diagram displayed in the
center of the dialog. All of the possible combinations are shown below.
Analyzing Sets You may want to find the links and entities that are common (that is exist in all), or
uncommon (do not exist in all) to a list of sets. For example, if you have many sets
that contain people, and each set is a collection that has some criterion in
common, you can find those records that would match all of those criteria. For
example, if you had sets that comprised: people with connections to Boston,
people connected with the crime of arson, and drivers of BMW cars, you could very
easily generate a list of all the records in the database that shared all three
characteristics.
IBM i2 Base 8 Quick Start Guide
41
Sets
From the Analysis menu, select Sets ➧ Analyze to find common, or uncommon,
records.
Finding out if a You can find out whether a record belongs to any sets. In a record list, right-click on
record
the record, and from the shortcut menu, select Set Membership. In this example,
belongs to any the record belongs to five sets:
sets
42
IBM i2 Base 8 Quick Start Guide
Browsing
Browsing
0.5
Many tasks require you to work through a list of entity or link records, reviewing the
data and taking action as required. The tool to use for this is the Browser. To
browse records of a specific type, right-click on the entity type you require and,
from the shortcut menu, select Browse.
Enter a suitable number of records to show and select the fields that you want to
display in the Fields list, then click Browse to retrieve the records. You can also
choose to browse the results of a saved query, or the contents of a set.
You can save browse definitions for later use, storing them in categories if you
wish. You can also specify that a particular browse definition is run each time you
start iBase, turn on the Auto-run check box on your browse definition.
IBM i2 Base 8 Quick Start Guide
43
Browsing
Autorun is often most useful when the browse presents the results of a
parameterized query, for example a query may be set up to find all the records that
have been entered in the previous week.
Following a browse command you will see a dialog containing a one-line
description for each record.
You can work with the data listed in the browse dialog as follows:
44
•
Double-click on any record to show the whole record.
•
Select one or more records and right-click to see the shortcut menu.
•
Select one or more records and use the toolbar buttons at the top.
•
Hide the configuration area to give more room to display the records.
•
Click on a column heading to sort by the contents of the column.
•
Drag and drop column headings to move them to the left or right.
•
Adjust the width of columns by dragging, or double-clicking, the column
separator.
IBM i2 Base 8 Quick Start Guide
Word Searching
Word Searching
0.6
Your database administrator may have created indexes of words contained within
the database to allow you to search for records that contain certain words. Word
search allows you to find words in the text fields of your records. Search 360 adds
the ability to widen the search and so catch records where data is mistyped or
entered in a slightly different format.
From the Analysis menu, select Word Search to display the Word Search dialog.
At the bottom of the dialog there is an indication of when the index was generated.
View the Enter Words tab if you are interested in specific words and where they
appear, or view the Word Index tab if you are more interested in the frequency of
occurrence of words.
Note: If your database is SQL Server then you may be able to use the more powerful
features of a Search 360 Search instead. From the Analysis menu, select Search
360. This is new in iBase 8 and is covered in more detail on page 64.
IBM i2 Base 8 Quick Start Guide
45
Charting
Charting
0.7
Records can be charted on an Analyst’s Notebook chart to assist in visualizing the
contents of your database. Chart items have a reference back to the source iBase
record and changes can be made from Analyst’s Notebook. Records can also be
added to your iBase database directly from Analyst’s Notebook (see Exploring &
Creating Data with Analyst’s Notebook on page 28).
To add an item to a chart, right-click on it and select Chart ➧ Add to Chart.
Analyst’s Notebook is opened if necessary and the record or records are
displayed. The way in which records are displayed is controlled by a charting
scheme and the charting settings in use at the time.
You can also select records and expand them on a chart so that both the selected
records and their linked entities are displayed.
iBase
Suspect
Minnie WORLEY
British
Link
1800198
Sale of narcotics
53 y rs
Analyst’s Notebook
Link
Roma BARTLETT
British
47 y rs
Offender
Robert WARBURTON
British
27 y rs
Note: You can also view a chart in iBase without having to open Analyst’s Notebook first.
See page 55 for details.
46
IBM i2 Base 8 Quick Start Guide
Charting
You can chart items as Association, Timeline, or Custom (mixed) charts. A
Timeline Assistant dialog can help you to construct timeline charts in a single step.
To use the Timeline Assistant from the Analysis menu, select
Analyst’s Notebook ➧ Timeline Assistant. When you create a timeline chart, you
can choose to create Event Charts or Flow Charts:
•
Event chart
01:00
01:30
02:00
Wednesday September 11th 2002
02:30 03:00 03:30 04:00 04:30
05:00
05:30
Wednesday September 11th 2002
06:00 06:30 07:00 07:30 08:00
08:30
09:00
Wednesday September 11th 2002
09:30 10:00 10:30 11:00
12:00
15:00
18:00
21:00
Thursday September 12th 2002
00:00 03:00 06:00 09:00
00:00
14th
15th
16th
September 15--20th 2002
17th
18th
19th
Mr George BENDING : Link
Mr George BENDING
Male
Mr Sean DAVIS : Link
Mr Delroy HOWELL : Link
Final Arrangements
12/09/2002 11:05
DAVIS phones BENDING to confirm
final arrangements for Murder.
Payment
22/09/2002
8000 US dollars transferred from
HOWELL's account to BENDING's
account - payment for Murder?
Mr George BENDING : Link
Mr Sean DAVIS : Link
Enforcer
30/07/2002
30/07/98 - Informant 76 - George
BENDING and Sean DAVIS used to run
drugs together in the USA. It is
believed that BENDING owes a huge
debt to DAVIS. The Circumstances
are not yet known.
Mr Sean DAVIS : Link
Mr Sean DAVIS
Male
Heroin Distribution
12/05/2002
12/05/98 - Informant 981 - Sean
DAVIS and David YOUNG are working
for Gene HENDRICKS they are
distributing Heroin throughout the UK
imported from Jamaica. There is some
connection to Sweden but we do not
know what at this stage.
30-Jul-02 w
20th
21st
22nd
23rd
24th
15:00
15:30
Tuesday September
16:00 16:30 17:0
Mr George BENDING : Link
12-Sep-02 11:05
22-Sep-02 w
Mr George BENDING : Link
Mr Sean DAVIS : Link
Mr Sean DAVIS : Link
Mr Delroy HOWELL : Link
Mr Delroy HOWELL : Link
Setting up a Murder
11/09/2002 11:34
Sean DAVIS phones Delroy HOWELLS
to discuss the murder of Gene
HENDRICKS, suggests that BENDING
commit the act.
Confirmation of Kill
24/09/2002 14:52
DAVIS phones HOWELL to advise
BENDING has completed the murder of
HENDRICKS.
11-Sep-02 11:34
24-Sep-02 14:52
12-May-02 w
Male UNIDENTIFIED
Male
Mr Delroy HOWELL
Male
•
Flow chart
00
03:00
06:00
09:00
12:00
Tuesday August 11th 1998
15:00 15:32
15:40
15:50 15:55
18:00
21:00
07970 345333
11/08/1998 15:30
11/08/1998 15:32
11/08/1998 15:33
11/08/1998 15:44
11/08/1998 15:52
11/08/1998 15:57
07976 222101
IBM i2 Base 8 Quick Start Guide
47
Reporting
Reporting
0.8
You may want to provide details from your database for presentation to your
colleagues in written or electronic form. You can create reports at any time; these
are snapshots of the data at the time the report is created. Since you may need to
create the same report many times, for example a weekly status report, you create
report definitions that can be saved and then use an appropriate definition to re-run
the report you want.
Report
definition
To create a new report definition, right-click on Report Definitions in the Database
Explorer window and select New. The Report Definition dialog is displayed.
You specify the main entity type from which records are to be reported upon at the
top of the dialog. Formatting, such as header and footer text style, is specified on
the General page. On the Entity page, specify what records are to be included and
the level of detail, and on the Links page, specify what link and link end entity
records are to be included. You need to save the report definition before you can
create a report. Optionally, you can make the report definition the default definition
for this entity type.
48
IBM i2 Base 8 Quick Start Guide
Reporting
Running the
report
To create a report based upon a report definition, from the File menu, select
Create Report to start the Report Wizard.
Specify the report definition and the source of the data on page 1; the source can
be a single record, the members of a set, the results of a query, or the entire
database. On page 2, specify the format of the report. Finally click Finish to create
the report. Reports can be displayed in a Report Viewer, or can be output to
Microsoft Word.
You can also run a report from the shortcut menu that is available whenever you
right-click on an entity in a list.
IBM i2 Base 8 Quick Start Guide
49
Mapping
Mapping
0.9
IBM i2 iBase Geographic Information System Interfaces enable you to send
entities and links from iBase to a GIS mapping application. From the mapping
application you can create sets and queries for further analysis back in iBase, you
can add items to an Analyst’s Notebook chart or you can use statistical analysis
tools such as Data Miner.
iBase
iBase GIS Interfaces
Add to Map
Select on Map
Sets and queries
Mapping application
Add to Map
Select on Map
Add to Chart
Expand
Send data
Add to Map
Select on Map
Analyst’s Notebook
Data Miner
Note: You must have IBM i2 iBase GIS Interfaces installed before you can use them,
contact your supplier for more details. Data Miner is a part of Analyst’s
Workstation.
50
IBM i2 Base 8 Quick Start Guide
Learning More About iBase
Learning More About iBase
0.10
This guide aims to give a general idea of the terminology and concepts involved in
using iBase. Hopefully it has helped you understand how to perform some simple
operations. However, this guide only describes the most basic concepts, so we
advise you to attend a training course and read the other iBase documentation to
learn about the more advanced techniques which will enable you to get the most
out of your software.
Training
Your supplier holds regular training courses to help you learn how to use iBase.
Help
Comprehensive help is available with an iBase. To display it at any time, select
from the Help menu or press the F1 key.
IBM i2 Base 8 Quick Start Guide
51
Learning More About iBase
52
IBM i2 Base 8 Quick Start Guide
New features in
this version
Welcome to IBM i2 iBase 8.9.
For users who are already familiar with iBase, this chapter introduces you to what’s
new in iBase 8:
•
Importing Files from a Folder (page 54)
•
Using Charts and Chart Item Data in iBase (page 55)
•
Transforming Data on Import (page 58)
•
Data Sources Task Pane in Analyst’s Notebook (page 59)
•
Database Subsets (page 60)
The following enhancements are new for SQL Server databases only:
•
Alerting (page 61)
•
Audit History (page 63)
The following enhancements are new for SQL Server 2005/2008 only:
•
Searching with Search 360 (page 64)
•
Exporting and Importing Data as XML (page 65)
If you also use IBM i2 iBase Designer to design, create and maintain databases,
then you can find out about the additional new features of interest to designers and
administrators in the iBase Designer help.
IBM i2 iBase 8 Quick Start Guide
53
Importing Files from a Folder
Importing Files from a Folder
0.1
You can import all the charts, documents, images and text files from a folder, or
from a folder and all its subfolders.
To do this type of import, select the Folder Contents option on the first page of the
import wizard and, on the next page, specify the location of the folder and the file
type(s):
You can import:
54
•
Any files into any entity or link type that has a document type field even if you
cannot open that type of file on your computer. The folder can contain any
combination of file types.
•
Pictures that are .bmp, .gif, and .jpg files into any entity or link type that
has a picture type field
•
Text files, provided they all have the same number and type of fields, and are
stored in a folder that only contains text files with a common structure. Once
you have selected the folder to import, you complete the import specification as
if you were importing a single text file.
IBM i2 iBase 8 Quick Start Guide
Using Charts and Chart Item Data in iBase
Using Charts and Chart Item Data in iBase
0.2
You can import batches of charts that can be viewed and searched like other iBase
records. The following chart types can be imported:
•
Analyst's Notebook charts (.anb)
•
Text Chart charts (.tcv)
You import them using a standard import specification and the Folder Contents
option, described on page 54, into any entity type that has a document type field.
You view charts either in the iBase Chart Viewer dialog or in Analyst's Notebook.
This figure shows how you display a chart in Chart Viewer:
In Chart Viewer, you can navigate
the chart, zoom in and out, find text
on the chart, and examine chart
item properties (such as cards), all
as if you were working in Analyst's
Notebook.
IBM i2 iBase 8 Quick Start Guide
55
Using Charts and Chart Item Data in iBase
The information on imported charts can also be searched using the Search 360
dialog (but only in databases that are SQL Server 2005 or later):
Search words are found in imported
Analyst’s Notebook charts
Other matches are found as well depending
on how the search options are set up
Clicking the record in the results list will display the embedded chart in the iBase
Chart Viewer.
Extracting data into iBase
If you have charts that contain information you would like to store in your iBase
database as entities and links rather than just a complete chart, you can extract
this data.
56
IBM i2 iBase 8 Quick Start Guide
Using Charts and Chart Item Data in iBase
You can use the Chart Item Extractor to extract the data. You can extract Analyst’s
Notebook data into iBase directly from Analyst’s Notebook when connected to your
iBase database or from iBase by opening the Chart Item Extractor and browsing to
the required chart.
Before extracting Analyst’s Notebook data, you need to define:
•
how you would like to store general information
•
whether you would like to add a chart as an iBase entity in addition to the data
•
whether you would like to create an extraction set that contains the results of
the extraction
When Analyst’s Notebook items are extracted into iBase, they are scanned for
information that can be aligned to entity types and link types. If the automatic
alignment for an entity or link type is incorrect, you can modify or remove it.
Once an entity or link type has been identified, information that is contained within
item data, attributes, and data records are processed to find matches to
corresponding fields.
Once alignment is complete, the items are checked to ensure they are ready to be
extracted.
IBM i2 iBase 8 Quick Start Guide
57
Transforming Data on Import
Transforming Data on Import
0.3
iBase now uses the wider range of actions provided in Analyst’s Notebook to
transform data on import. These field actions work in exactly the same way as the
Analyst’s Notebook ones.
1.
Select the
source field
that you want
to transform.
2.
Select the action
that you want to
apply to the source
data—you can apply
several actions.
3.
Specify how the
transformation will
work.
4.
Preview the result.
In this example the data in
the Number-1 field is
prefixed with data in the
Area-1 field.
58
IBM i2 iBase 8 Quick Start Guide
Data Sources Task Pane in Analyst’s Notebook
Data Sources Task Pane in Analyst’s Notebook
0.4
The Data Sources Task Pane in Analyst’s Notebook 8 replaces the old iBase
toolbar:
Open the iBase database from the
Common Tasks pane. The pane lists
previously-used databases and shows
which ones are currently connected.
Work with the iBase
commands in the usual way.
All the commands are
available on the three pages
of the Data Sources task
pane.
Combinations make
it easier to set up the
charting styles you
need. You can save a
series of
combinations for use
in future Analyst’s
Notebook sessions
IBM i2 iBase 8 Quick Start Guide
59
Database Subsets
Database Subsets
0.5
Your database administrator can create a small database that is a mirror image of
the main iBase database in terms of the entity and link types that it contains. The
database can also contain a small selection of records from the main database.
The records for the new database, the subset definition, are selected by creating
queries and sets and saving them as folder objects:
You can use this database subset in the field in exactly the same way as you would
use the main database. For example, you start a session by logging on to the
security file for the new database and then by opening the new database as usual.
The difference is that on return to base, you can upload new data to the main
database. The database subset can then be refreshed with new data from the
main database or it can be set to expire.
Note: Only administrative users can set up the main database for use with database
subsets. A database is initialized for database subsets by selecting Initialize
Database for Database Subsets from the File ➧ Database Subsets menu.
60
IBM i2 iBase 8 Quick Start Guide
Alerting
Alerting
0.6
You can add alert definitions that will alert you, or other nominated users, when the
data of interest changes or when anyone views that data. Data can be single
records, multiple records or the results returned by a query.
For queries, you
can also monitor
when records
appear and
disappear from the
results
New alerts are displayed in the alerting status bar as soon as they are received:
Go to the Inbox
(7 unread alerts)
Go straight to the detail
for this alert
Deal with the
alert later
IBM i2 iBase 8 Quick Start Guide
61
Alerting
For a summary of your alerts, use the alerting Inbox:
To find out the detail behind an alert, use the Alert Details dialog:
Alerting is only available in SQL Server databases.
Note: A system administrator can choose to deny access to the menu commands for
alerting.
62
IBM i2 iBase 8 Quick Start Guide
Audit History
Audit History
0.7
In SQL Server databases, you can view the history of the changes made to
records in the database. You begin by finding the records of interest and then:
•
In a record list, right-click on one or more selected records, and from the
shortcut menu, select Show History.
•
In the Show dialog, click History.
In the Audit History dialog, you can filter the displayed records by user, entity type,
link type, and time, or you can extend the selection to include other records of
interest.
The Views column shows the number of times the records have been viewed, but
not edited. Viewing includes activities such as listing in a record list, viewing in the
Show dialog, listing or viewing in the Audit History dialog. (The number of views is
only shown if the database is set to audit level 5.)
How far back the history goes depends on how frequently your system
administrator archives this data.
Note: Audit History is also available in Audit Viewer, and is displayed by double-clicking
on records with a Record Added, Record Modified, Record Deleted or Code List
Modified action.
IBM i2 iBase 8 Quick Start Guide
63
Searching with Search 360
Searching with Search 360
0.8
Search 360 is a powerful new way to search text for either exact matches or to
search more widely for iBase data that might possibly match (a fuzzy search).
360 searches are an efficient way of locating data that might be mistyped, have
variant spellings or that might not be in the iBase field that you expect it to be in.
Using a 360 search, you can can search for single records that match the search
criteria or search for related items, that is across end 1 entity — link— end 2 entity.
From the Analysis menu, select Search 360. This example shows a fuzzy search
for the organization Southwest Import and for any records linked to Southwest
Import that contain the name Yochum:
End 1 entity
End 2 entity or link
Note: Search 360 is only available in SQL Server databases (2005 or later). It is the
replacement for Full-Text Search. It requires setup by a database administrator.
64
IBM i2 iBase 8 Quick Start Guide
Exporting and Importing Data as XML
Exporting and Importing Data as XML
0.9
There are enhanced facilities for exporting and importing data as XML for SQL
Server databases (2005 or later). This uses iBase’s own XML schema instead of
the MS Rowset Schema supported in previous releases.
Exporting XML
You can export any combination of entity and link records in a single operation. You
select the data to export by creating export definitions that can consist of multiple
queries and sets:
From the iBase File menu, select Data ➧ Export Definitions.
Export to XML is an extension of the new database subset feature, which requires
that a database administrator initialize the database for database subsets.
Note: Before you can make use of the exported XML data, a transform must be applied
in an XML editor in order to convert the data to the schema of the target database.
Importing XML
You can import data from any external data source capable of generating XML
data. However, before you can import the data, a transform must be applied in an
XML editor in order to convert the data to iBase’s own XML schema.
Note: As XML import is a type of bulk import, it can only be run in iBase Designer. It also
requires that Bulk Import is activated.
Generating the XML schema file
XSD files containing the information that will be needed for writing the transforms
that convert XML data from or to the iBase XML schema can be generated in
iBase Designer.
From the Tools menu in iBase Designer, select Tools ➧ Database Design ➧
Generate XML Schema
IBM i2 iBase 8 Quick Start Guide
65
Notices
0.10
Notices
This information was developed for products and services offered in the U.S.A.
IBM may not offer the products, services, or features discussed in this document in other
countries. Consult your local IBM representative for information on the products and services
currently available in your area. Any reference to an IBM product, program, or service is not
intended to state or imply that only that IBM product, program, or service may be used. Any
functionally equivalent product, program, or service that does not infringe any IBM intellectual
property right may be used instead. However, it is the user's responsibility to evaluate and
verify the operation of any non-IBM product, program, or service.
IBM may have patents or pending patent applications covering subject matter described in
this document. The furnishing of this document does not grant you any license to these
patents. You can send license inquiries, in writing, to:
IBM Director of Licensing
IBM Corporation
North Castle Drive
Armonk,
NY 10504-1785
U.S.A.
The following paragraph does not apply to the United Kingdom or any other country
where such provisions are inconsistent with local law: INTERNATIONAL BUSINESS
MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT
WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT
LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT,
MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not
allow disclaimer of express or implied warranties in certain transactions, therefore, this
statement may not apply to you.
This information could include technical inaccuracies or typographical errors. Changes are
periodically made to the information herein; these changes will be incorporated in new
editions of the publication. IBM may make improvements and/or changes in the product(s)
and/or the program(s) described in this publication at any time without notice.This information
was developed for products and services offered in the U.S.A.
Any references in this information to non-IBM Web sites are provided for convenience only
and do not in any manner serve as an endorsement of those Web sites. The materials at
those Web sites are not part of the materials for this IBM product and use of those Web sites
is at your own risk.
IBM may use or distribute any of the information you supply in any way it believes appropriate
without incurring any obligation to you.
Licensees of this program who wish to have information about it for the purpose of enabling:
(i) the exchange of information between independently created programs and other programs
(including this one) and (ii) the mutual use of the information which has been exchanged,
should contact:
66
IBM i2 iBase 8 Quick Start Guide
Notices
IBM United Kingdom Limited
Hursley House
Hursley Park
Winchester,
Hants,
SO21 2JN UK
Such information may be available, subject to appropriate terms and conditions, including in
some cases, payment of a fee.
The licensed program described in this document and all licensed material available for it are
provided by IBM under terms of the IBM Customer Agreement, IBM International Program
License Agreement or any equivalent agreement between us.
Any performance data contained herein was determined in a controlled environment.
Therefore, the results obtained in other operating environments may vary significantly. Some
measurements may have been made on development-level systems and there is no
guarantee that these measurements will be the same on generally available systems.
Furthermore, some measurements may have been estimated through extrapolation. Actual
results may vary. Users of this document should verify the applicable data for their specific
environment.
Information concerning non-IBM products was obtained from the suppliers of those products,
their published announcements or other publicly available sources. IBM has not tested those
products and cannot confirm the accuracy of performance, compatibility or any other claims
related to non-IBM products. Questions on the capabilities of non-IBM products should be
addressed to the suppliers of those products.
All statements regarding IBM's future direction or intent are subject to change or withdrawal
without notice, and represent goals and objectives only.
This information contains examples of data and reports used in daily business operations. To
illustrate them as completely as possible, the examples include the names of individuals,
companies, brands, and products. All of these names are fictitious and any similarity to the
names and addresses used by an actual business enterprise is entirely coincidental.
If you are viewing this information softcopy, the photographs and color illustrations may not
appear.
Trademarks
IBM, the IBM logo, and ibm.com are trademarks or registered trademarks of International
Business Machines Corp., registered in many jurisdictions worldwide. Other product and
service names might be trademarks of IBM or other companies. A current list of IBM
trademarks is available on the Web at “Copyright and trademark information” at
www.ibm.com/legal/copytrade.shtml.
Adobe, the Adobe logo, PostScript, and the PostScript logo are either registered trademarks
or trademarks of Adobe Systems Incorporated in the United States, and/or other countries.
Microsoft, Windows, Windows NT, and the Windows logo are trademarks of Microsoft
Corporation in the United States, other countries, or both.
IBM i2 iBase 8 Quick Start Guide
67
Notices
Java and all Java-based trademarks and logos are trademarks or registered trademarks of
Oracle and/or its affiliates.
Other names may be trademarks of their respective owners. Other company, product, and
service names may be trademarks or service marks of others.
Contacting support
IBM Support provides assistance with product defects, answers FAQs, and helps users
resolve problems with the product.
Before you begin
After trying to find your answer or solution by using other self-help options such as technotes,
you can contact IBM Support. Before contacting IBM Support, your company or organization
must have an active IBM software subscription and support contract, and you must be
authorized to submit problems to IBM. For information about the types of available support,
see the Support portfolio topic in the "Software Support Handbook".
Procedure
To contact IBM Support about a problem:
1.
Define the problem, gather background information, and determine the severity of the
problem. For more information, see the Getting IBM Support topic in the Software
Support Handbook.
2. Gather diagnostic information.
3. Submit the problem to IBM Support in one of the following ways:
Online through the IBM Support Portal: You can open, update, and view all of your
service requests from the Service Request portlet on the Service Request page.
By phone: For the phone number to call in your region, see the Directory of worldwide
contacts web page.
Results
If the problem that you submit is for a software defect or for missing or inaccurate
documentation, IBM Support creates an Authorized Program Analysis Report (APAR). The
APAR describes the problem in detail. Whenever possible, IBM Support provides a
workaround that you can implement until the APAR is resolved and a fix is delivered. IBM
publishes resolved APARs on the IBM Support website daily, so that other users who
experience the same problem can benefit from the same resolution.
How to send your comments
Your feedback is important in helping to provide the most accurate and highest quality
information. To submit any comments about this book or any other documentation, send your
comments by email to [email protected].
Be sure to include the name of the book, the part number of the book, the version of the
software, and, if applicable, the specific location of the text that you are commenting on (for
example, a page number, table number, or a heading).
68
IBM i2 iBase 8 Quick Start Guide
Notices
IBM i2 iBase 8 Quick Start Guide
69