<?xml version="1.0"?>
<?xml-stylesheet type="text/xsl" href="AviXUserMan.xsl"?>

<chapter>
	<maintable>
	
	<ChapterName>Folder structure  </ChapterName> 

	<paragraph>Even though it might not seem necessary initially, 
	it’s a good idea to assign an external hard drive or a server area on your 
	local network where all AVIX data can be saved and stored.<br/><br/>

	<note>It’s not recommended to save data on the local hard drive (c:\), 
	because it will only be accessible from that specific computer and might also not be included in backup routines.</note>
	</paragraph>
	
	<paragraph>Create a pre-defined folder structure for all users, for example the following:<br/><br/>
	
	<picture>
	<file>FolderStructure-.png</file>
	</picture></paragraph>
	
	<paragraph>Each AVIX document (containing analysis data) is saved in the folder ”Analysis”, 
	and the corresponding movie is saved in the folder “Movies” and is named according to your routine.</paragraph>

	<paragraph>Define internal routines how to name:</paragraph>

	<paragraph>Movies should be named according to e.g. <br/><italic>Product 1 Model A date Movie 1 of 2.MP4</italic></paragraph>

	<paragraph>Documents/pictures should be named according to e.g.<br/><italic>Product 1 Model A date.JPEG</italic><br/><br/>

	<note>If the movie files are not saved and named in an organized and standardized way, 
	the data material will soon become difficult to handle, and it will be difficult to find the right movie or picture.</note>
	</paragraph>
	
	<ChapterName>Document default path </ChapterName>
	
	<Title>Document default path for movies, pictures and documents</Title>

	<paragraph>This is how you set the document default path. <br/>Click the menu <br/>	&#160; &#160; &#160; 
	<bold>Window &#129138; Preferences</bold>  <br/>then expand <br/>	&#160; &#160; &#160; <bold>AVIX preferences</bold> 
	by clicking the > angle bracket<br/>then select<br/>	&#160; &#160; &#160; <bold>Document default path</bold> <br/>
	Click the <br/> &#160; &#160; &#160; <bold>New</bold> button and navigate to the correct folder.<br/></paragraph>
	
	<paragraph>When e.g. a movie file is selected on a task, AVIX looks at the movie's absolute/complete/full path. 
	If the beginning of that path matches one of the configured document default paths, 
	that part is removed from the movie's absolute/complete/full path and the remaining (relative/incomplete) path to the movie on that task will be stored.</paragraph>

	<Title>Example</Title>
	
	<paragraph>You have a network drive mapped to <bold>Z:\</bold>. In that network drive, you have the folders <bold>AVIX\movies</bold> 
	which contain a movie named <bold>Assemble.mp4</bold>.</paragraph>
	
	<paragraph> &#160; <u><bold>Case 1</bold></u></paragraph>
	
	<paragraph>In AVIX, you create a task and in that task, you want to add that movie so you click <bold>Select...</bold> and navigate to 	<br />
	<bold>Z:\AVIX\movies\Assemble.mp4</bold></paragraph>

	<paragraph>Now the movie path field will contain an absolute/complete/full path to that movie. <br /><bold>Z:\AVIX\movies\Assemble.mp4</bold><br />
	<br />
	An absolute/full/complete path, is a path that starts with either the drive letter or "\\" like in a network path, and ends with the filename. <br/>
	For example, <bold>Z:\AVIX\movies\Assemble.mp4</bold> is an absolute/full/complete path.<br/>
	\\server-01\share-folder\AVIX\movies\Assemble.mp4 is also an absolute/full/complete path.<br/>
	<br/>
	In contrast, a relative/incomplete path is a path that does not specify the drive or root folder.<br/>
	For example, <bold>movies\Assemble.mp4</bold> is a relative or incomplete path because it does not have a 
	drive letter and does not start from the root directory. It has the beginning <bold>Z:\AVIX\</bold> cut off .
	
	<note>It is important to note that AVIX adds the folder of the current AVIX file to the list of Document default paths. 
	This affects the relative/incomplete path of videos that are located in the same folder as the current AVIX file. 
	So if you move the AVIX file and do not at the same time move the videos that are in the same folder, the links to the videos will not work.</note>
	</paragraph>
	<paragraph> &#160; <u><bold>Case 2</bold></u></paragraph>
	
	<paragraph>In AVIX Preferences you set the Document default paths to<br /><bold>Z:\AVIX\</bold><br />
	Then you create a task and in that task, you want to add the movie, so you click Select... and navigate to <br />
	<bold>Z:\AVIX\movies\Assemble.mp4</bold><br /><br />Now the preferences Document default paths will contain<br /><bold>Z:\AVIX\</bold><br />
	and the movie path field will contain (the relative/incomplete path)<br /><bold>movies\Assemble.mp4</bold><br />	
	These together will constitute the complete/absolute/full path<br /><bold>Z:\AVIX\movies\Assemble.mp4</bold></paragraph>
	
	<paragraph>When AVIX tries to open a file, it concatenates the relative/incomplete file path with the document default path into an 
		absolute/complete/full path and checks if a file with such a complete path exists. If it doesn't, AVIX continues with the next 
		configured document default path and tries again. When AVIX has found a combination of a document default path and 
		relative/incomplete file path that creates a valid complete path, that path is selected for "opening".</paragraph>
	
	<paragraph>Note that if your drive letter changes, then the files that have paths that begin with that (old) drive letter, 
		will not work. But if you used <bold>Document default paths</bold>, you could easily change it to match the new drive letter. 
		The same is true if  the folder that contains the files are moved around on the network. If you use <bold>Document default paths</bold> 
		you can easily change it to match the change.</paragraph>
	
	<paragraph>Under the menu <bold>Tools &#129138; Manage linked documents</bold>, there is a tool for managing the paths of documents, 
	which can convert all relative paths to absolute paths and back. It also lists all paths and marks whether they work or not. </paragraph>

	</maintable>
	<endtable><firstlink> <linkw><address>AviXUserMan-Filehandling.php</address><text>Previous page</text></linkw></firstlink>
		  <indexlink> <linkw><address>AviXUserMan-index.php</address    ><text>Index</text        ></linkw></indexlink><secondlink><linkw><address>AviXUserMan-UpdatingPathToMovieFile.php</address        ><text>Next page</text    ></linkw></secondlink></endtable>
</chapter>
	