http://support.collibra.com/knowledgebase/ en-us KnowlageBase RSS Generator http://support.collibra.com/knowledgebase/article/AA-00170 Sun, 09 Aug 2009 22:00:00 +0200 http://support.collibra.com/knowledgebase/article/AA-00169 1. Overview

After completing a search the Search View will be shown with an overview of all found matches. If you cannot see this view, go to Window > Show View > Search or Window > Show View > Other... and select the Search View.

The view consists of two parts, the local toolbar (1) positioned next to the tab and the content area containing the matches (2). You can handle, move, minimize and maximize the view using the tab. For example, double clicking the ]]> Sun, 09 Aug 2009 22:00:00 +0200 http://support.collibra.com/knowledgebase/article/AA-00168 Sun, 09 Aug 2009 22:00:00 +0200 http://support.collibra.com/knowledgebase/article/AA-00166

Toolbar Icon
Name

Description

Shortcut Windows

Shortcut Mac

Knowledge Base Article


 

New
When clicked upon the icon, a New Dialog will appear where you can select a wizard. When you click on the downward arrow, a context menu will display a selection of these wizards.
 


 


 




 
Save
Save the active file.
⌃ S
⌘ S
 


 
Print
Print the source of the active file.
⌃ P
⌘ P
 


 
Search
Search for certain conce]]> Sun, 09 Aug 2009 22:00:00 +0200 http://support.collibra.com/knowledgebase/article/AA-00165 Simple CompareUnderstanding the ComparisonWorking With the Comparison
1. Simple Compare
Select two files you want to compare with each other in the Navigator View. Right click and select Compare With > Each Other.

When the two files are identical a popup will appear telling you so, if not, you will be redirected to the Compare Editor.

2. Understanding the Comparison
Each]]> Tue, 04 Aug 2009 22:00:00 +0200 http://support.collibra.com/knowledgebase/article/AA-00164 Tue, 04 Aug 2009 22:00:00 +0200 http://support.collibra.com/knowledgebase/article/AA-00161

Menu Option

Description


New Window
Open a new window with the same workspace.


New Editor
Opens the active file in a new editor.


Open Perspective
Opens a selected perspective, containing a selection of views.


Show View
Open a view in its default location.


Customize Perspective...
Configures settings for the active perspective, including settings for:
- The quickly accessed settings on the New, Open Perspective and Show View submenus.
- Which options appear in]]> Wed, 29 Jul 2009 15:16:29 +0200 http://support.collibra.com/knowledgebase/article/AA-00159

Menu Option

Sub Options

Description

Shortcut Windows

Shortcut Mac

Knowledge Base Article



Quick Search


 
Go to the quick search dialog to search terms, relations and lexons.

⌥ S


⌥ S


 




Search...
Opens the normal search dialog.
⌃ H
⌃ H
 


File...
Opens the File Search dialog. File Search enables you to locate text in all files in your workspace.
 
 
 


Text
Workspace
Searches the Workspace for text selected in the ed]]> Wed, 29 Jul 2009 14:54:36 +0200 http://support.collibra.com/knowledgebase/article/AA-00157

Menu Option

Description

Shortcut Windows

Shortcut Mac


Toggle Comment
Comments or uncomments a line. Comments are used for adding text to your script to explain sections of code. Commented text will not be run as part of your code.
⌃ ⇧ C
⇧ ⌘ C


Add Block Comment
Comments a block by adding comment delimiters to either side of the code.
⌃ ⇧ /
⌘ /


Remove Block Comment
Removes a block comment.
⌃ ⇧ \
⌘ \


Shift Left
Shift the selected source one tab t]]> Wed, 29 Jul 2009 14:34:52 +0200 http://support.collibra.com/knowledgebase/article/AA-00152

Menu Option

Sub Options

Description

Shortcut Windows

Shortcut Mac

Knowledge Base Article



Undo


 
Undo the last action.

⌃ Z


⌘ Z


 




Redo
Redo reverses to a previous undone action.
⌃ Y
⌘ Y
 


Cut
Cuts the selected section of text.
⌃ X
⌘ X
 


Copy
Copies the selected section of text to the clipboard.
⌃ C
⌘ C
 


Paste
Pastes text from the clipboard.
⌃ P
⌘ P
 


Delete
Deletes the selected s]]> Wed, 29 Jul 2009 13:44:43 +0200 http://support.collibra.com/knowledgebase/article/AA-00160

Menu Option

Description

Shortcut Windows

Shortcut Mac

Knowledge Base Article


Open Project
Opens the currently selected project. This option is enabled when a closed project is selected.
 
 
 




Close Project
Closes the currently selected project. Closing a project does not cause it to be deleted from the file system. A closed project will still be displayed in the Navigator View but its resources are no longer accessible from within the Workbench.
 
 
&nbs]]> Tue, 28 Jul 2009 22:00:00 +0200 http://support.collibra.com/knowledgebase/article/AA-00158

Menu Option

Description


Turn Grammar Constraints Off
After you have turned the constraints off for a file, you can insert or delete any element or attribute regardless of the DTD or XML schema rules. You can create new elements or attributes that are not in the DTD or schema - these Design View prompts will only appear when you have turned constraints off. The file might become invalid if you do this.


Reload Dependencies
Reload the schemas linked into the XML file.


Expand All
Expand]]> Tue, 28 Jul 2009 22:00:00 +0200 http://support.collibra.com/knowledgebase/article/AA-00156

Menu Option


Description

Shortcut Windows

Shortcut Mac




Zoom In


Zoom in on the pattern.
⌃ =
⌘ =



Zoom Out

Zoom out of the pattern.
⌃ -
⌘ -




]]> Tue, 28 Jul 2009 22:00:00 +0200 http://support.collibra.com/knowledgebase/article/AA-00155

Menu Option

Sub Options

Description

Shortcut Windows

Shortcut Mac

Knowledge Base Article



Go Into


 
Goes into a selected folder so that only that folder's contents will be displayed in the Navigator View.
 
 
 




Go To
Back
Displays the previously displayed hierarchy in the Navigator View.
 
 
 


 
Forward
Returns to the display from which the back button was pressed in the Navigator View.
 
 
 


Up One L]]> Tue, 28 Jul 2009 22:00:00 +0200 http://support.collibra.com/knowledgebase/article/AA-00154 Studio.This feature is extremely handy to add a todo or a note about the source code without altering the code or adding comments to the source.To add a task or todo, go to a specific line in the source and click on Add Task... in the Edit menu.A dialog will be shown where you can enter a description and priority to you task.Click on OK to add the task. One the task is added, you will see]]> Tue, 28 Jul 2009 22:00:00 +0200 http://support.collibra.com/knowledgebase/article/AA-00153 Tue, 28 Jul 2009 22:00:00 +0200 http://support.collibra.com/knowledgebase/article/AA-00151

Menu Option

Sub Options

Description

Shortcut Windows

Shortcut Mac

Knowledge Base Article




New


Project

Start the wizard to create a new project.

 


 


 




 

Project...

Select a new project wizard.

 


 


 




New Pattern

Create a new pattern file.

 


 


Create a Pattern



New Commitment

Create a new commitment file.

 


 


Create a Commitment



New XML Template

Create a new XML template.

 


&n]]> Tue, 28 Jul 2009 22:00:00 +0200 http://support.collibra.com/knowledgebase/article/AA-00150 Sun, 26 Jul 2009 22:00:00 +0200 http://support.collibra.com/knowledgebase/article/AA-00149 Last but not least, some best practices if it comes to mappings:
Be as detailed as possible in your mappings so the Information Enabler can use all available information to perform the translation.Use the full path when mapping. For example, instead of stating
map /Delivery/Pallet/@ID on ID.be more specific and give the full path:map /Delivery/Pallet/@ID on ID of Pallet stores Good contained in Delivery.Map as many paths as possible. Also map nodes that are only used in XML for structuring. This will pres]]> Tue, 21 Jul 2009 22:00:00 +0200 http://support.collibra.com/knowledgebase/article/AA-00148 A value type is a type for something which can have an utterable value, such as words and numbers. For example the name of a person is a value type. The person is an entity because when we point to a person, we have no articulable value for it. His age, name and weight however, are.
Types of Mappings
The mappings can be very advanced, mapping application queries on conceptual queries. There are three kinds of mappings:
Value type mappings where the XPath that is mapped represents a value.
map /Delivery/ID]]> Tue, 21 Jul 2009 22:00:00 +0200 http://support.collibra.com/knowledgebase/article/AA-00147 Tue, 21 Jul 2009 22:00:00 +0200 http://support.collibra.com/knowledgebase/article/AA-00145 Explicit Functions
Explicit functions are the script functions that are explicitly referred to in the target mapping. For an example, consider this Groovy script function:
public static String formatDate(String[] date, String format) {}
This function can be referred to in the mapping as:
map "Document/@Date" on format_date( [Year of Date of Date and Time of issuing Message, Month of Date of Date and Time, Day of Date of Date and T]]> Tue, 21 Jul 2009 22:00:00 +0200 http://support.collibra.com/knowledgebase/article/AA-00144 Custom functions are supported in the form of scripts. Both JavaScript and Groovy are provided for the users to define their own functions. The type of script is specified with the section declarations:
Begin Script JavaScript ...End Script
Begin Script GroovyScript ...End Script
There is no limit on the number of script bloks. JavaScript is the default script type in case the type is not specified. All similar type blocks will be combined and validated by the Ω-RIDL Parser.
JavaScript
It is poss]]> Tue, 21 Jul 2009 22:00:00 +0200 http://support.collibra.com/knowledgebase/article/AA-00143 The function is applied on ]]> Tue, 21 Jul 2009 22:00:00 +0200 http://support.collibra.com/knowledgebase/article/AA-00142 Mandatory and uniqueness constraints can of course be combined. The Ω-RIDL language provides some syntactic sugar to do this. Combining mandatory and unique results in stating that there should be exactly one instance for the path. For example:

Delivery contains at exactly one Good.
Another form of syntactic sugar puts a uniqueness constraint on both reading directions and a mandatory constraint from left to right:

Product is with exactly one unique ID.
This constraint is typically used for identifiers]]> Tue, 21 Jul 2009 22:00:00 +0200 http://support.collibra.com/knowledgebase/article/AA-00141 A mandatory constraint means that there should be at least one instance in the population described by the path. For example the following constraint indicates that a Delivery should contain at least one Good.


Delivery contains at least one Good.








Navigation







 

Previous



 Table of Contents



Next







]]> Tue, 21 Jul 2009 22:00:00 +0200 http://support.collibra.com/knowledgebase/article/AA-00140 A uniqueness constraint means that there can be at most one instance in the population described by the path. For example the following constraint indicates that a Delivery is sent on at most one Date and Time.

Delivery sent on at most one Date and Time.
More complex instructions can be created as well, such as:
Delivery contains at most one Good stored on Pallet.
This means that the number of Goods are unlimited, but there can only be one Good that is stored on a Pallet.
External uniqueness constraints ]]> Tue, 21 Jul 2009 22:00:00 +0200 http://support.collibra.com/knowledgebase/article/AA-00139 Tue, 21 Jul 2009 22:00:00 +0200 http://support.collibra.com/knowledgebase/article/AA-00138 To be able to combine paths, logical connectors can be used:
andorxornot
When using a logical connector, each of the paths that it connects should be parenthesized. For example:
(Day of Date) and (Month of Date) and (Year of Date).
The connectors can be combined as well, such as:
((Day of Date) and (Month of Date)) or ((Year of Date) and (Month of Date))








Navigation







 

Previous



 Table of Contents



Next







]]> Tue, 21 Jul 2009 22:00:00 +0200 http://support.collibra.com/knowledgebase/article/AA-00137






Navigation







 

Previous



 Tab]]> Tue, 21 Jul 2009 22:00:00 +0200 http://support.collibra.com/knowledgebase/article/AA-00136






Navigation







 

Previous



 Table of Contents



Next







]]> Tue, 21 Jul 2009 22:00:00 +0200 http://support.collibra.com/knowledgebase/article/AA-00135 The selection in a commitment defines the universe of discourse for a particular application. The selection is built by selecting relevant lexons from the pattern which describe the application we wish to commit. You can select lexons for a commitment by drag-and-dropping these fact types from the pattern. They will be added to the Selection Section of the commitment. You can also add lexons textually to this section.

Selection of all of the lexons in the pattern depicted above results in the following S]]> Tue, 21 Jul 2009 22:00:00 +0200 http://support.collibra.com/knowledgebase/article/AA-00134 The commitment is split up into different sections. To following is a skeleton of a typical commitment:



Begin Selection ...End SelectionBegin Relations ...End RelationsBegin Constraints ...End ConstraintsBegin Script ...End ScriptBegin Mappings ...End Mappings









Navigation







 

Previous



 Table of Contents



Next







]]> Tue, 21 Jul 2009 22:00:00 +0200 http://support.collibra.com/knowledgebase/article/AA-00133 Committing your application means explicating its semantics using the lexons in a pattern. It is a three-part specification where you:
Select the relevant lexons that represent the universe of discourse of your application.Constrain the use of the lexons representing the rules in your application as closely as possible.Map the conceptual paths that are constructed by the lexons onto paths using a query language understood by your application.Once you have committed your application it can unambiguously co]]> Tue, 21 Jul 2009 22:00:00 +0200 http://support.collibra.com/knowledgebase/article/AA-00132 This tutorial serves as a specification of the Ω-RIDL language. Ω-RIDL is a conceptual data manipulation language for ontologies. It is a natural evolution from the RIDL language for data modeling towards ontology modeling.
Just as its predecessor, it is complaint with the NIAM modeling technique. Ω-RIDL is a form of controlled natural language, where readability and comprehensibility are the main drivers. Ontologies and commitments upon them should be validated and ideally created by businesses. There]]> Tue, 21 Jul 2009 22:00:00 +0200 http://support.collibra.com/knowledgebase/article/AA-00130




While you are building a pattern, you create lexons. A lexon
consist of two terms with a connecting relation (role and corole). Each term
exists within a certain context, usually the location from which this
term is extracted (a document, web-page, schema, ...). This is what we
call the lexical level of the pattern. However, it is important to be
able to link these terms to the conceptual level as well, through concept
definitions.

It is necessary to be able
to link ]]> Sun, 19 Jul 2009 22:00:00 +0200 http://support.collibra.com/knowledgebase/article/AA-00121 terms, lexons and concept definitions in all the
patterns in your workspace.
You can select which kinds of
resources you want to find, be it Conceptual Patterns or
Terms. Resources can dragged and dropped from the search view to other view or
editors. For example, to add a term or lexon to a pattern, simply drag
it to the pattern that is currently open in the Visual Editor. Th]]> Thu, 16 Jul 2009 10:28:44 +0200 http://support.collibra.com/knowledgebase/article/AA-00126 Wed, 15 Jul 2009 23:00:00 +0200 http://support.collibra.com/knowledgebase/article/AA-00127 1. Overview
The Outline View displays an outline of a structured file that is currently
open in the editor area, and lists structural elements. The contents of
the Outline View are editor specific. The screen capture below is an example of the Outline View that is accompanied with a pattern file. Other file types may or may not use the outline view as well, in which the usage is similar to that of the pattern file.
The Outline View is enabled by default in the P]]> Wed, 15 Jul 2009 22:00:00 +0200 http://support.collibra.com/knowledgebase/article/AA-00124



The Fact Editor is one of the quickest ways of adding new facts to your pattern. you can activate it using the Add Facts icon in the top toolbar of the Visual Editor or use the shortcut CTRL+D.

Upon activation, a dialog opens which allows you to enter a fact type.
These are the basic fact rules:
Terms always start with a capital.DeliverydeliveryTerms that consist of more than one word (noun phrase) should always have the two outer words capitalized.Date and TimeDate And TimeDate and ti]]> Wed, 15 Jul 2009 22:00:00 +0200 http://support.collibra.com/knowledgebase/article/AA-00123 or lexons in the pattern in a familiar way. The Table Editor can be
used to easily rename terms and roles by clicking on the names. A lexon
can be deleted from the pattern by clicking the red cross in the
right-side column of the table.IconNameActionDescriptionKB Article Remove RelationClicking on the icon deletes the relation from the pattern. This will not delete the two terms from the pattern.Remove a relation Rename Left cl]]> Wed, 15 Jul 2009 22:00:00 +0200 http://support.collibra.com/knowledgebase/article/AA-00122 graphical visualisation of the lexons in the pattern.It enables the
user to browse the lexons from the pattern in a familiar tree-like
view. The Norm Tree starts with a root Term located at the left of the
view. The root of
the tree can easily be changed to another term, to accommodate looking
at the pattern from a different perspective.On the top of the Visual Editor is a tool bar which features some actions that are specific to the Visua]]> Wed, 15 Jul 2009 22:00:00 +0200 http://support.collibra.com/knowledgebase/article/AA-00119 order to group and manage all the files that belong to a
certain project. OverviewLocal ToolbarContent Area1. OverviewTypically, an integration project will
include source files (e.g. XML files that need to be
translated), Patterns (e.g. selections of lexons that
constitute a specific message) and commitments (e.g. a
pattern with constraints and mappings to the i]]> Wed, 15 Jul 2009 22:00:00 +0200 http://support.collibra.com/knowledgebase/article/AA-00118

"A pattern is a meaningful group of fact types. Its purpose is
to conceptualize a small part of the domain as input for Semantic
Application."
In order to create a pattern, you have to launch the New Pattern Wizard by executing one of the following actions:
Press the New Pattern icon in the Main ToolbarPress the New icon in the Main Toolbar and select New PatternIn the Navigator View, press RMB and select New followed by New PatternGo to the application menu and select File > New > N]]> Wed, 15 Jul 2009 22:00:00 +0200 http://support.collibra.com/knowledgebase/article/AA-00117





Mac OS X

Windows




 Operating System

Mac OS X Tiger (10.4)Mac OS X Leopard (10.5)Mac OS X Snow Leopard (10.6)

Windows XPWindows VistaWindows 7




 RAM

256 MB





Hard Disk Space

100 MB





Java

5.0 or greater




]]> Tue, 14 Jul 2009 23:00:00 +0200 http://support.collibra.com/knowledgebase/article/AA-00116 Tue, 14 Jul 2009 23:00:00 +0200 http://support.collibra.com/knowledgebase/article/AA-00115


Minimal Requirements:
Mac OS X 10.4 or greaterMinimal RAM: 256 MBHard Disk space: 100 MBJava 5.0 or greaterAfter downloading the Collibra Studio trial, double click on the installation file (Collibra Studio.dmg).Drag the big blue diamond and drop it onto the applications folder to install.Go to Applications > Collibra Studio and double click on studio to launch the application.Upon launch the application will select the demo workspace as your default workspace. This workspace already c]]> Tue, 14 Jul 2009 22:00:00 +0200 http://support.collibra.com/knowledgebase/article/AA-00114
Video Tutorial



Minimal Requirements:
Windows XP or greaterMinimal RAM: 256 MBHard Disk space: 100 MBJava 5.0 or greater

Start the installation by double clicking on the msi package.

When the installer is started, click on the Next button.

Quickly go over the License Agreement and click on I accept the terms in the License Agreement if you do so. Click on Next to continue.

Select the type of installation and click on Next.
Typical & Complete: This will install all components.Custom: Choose wh]]> Tue, 14 Jul 2009 22:00:00 +0200 http://support.collibra.com/knowledgebase/article/AA-00113 Tue, 14 Jul 2009 05:00:00 +0200 http://support.collibra.com/knowledgebase/article/AA-00112 and strategic asset. Being able to exchange data and to interpret the
information in the data that has been exchanged in the right context
and within a reasonable time is a top priority for many organizations.
Starting from three simple but serious questions regarding data
semantics, data utilization, and data governance that pop up daily in
information-intensive enterprises, we easily identify a value
proposition for semantic alignment]]> Mon, 13 Jul 2009 23:00:00 +0200 http://support.collibra.com/knowledgebase/article/AA-00111 Sun, 12 Jul 2009 23:00:00 +0200 http://support.collibra.com/knowledgebase/article/AA-00107 Thu, 09 Jul 2009 23:00:00 +0200 http://support.collibra.com/knowledgebase/article/AA-00110



There are two ways for removing a relation:
Using the Visual EditorUsing the Table Editor
1. Visual Editor
Click on the relation's connection and press RMB.

Select Delete Relation: ...

2. Table Editor
Go to the Table Editor by selecting the other tab at the bottom of the Visual Editor.

Delete the relation by clicking once on the X icon in the right column.
]]> Thu, 09 Jul 2009 22:00:00 +0200 http://support.collibra.com/knowledgebase/article/AA-00109
After selecting the correct term, you can either click the red X icon in the top toolbar or right click on it and select Delete Concept in the context menu.

Note: When a term is deleted, all its corresponding relations are attached to its parent term.]]> Thu, 09 Jul 2009 22:00:00 +0200 http://support.collibra.com/knowledgebase/article/AA-00108




There are two ways to alter a relations role and corole. 

The first way is by double clicking on the role or corole box (not the
label) and give it a new name when the input field appears.

The second way it is done is by switching tabs at the bottom of the Visual Editor to the Table Editor.

In the Table Editor, go to the lexon which relation you want to alter.

Click on either the role or corole to edit them respectively.

Press the TAB or ENTER-key to accept changes and apply t]]> Thu, 09 Jul 2009 22:00:00 +0200 http://support.collibra.com/knowledgebase/article/AA-00106







At the top of the Visual Editor you will find an icon toolbar which contains the 'Add Relation' icon (). When you click on this icon, a new dialog will appear. The terms that were selected prior to this action will be used to automatically fill this form. Another option to get to this dialog is to right click on a term in the editor and select 'New Relation'.



Fill in the role and corole of the relation (with/of in this example) and press OK. This will add a relation between both t]]> Thu, 09 Jul 2009 22:00:00 +0200 http://support.collibra.com/knowledgebase/article/AA-00102




There are two ways to add a new term to your pattern:
Using the 'Visual Editor'Using the 'Outline'
1. Visual Editor

At the top of the Visual Editor you will find an icon toolbar which contains the Add Term icon (). When you click on this icon, a new dialog will appear.

Fill in a name for the new term and press the ENTER-key. Note that the dialog box also provides the option to introduce the term
in a context different from the pattern's default.
Another option is to right click in the]]> Mon, 06 Jul 2009 22:00:00 +0200