A Local Link is a mapping between a set of data that you want to either import into your e.List item(s) in the Contributor Grid or move to a different location in the open e.List item in the Contributor Grid. A Local Link is made up of the source data, items in the source, commentary, and the target tab of the source data.
Link definitions can be created using external data sources or tabs in the active Contributor Grid. Link Definitions can be modified and distributed after creation. Link definitions can be stored as a *.cld file.
In Get Data, you can create and run
a Local Link.
Create a Local Link so that you can load data from the following types of sources:
You create ASCII links when you want to load data from text files.
You create Excel links when you want to load data from a single worksheet from an Excel workbook. You can also use an .xls file that was created using Contributor Export for Excel.
Important: When using an Excel file as the source, in order for breakback to work, you must first delete the appropriate rows in file before importing.
With the breakback functionality, detailed cell entry takes precedence over the breakback. When importing an Excel file, cells that are blank are treated as zeros. Therefore, after performing the import with cells that are blank, the detailed cell entries will be imported with zeros. This will cause expected breakback results to not appear within the grid.
In order for the breakback to properly occur, the rows to be included in the breakback must be removed from the source file. After this is done and the link is executed, breakback will occur and the expected results will appear on the Contributor grid.
You create a Contributor-to-Contributor link when you want to move data in the active Contributor Grid. Data can be moved inside a single tab or from one tab to another.
Open Get Data.
In the Run Local Links dialog box, click the New button.
The Define Source Type and Destination dialog box appears.
In the Link Name box, enter a name for the new load.
Link names must be unique and cannot contain these characters: ’\ /:*?"<>|.
In the Description box, enter a brief description of the source and target of the link.
Tip: This information is useful when sharing links with other users.
In the Data source type box, click the data source type you want.
In the Pick source tab list, if you are using Contributor data, click a source tab where you want the data loaded from.
In the Pick target tab list, if you are using Excel or ASCII data as the source, click a target tab where you want the data loaded into and click Next.
The Pick Source Data dialog box appears.
In the Source box, enter the file name.
Provide the information required for your source file type:
For an ASCII file with fixed width columns, click Fixed width columns.
For an ASCII delimited file, specify the delimiter and the text qualifier that the file uses.
For an Excel Spreadsheet, choose a worksheet if required.
For a Contributor tab, specify the source and target tab.
Click Next to continue.
The Map Source to Target dialog box appears.
In the top work area, select each row or column that you
want to identify as description data and click Description.
The Description icon appears .
Description columns cannot follow Data columns in the source file.
Select each row or column that contains data for loading and click Values.
If some data is not numeric, right-click each column or row that contains non-numeric data, click Data Format, and click Text, Number, or Date.
If some rows or columns of source data are not needed, select each of these rows or columns and click Ignore.
The Ignore icon appears in the header.
In the Start import at row box, enter the row number that you want to start your import with if you do not want to load data beginning with the first row.
If you want, split a column or merge dimensions .
You must now map the dimensions.
The Map Source to Target dialog box is divided into two work areas:
The upper area is where you identify your source dimensions as data, description information, or unnecessary rows and columns. You can also rename columns and rows to make the link definition easier to understand. This is where you merge or split columns depending on what your target dimension requires.
The lower area is where you map source dimensions to target dimensions. You can map one or more source dimensions to a target dimension manually or you can choose Map All to map dimensions with the same name. You can also edit and clear any mapped dimensions.
When you preview your source files in Get Data, the headers are automatically renamed. For example, columns are renamed to C1, C2, and rows are renamed to R1, and R2.
You can rename your columns and rows by manually renaming the rows and columns or renaming columns using existing column headers.
Tip: Renaming rows and columns the same name as target dimensions helps to easily identify which source and target dimensions match. You can then use the Map All feature.
In the Map Source to Target dialog box, select a row or column header and click Rename.
Enter a new heading.
Click OK.
To use row header, do the following:
In the Map Source to Target dialog box, in the Rename columns using row box, enter the number of the row that contains the original names you want to use for each Description column.
This does not change dynamically with the data.
You can split a column whose information must be mapped to two or more separate target dimensions. For example, you have a source dimension that lists dates in the format Jan-03 and two target dimensions, one for month and one for year. You must split the source dimension into two sub-dimensions to correctly load the data.
Note: You cannot split a dimension already marked as a Description.
In the Map Source to Target dialog box, select the source dimension (row or column) that you want to split and click Split.
Position your pointer where you want to split the data, left-click, and drag the line into position.
Right-click the character to remove the split bar.
Click OK.
You can merge two or more source dimensions to map them to one target dimension. For example, you want to merge a source dimension for years (03) and a source dimension for months (Jan) into one dimension (Jan 03) and map it to the target dimension of months and year (Jan 03).
Note: You cannot merge two dimensions when either is already marked as Description.
You can also undo a split by merging the new dimensions.
Select the columns or rows that you want to merge.
Click Merge.
You must map the source dimensions to the target dimensions for loading.
You can either map source and target dimensions with the same names automatically, or manually map source dimensions to target dimensions.
Tip: You can tell what type of mapping was used by pausing the pointer over the connecting line between the source and target dimensions.
You can quickly map your source and target dimensions when the names of each already match. This feature is useful when working with large files that contain many rows and columns.
The Map All button is available only if you have at least one set of matching dimensions.
If the items in the source and target dimensions do not match, a manual map is required. For example, if the source item is Jan-03 and the target items is 1-03, a manual map is required. If the items in a source or target of the manually mapped load are added, the load must be manually updated.
If the names do not already match, in the Map Source to Target dialog box, rename the columns and rows to the same names as their corresponding target dimensions.
Click Map All.
A single line connects paired dimensions.
Tips: Double-click the connecting line (or either dimension) to confirm that the items in the dimensions are mapped correctly.
To change the link properties, click the line and click Edit. To remove the link, click the line and click Clear. To remove all links, click Clear All.
In the Map Items dialog box, select a source dimension and a target dimension and then click Map.
The Map Items dialog box appears. Any matching dimension items are highlighted.
Tip: Select the Case sensitive check box if you want to map items based on capitalization and the Calculated items check box if you want to map the calculated items.
Click OK to accept the highlighted dimension items.
The Map Source to Target dialog box reappears.
If unmatched items remain in the Map Items dialog box, click Manually Map and do the following:
In the Source Items box, select a source item.
In the Target Items box, select a target item.
Click Add.
Click OK.
The Map Source to Target dialog box reappears. A line connects single/paired dimensions.
Click Next. The Additional Options dialog box appears.
To include annotations, select Include Annotations.
To include attached documents, select Include Attached Documents.
Click Finish when you are done configuring the link element.
The Run Local Links dialog box reappears listing the new Local Link and whether it is Ready or Incomplete.
You can view only the first 50 detail items in a dimension.
Select either a source or target dimension.
Under the dimension name, click the Preview button .
You can remove a selected dimension from the Source Dimensions list in the Map Source to Target dialog box.
In the Map Source to Target dialog box, select the source dimension you want to remove.
Click the Remove button .
This removes the description designation from a row or column. The row or column is now treated as values.
You can filter dimension items that appear in the Dimension Items list based on the first character or more than one character in the item name.
Note: This filter only applies to items that appear in the list. It does not affect what gets loaded into the target.
In the Map Items dialog box, in the Filter box, enter the character or characters you want to filter on.
Only the items that begin with the character or character you entered in the filter box appear in the Dimension Items list.
Tip: To remove the filter, delete the characters in the Filter box .
You can filter Dimension items using a substring filter based on the character position. For example, you can filter items to just the third, fourth, and fifth characters of each item.
When you use a substring, all the items that match the substring are rolled up into one item. For example, if you have dimension items named Budget 1, Budget 2, and Budget 3 and if you applied the substring BUD to the first three characters, all three items are rolled into one dimension item to be loaded into the target dimension.
Unlike filtering by characters, using a substring applies to what is included in the load as well as what is viewed in the Dimension Items list. You can use substrings when mapping dimensions manually or automatically.
In the Map Items dialog box, click Substring.
The Select substring dialog box appears with the longest item name in the dimension list.
Clear the check boxes below the characters that you do not want to appear in the dimension list.
Tip: Drag the pointer to clear more than one check box at a time.
Click OK.
The dimension items are now filtered by the characters in the positions you selected.
Mapping creates relationships between one or more source dimensions and a target dimension. When all source and target dimensions are mapped, the load definition is ready. Sometimes, the source and target do not have the same number of dimensions or some source dimensions are not meant to be mapped directly to a target dimension. All dimensions must either be mapped or dealt with before you can run a load.
The load appears in the Run Loads list with either a ready or incomplete symbol.
Unmapped source dimensions are dimensions that are not mapped to a target dimension. You must designate the items on each unmapped source dimension that are to be included in the load. At least one item from every unmapped dimension must be selected or no data from the source will be loaded and the link will be incomplete.
Note: All source dimensions must be addressed, either by being mapped to a target dimension or by having items selected for inclusion on the Unmapped Dimensions dialog box. Otherwise the load will not be marked as complete and cannot be executed.
In the Pick Unmapped Source Dimensions Items dialog box, in the Available list, select which dimension items should be loaded.
If you select more than one item, the aggregated total is loaded into the target.
Select the All items check box if you want to include all items and any items added in the future to the source dimension.
Click Next.
Repeat for any unmapped source dimension items.
Unmapped target dimensions are target dimensions without any source dimensions mapped to it.
All target dimensions must be addressed, either by being mapped with a source dimension or by having items selected for inclusion. Otherwise the load will not be marked complete and can not be run.
In the Pick Unmapped Target Dimensions Items dialog box, in the Available list, select which dimension items should be targeted by the source data.
The same value is loaded into all items selected.
Select the All detail items check box if you want to include all the current items and any future items added to the target dimension.
Click Finish.
You can add link definitions to the Local Links list that were created by other Contributor users.
Click Add.
Find the link definition file (*.cld).
Click Open.
The newly added link definition appears in the Local Links list. You can now edit or run this link definition.
You can share link definitions with other Contributor users by distributing link definitions through email or network locations.
Users must have submit or edit access to the target cube that is defined in the link definition to run the link. You define access privileges in Contributor Administration Console.
In the Local Links list, select the link definition that you want to share.
Click Save as to save the link definition to your local computer, or to a network location.
Make the link definition file (*.cld) and the source file (*.xls or *.txt) available to other users.
Users can now add the link definition file to the Local
Links list . If they want to change the current location
of the source file or use a different source, they must modify the
link definition.
To load data into a target Contributor tab, you must have edit or submit rights for that tab. You cannot load data into tabs that are read-only.
In the Local Links list, select the Local Link that you want to run.
Multiple loads run consecutively.
Tip: You can control the order that the Local Links run in by adding them to the Local Links list in the desired order.
Click Run.
Click OK when the link is finished running.
You can load data from an Export for Excel file by using the Quick Load feature.
In the Local Links dialog box, click the Quick Load button.
Under Export for Excel file, in the Source box, enter the file name.
Choose the worksheets you want to load.
Tip: You can also click the Select All button or the Deselect All button.
Preview the file in the preview window.
Click Run.
You can run only System Links if the Contributor administrator grants you access to them. You cannot create a System Link.
Tip: To view the System Link execution history which includes when a link was run and by whom, click the History button.
In the System Links list, select the System Link that you want to run.
Click Run.
If errors exist, you are prompted to view or ignore them.