Business Scenario

Escenario de negocio

A contacts file contains ZIP Codes entered manually by different users. Some values are complete, while others are too short, contain letters, or include invalid characters. Before using this file for mailing, reporting, GIS, or validation against official address data, the invalid ZIP Codes must be identified and separated for review.

Un archivo de contactos contiene códigos postales ingresados manualmente por diferentes usuarios. Algunos valores están completos, mientras otros son demasiado cortos, contienen letras o incluyen caracteres inválidos. Antes de usar este archivo para envíos, reportes, GIS o validación contra datos oficiales de direcciones, los ZIP Codes inválidos deben identificarse y separarse para revisión.

Learning Objectives

Objetivos de aprendizaje

• Import a CSV file containing contact records.
• Validate ZIP Codes using a strict five-digit numeric rule.
• Separate valid records from invalid records.
• Export invalid ZIP Codes to a review file.
• Protect the original file by writing clean outputs to new files.

• Importar un archivo CSV con registros de contactos.
• Validar ZIP Codes usando una regla estricta de cinco dígitos numéricos.
• Separar registros válidos de registros inválidos.
• Exportar ZIP Codes inválidos a un archivo de revisión.
• Proteger el archivo original escribiendo resultados limpios en archivos nuevos.

Sample Input Data

Data de entrada de ejemplo

ContactID,Name,ZipCode
1001,Juan Carballo,33133
1002,Maria Lopez,3313
1003,Pedro Martinez,33A13
1004,Ana Torres,33145
1005,Luis Perez,33133-1234
1006,Carmen Diaz,

Step 1 — Define Source and Output Files

Paso 1 — Definir archivos de entrada y salida

$sourceFile = "C:\Training\contacts.csv"
$validFile = "C:\Training\ZipValidos.csv"
$invalidFile = "C:\Training\ZipInvalidos.csv"

Step 2 — Import the CSV File

Paso 2 — Importar el archivo CSV

$records = Import-Csv -Path $sourceFile

Step 3 — Define the ZIP Code Validation Rule

Paso 3 — Definir la regla de validación del ZIP Code

This rule accepts only ZIP Codes with exactly five digits.

Esta regla acepta únicamente ZIP Codes con exactamente cinco dígitos.

$zipPattern = '^\d{5}$'

Step 4 — Separate Valid and Invalid ZIP Codes

Paso 4 — Separar ZIP Codes válidos e inválidos

$validRecords = $records | Where-Object {
    $_.ZipCode -match $zipPattern
}

$invalidRecords = $records | Where-Object {
    $_.ZipCode -notmatch $zipPattern
}

Step 5 — Export the Results

Paso 5 — Exportar los resultados

$validRecords | Export-Csv -Path $validFile -NoTypeInformation -Encoding UTF8
$invalidRecords | Export-Csv -Path $invalidFile -NoTypeInformation -Encoding UTF8

Complete Script

Script completo

$sourceFile = "C:\Training\contacts.csv"
$validFile = "C:\Training\ZipValidos.csv"
$invalidFile = "C:\Training\ZipInvalidos.csv"

$zipPattern = '^\d{5}$'

$records = Import-Csv -Path $sourceFile

$validRecords = $records | Where-Object {
    $_.ZipCode -match $zipPattern
}

$invalidRecords = $records | Where-Object {
    $_.ZipCode -notmatch $zipPattern
}

$validRecords | Export-Csv -Path $validFile -NoTypeInformation -Encoding UTF8
$invalidRecords | Export-Csv -Path $invalidFile -NoTypeInformation -Encoding UTF8

Write-Host "Valid ZIP records: $($validRecords.Count)"
Write-Host "Invalid ZIP records: $($invalidRecords.Count)"

Expected Result

Resultado esperado

Validation Checklist

Lista de validación

• The original contact file remains unchanged.
• Only five-digit numeric ZIP Codes are accepted as valid.
• Short, blank, alphabetic, and non-standard ZIP values are exported for review.
• The clean file is ready for reporting, mailing, GIS preparation, or downstream validation.
• The validation rule can be expanded later to support ZIP+4 if required.

• El archivo original de contactos permanece sin cambios.
• Solo se aceptan como válidos ZIP Codes numéricos de cinco dígitos.
• Valores cortos, vacíos, alfabéticos o no estándar se exportan para revisión.
• El archivo limpio queda listo para reportes, envíos, preparación GIS o validación posterior.
• La regla puede ampliarse luego para soportar ZIP+4 si es necesario.

Professional Notes

Notas profesionales

ZIP Code validation is a small but important data quality control. Invalid postal codes can affect mailing accuracy, customer segmentation, GIS analysis, service-area reporting, and integration with external address systems. For production work, always confirm the required postal standard before rejecting records.

La validación de códigos postales es un control pequeño pero importante de calidad de datos. ZIP Codes inválidos pueden afectar envíos, segmentación de clientes, análisis GIS, reportes de áreas de servicio e integración con sistemas externos de direcciones. Para producción, confirma siempre el estándar postal requerido antes de rechazar registros.