Project Details

← Back to Question Bank

Details

Form

Sample version of the rendered form.

Project Details

Project Title

Project DescriptionA project to improve health outcomes in rural communities.

Amount Requested

Amount*

Currency Code*

Project Start Date

Project End Date

Data

Form Data

What the form data looks like when it is submitted.

{
  "title": "Community Health Initiative",
  "description": "A project to improve health outcomes in rural communities.",
  "amountRequested": {
    "amount": "-50.50",
    "currency": "USD"
  },
  "startDate": "2026-01-01",
  "endDate": "2027-12-31"
}

CommonGrants Data

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

{
  "title": "Community Health Initiative",
  "description": "A project to improve health outcomes in rural communities.",
  "amountRequested": {
    "amount": "-50.50",
    "currency": "USD"
  },
  "projectTimeline": {
    "startDate": {
      "date": "2026-01-01"
    },
    "endDate": {
      "date": "2027-12-31"
    }
  }
}

Schemas

JSON Schema

Provides the structure and data validation for this question.

$id: QuestionProjectDetails.yaml
type: object
unevaluatedProperties:
  not: {}
description: A composite question capturing key project details for a proposal
x-ui-schema:
  type: Group
  label: Project Details
  elements:
    - type: Control
      scope: '#/properties/title'
      label: Project Title
    - type: Control
      scope: '#/properties/description'
      label: Project Description
      options:
        multi: true
    - type: Group
      label: Amount Requested
      elements:
        - type: Control
          scope: '#/properties/amountRequested/properties/amount'
          label: Amount
        - type: Control
          scope: '#/properties/amountRequested/properties/currency'
          label: Currency Code
    - type: Control
      scope: '#/properties/startDate'
      label: Project Start Date
    - type: Control
      scope: '#/properties/endDate'
      label: Project End Date
x-mapping-to-cg:
  title:
    field: title
  description:
    field: description
  amountRequested:
    amount:
      field: amountRequested.amount
    currency:
      field: amountRequested.currency
  projectTimeline:
    startDate:
      date:
        field: startDate
    endDate:
      date:
        field: endDate
x-mapping-from-cg:
  title:
    field: title
  description:
    field: description
  amountRequested:
    amount:
      field: amountRequested.amount
    currency:
      field: amountRequested.currency
  startDate:
    field: projectTimeline.startDate.date
  endDate:
    field: projectTimeline.endDate.date
x-entity:
  - project
x-tags:
  - details
  - proposal
properties:
  title:
    type: string
    examples:
      - Community Health Initiative
    description: The title of the project
  description:
    type: string
    examples:
      - A project to improve health outcomes in rural communities.
    description: A description of the project
  amountRequested:
    description: The amount of funding requested
    $schema: https://json-schema.org/draft/2020-12/schema
    $id: Money.yaml
    type: object
    required:
      - amount
      - currency
    unevaluatedProperties:
      not: {}
    examples:
      - amount: '-50.50'
        currency: USD
      - amount: '5000'
        currency: EUR
      - amount: '10000.50'
        currency: USD
    properties:
      amount:
        description: The amount of money
        $schema: https://json-schema.org/draft/2020-12/schema
        $id: decimalString.yaml
        type: string
        examples:
          - '-100.5'
          - '100.5'
          - '100'
        pattern: ^-?[0-9]+\.?[0-9]*$
      currency:
        type: string
        description: The ISO 4217 currency code in which the amount is denominated
  startDate:
    type: string
    examples:
      - '2026-01-01'
    format: date
    description: 'The project start date (ISO 8601 format: YYYY-MM-DD)'
  endDate:
    type: string
    examples:
      - '2027-12-31'
    format: date
    description: 'The project end date (ISO 8601 format: YYYY-MM-DD)'

UI Schema

Describes how to present the question in the form UI.

{
  "type": "Group",
  "label": "Project Details",
  "elements": [
    {
      "type": "Control",
      "scope": "#/properties/title",
      "label": "Project Title"
    },
    {
      "type": "Control",
      "scope": "#/properties/description",
      "label": "Project Description",
      "options": {
        "multi": true
      }
    },
    {
      "type": "Group",
      "label": "Amount Requested",
      "elements": [
        {
          "type": "Control",
          "scope": "#/properties/amountRequested/properties/amount",
          "label": "Amount"
        },
        {
          "type": "Control",
          "scope": "#/properties/amountRequested/properties/currency",
          "label": "Currency Code"
        }
      ]
    },
    {
      "type": "Control",
      "scope": "#/properties/startDate",
      "label": "Project Start Date"
    },
    {
      "type": "Control",
      "scope": "#/properties/endDate",
      "label": "Project End Date"
    }
  ]
}

Mappings

Mapping to CommonGrants

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

{
  "title": {
    "field": "title"
  },
  "description": {
    "field": "description"
  },
  "amountRequested": {
    "amount": {
      "field": "amountRequested.amount"
    },
    "currency": {
      "field": "amountRequested.currency"
    }
  },
  "projectTimeline": {
    "startDate": {
      "date": {
        "field": "startDate"
      }
    },
    "endDate": {
      "date": {
        "field": "endDate"
      }
    }
  }
}

Mapping from CommonGrants

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

{
  "title": {
    "field": "title"
  },
  "description": {
    "field": "description"
  },
  "amountRequested": {
    "amount": {
      "field": "amountRequested.amount"
    },
    "currency": {
      "field": "amountRequested.currency"
    }
  },
  "startDate": {
    "field": "projectTimeline.startDate.date"
  },
  "endDate": {
    "field": "projectTimeline.endDate.date"
  }
}