{"revision":"c10276e953456835cdbb1f3a60d58ae1980be353","document":{"id":11295,"path":"employee-service-management/hr-service-delivery/edit-pdf-mappings.md","title":"Define a PDF field mapping","bundle":null,"doc_type":null,"release":"australia","body":"\n# Define a PDF field mapping\n\nDefine editable fields and store signature mappings using the PDF field mappings section.\n\n## Before you begin\n\nRole required: sn\\_doc.admin\n\n## About this task\n\nInformation on the PDF is parsed and stored in the PDF Mapping table. **Parse PDF** will allow you to store the fillable fields and **Mark signatures** will allow you to add signature mappings.\n\n## Procedure\n\n1. Navigate to **All** > **Document Templates** > **All Document Templates**.\n\n2. Select **PDF Document Template**.\n\n3. [Configure the PDF template.](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/employee-service-management/hr-service-delivery/configure-editable-pdf.md)\n\n4. Click the **Parse PDF** related link.\n\n **Note:** The link appears only for an editable PDF.\n\n The PDF Mapping related list displays field mappings.\n\n\n
\n\nField\n\n\n\nDescription\n\n
\n\nField name\n\n\n\nDisplay name that represents the document field.\n\n
\n\nPDF template\n\n\n\nPDF template to which the mapping record belongs.\n\n
\n\nDocument field\n\n\n\nField from the fillable PDF document that is automatically created through the **Parse PDF** related link. **Important:** Editing Document field is not allowed as it might break the document template flow.\n\n
\n\nDocument field type\n\n\n\nType of field you are mapping, such as Signature or Checkbox.\n\n
\n\nPreview value\n\n\n\nField-mapping value for preview.**Note:** Use this field to test a field value without going through the process of mapping fields or creating a case to test your mappings. What you enter here appears while you preview the document.\n\n
\n\nAdvanced script\n\n\n\nUse to configure script fields for complex mapping of a field.For example, to map a Social Security Number from the HR Profile \\[sn\\_hr\\_core\\_profile\\] table to a document and format it correctly, a script is used.\n\n
\n\nMandatory\n\n\n\nMandatory field to be filled by the assigned participant.**Note:** This field is not applicable for document field of type checkbox.\n\n
\n\nMapping table\n\n\n\nTable that the mapped fields come from.\n\n
\n\nRead only\n\n\n\nOption for enabling the editing of the field by the selected participant.\n\n
\n\nMapping field\n\n\n\nField that maps information into your document.\n\n
\n\nParticipant\n\n\n\nParticipant who can edit the field in the document.\n\n
\n\nPage number\n\n\n\nPage number of the PDF document which contains the field. Page number where the field is present.\n\n
\n\nFormat\n\n\n\nFormat in which values are to be entered by the participant. If the participant does not enter value in the specified format, a validation error appears for the participant.\n\n
\n\nActive\n\n\n\nOption for activating the field mapping.\n\n
\n\nUse Signing date\n\n\n\nOption to record the signature date automatically in the specified field in PDF document.**Note:** This option is applicable to ServiceNow Sign only.\n\n
\n\nDate offset type\n\n\n\nIndicates if the date should be Before, On, or After the specified date. **Note:** This field appears only for a date field when the **Advanced script** option is deselected.\n\n
\n\nDate offset quantity\n\n\n\nMeasuring units for the offset such as days, weeks, or months.**Note:** This field appears only for a date field mapping when the **Advanced script** option is deselected. It appears only when the **Before** or **After** values are selected in the **Date offset type** field.\n\n
\n\nDate offset units\n\n\n\nNumber of units to offset.**Note:** This field appears only for a date field mapping when the **Advanced script** option is deselected. It appears only when the **Before** or **After** values are selected in the **Date offset type** field.\n\n
\n\nSelect date format\n\n\n\nFormat for the date field. Values are:- User date format: Indicates that the date format is picked from the participant's user preference.\n- Specific format: Indicates the format in which you want the participant to enter the date.\n\n\n
\n\nSpecific date format\n\n\n\nSpecific format in which you want the participant to enter the date.\n\n
\n\nStates\n\n\n\nOptions stored for the non text fields. For example, social status might includes options such as **Married** or **Single**.\n\n
\n"}}