Primary Contact Phone

← Back to Question Bank

Details

Form

Sample version of the rendered form.

Primary Point of Contact Phone Number

Country Code*

The international country code (e.g., "+1" for US/Canada).

Phone Number*

The local phone number without the country code.

Extension

Optional extension number for the phone line.

Is Mobile?

Indicates whether this is a mobile/cell phone number.

Data

Form Data

What the form data looks like when it is submitted.

{
  "countryCode": "+1",
  "number": "444-456-1230",
  "isMobile": true
}

CommonGrants Data

What the data looks like translated to the CommonGrants data model using the mapping-to-cg.

{
  "contacts": {
    "primary": {
      "phones": {
        "primary": {
          "countryCode": "+1",
          "number": "444-456-1230",
          "isMobile": true
        }
      }
    }
  }
}

Schemas

JSON Schema

Provides the structure and data validation for this question.

type: object
examples:
  - countryCode: '+1'
    number: 444-456-1230
    isMobile: true
  - countryCode: '+1'
    number: 555-123-4567
    extension: '123'
    isMobile: false
description: A phone number for the primary point of contact
x-ui-schema:
  type: Group
  label: Primary Point of Contact Phone Number
  elements:
    - type: Control
      scope: '#/properties/countryCode'
      label: Country Code
    - type: Control
      scope: '#/properties/number'
      label: Phone Number
    - type: Control
      scope: '#/properties/extension'
      label: Extension
    - type: Control
      scope: '#/properties/isMobile'
      label: Is Mobile?
x-mapping-to-cg:
  contacts:
    primary:
      phones:
        primary:
          countryCode:
            field: countryCode
          number:
            field: number
          extension:
            field: extension
          isMobile:
            field: isMobile
x-mapping-from-cg:
  countryCode:
    field: contacts.primary.phones.primary.countryCode
  number:
    field: contacts.primary.phones.primary.number
  extension:
    field: contacts.primary.phones.primary.extension
  isMobile:
    field: contacts.primary.phones.primary.isMobile
x-entity:
  - poc
x-tags:
  - person
  - phone
required:
  - countryCode
  - number
properties:
  countryCode:
    type: string
    pattern: ^\+[1-9][0-9]{0,3}$
    description: The international country code (e.g., "+1" for US/Canada).
  number:
    type: string
    description: The local phone number without the country code.
  extension:
    type: string
    description: Optional extension number for the phone line.
  isMobile:
    type: boolean
    default: false
    description: Indicates whether this is a mobile/cell phone number.

UI Schema

Describes how to present the question in the form UI.

{
  "type": "Group",
  "label": "Primary Point of Contact Phone Number",
  "elements": [
    {
      "type": "Control",
      "scope": "#/properties/countryCode",
      "label": "Country Code"
    },
    {
      "type": "Control",
      "scope": "#/properties/number",
      "label": "Phone Number"
    },
    {
      "type": "Control",
      "scope": "#/properties/extension",
      "label": "Extension"
    },
    {
      "type": "Control",
      "scope": "#/properties/isMobile",
      "label": "Is Mobile?"
    }
  ]
}

Mappings

Mapping to CommonGrants

How to translate this question into the CommonGrants ProposalBase data model.

{
  "contacts": {
    "primary": {
      "phones": {
        "primary": {
          "countryCode": {
            "field": "countryCode"
          },
          "number": {
            "field": "number"
          },
          "extension": {
            "field": "extension"
          },
          "isMobile": {
            "field": "isMobile"
          }
        }
      }
    }
  }
}

Mapping from CommonGrants

How to pre-fill this question with data from the ProposalBase data model.

{
  "countryCode": {
    "field": "contacts.primary.phones.primary.countryCode"
  },
  "number": {
    "field": "contacts.primary.phones.primary.number"
  },
  "extension": {
    "field": "contacts.primary.phones.primary.extension"
  },
  "isMobile": {
    "field": "contacts.primary.phones.primary.isMobile"
  }
}