Loading files from the source code data view

The source code data view provides a method for you to load all of the source files related to a program, source files and dependent files, even if they are located in different projects.

About this task

Source code data queries can identify a list of files on a given criteria, along with a component identifier and a path in the component. From the Source Code Data view, you can load one file or a list of files, from one or several projects, from one or several components.
Note: When you load files from the source code data view, the folder structure is not shared. Because the folder structure is not shared, the following limitations exist:
  • If you move the file from the folder, the change does not appear on the Pending Changes view.
  • If you delete the file from the folder, the change does not appear on the Pending Changes view.
  • User properties on the parent folders are not accessible.
  • Once you have loaded a project with these files, you can not load a full project with the same name and overwite the existing project. You must delete the existing project, and load the full project after the deletion of the existing project.
  • For IBM i operating systemYou cannot rename files since the side metadata files are not being loaded.
  • For IBM i operating systemYou cannot change the text description of a file because that information is stored in the side metadata files that are not loaded.
When you want to unload the files, the following information applies:
  • When you delete the existing projects, you disconnect the shared files and delete the complete folder structure.
  • When you unload the files from the Pending Changes view, the shared files are unloaded, but the folder structure in the project remains. You have to explicitly delete the folders.

Procedure

  1. In the Source Code Data view, right-click one or more files. From the popup menu, you can select either Load to load the selected files or Load with dependencies.
    Note:
    1. Load is a basic search that looks for dependency relationships using only the dependency logical name, without a file extension, in the stream. Selecting Load creates a search that only returns files that the program explicitly lists as a dependency.
    2. Load with dependencies is a more advanced search. Using the Language Definition and Build Definition to define a search path, the search can find the correct dependency files in the stream. Since the search path guarantees that the correct dependency file is found, the search also returns files that are dependencies of the original dependency file that is located.
    3. You can also select Enterprise Extensions to create a build subset or add to an existing build subset.
    Either selection opens a wizard to identify which files to load, and the location from which they should be loaded.
  2. If you selected Load with dependencies, you can optionally check the Apply search path box on the first panel of the wizard to include other definitions to improve the search results and find additional dependencies that might not be found without them. If you check the Apply search path box, the Language Definition and Build Definition fields are required. Click Browse to locate and select the definitions.
  3. In the Select Repository Workspace panel, select a repository workspace from the list from which the files are to be loaded. The Show only my repository workspaces containing all files selection only displays workspaces that contain all the files that are to be loaded. When you have made your selections, click Next.
  4. On the Repository files to load panel, you can review and make changes to the files you want to load. The file you selected from the Source Code Data is already selected. The files can belong to various projects and components. To specify a local folder to load instead of the Eclipse workspace, expand the optional Advanced Options section to specify the path to the folder for where to load the files.
    Note: If you select a file that is contained by a component that is already loaded in another sandbox, the Load Wizard issues a warning about the component being in multiple sandboxes. You cannot load a file selection from components that are present in another sandbox.
    When you complete the selection of the files you want to load, and specified where to load the files or default to the Eclipse workspace, click Finish. The loaded files are shown in any view that displays your local projects.

video icon Video

Jazz.net channel
Software Education channel

learn icon Courses

IoT Academy
Skills Gateway

ask icon Community

Jazz.net
Jazz.net forums
Jazz.net library

support icon Support

IBM Support Community
Deployment wiki