Before beginning the SimplePhoto DP2 Bridge setup process, please setup an FTP site at your lab and send the FTP server address and login information to tech@simplephoto.com. SimplePhoto will use this FTP site to send order data files to your lab. The FTP folder will need to be accessible across your network from the machine running the DP2 Bridge Order Import program.
1. Install setup_SP_DP2Bridge_v1.1.exe
2. Copy the files in the "UpdatedFiles" folder into the directory where you installed the program, such as C:\Program Files\SimplePhoto\DP2Bridge . When you are prompted, allow the existing files to be overwritten.
3. Copy the "DP2Bridge" folder to the C drive on your computer. The path to this folder should be "C:\DP2Bridge". This "DP2Bridge" folder contains several default folders used by the DP2 Bridge program files.
4. Edit the SPKUpload.ini file. In the last line of the file (beginning with "ConnString="), change the [DP2DatabaseServerName] and [DP2DatabasePassword] text to the network name and database password of the machine running the DP2 database.
5. Test the connection to the DP2 Database
Open the "SimplePhoto Gallery Upload" program in the new "SimplePhoto" program group, or double-click the "SPKUpload.exe" file. Type a valid DP2 Order ID for an order in DP2 that has SubjectInfo. Click the "Student Portrait-style Gallery" option and then click the "Locate Order" button. If you see the "Select Password Data" field populate with the appropriate SubjectInfo columns, the database connection is set properly so you can move on to the next step. If you see an error message that says the program was unable to connect to the database, click OK and then close the program. Edit the last line of the SPKUpload.ini file to correct the database connection information. Save the SPKUpload.ini file and then re-open the Gallery Upload program to attempt the test again with the "Locate Order" button.
6. Open both the SPKUpload.ini and SPKLab.ini files. Copy the last line (beginning with "ConnString=") of the SPKUpload.ini file and paste this text to be the last line of the SPKLab.ini file. This will copy the working database connection information into the .ini file used by the Order Import program.
7. Configure the DP2 Bridge Gallery Upload program
-----------------------------------------------------
Open the "SimplePhoto Gallery Upload" program in the new "SimplePhoto" program group, or double-click the "SPKUpload.exe" file. When the program window opens, click the "Options" menu, then "Set Options".
Alternatively, you can edit the SPKUpload.ini file in Notepad to more quickly set the necessary values.
Here are explanations of the most important settings:
8. Make sure a test photographer account inside SimplePhoto has the "Lab Account #" set to the necessary DP2 Customer ID.
9. Use the Gallery Upload program to upload a test DP2 order to SimplePhoto. Before you use the Gallery Upload program to process a DP2 job, make sure the "Process Commands" option in DP2 is started. Start the "Render Engine" for the Printer Queue that is used by the DP2 Bridge Gallery Upload program.
Follow these instructions to upload a DP2 order using the Gallery Upload program:
Once the DP2 processing and FTP upload is complete you will see an alert message.
10. Verify that SimplePhoto received and processed the test upload.
11. Configure the DP2 Bridge Order Import program
-----------------------------------------------------
Open the "DP2 Order Import" program in the new "SimplePhoto" program group, or double-click the "SPKLab.exe" file. When the program window opens, click the "Options" menu, then "Set Options".
Here are explanations of the most important settings:
12. Setup Lab Products
---------------------------
Login to SimplePhoto with your lab login information. Click the "Products" tab. Click the "Add Product Group" button. Type a name such as "DP2 Test Products" and click the "Add" button.
Add a couple test products individually or use one of the CSV data import options at the bottom of the Lab Products screen. The Product Code field should have the DP2 Layout ID. For more details on adding lab products, visit: http://labhelp.digitaleventpics.com/lab-products/create-lab-products
13. Create a Retail Price list using the test lab products
---------------------------
On the page that shows the products inside the "DP2 Test Products" group, click the "Create Template" button below the list of products. Click the "Edit" button next to the newly created Retail Price List Template. Scroll to the bottom and click the "Published" checkbox and then click the "Update" button.
Login to the appropriate photographer account. Click the "Photographers" link in the navigation links at the top and then click the "Login" button next to the photographer account where the test DP2 Bridge upload was sent.
Click on the "Photographer Information" link on the SimplePhoto Dashboard. Scroll down to the "Product Groups Authority" section and either select the "All" option or select the "Test DP2 Products" options. Click the "Update" button. This will give the photographer account the authority to use the lab product group we just created.
Click the "Price Lists" link in the top navigation links. Scroll to the very bottom where you see the "Create new price list from Lab Template" section. Choose the "Test DP2 Products - Retail" option from the menu and click the "Create Price List" button. Rename the price list if desired and click the "Create Price List" button. This will copy the lab-level price list template into the photographer account.
Click the "Galleries" tab in the navigation links at the top. Find the job name uploaded earlier and click the adjacent "Folder Control Panel" or "Group Control Panel" button. Click the "Gallery Control Panel" button next to a gallery. Scroll to the "Price List" setting and change the price list to "DP2 Test Products - Retail". Scroll to the bottom and click the "Update" button. This associated the photographer's new price list with a gallery we uploaded using the DP2 Bridge.
14. Place a test order. On the "Gallery Control Panel", scroll to the bottom and click the "Cash Sale" button. A new web browser will open with the SimplePhoto gallery and shopping cart. Select one or two of each of the test products and complete the order. If SimplePhoto has finished configuring the FTP information provided by your lab, SimplePhoto should send order data to your lab as soon as the "Confirm Order" button is clicked on the final shopping screen.
15. Use the DP2 Bridge order Import program to import the test order. Open the DP2 Bridge Order Import program and click the "Start" button. You should see in the log that the test order was imported properly.
16. Verify that the test order was created properly in DP2 The DP2 Order ID generated by SimplePhoto will begin with an "S" and the rest of the DP2 Order Id will be the SimplePhoto Order ID.
Description of additional program settings
-------------------------------------------------------
DP2 Bridge Gallery Upload program
* "Web gallery image size - standard" - The size in inches that will be used when generating the web resolution images that are uploaded.
* "In Process Folder" - Used to store temporary files generated by the program. This typically should be local on the workstation running the DP2 Bridge. ex. C:\Program Files\SimplePhoto\DP2Bridge\InProcess\
* "Log Files Folder" - Used to store log files generated by the program. Useful for debugging purposes during testing. ex. C:\SimplePhoto\GalleryUploadLogs
* "Saved Zip Files Folder" - If you do not provide FTP information to have uploads sent directly to our server, the galleries will be saved in ZIP file format in this folder. ex. C:\SimplePhoto\SavedZipFiles
* "Web Gallery Large Image Folder" - The SimplePhoto DP2 Bridge Gallery Upload program can generate a second set of images. If this folder location is defined, a second set of images will be rendered when a gallery upload is processed. Some labs use this for generating images for use by a 3rd party fulfillment company. ex. C:\SimplePhoto\LargeImages
* "Web gallery image size - large" - The size in inches of the second set of images rendered by DP2 when a gallery upload is processed... if the "Web Gallery Large Image Folder" is defined.
DP2 Bridge Order Import program
* The remaining settings are typically left to their default values:
* "DP2 Images Folder" - not in use at this time, but must be defined. ex. C:\SimplePhoto\deadend
* "Processed Orders Folder" - used to store processed orders. Useful for debugging purposes during testing. ex. C:\SimplePhoto\ProcessedOrders
* "Exception Orders Folder" - used to store orders that were not processed due to an error. Useful for troubleshooting problems. ex. C:\SimplePhoto\OrderErrors
* "Log Files Folder" - Used to store log files generated by the program. Useful for debugging purposes during testing. ex. C:\SimplePhoto\OrderImportLogs
* "Other Vendor Files Folder" - not in use at this time, but must be defined. ex. C:\SimplePhoto\deadend
* "Polling Interval" - the number of seconds the program will wait to look for new orders in the "Received Orders Folder".