ServiceNow — Import Sets

​

What happens

Field tech scans asset (Forager app)
  → Attestation recorded in Forager
  → Forager POSTs row to your Import Set table
  → Transform Map maps fields to CI records
  → CI records updated on transform run

​

ServiceNow setup

​

Step 1 — Create a dedicated integration user

• rest_service role
• import_transformer role (instead of itil)

​

Step 2 — Create the Import Set table

1. Go to System Import Sets → Administration → Tables → Create table
2. Set:
   • Label: Forager Attestation Import
   • Name: u_forager_attestation_import (auto-populated)
   • Import set table: ✅
3. Add columns:

4. Save

​

Step 3 — Create a Transform Map

1. Go to System Import Sets → Administration → Transform Maps → New
2. Set:
   • Name: Forager to CMDB CI
   • Source table: u_forager_attestation_import
   • Target table: cmdb_ci (or your specific CI subclass)
3. On the Field Maps tab, map:

4. Set Coalesce on u_asset_tag → asset_tag so the transform updates the existing CI rather than creating a new one
5. Save

​

Step 4 — Configure auto-transform (optional)

1. On the Transform Map, check Run business rules
2. Create a Business Rule on the import table:
   • When: after insert
   • Script:
     var transformer = new GlideImportSetTransformer();
     transformer.transformAllMaps(current);
     

​

Forager dashboard setup

1. Go to Settings → CMDB Webhooks → Add webhook
2. The endpoint URL is the ServiceNow Table API pointing at your import table:
   https://[instance].service-now.com/api/now/table/u_forager_attestation_import
   
3. Auth Header: Authorization / Basic [base64(username:password)]
4. Replace the payload template with a flat field map matching your import table columns:

{
  "u_asset_tag": "{{asset_tag}}",
  "u_location_path": "{{location_path}}",
  "u_anchor_name": "{{anchor_name}}",
  "u_updated_by": "{{updated_by}}",
  "u_event_type": "{{type}}",
  "u_timestamp": "{{timestamp}}"
}

​

Testing

curl -X POST "https://[instance].service-now.com/api/now/table/u_forager_attestation_import" \
  -H "Authorization: Basic [your-base64-value]" \
  -H "Content-Type: application/json" \
  -d '{
    "u_asset_tag": "LAPTOP-00412",
    "u_location_path": "Main Building / Floor 2 / IT Office",
    "u_anchor_name": "IT Office",
    "u_updated_by": "Test User",
    "u_event_type": "match",
    "u_timestamp": "2026-05-12T19:00:00Z"
  }'