Internal Metadata
| Creating Internal Metadata |
| Externalizing Internal Metadata |
| Exporting Internal Metadata |
Internal metadata is a part of a graph, it is contained in a graph and can be seen in its source tab.
Creating Internal Metadata
Internal metadata can be created in the following ways:
Outline
In the Outline pane, you can select the item and open the context menu by right-clicking and selecting .
Graph Editor — Edge
In the Graph Editor, you must open the context menu by right-clicking any of the edges. There you can see the New metadata item.
Graph Editor — Component
To create metadata using a component, fill in the required properties first. After that, right click on the component and select Extract metadata.
See Creating Metadata.
Creating Internal Metadata: Outline or Edge
In both cases, after selecting New metadata, a new submenu appears. There you can select the way how to define metadata.
Now you have three possibilities for either case mentioned above: If you want to define metadata yourself, select the item; if you want to extract metadata from a file, select the or Extract from xls(x) file items, if you want to extract metadata from a database, select the item. This way, you can only create internal metadata.
If you define metadata using the context menu, the metadata is assigned to the edge as soon as it is created.
Creating Internal Metadata: Component
Many readers and writers allow to extract metadata using components' properties. Based on a type of the component, metadata is extracted from a file, database table or other sources.
Supported components are: FlatFileReader, ParallelReader, DatabaseReader, DBFDataReader, FlatFileWriter, DatabaseWriter, DBFDataWriter, DB2BulkWriter, InfobrightBulkWriter, InformixBulkWriter, MSSQLBulkWriter, MySQLBulkWriter, OracleBulkWriter, PostgreSQLBulkWriter.
The Extract metadata context menu is available only if the required file, connection or database properties are set on the component.
Externalizing Internal Metadata
Externalization of internal metadata is a conversion from internal metadata to external metadata being linked.
After you have created internal metadata as a part of a graph, you may want to convert it to external (shared) metadata. In such a case, you would be able to use the same metadata in other graphs (other graphs would share it).
To externalize any internal metadata item into external (shared) file,
right-click an internal metadata item in the Outline pane
and select Externalize metadata from the context menu.
After that, a new wizard will open
in which the meta folder of your project is offered
as the location for this new external (shared) metadata file;
now you can click .
You can also rename the offered metadata filename.
After that, the internal metadata item disappears
from the Outline pane Metadata group,
but, at the same location, already linked, the newly created external (shared) metadata file appears.
The same metadata file appears in the meta subfolder of the project
and it can be seen in the Navigator pane.
You can even externalize multiple internal metadata items at once.
To do this, select them in the Outline pane
and, after right-click, select Externalize metadata from the context menu.
After doing that, a new wizard will open
in which the meta folder of your project will be offered as the location
for the first of the selected internal metadata items and then you can click .
The same wizard will open for each of the selected metadata items until they are all externalized.
If you want (a file with the same name may already exist),
you can change the offered metadata filename.
You can choose adjacent metadata items when you press Shift and move the Down Cursor or the Up Cursor key. If you want to choose non-adjacent items, use Ctrl+ at each of the desired metadata items instead.
Exporting Internal Metadata
Export of metadata creates new external metadata as a copy of internal metadata.
This case is somewhat similar to that of externalizing metadata. Now you create a metadata file that is outside the graph in the same way as that of externalized file, but such a file is not linked to the original graph. Only a metadata file is being created. Subsequently you can use such a file for more graphs as an external (shared) metadata file as mentioned in the previous sections.
To export internal metadata into external (shared) one,
right-click some of the internal metadata items in the Outline pane,
click from the context menu,
select and expand the project you want to add metadata into,
select the meta folder, rename the metadata file,
if necessary, and click .
After that, the Outline pane metadata folder remains the same,
but in the meta folder in the Navigator pane,
the newly created metadata file appears.