Difference between revisions of "SmartFileRetriever"

From SmartWiki
Jump to: navigation, search
(updating categories)
 
(10 intermediate revisions by 2 users not shown)
Line 1: Line 1:
The UTA Browser is standalone tool that will allow you to '''download to your desktop''' the files that are stored in [[Custom Field Type: Link – Single File|Single File]] or [[Custom Field Type: Link – Multiple Files|Multiple Files]] custom fields at Level 1 within your [[SmartSimple]] [[Universal Tracking Application]].
+
The '''SmartFileRetriever''' (formerly called the UTA Browser) is a stand-alone tool that will allow you to '''download to your desktop''' the files that are stored in [[Custom Field Type: Link – Single File|Single File]] or [[Custom Field Type: Link – Multiple Files|Multiple Files]] custom fields at {{l1}} within your SmartSimple [[Universal Tracking Application]].
  
  If you wish to have access to this application please contact [[SmartSimple]] support.
+
  If you wish to have access to this application please contact [[:Category:Help Desk|SmartSimple support]].
  
  
 
==Instructions==
 
==Instructions==
* Install the '''UTA Browser''' application, following the instructions that came with the tool.
+
* Install the '''SmartFileRetriever''' application, following the instructions that came with the tool.
 
* Open the '''UTA Browser''' from your Programs menu.
 
* Open the '''UTA Browser''' from your Programs menu.
 
:''If you are logged into SmartSimple via a web browser you should log out.''
 
:''If you are logged into SmartSimple via a web browser you should log out.''
Line 13: Line 13:
  
 
* Click '''Login.'''<br />
 
* Click '''Login.'''<br />
:''Once the UTA Browser has authenticated with [[SmartSimple]] the Application pull-down list will populate with a list of the UTAs in your [[SmartSimple]] instance, and the "Launch" and "Download" buttons will become active.''
+
:''Once the Smart File Retriever has authenticated with [[SmartSimple]] the Application pull-down list will populate with a list of the UTAs in your [[SmartSimple]] instance, and the "Launch" and "Download" buttons will become active.''
  
  
 
* Select the desired UTA from the Applications list and click '''Launch'''. After a few seconds you will be presented with the Level 1 interface for your UTA.  
 
* Select the desired UTA from the Applications list and click '''Launch'''. After a few seconds you will be presented with the Level 1 interface for your UTA.  
* Using the filter options on the right-hand side of the '''UTA Browser''' window you should now filter the records as desired. If you wish to download the files stored in [[Custom Field Type: Link – Single File|Single File]] or [[Custom Field Type: Link – Multiple Files|Multiple Files]] fields for '''all''' records you should select "Show All Level 1 Items" and ensure that all Statuses are selected. Then click on the '''Search''' button:
+
* Using the filter options on the right-hand side of the '''SmartFileRetriever''' window you should now filter the records as desired. ''(Click "Show Search" if you do not see the search panel on the right).'' If you wish to download the files stored in [[Custom Field Type: Link – Single File|Single File]] or [[Custom Field Type: Link – Multiple Files|Multiple Files]] fields for '''all''' records you should select "Show All Level 1 Items" and ensure that all Statuses are selected. Then click on the '''Search''' button:
 
::[[Image:UTABrowser2.PNG]]
 
::[[Image:UTABrowser2.PNG]]
  
Line 29: Line 29:
 
:''Selecting all may take a few moments if there are a large number of records.''
 
:''Selecting all may take a few moments if there are a large number of records.''
  
:''If you do not see the check boxes in the first column of the Level 1 list view you will need to close the '''UTA Browser''', open your UTA via a Web Browser, go to Settings >> Application Configuration and check to '''Enable Calendar''' in the Level 1 Settings section.  
+
:''If you do not see the check boxes in the first column of the Level 1 list view you will need to close the '''SmartFileRetriever''', open your UTA via a Web Browser, go to Settings >> [[UTA Settings - Entity|Entity tab]] and check to '''Enable Calendar''' in the Level 1 Settings section.  
 
   
 
   
 
* Once all the desired records have been selected click on the '''Next''' button in the lower left-hand corner of the screen:
 
* Once all the desired records have been selected click on the '''Next''' button in the lower left-hand corner of the screen:
Line 42: Line 42:
 
* You will be asked to choose a location to download the files. Select a folder on your local machine and click '''OK'''.
 
* You will be asked to choose a location to download the files. Select a folder on your local machine and click '''OK'''.
 
:''If the file download does not start automatically, please click the '''Download''' button on the toolbar.''
 
:''If the file download does not start automatically, please click the '''Download''' button on the toolbar.''
* A window will appear to indicate the progress of the download.
+
* A window will appear to indicate the progress of the download. Any errors will be reported in this window.
* The '''UTA Browser''' window will also show the total number of "Records", "Fields", "Files" and the "Total Size" of the download.
+
* The '''SmartFileRetriever''' window will also show the total number of "Records", "Fields", "Files" and the "Total Size" of the download.
  
  
Line 49: Line 49:
 
Within the folder you selected for the download you will find the following:
 
Within the folder you selected for the download you will find the following:
 
* A folder will have been created for each Level 1 record. The folder will be given the same name as the Level 1 record.<br />
 
* A folder will have been created for each Level 1 record. The folder will be given the same name as the Level 1 record.<br />
::''If no files were present in any of the selected fields for a given record, no folder will be created for that record.''
+
::-''If no files were present in any of the selected fields for a given record, no folder will be created for that record.''
 +
::-''If you have not used the Level 1 Standard Field "Application Name", the folders will be named with the Tracking ID of the record.
 
* Within each Level 1 record folder you will find folder(s) with the same name as the [[Custom Field Type: Link – Single File|Single File]] or [[Custom Field Type: Link – Multiple Files|Multiple Files]] Custom Fields that you selected to be downloaded.
 
* Within each Level 1 record folder you will find folder(s) with the same name as the [[Custom Field Type: Link – Single File|Single File]] or [[Custom Field Type: Link – Multiple Files|Multiple Files]] Custom Fields that you selected to be downloaded.
::''Again, if no files were present in a given field for the record, no folder will be created for that field.''
+
::''If no files were present in a given field for that record, no folder will be created for that field.''
 
* Within each of the folders you will find the files that were stored within the relevant [[SmartSimple]] Custom Fields.
 
* Within each of the folders you will find the files that were stored within the relevant [[SmartSimple]] Custom Fields.
  
  
 
+
[[Category:Integration]]
[[Category:Applications]][[Category:Universal Tracking Application]]
+
[[Category:Desktop Plugins]]

Latest revision as of 15:09, 20 July 2017

The SmartFileRetriever (formerly called the UTA Browser) is a stand-alone tool that will allow you to download to your desktop the files that are stored in Single File or Multiple Files custom fields at Level 1 within your SmartSimple Universal Tracking Application.

If you wish to have access to this application please contact SmartSimple support.


Instructions

  • Install the SmartFileRetriever application, following the instructions that came with the tool.
  • Open the UTA Browser from your Programs menu.
If you are logged into SmartSimple via a web browser you should log out.
  • Enter your SmartSimple Server URL, Alias, User Name and Password:

UTABrowser1.PNG

  • Click to Enable SSL if you wish to encrypt the connection to SmartSimple.
  • Click Login.
Once the Smart File Retriever has authenticated with SmartSimple the Application pull-down list will populate with a list of the UTAs in your SmartSimple instance, and the "Launch" and "Download" buttons will become active.


  • Select the desired UTA from the Applications list and click Launch. After a few seconds you will be presented with the Level 1 interface for your UTA.
  • Using the filter options on the right-hand side of the SmartFileRetriever window you should now filter the records as desired. (Click "Show Search" if you do not see the search panel on the right). If you wish to download the files stored in Single File or Multiple Files fields for all records you should select "Show All Level 1 Items" and ensure that all Statuses are selected. Then click on the Search button:
UTABrowser2.PNG


  • Important: if you have more than one page of records be sure to click on the Show All button in the upper-right corner of the screen before proceeding to the next step:
UTABrowser3.PNG


  • You should now click on the check-box in the upper left corner of the screen in order to select all records, or if you want a sub-set of the records displayed you can manually select individual records:
UTABrowser4.PNG
Selecting all may take a few moments if there are a large number of records.
If you do not see the check boxes in the first column of the Level 1 list view you will need to close the SmartFileRetriever, open your UTA via a Web Browser, go to Settings >> Entity tab and check to Enable Calendar in the Level 1 Settings section.
  • Once all the desired records have been selected click on the Next button in the lower left-hand corner of the screen:
UTABrowser5.PNG


  • The following page will tell you how many records you have selected, and will provide a list of all the Single File and Multiple Files custom fields available at Level 1.
  • If you wish to download the files stored in all the fields listed click the check box at the top of the list. Otherwise select the subset of fields you wish.
UTABrowser6.PNG
  • Click Next
  • You will be asked to choose a location to download the files. Select a folder on your local machine and click OK.
If the file download does not start automatically, please click the Download button on the toolbar.
  • A window will appear to indicate the progress of the download. Any errors will be reported in this window.
  • The SmartFileRetriever window will also show the total number of "Records", "Fields", "Files" and the "Total Size" of the download.


Results

Within the folder you selected for the download you will find the following:

  • A folder will have been created for each Level 1 record. The folder will be given the same name as the Level 1 record.
-If no files were present in any of the selected fields for a given record, no folder will be created for that record.
-If you have not used the Level 1 Standard Field "Application Name", the folders will be named with the Tracking ID of the record.
  • Within each Level 1 record folder you will find folder(s) with the same name as the Single File or Multiple Files Custom Fields that you selected to be downloaded.
If no files were present in a given field for that record, no folder will be created for that field.
  • Within each of the folders you will find the files that were stored within the relevant SmartSimple Custom Fields.