In order to open a file from RayFlow, the following prerequisites have to be carried out first.
1.RayFlow instance has been configured in profile settings
2.User has signed-in and selected a RayFlow project
In Order to Open a Package From RayFlow
1.Press FILE button to show the backstage menu.
2.Click on menu item OPEN.
3.In the section From RayFlow, select RayFlowTask.
|
Note: When this option is selected before signing-in, it will as for RayFlow credentials. |
4.A new overlay window will be shown, prompting to select RayFlow phase, task, and a file belonging to a task.
5.Select RayFlow phase which contains the task that should be opened. The counter above the list shows the total number of phases that are visible to the current RayFlow user.
6.Click Continue with this phase... to proceed to the task selection with the currently selected phase. Press Cancel to go back to the backstage menu.
7.Next, select the task that should be opened.
The number displayed above the list shows the total number of tasks that are visible to the current RayFlow user. The results can be narrowed by ticking the only mine option, which hides all packages not belonging to the current RayFlow user. The task browser displays the first 5 data fields from RayFlow to enable easier identification (refer to the RayFlow documentation about setting up the data fields).
8.The results can also be narrowed by searching, using the search box in the top right corner of the list.
9.Once the required task is selected, press Continue with this task... to proceed to the file selection. Press Cancel to go to the backstage menu. In order to go back to the phases view, click the arrow on the left side of the list or the partially transparent area containing the tiles representing available phases.
10.On the next screen, select the file to open.
11.The number displayed in the top left corner represents the number of files that are present in the currently selected package.
oThe type column represents the source from which the file can be accessed. Possible values are Attachment (file has been physically uploaded to RayFlow) and Link (the package is available on a shared location and only the path to the root file is saved in RayFlow).
oDate and Uploaded by columns denote who and when has uploaded the file.
oThe list is sorted by the date, the most recent items are displayed on the top of the list.
oOnly the following file extensions are shown.
▪.msi
▪.mst
▪.rcp
▪.rpp
▪.zip (the file will be extracted, see section Handling Multiple and Supporting Files Within a Single Package)
▪.7z (the file will be extracted, see section Handling Multiple and Supporting Files Within a Single Package)
12.Press OK to open the selected file. Press Cancel to go back to the backstage. In order to change RayFlow task or phase, click the arrow on the left side of the list or the partially transparent area containing the list of tasks.
Storing RayFlow Files Locally
RayPack stores the downloaded RayFlow files in the following folder.
<RayPackProjectsFolder>\RayFlow\<TaskId>\<FileName>\
The four placeholders mean the following.
•The default folder for RayPack projects (configurable in Projects tab in RayPack Settings).
•A GUID of a task to which the package belongs to.
•A file name of the package (Keep in mind that all files in a single RayFlow task have unique names within the scope of a task).
When opening a project from RayFlow, RayPack checks this folder and if it is able to find any supporting file it will first ask whether to open a local copy or to download the file again, overriding any changes that might have been done since last download.
•Pressing OPEN LOCAL FILE opens the already existing file, preserving any changes since the last download.
•Pressing DOWNLOAD AGAIN downloads the file again. This option overrides all local changes.
|
Note: Once uploaded to RayFlow, files never change. Each time adjustments are made and uploaded back, the files receive new names ensuring they are unique in the scope of a single task. Thus, the option DOWNLOAD AGAIN does not have to be used, unless the user wants to discard any changes he made locally to the package. In order to get the latest version of the package file that might have been uploaded since, simply open the newest file from RayFlow. |
Handling Multiple and Supporting Files Within a Single Package
RayFlow stores multiple files (for example MSI and supporting files) as ZIP containers. When RayPack user requests such file, its content is extracted first. Then, the following may happen depending on the content.
1.If the compressed archive was already uploaded directly from RayPack , then the correct file will be automatically identified as an entry point and opened in PackDesigner.
2.Otherwise, RayPack tries to determine the entry point by looking for supported extension in the extracted folder. If exactly one is found, that file is opened in PackDesigner.
3.Otherwise if there is more than one supported file, RayPack looks for the file which has the same name as the name of the ZIP archive (less ZIP extension). If any is found, that file is opened in PackDesigner. Otherwise, RayPack shows a list of supported files and asks user which one should be opened in PackDesigner.
4.If no file could be found using methods described above, then the file will not be opened at all and RayPack will show a respective warning.
|
Note: Only ZIP and 7Z containers are supported by this functionality. Archives in other formats (for example .rar) have to be extracted manually. |
File Depots
The files are shown within the browser irregardless of RayFlow File Depot they come from (see chapter Using file depots for more information and requirements of this feature). Once the file is requested, RayPack downloads it transparently for every supported type of depot (local, WebDav, FTP) without any further user interaction. The file browser contains an extra column informing about source File Depot.