Saving an Analysis File in the Library


Using the Library, you and your colleagues can work together on the same analysis, keeping everyone up to date. When publishing your document, your current analysis is stored as a DXP file in the library. Files in the library can also be opened by your colleagues who run the Spotfire web client. If this is the intended use of the file, see the chapter Preparing Analyses for TIBCO Spotfire Web Clients to be aware of the limitations on the files available to web users.

Files saved in the library cannot be opened if you are working offline (without a connection to a server).

Tip: You can define your preferred data loading settings for each data table or part of a data table in the data canvas, as well as configuring additional settings for each data table in the Data Table Properties dialog, at any time while working on your analysis. This way you will not have to define those settings when saving the analysis, which makes the save procedure quicker.

Tip: An Administrator may change the default data loading settings for file data sources, using preference settings. The preference settings are reached in the Administration Manager, Preferences tab, under Application > DataImportPreferences. The administrator can also change the preference default for embedded data or force embedding of data when saving to library. You can find those preferences under  Application > LibraryPreferences. If the final data table is embedded, then you will not be able to change any data loading settings for specific sources.

To save an analysis file in the Library:

Note: If you are working with linked data, you may want to select key columns before saving the analysis. This is important if you want any specified tags to be able to be reapplied when reopening the analysis file, or, to be able to reapply markings in unaggregated visualizations (including markings in bookmarks). Make sure to select columns that uniquely identify all rows in the data table.

  1. Select File > Save as > Library Item.

    Response: The Save as Library Item dialog is opened.

    Comment: The path in the upper part of the dialog shows your current location in the folder structure of the library.

  2. Navigate to the folder where you want to save the analysis file.
    Comment: Double-click on a folder to open it, double-click on the uppermost folder with two dots next to it to move up in the folder structure, or click on the New Folder button to create a new folder to save your analysis file in.

  3. Specify a Name for the analysis file.

  4. Optionally, click Folder Permissions... to review or change the permissions for the selected library folder.

  5. If you want to keep the current data loading settings, go to step 8. If you want to see the current settings, click Review or edit settings.

    Comment: Depending on whether you want data to be updated from a linked source each time you open the analysis, or, whether you want to store a fixed version of the data in the analysis, you might want to change the data loading settings for a data table or a part of a data table. See Embedded or Linked Data? for more information.

  6. In the Data Loading Settings dialog, review the settings for all data tables in the analysis. You can click on the plus or minus sign for a data table to expand or collapse the data table and show or hide details about the various sources that were used to build the data table. Click on the drop-down list to change the data loading setting for a particular source. For example, if you want as much data as possible to be stored in the analysis, use the Change all applicable data sources to drop-down list and select Stored data.

    Comment: If the final data table is embedded, then you will not be able to change any data loading settings for specific sources.

  7. Click OK in the Data Loading Settings dialog.

  8. In the Save as Library Item dialog, click Next >.

  9. Optionally, type a Description for the analysis file.

  10. Optionally, type one or more Keywords specific to the content of the analysis.

    Comment: Keywords are separated by a semicolon, i.e., if you write "primary screening;quality" this will be two keywords, "primary screening" and "quality". Keywords are used to enhance organization and search capabilities.

  11. Click Finish.

    Response: The document is published and the confirmation dialog for the wizard is opened.

  12. Click Close.

Tip: Right-click in the library tree to display a pop-up menu where you can delete or edit the properties of previously added files and folders.

It is also possible to delete and edit files in the library via the Library Administration tool. You do not have to be  a member of the Library Administrator group to use the tool. To get access to the Library Administration tool the license called TIBCO Spotfire Administrator, as well as the license feature Library Administration below it, must be enabled.

To save a copy of an analysis in the library:

If you want to save a backup copy of the analysis you are working on, without modifying the original file, you can use the Save Copy As option instead.

  1. Select File > Save copy as > Library Item.

    Response: The Save Copy as Library Item dialog is opened.

  2. Navigate to the folder where you want to save the copy of the analysis.

  3. Specify a Name for the analysis file.

  4. Optionally, click Folder Permissions... to review or change the permissions for the selected library folder.

  5. If you want to keep the current data loading settings, go to step 8. If you want to review or change the settings, click Review or edit settings.

    Comment: Depending on whether you want data to be updated from a linked source each time you open the analysis, or, whether you want to store a fixed version of the data in the analysis, you might want to change the data loading settings for a data table or a part of a data table. See Embedded or Linked Data? for more information.

  6. In the Data Loading Settings dialog, review the settings for all data tables in the analysis. You can click on the plus or minus sign for a data table to expand or collapse the data table and show or hide details about the various sources that were used to build the data table. Click on the drop-down list to change the data loading setting for a particular source. For example, if you want as much data as possible to be stored in the analysis, use the Change all applicable data sources to drop-down list and select Stored data.

  7. Click OK in the Data Loading Settings dialog.

  8. In the Save as Library Item dialog, click Next >.

  9. Optionally, type a Description for the analysis file.

  10. Optionally, type one or more Keywords specific to the content of the analysis.

  11. Click Finish.

    Response: The copy is published and the confirmation dialog for the wizard is opened. Note that you will continue to have the original analysis open and any further changes will be made to that analysis and not to your copy.

  12. Click Close.

Tip: If you are an administrator, you may want to configure scheduled updates to specify that the data for an analysis should be updated and pre-loaded at a certain time. This may improve the loading time for an analysis. This is only applicable when a TIBCO Spotfire Server Web Player Service node has access to the library where you are publishing the analysis. See TIBCO Spotfire® Server and Environment Installation and Administration manual for more information about scheduled updates.

See also:

Save as Library Item - Step 1

Save as Library Item - Step 2

Save as Library Item - Published

What are Tags?