Depm 2022.x Designer En-Us
Depm 2022.x Designer En-Us
Depm 2022.x Designer En-Us
Release 2022.x
Copyright © 2021 Infor
Important Notices
The material contained in this publication (including any supplementary information) constitutes and
contains confidential and proprietary information of Infor.
By gaining access to the attached, you acknowledge and agree that the material (including any
modification, translation or adaptation of the material) and all copyright, trade secrets and all other
right, title and interest therein, are the sole property of Infor and that you shall not gain right, title or
interest in the material (including any modification, translation or adaptation of the material) by virtue
of your review thereof other than the non-exclusive right to use the material solely in connection with
and the furtherance of your license and use of software made available to your company from Infor
pursuant to a separate agreement, the terms of which separate agreement shall govern your use of
this material and all supplemental related materials ("Purpose").
In addition, by accessing the enclosed material, you acknowledge and agree that you are required to
maintain such material in strict confidence and that your use of such material is limited to the Purpose
described above. Although Infor has taken due care to ensure that the material included in this publication
is accurate and complete, Infor cannot warrant that the information contained in this publication is
complete, does not contain typographical or other errors, or will meet your specific requirements. As
such, Infor does not assume and hereby disclaims all liability, consequential or otherwise, for any loss
or damage to any person or entity which is caused by or relates to errors or omissions in this publication
(including any supplementary information), whether such errors or omissions result from negligence,
accident or any other cause.
Without limitation, U.S. export control laws and other applicable export and import laws govern your
use of this material and you will neither export or re-export, directly or indirectly, this material nor any
related materials or supplemental information in violation of such laws, or use such materials for any
purpose prohibited by such laws.
Trademark Acknowledgements
The word and design marks set forth herein are trademarks and/or registered trademarks of Infor and/or
related affiliates and subsidiaries. All rights reserved. All other company, product, trade or service
names referenced may be registered trademarks or trademarks of their respective owners.
Publication Information
Release: Infor Dynamic Enterprise Performance Management (d/EPM) 2022.x
Publication Date: December 10, 2021
Document code: depm_2022.x_designer__en-us
Contents
Contents
Contacting Infor..................................................................................................................................8
Scripts.............................................................................................................................................44
Creating and deleting scripts.......................................................................................................44
Specifying, editing, and running scripts.......................................................................................45
Script properties...........................................................................................................................45
Comments and notes...................................................................................................................45
Moving a Designer database between farms..................................................................................46
Chapter 4: System folder.................................................................................................................47
Connections....................................................................................................................................47
Data Sources...................................................................................................................................47
Data Connections............................................................................................................................48
Languages.......................................................................................................................................49
Managing languages....................................................................................................................49
Assigning multilingual captions....................................................................................................50
Assigning Designer permissions to roles........................................................................................50
Common..........................................................................................................................................51
Rules...............................................................................................................................................51
Rule groups..................................................................................................................................53
Creating a rule group...................................................................................................................53
Assigning a rule to a group..........................................................................................................53
Deleting an assignment...............................................................................................................53
Editing a rule group......................................................................................................................53
Chapter 5: Connector.......................................................................................................................55
ODBC connections..........................................................................................................................55
Source databases...........................................................................................................................55
Business units.................................................................................................................................55
Business groups..............................................................................................................................56
Mapping source tables to target dimensions...................................................................................56
Mapping elements and creating hierarchies....................................................................................56
Reference database........................................................................................................................56
Data connections for cubes.............................................................................................................57
Step by step....................................................................................................................................57
Connector settings..........................................................................................................................58
ODBC connections tab................................................................................................................58
Configuring data connections..........................................................................................................58
Exporting data.................................................................................................................................86
Connector configuration check........................................................................................................87
Contacting Infor
If you have questions about Infor products, go to Infor Concierge at https://concierge.infor.com/ and
create a support incident.
The latest documentation is available from docs.infor.com or from the Infor Support Portal. To access
documentation on the Infor Support Portal, select Search > Browse Documentation. We recommend
that you check this portal periodically for updated documentation.
If you have comments about Infor documentation, contact documentation@infor.com.
This section describes how to start Designer. It also contains overview of the user interface.
Starting Designer
Select Infor d/EPM > Designer.
On first use, you must register a repository for the Designer database and connect to the model of the
farm:
If a repository has been registered, see the "Connecting with a Designer database" topic.
The repository contains the structural information that you use to create the OLAP database for your
application.
9 Click OK.
10 Select the project.
If you are configuring Budgeting & Planning, you must select DEPM.
Caution: Do not select DEPMAPPS for Budgeting & Planning as this project is for Business
Modeling-based applications. DEPM is the project that belongs to the OLAP database that you
want to create from this Designer database.
11 Select the check box Synchronize users and roles while logging on to start synchronization of
users and roles from Repository to Designer when you log on to the Designer.
12 Specify a password to delete the connection information if the selected repository is no longer
available.
13 Click Next.
14 To confirm the selected synchronization option, click Yes.
15 Review the selected settings and click Finish.
16 Select the Designer database to work with the Database list.
17 Select the authentication system from the Authentication list.
18 Specify the user name and password. The user must have Administer Repository permission on
the farm level and Administer Permissions on the application level.
19 Click OK.
The farm repository information is stored within the Designer database. If you register a Designer
database in another Designer installation, the farm repository registration is the same for both
clients.
You can edit the farm repository in File > Settings > Repository Connection.
Adding connections
You can add a connection to a farm from the Sign-in Wizard:
1 Click MANAGE CONNECTIONS.
2 Click ADD CONNECTION.
3 Browse to the .farmprofile file of the client to connect and click Open.
The profile must be appropriate for the version of the client. Profiles and clients must be downloaded
from the Client Access dashboard.
4 Specify the password for the profile and click OK.
You can drag connections to change the order in which they are displayed.
5 Click DONE.
Editing connections
In the Sign-in Wizard you can edit the name and description of a connection to a farm, or delete a
connection.
1 Click MANAGE CONNECTIONS.
Edit and Delete icons are displayed on existing connections.
2 Click one of these icons:
Icon Function
Edit Opens the Edit Connection dialog box. You can edit the name and
description of the connection.
Delete Deletes the connection, if you click Yes to confirm.
3 Click DONE.
User interface
The Designer user interface has four main elements:
1 Menu commands
2 Navigation tree on the left: It contains projects, folders, and database objects.
3 Data section on the right: Specify or view data of a selected object.
4 Status section at the bottom: Shows the log.
To hide the navigation tree, click the small left arrow icon at its top right.
To hide the status pane, click the dash at its top right.
Navigation tree
The navigation tree displays the objects of the Designer database. The folders at the top level of the
tree represent the projects, which you can integrate into the database models in the Settings dialog.
In a project, you can create these database objects:
Cubes
Dimensions
Relational tables
MS Office documents
Web pages
When you select an object, its contents are displayed in the data section.
To use database objects in several projects, you create links. To create a link in a folder or a project,
right-click the folder in the tree, select the Link command and then the object type for that you create
a link, for example, Link > Dimension. The New Link dialog opens, where you select the object.
The nodes Connector and System in the tree do not depend on projects.
You find commands and options for the administration of database objects on the shortcut menu
(right-click an object) and the Action menu.
Note: System objects of applications cannot be moved to Designer projects. Designer system objects
cannot be moved to application projects.
Data section
When you select an object in the tree, it is displayed in the data section for analysis and data input.
The data sections of the object types (dimension, cube, document, etc.) are not identical. The data
section of most object types contains the tabs Design (data input), Notes (specify comments) and
Help (information about the object).
Status section
In the status section at the bottom events are logged that occur creating the data model or during
automatic database updates. The columns Description and Time provide information about processes
and the course of the database testing and creation. You configure the log function in the Settings
dialog.
Right-click the log and select Copy to Clipboard or Save As, to search or further process the log data
with another program. Use the tab as separator for export.
This section describes how to create multidimensional OLAP database and create, edit, or delete
cubes, dimensions, and elements of the OLAP database.
Menu commands
The Designer menu bar consists of these menus: File, Action, and Help.
File
The File menu contains these commands:
Creating database
Select the menu command File > Create Database to open a dialog, in which you create the OLAP
database on the basis of the relational database in Designer. Before the dialog opens, the database
configuration is tested. If you select the Recreate entire database check box, the data model will be
completely rebuilt. The complete creation may take very long. Without this option, only the modified
dimensions are rebuilt.
When you update an OLAP database using the Create Database command, the data is cached before
the structure is updated. If target elements are missing when writing back data to the database, the
data is written to the file Error_Data_Data.txt. The location of the file is displayed in the log that
you see in the Status section.
Status information regarding the database creation is logged.
Validating database
Select File > Validate Database to check whether Designer can establish a connection to the OLAP
database.
If the validation fails, the OLAP database uses a different farm repository than Designer.
Note: Ensure that Designer targets the OLAP database which belongs to the OLAP permission
management that has been configured in the Repository Connection tab.
You configure the target OLAP database on the Models tab of the Settings dialog. Select the database
from the OLAP Server drop-down list.
Settings
Select File > Settings to open the dialog Settings. In the Settings dialog, you configure the program
language, the database models, and the logging.
Language
On the Language tab, you select the program language and the date separator. The date separator
is relevant for the elements of the period dimension. When you change the language, you must restart
the program.
Repository Connection
On the Repository Connection tab, the repository of the farm is selected by default. Click Connect.
In Connect to repository specify the log-on information and click OK. Then select the project and the
OLAP permission management.
If you select the check box Synchronize users and roles while logging on, users and roles are
synchronized between repository and Designer database each time you log on.
Modeling Service
The Modeling Service is part of the Infor d/EPM Platform applications integration. The information is
read by the Model Manager.
Models
On the Models tab, you administer the target databases for the creation of the OLAP database.
In the Settings of the database model section you select the OLAP database on which the model
must be created from the OLAP server drop-down list.
Select the default permission of the model (All, Write, Read, None) from the Default user permission
drop-down list.
If you select the check box The database model can only be modified by Designer, the object
structure of the OLAP database can only be changed in Designer.
You can select the check boxes of projects that must be included in the databases.
To save the model settings, click Apply.
Logging
On the Logging tab, you configure the settings for the event log. Select the check boxes Enable the
event list and/or Events in Windows event log. You can select the detail level of the log for both
methods from the drop-down lists: Debug (all events), Information, Warning, and Error. Each category
includes the subsequent ones. The information in the Status section is not saved automatically. The
events that are logged can be checked in the Windows Event Viewer when you select the log file Infor
BI Designer.
To activate the Auditing feature, select Enable Auditing. By default, auditing is disabled. Once you
enable auditing, you cannot disable it again. To view the audit entries, click View Audit Entries.
Auditing
In the Audit Viewer dialog, you can view and search for Designer auditing data. Audit entries are
recorded automatically when you enable the Auditing feature.
To open the Audit Viewer dialog, select File > Settings. Click the Logging tab and click View Audit
Entries. To use the Auditing feature, you must have the permission Administer Audit on the farm level.
The Audit Viewer dialog provides a variety of search capabilities to search for recorded audit entries,
so that you can quickly find the data you are looking for.
These are basic searching scenarios:
• Show all audit entries between a start and end date.
• Show all audit entries for a specific user.
• Show all audit entries for a specific application.
• Show all audit entries for a specific audit event (requires to also set the application).
• Show all audit entries for a specific audit event of an application filtered by additional fields.
You can use these search criteria in the Audit Viewer dialog:
• From, To: Time period in which the audit event happened.
• Repository user: The Repository user who performed the audit event. This is the user login name
in Repository.
• Windows user: Windows user name under which the audit event happened. This is the fully
qualified Windows user name.
• IP address: IP addresses of the physical machine where the audit event happened. This is a
semicolon separated list of all IP addresses the current local machine has assigned.
• Computer name: Name of the physical machine where the audit event happened. This is the
current local machine name from the operating system.
• Process name: Name of the Windows process (executable) in which the audit event happened.
This is the name of the process without extension.
• Application: Predefined list of applications that offer auditing. You can select Designer from the
drop-down list. The Event field shows a list of application-specific audit events that are recorded
by Designer.
• Project: List of available projects in the current repository in which the audit event happened. This
is the unique name of the repository project. You can select <Any> here to consider all projects in
the current repository, or <Unknown> if projects were deleted meanwhile and cannot be mapped
to existing projects.
• Event: Audit event that happened. The list of audit events shown here depends on the selected
application. Custom fields that are linked to an audit event are available for filtering if a certain
audit event is selected. In such a case, a specific set of additional fields appears in the filter section
for the selected audit event. You can select <Any> here to consider all events in the current
repository respectively application.
If you select a combination of different search criteria, they are always combined with a logical and
when a database query is performed. The only criteria that you must always specify are the time range
and the application. You can leave other search criteria empty or use the <Any> option.
To start the search according to the specified search criteria, click Search. On the right side of the
dialog, a list of the resulting audit entries is shown. By default, this list shows the common column
information without custom field information. If you perform a search by using a specific audit event as
a filter, in addition applicable custom columns are shown that are based on the selected event.
Note: When you perform a search that retrieves a number of audit entries greater than 50.000, an
error message is shown: The search would return more than 50 000 entries. Try to
specify more specific filter criteria to narrow down the results..
To reset the specified search criteria, click Reset.
To start the export of the search result to a .csv file, click Export. In the Save As dialog, specify the
file name and click Save. The current view of audit entries of the previous search is saved to the file.
Designer Database
On the Designer Database tab, you specify the Designer database ID.
Select the check box Use Database ID and specify a Designer database ID. This is required if the
same version of the database is used for the data transfer between databases, for example, when you
update the structure of the OLAP database during a structure import (DBT file).
General
On the General tab, select the check box Disconnect users from Infor BI OLAP Server while
creating the database, if users must be logged off automatically before the database is created. Users
that have administrator rights cannot be logged off automatically. They can still access theOLAP
database.
Select the check box Disable Event Agent while creating the database, to prevent that the Event
Agent of OLAP generates events during the database creation.
Note: Event Agent generates many events during the database creation by Designer. This can
dramatically slow down the database creation or crash it. Therefore, the check box Disable Event
Agent while creating the database is selected by default. Change this setting only in special cases.
Action
The menu items of the Action menu depend on the object selected in the tree. The commands are
the same as those on the shortcut menu of the object in the tree.
Help
The Help menu contains these commands:
Folders
You can create and delete folders.
Relational tables
This section describes how to manage elements in relational tables. In relational tables, you can create,
edit, and delete elements.
Data input
There are two types of columns:
1 Input columns: Specify values directly, or open the input dialog per double-click, or press F4.
2 Option columns: Double-click, or press F4 to open an option dialog.
In option dialogs you select values that have been specified in other tables. To work with cell values,
use the commands Cut, Copy, Paste, and Delete on the shortcut menu. Details regarding the contents
of the tables and columns of a specific application may be found in the section about the application
and on the Help tab of the data section.
Dimensions
This section describes how to manage dimensions.
Dimension Properties
The ID of a dimension cannot be changed. You can specify a description of the dimension in the
Dimension description text box. It will be displayed in the tree.
In the next area, the element key, the element caption, and the default element are displayed. If you
click Reset, the default element of the dimension will be discarded.
Select the dimension type from the Dimension type drop-down list. Select the ODBO dimension type
from the ODBO dimension type drop-down list. The ODBO provider may use this dimension type.
If you select the Flat view check box, the dimension is displayed non-hierarchically in the hierarchy
browser in OLAP Administration. In flat view, all the elements of the dimension are listed without their
hierarchical structure.
If you select the Inverted hierarchy check box, only the top level elements of the dimension are
displayed in the hierarchy browser. By default, hierarchies are displayed from top to bottom, with the
top level consolidated element at the top and the base level elements at the bottom. Inverting the
hierarchy reverses this.
If you select Synchronize with OLAP, the visual appearance of the dimension elements in Designer
is synchronized with that of the hierarchy browser in OLAP Administration.
Level Names
On the Level Names tab, you can add, edit, and delete level names of the dimension.
To structure dimensions clearly, you can specify level names on the Level Names tab. For example,
the Periods dimension may have the levels Year, Half a Year, Quarter and Month. This facilitates the
navigation within the hierarchy. You may specify as many level names as you like. If a level does not
exist in the dimension, it will be marked with a warning sign. Non-existing levels will not be created in
OLAP.
Note: We recommend that you do not create top level elements and levels of the same name within
the same dimension. The unique names of the elements would be the same as the unique names of
the levels.
To specify a level name, select it, click Edit level name and specify the level name in the Add or edit
level name dialog.
Attributes
You can edit 3 attribute tables. On the Languages tab, the attribute fields of the languages are displayed.
You cannot add or delete languages.
The attribute tables contain the columns ID, Description, Data Type, Length, Precision, and
Unchangeable.
Column Description
ID Name of the attribute
Description Description of the attribute
Data type • String
• Boolean
• Double
• Date
Column Description
Length, Precision For the data type String you may specify values
between 0 and 252. It determines the maximum
length of the field. When you specify -1, the field
length will automatically adapted to the longest
value.
You cannot specify values for the Boolean data
type.
For the data type Double you may specify the
number of decimal places.
Unchangeable Shows which attributes can be edited. If the value
is Yes, it cannot be edited, because it is required
for the dimension. If the value is No, the attribute
can be edited.
Cubes
The cubes that use this dimension are shown here. They cannot be edited here.
Mappings
Here the mappings of the business units of this dimension are shown. They cannot be edited here.
Hierarchies
Hierarchies are used to define a set of automatic data aggregations. There are two types of hierarchies
allowed in a dimension: parent-child hierarchies and attribute-driven hierarchies. Parent-child hierarchies
are based on a set of hierarchical relationships between parent and child elements. Attribute-driven
hierarchies are hierarchies whose aggregated elements are derived from values stored in the attribute
tables of the dimension.
On the Hierarchies tab, you can manage the hierarchies of the selected dimension. The tab shows a
list of defined hierarchies. For each hierarchy, the name, description, default member, and hierarchy
type are listed. Users can create, edit, or delete hierarchies and also set the default hierarchy for a
dimension. Each dimension has a default hierarchy, which cannot be deleted.
Description
Specify a description for the parent-child hierarchy.
Default member
Specify the element that is used as default element for the hierarchy. Each hierarchy has a default
member. If not explicitly selected or defined, the default member is the first element in the top
level of the hierarchy. Applications selects this element automatically.
Description
Specify a description for the attribute-driven hierarchy.
Source Hierarchy
Select a source hierarchy from the drop-down list. The source hierarchy must be a parent-child
hierarchy.
Default Member
Specify the element that is used as default element for the hierarchy. Each hierarchy has a default
member. If not explicitly selected or defined, the default member is the first element in the top
level of the hierarchy. Applications selects this element automatically.
Name
Specify the top level name.
Element
Specify the top element name.
6 In the Attribute Levels section, click Add Attribute to add the required attributes.
The Attributes dialog opens.
7 Select one or multiple attributes from which the values are taken to build aggregated elements in
the hierarchy and click Select.
The selected attributes and levels are shown in the list.
8 To remove an attribute, select the attribute from the list and click Remove Attribute.
The attribute is removed from the list.
9 Click Move Up and Move Down to change the order in which the selected attributes are displayed
in the list.
Subsets
Subsets are subsets of the elements of a dimension. Subsets are displayed in the tree underneath the
dimension. Subsets may be static, dynamic, or parent-child subsets.
Creating subsets
To create a subset, right-click the dimension in the tree and select New Subset. In the Subset Wizard,
you specify the name of the subset and select the type of the subset, static, dynamic or
parent-child-subset.
Note: The synchronization of the OLAP model in Designer does not cover the synchronization of subset
elements. If a customized dimension uses subsets and the dimension is enabled for synchronization,
subsets do not work anymore.
The SQL statement of the filter definitions is displayed in the Filter definition field of the Subset Wizard
and can be edited there.
dimension structure or reduce it to the top-level elements. In the data section you also edit the structure
of the dimension. Details regarding the contents of the tables and columns of an application may be
found in the relevant section and on the Help tab of the data section.
Data input
In the data section for dimensions you specify values for both aggregated and basic elements. There
are two types of columns:
1 Input columns: Specify values directly, or open the input dialog per double-click, or press F4.
2 Option columns: Double-click, or press F4 to open an option dialog.
In option dialogs you select values that have been specified in other tables. To work with cell values,
use the commands Cut, Copy, Paste, and Delete on the shortcut menu. Details regarding the contents
of the tables and columns of a specific application may be found in the section about the application
and on the Help tab of the data section.
Parents
On the Parents tab in the option section of dimensions you see the parent elements of the selected
element.
Further command buttons are available:
• Click Add Parent to assign a parent element to the selected element, or create parallel hierarchies
by assigning additional parent elements. In the Select Element dialog use the text filter and the
buttons Collapse All and Expand All to expand or collapse the view. You cannot create circular
parent-child relations. An element cannot be a child element and a top level element at the same
time.
• Click Remove Parent to detach an element from the selected parent element. If the child is not
subordinate to any other parent, it will be moved to the top level of the hierarchy.
To change the weighting of the element for the calculation of the selected parent element, click the
entry in the Weight column and specify a value.
Permissions
On the Permissions tab in the option section of the dimensions you administer the rights of roles for
the selected dimension element. The Role table shows an overview of the mappings of rights and roles
in the columns Role, Description and Permission.
To assign permissions, select the role in the Role table and click one of the buttons for the permissions:
Default, Administer, Write, Read, or None. For each element only one permission can be assigned
to a role. The rights are those used in OLAP.
Click Pass to descendants if the permissions of a role should be passed to the descendants of a
parent. A selected check box in the Pass to descendants column shows that this function is activated.
This option allows to define permissions on aggregated elements that will be inherited by all descendants.
The permissions of the dependent elements can be applied automatically by OLAP through the usage
of stored permissions on elements in DAC cubes (Dimension Access Control cube).
Import
On the Import tab of the dimensions, you import structures from a text file and create mappings for
subsequent operations or you select a relational data source and then the table structures that must
be imported.
If you use a source frequently and save information about the origin of imported elements, create a
registration in the Connections table and assign it to a data source ID in the table Data Source. The
source is then available in the Data source drop-down list and can be used for import.
Select the table that you import from the drop-down list Table. The structure of the table is shown when
you select the Schema tab in the import table on the Import tab. Save the table selection with the
Save Profile button. For quick access to saved profiles, profiles are the first entries in the Table
drop-down list.
When you double-click a cell in the Mappings column, you can map the columns of the relational data
source table to the columns of the selected dimension.
To view the data that will be imported from the relational data source, click Data beneath the import
table.
Importing data
When you select a data source, the available structures and elements are shown in the import table
on the Import tab. You can import these elements or map them to dimension elements for subsequent
operations. The import table is divided into the tabs Schema and Data.
Command Description
Insert as Element... Import as child element. A dialog opens for the
selection of the target element.
Insert as Element Automatically Import as child element applying the mapping on
the Schema tab. The Parent column is used for
the hierarchy.
Insert as Element Automatically (without Import as basic element without applying map-
Parents) pings from the Schema tab.
Map to Element Mapping to an element. A dialog opens for the
selection of the target element.
Map to Element Automatically Automatic mapping to an element of the same
name or ID.
Remove Mapping Deletion of a mapping.
You can perform these shortcut menu commands with several elements at the same time.
On the Data tab, mappings are displayed with a blue square in front of the mapped element in the key
column.
You can clear or select the check box Display Mapped Elements to hide or display mapped elements
on the Data tab. The check box is only shown in case of saved profiles for relational data sources.
Order position
By default, elements imported in a dimension are ordered alphabetically by name, regardless of their
order in the file from which they are imported.
To control the order of the elements, specify the order position of each element in the Order Position
column.
Cubes
This section describes how to manage cubes.
Creating cubes
To create a cube, right-click the node Cubes in the tree and select New > Cube. Specify the name
and description in the Create Cube dialog and select the cube type. You can edit the cube in the data
section of the cube.
Buttons Description
To change the cube structure, move the dimen-
, sions from Available dimensions to Dimensions
of the Cube, and vice versa, by using these
buttons.
A cube may contain a maximum of 20 dimen-
, sions. Adjust the position of a dimension in the
Dimensions of the Cube list by using these
buttons.
Buttons Description
Click this button to remove all dimensions from
a cube.
To delete a cube, select the Delete command on the shortcut menu of the cube in the tree.
Caution: The position of the dimensions in the Dimensions of the Cube list is important for the
creation of reports withApplication Studio and should not be changed without consultation, because
report structures must be adjusted.
3 Select the check box of the cubes that can be assigned to the MDAC cube in the ID column. Click
OK to close the dialog.
4 Right-click the MDAC cube and select Add MDAC Scenario.
5 In the Create Scenario dialog, specify a name and a description. If you clear the check box Do
not create scenario with the database, the scenario is inactive and the cell areas will not be
locked. Click OK. The scenario is displayed underneath the MDAC cube in the tree.
6 To lock an area, click the scenario and select a subset.
7 For each dimension, select one subset. If required, click the button New Subset to create a subset
and select it.
Properties of cubes
Right-click a cube in the tree and select the Properties command to open the Properties dialog, where
you administer cube permissions and select the measure dimension for the selected cube.
access permissions check box. Select the role in the Role list and click one of the buttons for the
permissions: Default, Administer, Write, Read, or None. The permissions are those used in OLAP.
Use the filter to search for roles.
Cube-to-cube relations
Here you see the cubes assigned to the cube. You can only assign cubes that have the appropriate
dimension structure. To display all cubes, clear the check box Show only MDAC cubes that can be
related to this cube.
Importing rules
To import rules into a cube:
1 Right-click the cube and select Rules > Import Rules from OLAP. Rules are imported into the
cube.
2 Click OK at the message that the import has been successfully completed.
If an imported rule group exists in OLAP but not in Designer, it is created in Designer and named
<CubName>$<OrderPosition>$UniqueName.
Exporting rules
To export rules of a cube:
1 Right-click the cube and select Rules > Export Rules to OLAP. Rules are exported to the OLAP
database.
Note: The cube and cube rules are updated. You do not require to rebuild the cube.
2 Click OK at the message that the export has been successfully completed.
Office documents
This section describes how to use Office documents in Designer.
Web pages
This section describes how to use web pages in Designer.
Scripts
You can insert scripts in the tree, which are stored in the relational database. Scripts can either be
SQL Statements, VBScripts or JavaScripts. You can execute these scripts with the shortcut menu
command Execute.
Subs and functions of VBScripts and JavaScripts are loaded and are globally available (also for other
scripts) when you start Designer and the connection to the relational database is established. Existing
VBScripts and JavaScripts are automatically executed. SQL scripts are not executed when starting
Designer. You can enable and disable scripts and set the time-out for the execution of a script.
Sub Main()
Test
End Sub
Script properties
Right-click a script in the tree view and select the Properties command to open the Properties of
Script dialog. Here you can enable or disable the script. If you select the Enable script check box,
the script is started when the Designer starts and the connection to the relational database is established.
Additionally, you can specify a value for the Timeout, after which the execution of the script is stopped.
To disable the timeout, specify the value 0 (zero).
2 Start Designer.
3 Register the restored Designer database.
4 Register the database in a farm repository.
The System folder contains connections to other databases, configured data sources systems, data
connections of cubes, settings for languages, the administration of users and groups, and settings for
rules.
Connections
In the Connections view you administer the connections to other databases. You can use these
connections, for example, for the import of structures.
To create a connection, click New. Specify the name of the database connection in the dialog Register
Database. If you require the character code translation from OEM to ANSI for the new database
connection, select the OEM to ANSI check box. Click the Wizard button to configure a connection to
a Microsoft SQL Server database. Since many functions in the Designer use this ID, you must assign
a data source ID to the database connection in the system table Data Sources.
To edit a database connection, select it and click Edit.
To delete a database connection, select it and click Delete.
Column Description
Name Descriptive element name of the database con-
nection. This name is available in the Connection
ID column of the Data Sources table, when you
configure a new data source.
Database Type This column is filled automatically, when the
connection has been specified, for example, Mi-
crosoft SQL Server.
Data Sources
The table Data Sources contains a list of configured data source systems. Before you add a data
source, you must configure a database connection in the Connections system table. In the Data
Sources table, you define this database connection as a data source. To create a new element in the
Data Sources table, double-click <New: ID> at the bottom of the ID column and specify the unique ID.
Double-click the entry of the Connection ID column and specify the configured database connection
name.
Data Connections
In the Data Connections view, you specify how values are transferred from a detail cube to a central
cube and how values are transferred within a cube.
To set the parameters of data connections, click Data Connections in the System node of the tree.
In the Cube drop-down list you select for which cube the settings are displayed. Select Source View
to display data connections where the selected cube is used as source and Target View for data
connections where it is used as target.
If you select the source view, the column Target Cube is displayed. In the target view, the column
Source Cube is displayed. You edit the contents of the table in the Transfer Editor that opens when
you click the New or Edit button or double-click one of the cells.
In the Transfer Editor you select the source and the target cubes of the data connection on the Source
and Target tab. The dimensions of the selected cube are displayed. Dimensions that are not contained
in both cubes are highlighted in red. Right-click a dimension in the source cube to select all elements
of the dimension (only dimensions marked with an asterisk '*'), or a single element, or a subset of the
dimension. Use the shortcut menu command Subsets > Create Subset to create a subset for the
selected dimension in the Subset Wizard without switching to the tree view. Right-click a dimension
in the target cube to select the same elements as in the source cube or to select a single element.
Rules may also be defined for data connections. On the Properties tab, select Infor d/EPM OLAP
Server Rule or Event Agent Rule (Push Rule). If you create an Event Agent Rule, you can lock the
target area in order to prevent inconsistencies in the database, if wrong entries are made in the target
element.
If you select the Execute further calculations automatically check box, you can create a chain of
multiple Event Agent Rules. If the target area of an Event Agent Rule is identical with the source area
of another Event Agent Rule, the second Event Agent Rule is triggered by the first one. If you clear the
Execute further calculations automatically check box, only the first Event Agent Rule is executed.
Caution: If further calculations are performed automatically, this may lead to circular references.
If you select the Allow loop in target area check box, you can specify an aggregated element as
target area of an Event Agent Rule. The source value is then written to all child elements.
Select the check box Calculate online to specify that the values are calculated online immediately
after each input. Clear the check box Calculate online to calculate the values off-line as batch process.
Select the check box Clear target area before calculation to specify that the target area is deleted
before the calculation.
On the Rule tab, you create the calculation rule. The default rule is: Target.Value =
Source.Value. To edit the rule, click Formula Wizard. In the Formula Wizard you select the data
cube from which the data will be retrieved. A Source.Value expression is created with the selected
elements. Click the Check Syntax button after you have created the rule to check it. When you click
Save the syntax is also checked.
Languages
The user interface of Designer can be displayed in a variety of languages.
Managing languages
To add, disable, remove a language, or to reorder the language list:
Common
The Common folder contains the Currencies dimension. The entries of the Currencies dimension are
required to run the application. The ISO code of the currencies is used for the unique assignment of
the currencies.
Rules
The Rules table contains rules. Rules apply to specific areas of a cube. The cell values of a cube are
not stored in the database: they are calculated at the moment they are retrieved. Accelerators are rules
that accelerate this calculation.
You can create rules in this table. To create rules in this table, you must specify this information:
Rule groups
Optionally, you can organize rules into groups. It is important that rule groups and the rules which they
contain are associated with the same cube. To ensure that you do not group rules of one cube in the
rule group of another, it is good practice to include the cube name in the description of the rule group.
By default, the names of new cube rule groups are prefixed with the name of the cube with which they
are associated. But you can edit the name of the rule group.
Deleting an assignment
To delete the assignment of a rule to a rule group:
1 Click the ParentRuleGroupID column of the rule.
2 Press F2 to make the field editable.
3 Delete the Parent Rule Group ID.
1 Right-click the rule group in the Rule table and select Edit rule group. The Edit Cube Rule Group
dialog is displayed.
2 Edit the rule group as required and click OK.
Note: If you change the name of the group to which a rule is assigned, you must manually reassign
the rule.
Chapter 5: Connector
With Connector, you can import the structures and data from other databases into a multidimensional
OLAP database.
The node Connector is integrated into the tree view of Designer at the top level.
ODBC connections
To access a source database, Connector uses ODBC connections. ODBC connections establish the
connection to a data source. These may be relational data sources (SQL Server, Oracle, Access or
others), text files (.txt-, csv-files and others) and Excel. To get a complete list of available data source
drivers, open the ODBC Data Source Administrator dialog. ODBC data sources do not contain
categorization information.
When the ODBC connection is enabled tables that contain a primary key which consists of only one
field, will be categorized as dimension tables.
Source databases
If you use ODBC connections and you want to establish the connection to a source database, enable
the ODBC connections in the Connector Settings dialog.
Business units
Connections recognize the business units of the source database, for example, companies or reporting
entities, depending on the database type. Business units of the source database are combined to
business groups using a wizard.
Business groups
In a business group you create unified mappings between source tables and OLAP dimensions. The
mappings standardize the access to data and structures that are equal for all business units.
Reference database
The business data that you import into an OLAP database using Connector, are temporarily stored in
a reference database comparable to a Data Warehouse.
You specify, when the data are loaded from the source databases into the reference database. This,
you specify for each business group. The data must be loaded, when you create the OLAP database.
You configure the transfer of business data from the reference database to the OLAP database using
data connections for cubes.
Step by step
When you use Connector for the first time:
1 Install and configure the preferences.
2 Check the target structure.
Before you create unified mappings for business groups, check, whether the target dimensions
and target cubes exist. Unified mappings may also be added and edited later.
3 Create the business groups.
Create the business groups with the Business Group Wizard. Thus, you combine the business
units, for which you use the same settings. Unified mappings, currency settings and settings to
load business data, are specific to the business groups.
4 Check the mappings.
Check the mappings you have created with the Business Group Wizard. Create further mappings,
if necessary. For the unified mappings select the elements to import later.
5 Assign elements in the target dimension.
Create the hierarchical structure for the import. Copy the source elements to the target dimension
or create elements that you assign to the source elements.
6 Create data connections for cubes.
Create the data connections for cubes for the cubes of the OLAP database. Thus, you determine,
which data are loaded into the cube, when the database is created.
7 Create the OLAP database.
Create the database using the menu command File > Create Database. In the OLAP database,
the structures are created and the mapped data are imported from the source database.
Connector settings
To open the Connector Settings dialog, right-click Connector in the tree and select the Settings
command.
Note: In the lower section of the Summary tab, an overview of the connections is displayed.
Commands Description
Deactivate Deactivates the business unit. It will no longer be
shown in the navigation.
Export Source Configuration Definition File Exports the configuration data of the business
unit to a file.
Import Source Configuration Definition File Imports the configuration data of the business
unit from a file.
Create ad-hoc project Creates an ad-hoc project. It contains mappings
based on dimensions that exist in the source
connection. Cubes are created from the fact ta-
bles. For each mapping a dimension is created.
Data connections are created for the cubes.
To create an ad-hoc project, right-click the busi-
ness unit and select Create Ad-hoc Project. In
the Create Ad-hoc Project dialog specify the
name of the ad-hoc project and click OK.
Refresh Refreshes the settings of the business unit.
Field
MEASURE field
KEY field
DESCRIPTION field
Erroneous tables
Business unit
Button Description
Opens the Add Table dialog.
Business unit
Button Description
Deletes the selected table.
Button Description
To show the SQL statement, select a table and
click the button.
To edit the SQL statement, click the button.
In addition to the properties of the fields, you can specify related fields:
Button Description
To specify a related field, select a field and click
the button. In the Related Fields dialog you
specify the related fields.
To hide this section, click the button.
Property Description
FACTTABLE Specifies the table as a fact table. Fact tables
contain values that are stored in a cube. Fact ta-
bles must contain the ID fields of the dimensions
and the references to the dimensions.
CHARTOFACCOUNTS Specifies the table as a chart of accounts dimen-
sion. The chart of accounts contains the available
accounts.
PERIOD Specifies the table as a period dimension.
CURRENCYCODE Specifies the table as the dimension of the cur-
rency codes.
CURRENCYRATE Specifies the table as the fact table of the curren-
cy rates.
ANALYTIC Specifies the table as a common dimension. A
common dimension is not further categorized.
YEARPART Specifies the table as the dimension of the years.
PERIODPART Specifies the table, that contains the parts of the
periods definition (days, weeks, months, quar-
ters).
UNCLASSIFIED Tables that are not categorized. To bring these
tables into further use, the type FACTTABLE or
ANALYTIC must be assigned to them.
LOOKUP This type is automatically assigned to dimensions
that are created on basis of the list of known en-
tries of a field.
• Dimension type PERIOD: The key field of the PERIOD dimension must be of the type IS_PERIOD.
Note: Automatically created attribute table fields cannot be edited. They are marked with a lock icon.
Button Description
Click Goes to the Related Field to jump to a re-
lated field.
Click Goes back to the Original Field, to step
back to the original field.
Erroneous relations
Erroneous relations can occur when the relation has been deleted or deactivated on one side. Erroneous
relations and the tables that contain them are marked with a red point.
Adding tables
This section shows how to add tables for ODBC connections:
• ODBC connections: To add a table, right-click the node and select Add table. Create the SQL
statement in the SQL Statement section. Specify the ID of the table in the Name field. Select the
table type from the drop-down list Type and specify a description for the table. Click OK to close
the dialog and to save the definition.
Note: Do not use these key words: create, alter, drop, delete, update, insert, execute,
into, checkpoint, dbcc, declare, deny, backup, dump, exec, go, goto, grant, kill, load,
restore, revoke, rollback, setuser, transaction, shutdown, use, waitfor, truncate.
Removing tables
To remove a table, right-click it and select Delete.
Property Description
Name and description You specify the name and the description of the
business group.
Business units Select the business units to add to the business
group.
Currencies Select the group currency of the business group
and the currencies of the business units, whose
values are imported. This is important for the
currency translation.
Default mappings You create general mappings of source tables to
target dimensions. You can edit these mappings
later and create further mappings.
Data transfer You select the periods, whose data will be written
from the source database to the OLAP cubes,
when the OLAP database is created.
Properties that you do not configure with the Business Group Wizard can be edited in the Properties
dialog of the business group.
Mappings that you create with the wizard are displayed in the tree. You can edit them later.
To start the Business Group Wizard, right-click the Business Groups in the tree and select the New
Business Group command. To create a business group, take these steps:
Note: You may change the currency settings in the Properties dialog.
Column Description
Id of the unified mapping For each table used in at least one business en-
tity of the source database, a mapping will be
proposed. Only one mapping will be created for
tables of the same name in several business en-
tities (unified mapping). Use the Description
column to check, whether the table has the same
function in all source databases. You may ex-
clude individual business entities. Select the
check box next to the mapping ID to create the
mapping.
Description Specify the description of the mapping. The de-
scription of one of the tables in the source
database will be proposed. Use the description
to check, whether all business entities in tables
of the same name store the same contents.
Use default mapping Select the check box to add all elements of the
source table as preselection to the element list.
This is useful, if import all elements later on.
Thus, you will not require to select the elements
separately for the import. The elements are
available on the Unified Data Sources tab in the
target dimension. If you select the option Use
default mapping, a dynamic range will be creat-
ed for the mapping, which contains all source el-
ements. Filter: ID LIKE %.
Target dimension Select the dimension, into which you import the
data and the structures of the table later on. The
dimension must exist in the tree of Designer.
Use default mapping (Target dimension) Select the check box to add elements of the
source table to the target dimension. This is only
useful, if the check box Use default mapping is
also selected for the mapping. If you select the
option Use default mapping, a dynamic range
will be created for the target dimension, which
contains all source elements. Filter: ID LIKE %.
Note: You can edit the mappings later and create further mappings.
contained in the reference database. Dimension elements and structures will also be created, when
the reference database is empty. You may change all settings in the properties dialog of the business
group.
Select the check box Load data, when the database is recreated to load all data of all business
entities, before the OLAP database is created the next time. If all data are loaded into the reference
database, those data are also loaded that are not assigned to anyOLAP dimension. When creating the
database with the command File > Create Database, the check box is automatically cleared.
In the table you specify, the data that is always loaded into the reference database before the OLAP
database is created. For each business unit you select the periods for which data are loaded.
The table contains these columns:
Column Description
ID and Description ID and description of the business entity.
Load exchange rates Select the check box, if the exchange rate values
of the business entity are to be loaded into the
reference database, when the OLAP database
is created.
You cannot specify for which periods the ex-
change rates are loaded. The exchange rates of
all periods are loaded.
Load fact data Select the check box, if the fact data of the busi-
ness entity are to be loaded into the reference
database, when the OLAP database is created.
In the Periods column you specify, for which
periods the business data (fact data) are loaded.
You can specify that the data is loaded incremen-
tally. Select Incremental Load from the drop-down
list in the Filter column.
Periods Select the periods, for which business data (fact
data) must be loaded into the reference database
from the drop-down lists, for example, Current
Quarter.
Select the option Select periods manually to se-
lect individual periods in a dialog.
Column Description
Manual selection If you select the option Select periods manually
in the Periods column, click the Browse button
in this column to open a dialog, where you may
select individual periods.
In the dialog, first specify the values for the start
period and the end period to restrict the range of
the selection. Then select the check box of the
periods, whose data are to be loaded into the
reference database, when the OLAP database
is created.
Note: To write the data from the reference database into the OLAP database, you must create data
connections for those cubes that contain dimensions with mappings for source tables. You may change
the settings of the data transfer in the properties dialog of the business group.
Step 7 - Summary
Here, you see the summary of the configuration steps.
Select the check box Load structure data of the business units when the wizard is finished to
load the structure data used in the business group and the mapping, if you click Finish. If you do not
select the option, the structure data must be loaded, when you click a mapping in the tree or when you
edit a mapping.
Tab Description
Business Group Here you change the description of the business
group. Furthermore, you select the exchange
rates for the key date rate and the average mar-
ket price.
Tab Description
Business Units Here you specify, which business units belong
to the business group.
Currencies Here you configure the currencies of the business
group and of the business units.
Mappings Here you edit the mappings of the business
group.
Data connections for cubes Here you specify, when and which data are
transferred from the reference database to the
OLAP database. To transfer data to the OLAP
database, the data must be contained in the ref-
erence database.
Data transfer Here you specify, when and which data are
loaded from the source databases into the refer-
ence database. Only data contained in the refer-
ence database can be transferred into the OLAP
database.
If you select Select periods manually and
no data is available for the business unit, the pe-
riods 15 years before and after the current period
are shown. Once the data are imported from the
source system, the periods are shown correctly.
Depending on the periods of the source system,
they require to be adapted.
Loading of Structures Here you specify the mappings of the business
group, which are to be refreshed always, when
the OLAP database is created.
Carry Forward Here you specify, whether the values of the pre-
vious year are to be carried forward to the starting
period of the following year.
select an exchange rate for each currency pair, which is valid for the entire business group, Currency
1 and Currency 2, for example, EUR and USD. Select the business entity in the column Business
entity, whose rate you use. In the Currency rate column, select the rate, for example, Rate1. The
available rates depend on the selected database.
Note: To work with the currency translation, you must create a mapping of the Currencies type. This
mapping must contain at least two currencies. If you do not create any mapping for the currencies, the
Exchange Rates button is disabled.
Business units
On theBusiness Units tab in the Properties dialog of the business group, select the business units
that belong to the business group. You see the databases and the business units in a tree. Select the
check box of a business unit to add it to the business group. To add all business entities of a source
database, select the check box of the database.
Only the enabled business units are displayed.
Currencies
On the Currencies tab in the Properties dialog of the business group, you configure the currencies.
The options are identical with those of the step Configure the currencies in the Business Group Wizard.
Select the group currency of the business group from the drop-down list Currency of the business
group. This is important for the representation in reports and for the currency translation for transactions
from one business entity to another.
In the ISO code column, you assign a code from the table System > Currencies. This is important
for the unambiguous mapping of currencies, because currencies in different business entities may
have different IDs.
A business entity may have several currencies. With the settings in the Currency function column,
you specify, whether the values of the currencies are imported and which function a currency has in
the target database.
Note: You must import at least one currency per business entity with the currency function Used or
Local.
Mappings
To see an overview of the mappings, select the Mappings tab in the Properties dialog of the business
group.
To edit a mapping, click Edit. In the Properties of the Mapping dialog you edit the description of the
mapping and select the source tables and target dimensions.
You create and delete mappings with the shortcut menu of the business group in the tree.
Data transfer
On the Data transfer tab of the Properties dialog of the business group, you configure the transfer of
data from the source databases into the reference database. This is important, because only those
business data (fact data) are transferred to the OLAP database that are contained in the reference
database. Dimension elements and structures will also be created, when the reference database is
empty.
Select the check box Load data, when the database is recreated to load all data of the business
units before the OLAP database is created the next time including the data that are not mapped to any
OLAP dimension. The check box is disabled, while the database is created. In the table, specify, which
periods are loaded for each business unit.
The table contains these columns:
Column Description
ID and Description ID and description of the business entity.
Column Description
Load exchange rates Select the check box, if the exchange rates of
the business entity are to be loaded into the ref-
erence database, whenever the OLAP database
is created.
The exchange rates of all periods are always
loaded into the reference database.
Load fact data Select the check box, if the business data (fact
data) of the business entity are to be loaded into
the reference database, whenever the OLAP
database is created.
In the Period column you specify the periods,
whose business data (fact data) are loaded.
Period Select a period category, for which business data
(fact data) are loaded into the reference database
from the drop-down lists, for example, Current
Quarter.
Select Select periods manually from the
drop-down list to select individual periods in a
dialog.
Manual selection If you select the option Select periods man-
ually in the Period column, click the button in
this column to open the Periods dialog, where
you may select the periods.
In the dialog, first specify the values for the Start
period and the End period to restrict the range of
the selection. Then select the check box of the
periods, whose data are to be loaded into the
reference database, when the OLAP database
is created.
Note: To write the data from the reference database into theOLAP database, you must create data
connections for those cubes that contain dimensions with mappings for source tables.
Loading structures
In the property dialog of the business group, you specify the mappings, whose structure is always
refreshed when the OLAP database is created on the Loading Structure Data tab. In the ID column,
select the check boxes of the mappings, whose structures are to be refreshed when the database is
created. This is important, because the structures of the tables and dimensions of the source database
may change.
Carry forward
Here you specify, whether the values of balance sheet accounts of the previous year are to be carried
forward to the starting period of the following year. Select the Carry forward check box to enable the
function. If you specify several balance sheet accounts, select a separator that separates the balance
sheet accounts in the entry field. Specify the name of the balance sheet account types.
Creating mappings
To create a mapping, right-click the business group in the tree and select Mappings > New Mapping.
The wizard for mappings opens.
1 Specify the name and description of the mapping.
Here, you specify the name and the description of the mapping. In the tree you see the mappings
and their description. The descriptions may be edited later. From the drop-down list Mapping type,
select the type of the mapping, for example, Scenarios. Selecting the mapping type restricts the
selection of source tables. Example: If you select Currencies as the mapping type, only those
source tables are displayed that contain currencies. The mapping type cannot be edited later.
2 Select the source tables.
Here, you select the source tables of the mapping. In a tree, at the top level, are the business
entities that belong to the business group. At the level underneath are the tables of the business
entities. Only those source tables are displayed that match the mapping type, for example, currency
tables for the mapping type Currencies.
Because tables with the same name may have different functions in the business entities, select
the table for each business entity that is to be used in the mapping. You can only select one table
as the source per business entity.
Select the check box in the Use default mapping column to insert all elements of the source table
as preselection into the element list. This is useful, if you import all elements. If you import all
elements, it is not required to select the elements for the import on the Sources tab of the mapping.
The elements will be available in the target dimension, when you create the mapping on the Unified
data sources tab.
3 Select the target dimensions.
Here, you select the OLAP dimension, into which to import the data and the structures of the source
tables. If you later click these dimensions in the tree, you will find the Unified Data Source tab in
the data area of the dimension. This tab contains the elements that you select in the data area of
the mapping for the import.
Select the check box in the Use default mapping column to add all elements of the source table
to the target dimension. This is only useful, if this option is also selected for the source tables.
Note: You select the elements, which you import later, in the data area of the mapping on the
Sources tab.
Editing mappings
To edit a mapping, right-click the mapping in the tree and select Properties. The Properties of the
Mapping dialog opens, where you edit the description and select the source tables and the target
dimension.
On the Mapping tab you change the description. In the tree you see the mappings and their description.
The mapping type cannot be edited. If you require the mapping of a different type, you must create an
additional mapping.
On the Data sources tab you select the source tables of the mapping. In a tree, at the top level, you
see the business entities that belong to the business group. At the level underneath you see the tables
of the business entities. Only those source tables are displayed that match the mapping type, for
example, currency tables for the mapping type Currencies. In each business entity, select the check
box of the source table that you map to a dimension.
In the Target Dimension tab, you select the OLAP dimension into which the structures and data of
the source tables is to be imported. If you later click these dimensions in the tree, you will find the
Unified Data Source tab in the data area of the dimension. This tab contains the elements that you
select in the data area of the mapping for the import.
Note: You select the elements that you import later, in the data area of the mapping on the Sources
tab.
Tab Description
Data Here, you see the source elements of the select-
ed business entity:
Source elements that have not been mapped or
copied.
Source elements that you have copied to the ele-
ment list.
Source elements that you have mapped to a dif-
ferent element of the element list.
Source elements that have been copied into the
element list by a dynamic range.
Schema Here, you map the columns of the source table
(Column) to the columns of the target dimension
(Mapping). Thereby, you determine, how the
values of the source elements will be processed.
Dynamic ranges Here, you create dynamic filters for an element
selection, which may be stored and re-applied to
the modified source database.
Copying elements
The Data tab shows the source elements you have mapped to the dimension. To copy source elements
to the element list, so that for each source element an element in the element list is created, select the
source elements and drag them into the element list. A shortcut menu opens, where you select the
Copy command. An element of the same name will be created. Alternatively, to select the source
elements in the list, right-click them and select Insert Elements Automatically.
To show elements that have not yet been assigned, select Only show unmapped elements.
Mapping elements
The Data tab shows the source elements you have mapped to the dimension. To map source elements
to an element in the list, select the source elements and drag them to the target element in the element
list. A shortcut menu opens, where you select the Create Mapping command.
If you map source elements within the element list, select the source elements on the Data tab, right-click
them and select Automatically Map Elements if Target Exists.
To show elements that have not yet been assigned, select Only show unmapped elements.
Field Description
Column Select the column of the source table, by which
the values are to be filtered, for example, ID.
Operator Select a comparison operator for this value, for
example, > (the SQL convention applies to oper-
ators).
Value Specify the value that will be checked by the
comparison operator of the Operator field using
the value of the field Column, for example, 1,000
(the SQL convention applies to wildcards).
Example
Select the ID column from the drop-down list Column. Select the operator > (greater than) from the
drop-down list Operator. Specify the value 1,000 into the Value field. As a result, all source elements
with an ID greater than 1,000 are transferred into the element list.
To combine various filter criteria, define additional criteria in the Filter dialog. With the option buttons
AND and OR you determine, whether those source elements are added exclusively that match all
criteria (AND; restrict list), or whether source elements only have to match one of the two criteria (OR;
expand list).
To save the dynamic range and to add the filtered elements, close the dialogs Filter and Dynamic
Range with OK and click Save on the Dynamic Range tab.
Note: If you select the option Use default mapping when creating a business group, a dynamic
range will be created in the mapping, which copies all source elements into the element list. Filter: Id
LIKE %.
Deleting mappings
To delete a mapping, right-click the mapping in the tree and select Delete.
To show the source elements of a hidden business entity, click the bar with the name of the business
entity. Select the source elements of the business entities one by one and add them to the dimension
to import them.
Tab Description
Data Here, you see the source elements of the select-
ed business entity:
Source elements that you have not mapped or
copied.
Source elements that you have copied to the ele-
ment list.
Source elements that you have mapped to a dif-
ferent element of the element list.
Source elements that have been copied into the
element list by a dynamic range.
Only show unmapped elements Enable the check box Only show unmapped
elements to show elements that you have not
yet mapped or copied.
Schema Here, you map the columns of the source table
(Column) to the columns of the target dimension
(Mapping). Thereby, you determine, how the
values of the source elements will be processed.
Here you may specify, whether a column of the
source table is to be used as parent.
Dynamic ranges Here, you create dynamic filters for an element
selection, which may be stored and re-applied to
the modified source database.
Copying elements
The Data tab shows the source elements you have mapped to the dimension. To copy source elements
to the dimension, so that for each source element an element in the dimension is created, select the
source elements and drag them into the dimension. A shortcut menu opens. Select the Copy command.
An element of the same name is created. Alternatively, you can select the source elements in the list,
right-click them and select Insert Elements Automatically.
To show elements that have not yet been assigned, select Only show unmapped elements.
Mapping elements
The Data tab shows the source elements you have mapped to the dimension. To map source elements
to an element of the dimension, select the source elements and drag them to the target element of the
dimension by drag-and-drop. On the shortcut menu, select Create Mapping.
To show elements that have not yet been assigned, select Only show unmapped elements.
To map source elements to dimension elements of the same name, select the source elements on the
Data tab, right-click them and select Automatically Map Elements if Target Exists. Connector
compares the names of source and target elements and maps elements of the same name.
Note: The data of the source element, which you map to dimension elements, are imported into the
element. If you map several source elements to a dimension element, the values are summed up. Do
not create mappings to parent elements in the dimension (C elements). Imported values cannot be
distributed to subordinate elements.
Field Description
Column Select the column of the source table, by which
the values are to be filtered, for example, ID.
Operator Select a comparison operator for this value, for
example, > (the SQL convention applies to oper-
ators).
Value Specify the value that will be checked by the
comparison operator of the Operator field using
the value of the field Column, for example, 1,000
(the SQL convention applies to wildcards).
Example
Example: Select the ID column from the drop-down list Column. Select the operator > (greater than)
from the drop-down list Operator. Specify the value 1,000 into the Value field. As a result, all source
elements with an ID greater than 1,000 are transferred into the element list.
To combine various filter criteria, define additional criteria in the Filter dialog. With the option buttons
AND and OR you determine, whether those source elements are added exclusively that match all
criteria (AND; restrict list), or whether source elements only have to match one of the two criteria (OR;
expand list).
To save the dynamic range, close the dialogs Filter and Dynamic Range and click Save on the
Dynamic range tab.
Note: If you select the option Use default mapping when creating a business group, a dynamic
range will be created in the mapping, which copies all source elements into the element list. Filter: Id
LIKE %.
Option Description
Load automatically Select the check box, if the fact data are to be
loaded from the reference database into the cube
of the OLAP database, whenever theOLAP
database is created.
To use external data for the cube, select the Use
external data check box. Data of an existing fact
table are loaded. The fact table will not be created
anew.
Allow Export Enable this check box, to enable the export
function for the data connection.
Clear data area Select this check box to clear the target data area
of the cube, where the data is transferred to. This
ensures the consistency of the data in the cube.
To delete a data connection for cubes, right-click the data connection in the tree and select Delete.
create filters on used and unused mappings that limit the data transferred to OLAP. You can also create
filters on the Dimension filters tab.
To specify the default element of a dimension, select it from the drop-down list of the Default column.
To specify a filter of a mapping, a used mapping or a dimension, click the Browse button. Specify the
filter in the Filter dialog.
Note: Only data that have already been loaded into the reference database can be transferred into the
OLAP cube. You may specify, whether the data are loaded automatically from the source databases
into the reference database.
To enable the export function for a data connection for cubes, so that you can export the data of the
data connection, right-click the data connection in the tree and select Properties. In the Edit Data
Connection for Cubes dialog, enable Allow Export. On the Data Connections for Cubes tab in the
Property dialog of a business group, you can enable Allow Export for all data connections of a cube
or of a business group.
Importing data
When all steps of Connector are completed, you must create the OLAP database to import the data.
To create the database, select File > Database.
You can use the Export dialog, to export the data you have imported into the OLAP database and
edited there, for example, to re-import the data to a SunSystems database.
Exporting data
You can export the data, which you have imported to an OLAP database using Connector into a text
file, for example, to re-import edited SunSystems data to a SunSystems database.
Note:
• For the export, information from the reference database and the repository are required. Therefore,
only data can be exported which originate from OLAP databases and cubes, which you imported
using Connector.
• To export the data of a data connection for cubes, you must enable the Allow Export option for
the data connection. When you have enabled this option for a data connection, you must re-create
the database.
You use the Export dialog, to export cube data to a text file. There are two ways to open the Export
dialog:
• Right-click the cube and select Data Connections for Cubes > Export.
• Right-click a data connection for cubes and select Export.
In the Export dialog, there are these options:
Option Description
Data connections for cubes From the drop-down list, select the data connec-
tion for cubes, whose data you export. You can-
not select the data connection, if you have
opened the dialog by the shortcut menu of a data
connection in the tree.
Business entity From the drop-down list, select the business en-
tity, whose data you export.
Periods In the list, select the periods, whose data you
export (multiple selection with Ctrl).
Scenario From the drop-down list, select the scenario,
whose data you export.
Bridge From the drop-down list, select the bridge, whose
data you export.
Journal type If you select the file format SunSystems 4, you
select the journal type of the transactions that
you export here. If the journal types cannot be
retrieved (error message), you can specify a
journal type you know.
File format Select the file format of the export file, for exam-
ple, SunSystems 4 or SunSystems 5.
Filename Specify the name and the path of the export file.
Transaction reference Specify a text to be used as transaction reference
for the export.
Description Specify a text to be used as description for the
export.
another. For example, if you select a measure, the associated measure dimensions and cubes are
selected.
To run the connector configuration check:
1 Select File > Connector Configuration Check. The Validation dialog is displayed.
2 Select the measures, measure dimensions and cubes to check.
3 Click OK.
The results are displayed. They show a hierarchical view of the mappings and highlight unmapped
elements and invalid mappings.
4 Click OK, to close the overview.
5 Optionally, save the results as an HTML report.
a Click Save report as HTML.
b Browse to where to save the report and click OK.