ROES and RetouchUp Integration
ROES Server RetouchUp Integration
Use this article to configure the RetouchUp Agent in ROES Server and assign automated image enhancement levels through image options or order options.
Overview
SoftWorks and RetouchUp, also referenced as Hollywood FotoFix, collaborated to integrate automated image enhancement capability within ROES Server.
Enhancement levels are assigned through image options or order options. The RetouchUp Agent looks for the retouchup attribute within the order details. Images flagged for retouch service are uploaded with the specified retouch level. Additional instructions and, in some cases, a reference image for a head swap can also be included. If no retouchup attributes are found, the order passes to the next device in the workflow.
Quick Setup
- Establish an account with RetouchUp.
- In ROES Server, define a RetouchUp Queue and add the RetouchUp Agent.
- Enter the RetouchUp username and password in the ROES Server RetouchUp Agent.
- Place the RetouchUp Agent in the appropriate position in the workflow, before any rendering for printing.
- Add the desired RetouchUp options to the ROES template file or collection.
- Test the setup before using it in production.
Workflow Placement Note
The RetouchUp Agent should be placed before any render-for-printing step so returned images can be used by later workflow devices.
The RetouchUp Agent
The RetouchUp Agent requires two setup values: username and password.
When processing a job, the agent first creates a folder named Backups inside the order’s Order Images / OrderID folder. If images in the order are found to have the retouchup attribute, the original images as received from the end user are copied to this backup folder. The flagged images are uploaded to the RetouchUp server. The job waits for updated images to be returned, then continues to the next queue in the workflow.
If this image does not display, open it directly: RetouchUp_Agent.png
Defining Options
There are three retouch levels that can be assigned to either an image option or an order option with per_image set to true. Each level has a numeric value of 1 through 3.
Additional artist instructions can be provided in a needs_text or needs_textarea field as part of the option definition.
An additional image for swapping purposes can be included with the needs_file attribute on the image option.
Retouch level values
- Complete — retouchup="1"
- Complete Plus — retouchup="2"
- Complete Deluxe — retouchup="3"
If this image does not display, open it directly: ImageOption_Complete.png
Reference Information and Supporting Links
- RetouchUp
Source HTML listed this as www.retouchup,com; link corrected to the standard domain format.
Expected Result
Images with a retouchup attribute should be backed up, uploaded to RetouchUp, returned after service, and then passed to the next queue in the ROES Server workflow. Orders without RetouchUp attributes should continue to the next workflow device without upload.
Escalation Notes
- Confirm the lab has an active RetouchUp account.
- Confirm the RetouchUp Agent username and password are entered correctly.
- Confirm the agent is placed before render-for-printing workflow devices.
- Confirm the image or order option writes the correct retouchup value.
- Confirm whether additional instructions are passed through needs_text or needs_textarea.
- Confirm whether head-swap reference images are passed with needs_file.