---
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


---

# Bulk import map examples

# Bulk import map examples {#ariaid-title1}

* Versão de lançamento: Australia
* 
* Atualizado 12 de mar. de 2026
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 5 min. de leitura

Mapping your source employee documents to required elements in Employee Document
Management is crucial for a successful bulk import.
This topic provides examples on how to map your source employee documents to the required
elements in Employee Document Management. The values provided are examples designed to guide
you through the import map configuration.

## Map fields and values directly from existing file names {#edm-map-examples__section_qqq_gtl_yfb}

Using your existing employee document file names is recommended when your source employee
documents reside in a local repository.  
For example, an employee document can have all the meta data in the file name Abel_Tuter_tuition.pdf to map to Employee Document Management.  
Nota:  
When using regular expressions (RegEx) to define the replacement value, use a regular expression test site to ensure correct parsing.

File name example
:   The example file name is abel_tuter_tuition.pdf.
:   To find and extract the file name from the source repository, see this example:
:
:   The import map is looking for a source element called fileName.
:   The import map is going to translate this source element to a mapped element called
    fileName.
:   The Regex is looking for the format of the file name first_last_xxx.pdf.

File name to employee name example
:   From the file name, the employee name is extracted. Employee name is a requirement
    for Employee Document Management.
:
:   The import map is looking for a source element called fileName.
:   The import map is going to translate this source element to a mapped element called
    employee.
:   The Regex is looking for the format of the file name to be first_last_tuition.pdf
    (\\w+)_(\\w+)_(\\w+).(\\w+).
:   It replaces the original file name with first.last ($1.$2)

File name to document type example
:   From the file name, the document type is extracted. Document type is a requirement
    for Employee Document Management.
:
:   The import map is looking for a source element called fileName.
:   The import map is going to translate this source element to a mapped element called
    docType.
:   The Regex is looking for the format of the file name to be first_last_tuition.pdf
    (\\w+)_(\\w+)_(\\w+).(\\w+).
:   It creates a docType of tuition ($3).  
    Nota:  
    Having the source employee documents in a central repository, simple directory structure, and consistent file naming convention are highly recommended and reduces errors.

## Parse and map fields and values from a JSON output {#edm-map-examples__section_py2_btl_yfb}

Using a JSON output is recommended when your source employee documents reside in a
third-party, cloud-based repository.  
{#edm-map-examples__table_dkq_pqm_yfb__entry__2}

| Field | Description |
|-|-|
| Mapping type | Field |
| Mapped element | items Looks for the items mapping element in an array of items in the folder. This mapping is used after Stage --- Directory import source. |
| Source element | entries Source element in the JSON output and represents the items in a folder. For example, Box uses entries as the source element. |
[Tabela 1. Map record for element item]

{#edm-map-examples__table_dkq_pqm_yfb}

{#edm-map-examples__table_t1j_crm_yfb__entry__2}

| Field | Description |
|-|-|
| Mapping type | Field |
| Mapped element | item Looks for item, an entry in an array of items in the folder. This mapping is used after Stage --- Directory import source to run operations against a single item. |
| Source element | id For each item in the array, find the file ID in the JSON output. |
| Filter regex | file Combined with the Filter field to exclude subfolders. |
| Filter field | type Filter output to where the type field is equal to file to exclude subfolders. |
[Tabela 2. Map record for element employee]

{#edm-map-examples__table_t1j_crm_yfb}

{#edm-map-examples__table_ckk_nrm_yfb__entry__2}

| Field | Description |
|-|-|
| Mapping type | Field |
| Regex | (\\w+)\\s(\\w+) String translation to convert fname lname to fname.lname. |
| Replace | $1.$2 Converts files found in Regex field fname lname to fname.lname. |
| Mapped element | employee Looks for employee mapping element. Employee is a field in the file item. This mapping is used after Stage --- file import source. |
| Source element | owned_by.name Looks for name in owned_by object. Bypass nested objects with a dot notation. |
| Filter regex |   |
[Tabela 3. Add map records for element employee (continued)]

{#edm-map-examples__table_ckk_nrm_yfb}  
{#edm-map-examples__table_wmt_xms_yfb__entry__2}

| Field | Description |
|-|-|
| Mapping type | Value Selecting Value maps the employee element within an array of information from your source document to a specific value in Employee Document Management. |
| Replace | david.loo The value you want to replace the source element with in Employee Document Management. Employee Document Management requires employee names to be formatted fname.lname. |
| Mapped element | employee Looks for the employee mapping element that is a field in the file item. This mapping is used after Stage --- file import source. |
| Source element | davidl Looks for the source value of davidl. |
[Tabela 4. Add map record for element employee (alternative)]

{#edm-map-examples__table_wmt_xms_yfb}This example illustrates how to use Value mapping to take an employee name from your source document and map it to the format that Employee Document Management requires.  
{#edm-map-examples__table_ys3_lwm_yfb__entry__2}

| Field | Description |
|-|-|
| Mapping type | Field |
| Mapped element | docType Looks for the docType mapping element embedded in the description field in the file item. This mapping is used after Stage --- file import source. |
| Source element | description Looks for name in description. |
| Filter regex |   |
[Tabela 5. Add map records for element docType]

{#edm-map-examples__table_ys3_lwm_yfb}  
{#edm-map-examples__table_q23_vym_yfb__entry__2}

| Field | Description |
|-|-|
| Mapping type | Value Use Value to map a specific value in your third-party, cloud-based repository to a value in Employee Document Management. |
| Replace | employee verifications Replace verification (source) with employee verifications (Employee Document Management). |
| Mapped element | docType Looks for the docType mapping element embedded in the description field in the file item. This mapping is used after Stage --- file import source. |
| Source element | verification Look for the name value of verification in the JSON. |
[Tabela 6. Add map records for element docType (continued)]

{#edm-map-examples__table_q23_vym_yfb}
{#edm-map-examples__table_imc_4cn_yfb__entry__2}

| Field | Description |
|-|-|
| Mapping type | Value Use Value to map a specific value in your third-party, cloud-based repository to a value in Employee Document Management. |
| Replace | transcripts Replace school (source) with transcripts (Employee Document Management). |
| Mapped element | docType Looks for the docType mapping element embedded in the description field in the file item. This mapping is used after the Stage --- file import source. |
| Source element | school Looks for the name value school. |
[Tabela 7. Add map records for element docType (continued)]

{#edm-map-examples__table_imc_4cn_yfb} {#edm-map-examples__table_cv5_22n_yfb__entry__2}

| Field | Description |
|-|-|
| Mapping type | field |
| Mapped element | fileName Looks for the fileName mapping element embedded in the name field in the file item. This mapping is used after Stage --- file import source. |
| Source element | name Looks for filename in the description in the JSON output. |
| Filter regex |   |
[Tabela 8. Add map record for element fileName]

{#edm-map-examples__table_cv5_22n_yfb}

{#edm-map-examples__table_tj2_pwr_yfb__entry__2}

| Field | Description |
|-|-|
| Mapping type | field |
| Mapped element | url Looks for the url mapping element embedded in the id field in the file item. This mapping is used after Stage --- file import source. |
| Source element | Looks for id in JSON output. Nota: some third-party, cloud-based repositories use the file ID. The capture import source builds a URL from this value. |
[Tabela 9. Add map record for element url]

{#edm-map-examples__table_tj2_pwr_yfb}

## Bulk import mapping records {#edm-map-examples__section_jf1_sfs_yfb}

An example of Employee Document Import Map.

When a connection to your source repository is confirmed and import maps are set up
correctly, you can click Start staging job from Related Links.