Name Matching Import Fields
Accepted headers
Section titled “Accepted headers”The importer accepts Chinese and English header variants that map to:
- personId
- canonicalName
- nickname
- delete
- lastUsedAt
Field rules
Section titled “Field rules”| Field | Required | Accepted values | Notes |
|---|---|---|---|
| personId | Conditional | Positive integer | Needed for add/update target resolution. |
| canonicalName | Optional | Text | Can be used to resolve personId by canonical roster name. |
| nickname | Yes | Non-empty text | Zoom display name to map. |
| delete | Optional | true/false, yes/no, y/n, 1/0, 是/否 | delete=true removes existing mapping by nickname. |
| lastUsedAt | Optional | Text timestamp | Preserved as metadata when provided. |
Validation outcomes
Section titled “Validation outcomes”Import row is rejected when:
- personId is invalid format.
- delete value is invalid boolean-like text.
- nickname is empty.
- nickname collides with canonical roster name.
- nickname duplicates another row in same import.
- delete requested for nickname that does not exist.
Action outcomes
Section titled “Action outcomes”- add: creates Name Matching row.
- update: updates mapping target and metadata.
- delete: removes mapping row.
- reject: row skipped with reason.