Documentation

# Box migration connector

Migrates documents from Box (opens new window) cloud content management system to SharePoint.

DLL: Epona.Migrate.Box.dll

# What it does

  • Document retrieval — reads documents and folders from Box using the Box API
  • Metadata extraction — retrieves file properties, timestamps, ownership information
  • Batch upload — transfers documents to SharePoint while preserving metadata
  • Matter mapping — organizes documents by matter or client structure in SharePoint
  • Error recovery — detailed logging for troubleshooting failed transfers

# Prerequisites

  • Box account with administrative access
  • Box API credentials (application token or OAuth credentials)
  • Network connectivity to Box API endpoints
  • Target SharePoint site collection provisioned with document libraries

# Deployment

  1. Copy Epona.Migrate.Box.dll to the Epona.Migrate application directory
  2. Restart Epona.Migrate or reload connectors
  3. Configure Box connection settings in the migration UI

# Configuration

# Connection settings

# Box API URL

  • Type: string
  • Description: Base URL of Box API (typically https://api.box.com)

# API Credentials

  • Type: string
  • Description: Box application token or OAuth credentials

# Root Folder ID

  • Type: string
  • Description: Box folder ID to start migration from

# Metadata mapping

Map Box file properties to SharePoint columns:

# name

  • Box field: name
  • SharePoint column: Title
  • Description: Document title/filename

# created_at

  • Box field: created_at
  • SharePoint column: Created
  • Description: Date document created in Box

# modified_at

  • Box field: modified_at
  • SharePoint column: Modified
  • Description: Date document last modified

# created_by.name

  • Box field: created_by.name
  • SharePoint column: Author
  • Description: User who created the document

# size

  • Box field: size
  • SharePoint column: —
  • Description: Document file size (informational)

# Custom metadata

  • Box field: Custom metadata
  • SharePoint column: Custom columns
  • Description: Any custom Box metadata fields

# Matter mapping

Define how Box folder structure maps to SharePoint matters:

Box folder: /ACME/Case-00123
  ↓ matches pattern: /{ClientCode}/Case-{MatterCode}
  ↓
SharePoint: /teams/ACME-00123/Documents

# Migration workflow

  1. Scan — enumerate all documents in Box folder structure
  2. Filter — apply inclusion/exclusion rules
  3. Validate — verify matter/client mapping and metadata
  4. Plan — review migration scope and target locations
  5. Execute — transfer documents to SharePoint with metadata
  6. Report — log results and any errors

# Troubleshooting

# Common issues

# Authentication failed

  • Cause: Invalid API credentials
  • Resolution: Verify Box API token/OAuth credentials in configuration

# Folder not found

  • Cause: Incorrect Root Folder ID
  • Resolution: Check Box folder ID in Box web UI (right-click folder → Share → Copy link)

# Documents not transferring

  • Cause: Network connectivity or SharePoint quota
  • Resolution: Check network connectivity and SharePoint storage quota

# Metadata not mapping

  • Cause: Column names mismatch
  • Resolution: Verify column names match exactly in SharePoint site configuration
Last Updated: 4/2/2026, 11:46:36 AM