contract-cli MDM Fields

Applicable Commands

• contract-cli mdm fields list --biz-line <vendor|legal_entity|vendor_risk>

Quick Decision-Making

• Need to confirm field definitions before writing vendors:

  --biz-line vendor

• Need to confirm field definitions before writing legal entities:

  --biz-line legal_entity

• Need to confirm vendor risk fields:

  --biz-line vendor_risk

  , applicable only to user/MCP paths
• If users want to query contract creation enums, do not use this; use

  contract enum list

  instead

Key Rules

• --biz-line

  is required

• mdm fields list --as user

  uses

  /open-apis/contract/v1/mcp/config/config_list

• mdm fields list --as bot

  uses

  /open-apis/mdm/v1/config/config_list

• The bot backend currently only accepts

  vendor

  /

  legalEntity

  ; the CLI will automatically map

  legal_entity

  under bot to

  legalEntity

• vendor_risk

  is not supported under bot identity and will throw a local error

• --user-id-type

  /

  --user-id

  are still passed through according to shared rules without local validation
• Currently only field configuration query is encapsulated, local validation and field conversion are not handled
• Recommended reading order:
  • First read references/schema-fields-guide.md to select business lines and query scenarios
  • Then read references/schema-biz-lines.md to check the exact value of

    --biz-line

  • Finally read references/commands.md to copy command examples

Implementation Sources

• internal/cli/schema_command.go
• internal/openplatform/schema/service.go
• references/schema-fields-guide.md
• references/schema-biz-lines.md
• references/commands.md

Operation Suggestions

• Before the write interface is encapsulated, use this command to confirm the field structure first
• When needing to write vendors or legal entities, wait for the corresponding structured write command to be released; do not revert to

  api call

  , as this entry is currently not open
• When only wanting to query contract enums, do not use this

Do Not Do This

• Do not treat

  mdm fields list

  as a data query command
• Do not assume it will automatically validate your write requests