PGP Universal Web Messenger Customization Troubleshooting

Article:TECH149061  |  Created: 2007-10-17  |  Updated: 2011-06-30  |  Article URL http://www.symantec.com/docs/TECH149061
Article Type
Technical Solution


Subject

Issue




After creating the template, you receive File Validation Error(s) or you cannot make active a broken template. The following article describes troubleshooting customized templates for PGP Universal Server Web Messenger.

 


Solution




 

Template Validation Errors

Advanced and complete custom templates allow you to edit the images and/or HTML files used by PGP Universal Web Messenger. After you upload your files, there are two levels of validation: file validation and tag validation.

File Validation

During advanced customization file upload, the zipped image file is validated to make sure all required files are present. During complete customization, the zipped file is validated to make sure all required image, HTML, and other files are present and located in the correct directory. When you download the default file set, all necessary files are present. The same files must be present, although edited, during upload. You can add more files, but you cannot remove any.

File validation runs before tag validation. If the template fails file validation and you make corrections, the template may still fail validation at the tag validation stage.

To correct invalid files:

If validation of the uploaded files fail, the File Validation Error screen displays a list of missing or missplaced files.

Use the following steps to correct any error(s) and upload the new files.

 

  1. Click Export Validation Error Log to export and view the error log offline. The error log is exported as a text file.
  2. Click Cancel to save the template in the error state.
  3. Repair the invalid files on your own computer desktop, using the exported error log as a reference. You can download the default set of files and use them as a reference when replacing and re-organizing missing and incorrectly located customized files.
  4. When you are ready to upload the corrected files, click the template. The template opens to the validation page.
  5. Click Upload New File to upload the .zip files.

Tag Validation

During complete customization file upload, the zipped file is validated to make sure all required files are present. A compiler converts the HTML pages to an internal format, and then the validation process makes sure that all required HTML tags and tag attributes are present in the HTML and are correctly positioned in relation to each other.

Validation checks that specific code necessary to PGP Universal Web Messenger functionality has not been modified, moved, or deleted. Tag attributes that mark specific locations on each page, such as ID attributes, are particularly important.

If your files failed the validation process, compare the default set of files with your edited versions to find the errors listed in the validation error log.

Make sure that you have not deleted any HTML tags, IDs, and other elements that use the "Required" attribute. HTML tags necessary to PGP Universal Web Messenger functionality are marked with the Required attribute, so if you delete a tag that was marked as Required, validation will fail and an error message appears. If the Required attribute is "true," the tag is required.

Example:

<h2 id="loginWelcome" required="true">

Look for incorrectly nested HTML tags, attributes, and other elements. Make sure you have not moved or deleted elements containing the "Within" attribute. The content of the attribute is the element in which it should be nested.

Example:

<tr id="trTemplateRow" required="true" within="taInbox">

<td class="first" width="20"><input id="deleteCheckbox" required="true" within="trTemplateRow" type="checkbox" name="deletedMessages" value="runtime_replace" onclick="highlightRow(this);"></td>


To correct invalid files

If validation fails, the Tag Validation Error page appears. The Tag Validation Error page shows a list of missing or misplaced files.

 

  1. Click Export Validation Error Log to export and view the error log offline. The error log is exported as a text file.
  2. Click Cancel to save the template in the error state.
  3. Repair the invalid files on your own computer desktop, use the exported error log as a reference.

    Note: You can download the default set of files and use them as a reference when replacing and re-organizing missing and incorrectly located customized files and repairing the HTML.


     
  4. When you are ready to upload the corrected files, click the template. The template opens to the validation page.
  5. Click Upload New File to upload the .zip files. The files are validated.


Legacy ID



809


Article URL http://www.symantec.com/docs/TECH149061


Terms of use for this information are found in Legal Notices