Overview
In CRMpad Legacy 5.0.2, photos taken or uploaded directly from the device camera inside CRM.pad (iPad) may be automatically cropped to a square. This behavior is controlled by a CRM.designer Web Configuration parameter and can be disabled without any code changes.
Solution
Symptoms
When taking/uploading a picture directly from the device camera in CRMpad Legacy 5.0.2, the resulting image is cropped to a square (for example: “photo is cropped… the size is cropped to a square”) instead of preserving the original image section/aspect ratio.
Environment
- Product: CRM.pad (iPad)
- Version reported: CRMpad Legacy 5.0.2
Cause
The camera square-cropping behavior is controlled by a CRM.designer Web Configuration parameter. There is no need to modify client code to change this behavior, and it is not controlled by a PhotoUploadAction JSON setting.
Configuration Change (CRM.designer Web Configuration)
Create or update the following Web Configuration parameter in the configuration assigned to your CRM.pad users:
- Parameter name:
Photo.DisableCropImage - Type: Boolean / Checkbox
- Value: enabled/checked (equivalent to
true)
Steps (CRM.designer)
- Open CRM.designer.
- Switch to the configuration used by your CRM.pad users (ensure you are editing the correct configuration in the inheritance hierarchy).
- Navigate to Web Configuration parameters.
- Create the parameter
Photo.DisableCropImageif it does not exist, or edit it if it already exists. - Set it as a Boolean/Checkbox and set the value to enabled (
true). - Save/publish the configuration changes using your standard configuration deployment process.
Device Step (Important)
- If the change does not take effect immediately on the iPad, run a Full Synchronization in CRM.pad so the updated Web Configuration is applied.
Validation
- On an iPad using the affected CRM.pad configuration, run a Full Synchronization (if not already done).
- Open the same CRM.pad flow used to attach/upload photos.
- Take a new photo using the camera (not an existing gallery image).
- Confirm the uploaded image preserves the original image section (no forced square crop).
If It Still Crops to a Square
- Confirm the parameter name is exactly
Photo.DisableCropImage(case and spelling matter). - Confirm the parameter is set in the actual configuration assigned to the user/device (and not only in an unrelated parent/child configuration).
- Perform another Full Synchronization on the iPad.
Frequently Asked Questions
- 1. How can I tell if I’m experiencing the same problem?
- You see the behavior described as: “photo is cropped… the size is cropped to a square” when taking a photo directly with the device camera inside CRM.pad, and the uploaded/attached image does not keep the original image section/aspect ratio.
- 2. Which setting controls the camera square-cropping behavior in CRMpad Legacy 5.0.2?
- Set the CRM.designer Web Configuration parameter
Photo.DisableCropImagetotrue(enabled/checked). - 3. Do I need to change PhotoUploadAction “Config Input Argument” JSON to fix cropping?
- No. The fix is via a CRM.designer Web Configuration parameter:
Photo.DisableCropImage. - 4. The parameter is set, but devices still crop images. What should I do?
- Run a Full Synchronization in CRM.pad. Also confirm you edited the correct configuration that the users/devices are assigned to in your configuration hierarchy.
- 5. Does this require a code change or a newer CRM.pad build?
- No code change is required. The behavior can be changed via Web Configuration by setting
Photo.DisableCropImageto enabled.
Priyanka Bhotika
Comments