User Tools

Site Tools


addons:bulk_uploader:revolving_inventory

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Next revision
Previous revision
addons:bulk_uploader:revolving_inventory [2010/06/28 21:26]
matt created
addons:bulk_uploader:revolving_inventory [2016/03/07 23:20] (current)
geojames [Step 1]
Line 1: Line 1:
 =====Revolving Inventory Uploads===== =====Revolving Inventory Uploads=====
  
-**Important: This feature is both very powerful and very new. Be certain you have read the following documentation carefully before attempting to use it**.+**Important: This feature is very powerful. Be certain you have read the following documentation carefully before attempting to use it**.
  
  
Line 19: Line 19:
 {{:addons:bulk_uploader:bulk_uploader_v5_2.png|}} {{:addons:bulk_uploader:bulk_uploader_v5_2.png|}}
  
-To begin setting up a Revolving Inventory upload, select the box marked "Save this upload as Revolving Inventory?" This will cause the "Specify a label for this upload" text box to appear. In that box, enter a label for the Revolving Inventory session. The label you enter will be used in the filename of the source file created by the Revolving Inventory system. If the name you select is already in use, you will be prompted for another when you submit the form. Since the label is used directly in a created filename, it may consist only of Latin letters and numbers (a-z, 0-9), for security purposes.+To begin setting up a Revolving Inventory upload, select the box marked "Save this upload as Revolving Inventory?" This will cause the "Specify a label for this upload" text box to appear. In that box, enter a label for the Revolving Inventory session. The label you enter will be used in the directory name where the source file will be uploaded to for the Revolving Inventory system to check later. If the name you select is already in use, you will be prompted for another when you submit the form. Since the label is used directly in a created directoy, it may consist only of Latin letters and numbers (a-z, 0-9), for security purposes.
  
 +So if you set the name to "joesgmcdealership" that directory will be created on the server within following directory of your site:
 +
 +  /addons/bulk_uploader/uploads/revolving/
 +  
 +and that directory name will be:
 +
 +  /addons/bulk_uploader/uploads/revolving/joesgmcdealership/
 +  
 +So if there are no "structural changes" in the data or data file name submitted in the future you could give that specific client ftp access to that one directory to upload their own file to your site.  That way you would not need to do anything for that clients to update their own inventory.  Of course you can manually upload their file for them.  The choice is yours but the system allows for them to do it with the proper ftp rights.
  
 ====Step 2==== ====Step 2====
Line 32: Line 41:
 ====Step 4==== ====Step 4====
  
-If all goes well, the confirmation screen will show the filename of the newly-created source file for this Revolving Inventory session. Its name will be **_R_(label).csv**, where (label) is whatever label you assigned back in Step 1. The full path to that file on your server will also be shown. It is this file that you can make edits to, as described above, in order to manipulate the associated listings.+If all goes well, the confirmation screen will show the full path to the newly-created source file for this Revolving Inventory session. It is this file that you can make edits to, as described above, in order to manipulate the associated listings.
  
  
Line 40: Line 49:
  
 One thing to note is that the "Next run:" value shown on this page is the //soonest possible// time that each file will be updated. The actual update will not take place until the cron routine runs. When the cron runs, it looks for any Revolving Inventory uploads whose "Next run" date is past, and updates them. The main cron runs once a day, and can be configured via the //Site Setup > Cron Jobs// admin page. One thing to note is that the "Next run:" value shown on this page is the //soonest possible// time that each file will be updated. The actual update will not take place until the cron routine runs. When the cron runs, it looks for any Revolving Inventory uploads whose "Next run" date is past, and updates them. The main cron runs once a day, and can be configured via the //Site Setup > Cron Jobs// admin page.
 +
 +<tip c v>
 +Note:
 +Url's for listings added via the revolving upload feature will not change.
 +
 +You only want to change values in that revolving upload file that need to change.  If an item doesn't change leave it alone within that revolving upload file.  If a new item is added to that file the system will create a new listing for that item.  If an item is changed within that file the system will update that listing within the system.  If a listing was removed from that file that corresponding listing will be removed from the site.
 +
 +Now knowing the above:
 +
 +  - the listing id's for changed items will not change and neither will their urls
 +  - the listing id's for removed items will "expire" and linking to that url will not show that listing
 +  - the listing id's for new items will be added to the system with their own unique id's
 +
 +Do note that if a listing expires before the next "revolving upload" routine is run that listing will be created anew.</tip>
addons/bulk_uploader/revolving_inventory.1277760408.txt.gz · Last modified: 2014/09/25 16:55 (external edit)