Working with libraries and resources (DataStage)

Use the Schema Library Manager to import resources, such as JSON files, and to create and manage libraries of resources.

Libraries are stored in the metadata repository and are available for use in any job that uses the Hierarchical Data stage. In the metadata repository, a contract library is represented by the library name.

Table 1. Working with libraries
Task Action
Creating libraries
  1. Click New Library.
  2. Enter a name.
  3. Enter a description and the name of a new or existing category.
Refreshing library lists Click the Refresh icon at the top of the Libraries pane.
Removing libraries Select a library, and click Remove.
Opening libraries Select a library, and click Open. You can open a library only if it has been validated and has no errors. The Types tab displays a list of namespaces and the belonging types. To view the schema for a type, select a type from the Types tab. To view the facets and attributes for a node, select the node from the Schema tab.
Recategorizing libraries To move a library to a different category, edit the Category field in the library details.
Table 2. Working with resources
Task Action
Importing resources
  1. Select the name of a library, and click Import new resource.
  2. Select the file to import, and click Open. You can select a single json file. You cannot import json files from a zip file.
  3. After importing all of the required resources into the library, the library is automatically validated. If the library is valid, a green checkmark displays beside its name. If it is not valid, a red exclamation point displays beside its name.
  4. If the library is invalid, click Validate to display the list of errors.
Displaying the types in schemas Double-click the name of a library to display the Types and Schema tabs. On the Types tab, click the plus sign beside a namespace to display a list of types that belong to the namespace. Click a type to display the schema for the type on the Schemas tab. Browsing the types and their structures is useful for a variety of reasons. You can determine which type corresponds to a specific document instance by matching the top-level element name with the type name. You can determine which pieces of information are optional but could be included in similar documents. You can view the characteristics of the data, so that you can understand how to set transformation options.
Exporting resources Select the resource, and then click Export to save a copy of the resource on the local computer.
Updating resources If you modify a resource and want to update it in the library, select the resource, and then click Replace Selected Resource. The updated resource has no effect on jobs that used the earlier version of the resource. To use the updated version in an existing job, you must edit the assembly.
Deleting resources Click the Delete icon that displays beside the resource name. Deleting a resource has no effect on existing jobs that use the resource.
Displaying the resources in a library Click the name of a library. For the Hierarchical Data stage, the Resources view displays a file location and a namespace for each schema in the library. Click the name of a schema to display additional details about each schema.
Editing resource details Only the File Location and Description fields can be updated. After you update the file location, the library is automatically validated.