Benutzerspezifische Werkzeuge
Sie sind hier: Startseite Produkte Import File Uploader Help

Help

— abgelegt unter:

This document contains the online help of the Import File Uploader Version 0.2.
It directs to users of the Import File Uploader.
How to install and set up the Import File Uploader is described in the Documentation.


Content of this document:
1. What is the Import File Uploader good for?
2. How to...
2.1. How to upload files
2.2. How to rename files on the server
2.3. How to edit comments
2.4. How to delete files on the server
3. Errors
4. Risks by using the Import File Uploader


1. What is the Import File Uploader good for?

The Import File Uploader is an extension of ZOPE for ZOPE Managers (users, editing ZOPE objects) without access to the file system of the server. These people might faced with the following problem:
You want edit a group of ZOPE objects offline (because you are not always online). - Seems to be no problem: Exporting the folder containing the objects using the import/export button in the ZOPE manage interface to a file in your computer. Go offline. Importing the file in your standalone installation of ZOPE on your computer. Edit the objects as you please. When finished, export the folder containing the objects again to another file. Go online. And now? How to get the file into the import directory on the server for importing it there? - You could be lucky by using the Import File Uploader: Upload the file. Rename your original folder and import the file. When it's working all right so far delete the renamed original folder.

Attention: The use of the Import File Uploader is not free of risks! - See chapter 4. Risks by using the Import File Uploader

up to content


2. How to...

The following sub-chapters containing step-by-step guides for the main user activities while using the Import File Uploader.

2.1. How to upload files

  • Start at the main page of the Import File Uploader using the form at the end of the page.
  • Select a File on your computer using the search button.
  • Optional: Enter a File Name on Server. The uploaded file will be saved using this name in the import directory of the ZOPE installation on the server. If none given, the name of the selected file is used.
  • Optional: Enter a Comment. This comment will be shown in the Uploaded Files table below the corresponding file name.
    It's only for your comfort and not saved in the file system.
  • Press the Upload File Button and have some patience - the file is on its way. Depending on file size and bandwidth of your connection it may take a while.
  • The main page of the Import File Uploader will be shown again either showing a success message and the uploaded file in the Uploaded Files table or showing an error message.

up to content

2.2. How to rename files on the server

  • Start at the main page of the Import File Uploader using the Uploaded Files table.
  • Select files to be renamed in the Uploaded Files table by marking the checkboxes left to the file names.
  • Press the Rename button below the Uploaded Files table.
  • Another page appears. This page contains a table similar to the Uploaded Files table on the main page of the Import File Uploader. This table contains only the previously selected files.
  • Edit the file names as you please. (Keep the operating system depending restrictions for file names in mind!)
  • Press the Rename button below the table to bring your modifications in effect.
  • The main page of the Import File Uploader will be shown again either showing a success message and the files with the new names in the Uploaded Files table or showing an error message.

 

up to content

2.3. How to edit comments

  • Start at the main page of the Import File Uploader using the Uploaded Files table.
  • Select files you want edit the comments in the Uploaded Files table by marking the checkboxes left to the file names.
  • Press the Edit Comments button below the Uploaded Files table.
  • Another page appears. This page contains a table similar to the Uploaded Files table on the main page of the Import File Uploader. This table contains only the previously selected files.
  • Edit the comments as you please. (Keep in mind: only plain text.)
  • Press the Ok button below the table to bring your modifications in effect.
  • The main page of the Import File Uploader will be shown again either showing a success message and the files with the new comments in the Uploaded Files table or showing an error message.

up to content

2.4. How to delete files on the server

  • Start at the main page of the Import File Uploader using the Uploaded Files table.
  • Select files to be deleted in the Uploaded Files table by marking the checkboxes left to the file names.
  • Press the Delete button below the Uploaded Files table.
  • Another page appears. This page contains a table similar to the Uploaded Files table on the main page of the Import File Uploader. This table contains only the previously selected files.
  • Press the Delete Files irrecoverable button below the table to push the files into the nirvana.
  • The main page of the Import File Uploader will be shown again either showing a success message without the files in the Uploaded Files table or showing an error message.
  • up to content


    3. Errors

    I tried to encapsulate all possible errors well. So you should never be faced with internal server errors. However, if this happens send me an email: cdlfj@jagusch-online.de - thanks.
    All success and error messages are shown in a special box above the Uploaded Files table on the main page of the Import File Uploader. The following list contains all error messages and tries to explain their meaning:

    • Error: Not all files successfully renamed! May be a file with the new name already exists (may be invisible to you, because it belongs to another user). Choose another filename.
      There are tree possible reasons for this error:
      • You see in the Uploaded Files table at the main page of the Import File Uploader only the files you uploaded (due to your login). So a renaming conflict might happen. - Choose another filename and try again.
      • You tried to rename more than one file and at least one of the new names equals one of the old names. So a renaming conflict might happen due to the order of the single renaming actions. - Divide the renaming process into single renaming actions.
      • You choose a filename violating the operating system depending restrictions for filenames on the server. - Choose another filename and try again.
    • Error: File 'filename' not uploaded! File 'filename' already exists (may be invisible to you, because it belongs to an other user). Delete file 'filename' first or choose another filename.
      There are two possible reasons for this error:
      • You see in the Uploaded Files table at the main page of the Import File Uploader only the files you uploaded (due to your login). So a naming conflict might happen. - Choose another filename and try again.
      • You choose a filename violating the operating system depending restrictions for filenames on the server. - Choose another filename and try again.
    • Error: File not uploaded! No file specified, but there must be one.
      No real error. Rather the result of improper use: You pressed the Upload File button without previously specifying a file.
    • Aborted by user - no files renamed.
      No real error. Rather the success message for pressing the Cancel button while renaming files.
    • Aborted by user - no comments changed.
      No real error. Rather the success message for pressing the Cancel button while editing comments.
    • Aborted by user - no files deleted.
      No real error. Rather the success message for pressing the Cancel button while deleting files.
    • No files selected. Select one or more files by clicking the checkboxes.
      No real error. Rather the result of improper use: Your pressed one of the Rename, Edit Comment or Delete buttons without previously selecting files.
    • Internal error: No valid action in manage_rename - abnormal use of this script!
      This error message you should never see. It appears when the python script manage_rename is called with improper arguments.
    • Internal error: No valid action in manage_comments - abnormal use of this script!
      This error message you should never see. It appears when the python script manage_comments is called with improper arguments.
    • Internal error: No valid action in manage_delete - abnormal use of this script!
      This error message you should never see. It appears when the python script manage_delete is called with improper arguments.
    • Internal error: Incomplete parameters in method saveFile.
      This error message you should never see. It appears when the external python script saveFile is called with improper arguments.
    • Internal error while saving file in method saveFile.
      This error message you should never see. It appears due to a bug or improper installation of the Import File Uploader or improper modifications in the file system of the server (lack of rights to create and write a file).
    • Internal error: Incomplete parameters in method syncronize.
      This error message you should never see. It appears when the external python script syncronize is called with improper arguments.
    • Internal error while creating dtml-objects in method syncronize.
      This error message you should never see. It appears due to a bug or lack of space in the ZOPE object database.
    • Internal error while updating dtml-objects in method syncronize.
      This error message you should never see. It appears due to a bug or lack of space in the ZOPE object database.
    • Internal error while deleting dtml-objects in method syncronize.
      This error message you should never see. It appears due to a bug or lack of space in the ZOPE object database.
    • Error while deleting file 'filename'.
      This error message you should never see. It appears due to a bug or improper installation of the Import File Uploader or improper modifications in the file system of the server (lack of rights to delete a file).
    • Internal error: Incomplete parameters in method renameFile.
      This error message you should never see. It appears when the external python script renameFile is called with improper arguments.
    • Error while renaming file 'oldfilename' to 'newfilename'.
      This error message you should never see. It appears due to a bug or improper installation of the Import File Uploader or improper modifications in the file system of the server (lack of rights to delete a file).

    up to content


    4. Risks by using the Import File Uploader

    The improper use of the Import File Uploader causes some serious risks. These risks (by the point of view of the user of the Import File Uploader) are described below. Further (internal) risks are discussed in the Documentation.

    • Due to the handling with files there is no undo function within the Import File Uploader. - Mind your steps!
    • The usage of the Import File Uploader as described in chapter 1. What is the Import File Uploader good for? don't cares for any version conflicts. Any changes done on the ZOPE objects on your server in between export them first and import the file with your edited objects are lost and gone for ever! That's why the offline editing of ZOPE objects is only practical for static content and single editors.
    • When you do the last steps as described in chapter 1. What is the Import File Uploader good for? your ZOPE objects are not available for other users in between renaming your old folder and importing the uploaded file.
      You may reduce this problem by using following work around: Rename the folder on your standalone ZOPE. Export the renamed folder. Upload the file containing the renamed folder to your server using the Import File Uploader. Import it into ZOPE on your server. Write a short script for renaming your original folder to another name and your imported (new) folder to the original name. Run these script and your ZOPE objects are only for some milliseconds not available.
    • A file uploaded by one user can get imported into ZOPE by any ZOPE user having the Import/Export objects permission (usually included in the Manager role).
      You may reduce this risk only by deleting your uploaded files on your server as soon as possible after importing them into ZOPE on your server.

     

    up to content


    © by Frank Jagusch

    Artikelaktionen