Principal Investigator Address

← Back to Question Bank

Details

Form

Sample version of the rendered form.

Principal Investigator Address

Street Address (Line 1)*

Street Address (Line 2)

City*

State*None

Country*

Postal Code*

Data

Form Data

What the form data looks like when it is submitted.

{
  "street1": "100 University Blvd",
  "city": "Cambridge",
  "state": "MA",
  "country": "US",
  "postalCode": "02139"
}

CommonGrants Data

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

{
  "contacts": {
    "otherContacts": {
      "principalInvestigator": {
        "addresses": {
          "primary": {
            "street1": "100 University Blvd",
            "city": "Cambridge",
            "stateOrProvince": "MA",
            "country": "US",
            "postalCode": "02139"
          }
        }
      }
    }
  }
}

Schemas

JSON Schema

Provides the structure and data validation for this question.

$id: QuestionPiAddress.yaml
type: object
unevaluatedProperties:
  not: {}
examples:
  - street1: 100 University Blvd
    city: Cambridge
    state: MA
    country: US
    postalCode: '02139'
  - street1: 456 Main St
    street2: Suite 100
    city: Anytown
    state: CA
    country: US
    postalCode: '12345'
description: A mailing address for the principal investigator
x-ui-schema:
  type: Group
  label: Principal Investigator Address
  elements:
    - type: Control
      scope: '#/properties/street1'
      label: Street Address (Line 1)
    - type: Control
      scope: '#/properties/street2'
      label: Street Address (Line 2)
    - type: Control
      scope: '#/properties/city'
      label: City
    - type: Control
      scope: '#/properties/state'
      label: State
    - type: Control
      scope: '#/properties/stateOrProvince'
      label: State or Province
      rule:
        effect: SHOW
        condition:
          scope: '#/properties/state'
          schema:
            pattern: ^Outside the US$
    - type: Control
      scope: '#/properties/country'
      label: Country
    - type: Control
      scope: '#/properties/postalCode'
      label: Postal Code
x-mapping-to-cg:
  contacts:
    otherContacts:
      principalInvestigator:
        addresses:
          primary:
            street1:
              field: street1
            street2:
              field: street2
            city:
              field: city
            stateOrProvince:
              field: state
            country:
              field: country
            postalCode:
              field: postalCode
x-mapping-from-cg:
  street1:
    field: contacts.otherContacts.principalInvestigator.addresses.primary.street1
  street2:
    field: contacts.otherContacts.principalInvestigator.addresses.primary.street2
  city:
    field: contacts.otherContacts.principalInvestigator.addresses.primary.city
  state:
    field: contacts.otherContacts.principalInvestigator.addresses.primary.stateOrProvince
  country:
    field: contacts.otherContacts.principalInvestigator.addresses.primary.country
  postalCode:
    field: contacts.otherContacts.principalInvestigator.addresses.primary.postalCode
x-entity:
  - principalInvestigator
x-tags:
  - person
  - address
required:
  - street1
  - city
  - state
  - country
  - postalCode
properties:
  street1:
    type: string
    description: The primary street address line
  street2:
    type: string
    description: Additional street address information
  city:
    type: string
    description: The city or municipality
  state:
    description: The US state, territory, or "Outside the US"
    $schema: https://json-schema.org/draft/2020-12/schema
    $id: USState.yaml
    type: string
    enum:
      - AL
      - AK
      - AZ
      - AR
      - CA
      - CO
      - CT
      - DE
      - FL
      - GA
      - HI
      - ID
      - IL
      - IN
      - IA
      - KS
      - KY
      - LA
      - ME
      - MD
      - MA
      - MI
      - MN
      - MS
      - MO
      - MT
      - NE
      - NV
      - NH
      - NJ
      - NM
      - NY
      - NC
      - ND
      - OH
      - OK
      - OR
      - PA
      - RI
      - SC
      - SD
      - TN
      - TX
      - UT
      - VT
      - VA
      - WA
      - WV
      - WI
      - WY
      - DC
      - AS
      - GU
      - MP
      - PR
      - VI
      - Outside the US
  stateOrProvince:
    type: string
    description: State or province name (for non-US addresses)
  country:
    type: string
    description: The country
  postalCode:
    type: string
    description: The postal or ZIP code

UI Schema

Describes how to present the question in the form UI.

{
  "type": "Group",
  "label": "Principal Investigator Address",
  "elements": [
    {
      "type": "Control",
      "scope": "#/properties/street1",
      "label": "Street Address (Line 1)"
    },
    {
      "type": "Control",
      "scope": "#/properties/street2",
      "label": "Street Address (Line 2)"
    },
    {
      "type": "Control",
      "scope": "#/properties/city",
      "label": "City"
    },
    {
      "type": "Control",
      "scope": "#/properties/state",
      "label": "State"
    },
    {
      "type": "Control",
      "scope": "#/properties/stateOrProvince",
      "label": "State or Province",
      "rule": {
        "effect": "SHOW",
        "condition": {
          "scope": "#/properties/state",
          "schema": {
            "pattern": "^Outside the US$"
          }
        }
      }
    },
    {
      "type": "Control",
      "scope": "#/properties/country",
      "label": "Country"
    },
    {
      "type": "Control",
      "scope": "#/properties/postalCode",
      "label": "Postal Code"
    }
  ]
}

Mappings

Mapping to CommonGrants

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

{
  "contacts": {
    "otherContacts": {
      "principalInvestigator": {
        "addresses": {
          "primary": {
            "street1": {
              "field": "street1"
            },
            "street2": {
              "field": "street2"
            },
            "city": {
              "field": "city"
            },
            "stateOrProvince": {
              "field": "state"
            },
            "country": {
              "field": "country"
            },
            "postalCode": {
              "field": "postalCode"
            }
          }
        }
      }
    }
  }
}

Mapping from CommonGrants

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

{
  "street1": {
    "field": "contacts.otherContacts.principalInvestigator.addresses.primary.street1"
  },
  "street2": {
    "field": "contacts.otherContacts.principalInvestigator.addresses.primary.street2"
  },
  "city": {
    "field": "contacts.otherContacts.principalInvestigator.addresses.primary.city"
  },
  "state": {
    "field": "contacts.otherContacts.principalInvestigator.addresses.primary.stateOrProvince"
  },
  "country": {
    "field": "contacts.otherContacts.principalInvestigator.addresses.primary.country"
  },
  "postalCode": {
    "field": "contacts.otherContacts.principalInvestigator.addresses.primary.postalCode"
  }
}