# [LON-CAPA-cvs] cvs: loncom /html/adm/help/tex Portfolio_About.tex Portfolio_AddFiles.tex Portfolio_ChangeDirectory.tex Portfolio_CreateDirectory.tex Portfolio_DeleteFile.tex Portfolio_FileList.tex Portfolio_OpenFile.tex Portfolio_RenameFile.tex Portfolio_ShareFile.tex Portfolio_ShareFile_ChangeSetting.tex Portfolio_ShareFile_SetAccess.tex Portfolio_ShareFile_StopAccess.tex

rezaferry lon-capa-cvs@mail.lon-capa.org
Tue, 31 Oct 2006 19:22:22 -0000

This is a MIME encoded message

--rezaferry1162322542
Content-Type: text/plain

rezaferry		Tue Oct 31 14:22:22 2006 EDT

Portfolio_ChangeDirectory.tex
Portfolio_CreateDirectory.tex
Portfolio_DeleteFile.tex
Portfolio_FileList.tex
Portfolio_OpenFile.tex
Portfolio_RenameFile.tex
Portfolio_ShareFile.tex
Portfolio_ShareFile_ChangeSetting.tex
Portfolio_ShareFile_SetAccess.tex
Portfolio_ShareFile_StopAccess.tex
Log:
10/31/2006 Added the tex file for help

--rezaferry1162322542
Content-Type: text/plain
Content-Disposition: attachment; filename="rezaferry-20061031142222.txt"

The portfolio \index{portfolio} allows you to store and retrieve files. There are two main purpose of using a portfolio; to upload documents that could then be submitted in response to an essay/drop box/task and to upload documents that can be shared.  By storing in the portfolio space of lon-capa you can access these files from any location with an internet/web connection.

Every student user on the LON-CAPA system has a quota of 20 MB of portfolio space. Each file the student add reduces the quota. However, portfolio submitted files can be modified by the grader and then  uploaded back to the student, this will apear as a new 'version' of the file for the student but does not count against their quota.

To use the portfolio to store files you must first create directories (\ref{Portfolio_CreateDirectory}) and subdirectories. After creating the directory that you need to enter the directory (\ref{Portfolio_ChangeDirectory}) and upload the file (\ref{Portfolio_AddFiles}) to the current directory.

To use the portfolio to retrieve file, find the directory that contains the file then click on the file name (\ref{Portfolio_OpenFile}). The file that you wanted will be downloaded to your computer.

You can also share your files by changing the file permissions (\ref{Portfolio_ShareFile}). You can also find/read other people's shared files by typing going to the other person's about me page (http://server/adm/domain/user/aboutme/portfolio).

Also see:
\textbf{Deleting File} (\ref{Portfolio_DeleteFile}), \textbf{Renaming File} (\ref{Portfolio_RenameFile}), and \textbf{The file list} (\ref{Portfolio_FileList}).

To add files first make sure that you are in the correct directory (\ref{Portfolio_CreateDirectory}, \ref{Portfolio_ChangeDirectory}). The current directory you are in is shown above the list of files. The current directory indicator starts with the text portfolio and is a link. Click on the directory name that you want to enter the directory.

Once you are in the correct directory upload the file that you want by:

\begin{enumerate}
\item Click on \fbox{browse} to find the file from your local filesystem that you wish to upload to the portfolio space. You can only upload files, you cannot upload whole folders.
\item When the file is uploaded (it may take a while if the file is large) a screen will show up that says done. Click on that link and you will be taken back to the portfolio screen.
\end{enumerate}

\label{Portfolio_ChangeDirectory}

The current directory you are in is shown before the file list. The complete path to the directory is also shown, starting with the root directory 'Portfolio\'. You can click on any of the directories shown on the path to move to a particular directory. If you need to enter a subdirectory, click on the directory name on the file list.

\label{Portfolio_CreateDirectory}

The portfolio can be organized by using directories and subdirectories. To create a subdirectory first make sure that you are in the correct directory. The current directory you are in is shown above the list of files. The current directory indicator starts with the text portfolio/ and is a link. Click on the directory name that you want to enter the directory.

Once you are in the correct directory:
\begin{enumerate}
\item Write the name of the new subdirectory in the input box 'Create subdirectory in current directory:'.
\item Press \fbox{create subdirectory}
\item A new subdirectory is created. If the name you submit has illegal characters (such as spaces), the illegal characters will be replaced by the underline character '\_'.
\item Press done
\end{enumerate}

Creating a subdirectory does not put you inside the directory. If you wish to enter the directory you must click the directory name you have just created (\ref{Portfolio_ChangeDirectory}).

\label{Portfolio_DeleteFile}

The portfolio allows you to delete some files. Not all files can be deleted. Specifically locked files (files that have been handed in as solutions to a problem) cannot be deleted. Subdirectories cannot be deleted. To delete one or more files:

\begin{enumerate}
\item Check on the checkboxes next to the filenames you wish to delete.
\item Once all files in the directory are checked click on \fbox{delete checked files}.
\item A confirmation screen will appear. Make sure that the filenames are correct. Press continue to delete the file, and cancel to cancel the deletion of the file.
\end{enumerate}

File deletion cannot be undone

\label{Portfolio_FileList}

The file list shows all files and sub-directories contained within this directory. Clicking on a file will open that file. Clicking on a directory will take you inside the directory.

The file list also has various action icons. The meaning of each of these icons are:
\begin{itemize}
\item folder image: This denotes that the name correspond to a directory.
\item locked: If you have submitted a file for a problem, you cannot delete this file
\item checkbox: Check this box and the delete button to delete a files
\end{itemize}

\label{Portfolio_OpenFile}

To open a file, click on the file name on the file list. If you cannot see your file, you may be in the wrong directory, try changing directories.

\label{Portfolio_RenameFile}

You can only rename unlocked files. Click on the \underline{rename} link on the file you wish to rename. The screen will change to a screen with an input box. Type in the new filename in the input box (be sure to write the extension - which is used by the operating system (MS Windows, among others) how to open the file). Press \fbox{continue} if you wish to rename the file. If you do not want to change the file name, press \fbox{Cancel}.

Invalid characters will be replaced by the character '\_'.

\label{Portfolio_ShareFile}

You can allow other people to see/download your file. This is done by setting the access status of the various file. The access status of the file can be changed for both locked and unlocked files. There are 3 different status

Password protected access: To see/download your file, a person must enter the password that you have set.

To change the status of a file, click on the  \underline{view/change status} link after the file name.

\label{Portfolio_ShareFile_ChangeSetting}

\textbf{Changing share settings}
If you have previously set a file to be publicly accessible and you wish to change the settings:
\begin{enumerate}
\item Change the beginning/end date of the file
\item Check on update checkbox
\item press \fbox{Proceed} to update your settings
\end{enumerate}

\label{Portfolio_ShareFile_SetAccess}

%\textbf{Setting public access/ password protected access}

You can set the public/password protected access by:
\begin{enumerate}
\item  setting the starting date and the ending date of when your file is to be publicly accessible. The ending date must be after the starting date.
\item If you wish to have the file public/password protected forever, click on \fbox{no end date}.
\item For password protected access, you must write a password. You can then give the password to anyone who you wish to share your files with
\item Click on the activate check box
\item press \fbox{Proceed} to make your files publicly available.
\end{enumerate}

The URL where this file can be accessed will be given to you. Copy this URL and give the URL to people you wish to share your files with