--- sourceDocument: Australia Employee Service Management sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/employee-service-management Release : - australia ft:locale : - pt-BR ft:publication_title : - Australia Employee Service Management ft:clusterId : - emplsm bundleId : - emplsm workflow : - Employee --- # Configure metadata for fields and variables # Configure metadata for fields, variables, and variables sets in a contract document {#ariaid-title1} * Versão de lançamento: Australia * * Atualizado 12 de mar. de 2026 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 min. de leitura As a contract configurator, add and configure metadata for fields, variable, and variable sets to pre-fill the information in the contract document. ## Antes de Iniciar The Microsoft Word add-in for ServiceNow Contracts must have been configured. For more information, see [Configure the Microsoft Word add-in for ServiceNow Contracts](https://servicenow-prod.fluidtopics.net/4hd8IHn6GdbUDMlb3G27IA "As an admin, configure the Microsoft Word add-in for ServiceNow Contracts."). A contract template must exist that is active and is in the Draft or Editing state. For more information, see [Create a contract template to contain content controls](https://servicenow-prod.fluidtopics.net/YybiCA_e56Wq_hIyyGwYDQ "Create a contract template using the Microsoft Word add-in for ServiceNow Contracts to which you can then add content controls."). Role required: sn_cm_core.contract_config and canvas_user ## Por Que e Quando Desempenhar Esta Tarefa The metadata added for fields, variable, and variable sets act as placeholders for values that will be used while generating contract document. Nota: In Contract Management Pro version 1.4.1, the Legal Contract Request form in Legal Counsel Center and Contract Workspace displays only mapped legal fields for variables in the contract fulfiller view. You therefore need to apply the Field mapping option when setting up Metadata mapping for legal contracts. For existing templates with Variable mapping, edit the template and update the configuration with Field mapping. For more information on editing a contract template, see [Edit a contract template using Microsoft Word add-in for ServiceNow Contracts](https://servicenow-prod.fluidtopics.net/NZv1Nev_Bws_qWC9mdallw "Edit the metadata, signatories, or clauses in a contract template that must be included in the contract template to generate a standard contract when an employee submits a contract request using the Microsoft Word add-in for ServiceNow Contracts."). * The metadata of the type Field mapping gets its value from the table that the contract template is associated with. * The metadata of type Variables gets its value from the record producer. {#cncore-addin-add-metadata__ul_zj3_yq1_hzb} ## Procedimento 1. Open the document in which you want to mark the content controls in Microsoft Word. 2. From the Microsoft Word ribbon, select the ServiceNow Contracts add-in. 3. On the login screen, enter the credentials of the ServiceNow instance for which the Microsoft Word add-in is configured. For more information, see [Configure the Microsoft Word add-in for ServiceNow Contracts](https://servicenow-prod.fluidtopics.net/4hd8IHn6GdbUDMlb3G27IA "As an admin, configure the Microsoft Word add-in for ServiceNow Contracts.") 4. On the add-in screen in the Templates tab, select the contract template to which you want to add the metadata. Only templates that have been created in the global application scope are visible. 5. In the Microsoft Word document, place the cursor where you want to add the placeholder for metadata. Figura 1. Create metadata mapping 6. In the Metadata tab, select Create metadata mapping. 7. On the Create mapping form in the Type field, select either field mapping or variables. | Type of metadata | Fields available | | Field mapping | * Mapping field- Fields of the table to which the contract template is associated. * Field Name- The field is automatically set to the value of the Mapping Field. You can also modify the value. {#cncore-addin-add-metadata__ul_sr1_jw5_yxb} | | Variables | Nota: If a fulfiller updates the legal fields in a contract request and the template of the contract request uses variable mapping, the contract document will not be updated with the new values when you create a contract revision. * Record producer- The record producer from which you want to add the variable. For example, if you want to add a variable from a contract request for a non-disclosure agreement, select the record producer for a non-disclosure agreement. * Variable- The variable of the record producer that you want to add. * Variable set row- The row value of the variable set. The field is displayed only when the selected value in Variable is a set of values. For example, the Signatory variable is a set of variables for Title, Name, and email address. You can visualize this data set in rows and columns. ![Signatory variables]() If you wanted to map the variable to Beth Anglin, you would enter Row2 as the value in the Variable set row field. * Field Name- This field is automatically populated depending on the values for Variable and Variable set row. You can also modify the value. The maximum character limit for the field name is 200. Nota: Validation errors might occur for the following reasons: * The field name is not unique. * You have mapped metadata to a field that has already been mapped. {#cncore-addin-add-metadata__ul_yyt_mvq_dzb} {#cncore-addin-add-metadata__ul_i1f_lw5_yxb} | |-|-| {#cncore-addin-add-metadata__choicetable_qfz_dkb_yyb} 8. Select Create. * The metadata is added and displayed as a tile with the field name as the title. Figura 2. View added metadata * The metadata is synced to the ServiceNow instance. {#cncore-addin-add-metadata__ul_o2f_wvg_yyb} Nota: If you have included the sys_id variable, you must adjust this script to display it correctly. For more information, see [Configure fields in contract template to display correct sys_id value in contract documents](https://servicenow-prod.fluidtopics.net/qgq5zm1YsDbgmHE4Pd8A~w "As a contract configurator, update an advanced script to print the correct display value for sys_id variables in the generated contract document."). 9. **Opcional:** Add the metadata to other locations in the document or the header or footer of the Word document by selecting the tile and moving it to the desired location. 10. **Opcional:** View the metadata by logging in to your ServiceNow instance and navigating to the Template Mappings related list of the contract template. Figura 3. View template mapping in your instance **Conceitos relacionados** * [Configuring signatories in Contract template using Microsoft Word add-in](https://servicenow-prod.fluidtopics.net/wXosEp2epu72Jccayfmhdg "For signatories to add their signatures in the contract document, you can either create signature blocks or configure participants in a contract template with placeholders.") **Tarefas relacionadas** * [Map clauses and clause variations using the Microsoft Word add-in for ServiceNow Contracts](https://servicenow-prod.fluidtopics.net/U8ZKKNX2l2jlPEwTfNhgbA "As a contract configurator, add clause and clause variations to a contract using the Microsoft Word add-in for ServiceNow Contracts.") * [Map contract tables using the Microsoft Word add-in for ServiceNow Contracts](https://servicenow-prod.fluidtopics.net/GbauMiuPlQfSnl4nabWZxA "Use the ServiceNow Contracts add-in to map a contract table to a source table in your ServiceNow instance to determine the data that will be added in a contract document. When a contract document is generated from the template, the rows and columns are dynamically added in the mapped table of the contract document.")