Key Contact
Summary
19 total questions | 84% mapped to the CommonGrants schema
List of key contacts for the application
Details
Sample version of the rendered form.
The organization's legal name
Contact's organizational affiliation if different from the applicant organization
County or parish of the contact address
Contact's fax number
This contact's role on the project (e.g. Project Director, Fiscal Contact)
Form Data
What the form data looks like when it is submitted.
{ "org": { "name": "Example Organization" }, "contact": { "name": { "prefix": "Dr.", "firstName": "Jane", "middleName": "Edward", "lastName": "Doe", "suffix": "Jr." }, "title": "Executive Director", "address": { "street1": "456 Main St", "street2": "Suite 100", "city": "Anytown", "state": "CA", "country": "US", "postalCode": "12345" }, "phone": { "countryCode": "+1", "number": "444-456-1230", "isMobile": true }, "email": "test@example.com" }, "contactOrganizationalAffiliation": "Test Organization", "contactCounty": "", "contactFax": "555-111-2222", "projectRole": "Project Director"}JSON Schema
Provides the structure and data validation for this form.
{ "title": "Key Contact", "description": "Grants.gov \"Key Contacts\" form (FID 683).\n\nCaptures the primary point of contact for a grant application along\nwith their role on the project. The applicant organization name doubles\nas the link to ApplicantInfo on full applications.", "type": "object", "required": [ "org", "contact", "projectRole" ], "properties": { "org": { "description": "Applicant organization", "type": "object", "required": [ "name" ], "properties": { "name": { "type": "string", "description": "The organization's legal name" } } }, "contact": { "description": "Primary point of contact for the project", "type": "object", "required": [ "name" ], "properties": { "name": { "description": "The contact's full name", "type": "object", "required": [ "firstName", "lastName" ], "properties": { "prefix": { "description": "Honorific prefix", "type": "string", "enum": [ "Mr.", "Ms.", "Mrs.", "Dr.", "Prof." ] }, "firstName": { "type": "string", "description": "First or given name" }, "middleName": { "type": "string", "description": "Middle name" }, "lastName": { "type": "string", "description": "Last or family name" }, "suffix": { "description": "Name suffix", "type": "string", "enum": [ "Jr.", "Sr.", "II", "III", "IV", "Ph.D.", "M.D.", "Esq." ] } } }, "title": { "type": "string", "description": "The contact's job title or role" }, "address": { "description": "The contact's mailing address", "type": "object", "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\"", "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" } } }, "phone": { "description": "The contact's phone number", "type": "object", "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." } } }, "email": { "description": "The contact's email address", "type": "string", "format": "email" } } }, "contactOrganizationalAffiliation": { "description": "Contact's organizational affiliation if different from the applicant organization", "type": "string", "minLength": 0, "maxLength": 60 }, "contactCounty": { "type": "string", "minLength": 0, "maxLength": 30, "description": "County or parish of the contact address" }, "contactFax": { "description": "Contact's fax number", "type": "string", "minLength": 0, "maxLength": 25 }, "projectRole": { "type": "string", "minLength": 1, "maxLength": 45, "description": "This contact's role on the project (e.g. Project Director, Fiscal Contact)" } }}UI Schema (merged)
Describes how to present the form. Reflects any per-form
x-overrides.uiSchema patches applied on top of the inherited
question-bank UI schemas.
{ "type": "VerticalLayout", "elements": [ { "type": "VerticalLayout", "elements": [ { "type": "Control", "scope": "#/properties/org/properties/name", "label": "Applicant Organization Name" } ] }, { "type": "Group", "label": "Primary Point of Contact Details", "elements": [ { "type": "Group", "label": "Name", "elements": [ { "type": "Control", "scope": "#/properties/contact/properties/name/properties/prefix", "label": "Prefix" }, { "type": "Control", "scope": "#/properties/contact/properties/name/properties/firstName", "label": "First Name" }, { "type": "Control", "scope": "#/properties/contact/properties/name/properties/middleName", "label": "Middle Name" }, { "type": "Control", "scope": "#/properties/contact/properties/name/properties/lastName", "label": "Last Name" }, { "type": "Control", "scope": "#/properties/contact/properties/name/properties/suffix", "label": "Suffix" } ] }, { "type": "Control", "scope": "#/properties/contact/properties/title", "label": "Job Title" }, { "type": "Group", "label": "Mailing Address", "elements": [ { "type": "Control", "scope": "#/properties/contact/properties/address/properties/street1", "label": "Street Address Line 1" }, { "type": "Control", "scope": "#/properties/contact/properties/address/properties/street2", "label": "Street Address Line 2" }, { "type": "Control", "scope": "#/properties/contact/properties/address/properties/city", "label": "City" }, { "type": "Control", "scope": "#/properties/contact/properties/address/properties/state", "label": "State" }, { "type": "Control", "scope": "#/properties/contact/properties/address/properties/country", "label": "Country" }, { "type": "Control", "scope": "#/properties/contact/properties/address/properties/postalCode", "label": "Zip / Postal Code" } ] }, { "type": "Group", "label": "Phone Number", "elements": [ { "type": "Control", "scope": "#/properties/contact/properties/phone/properties/countryCode", "label": "Country Code", "rule": { "effect": "HIDE", "condition": { "scope": "#/properties/contact/properties/phone/properties/countryCode", "schema": {} } } }, { "type": "Control", "scope": "#/properties/contact/properties/phone/properties/number", "label": "Telephone Number" }, { "type": "Control", "scope": "#/properties/contact/properties/phone/properties/extension", "label": "Extension", "rule": { "effect": "HIDE", "condition": { "scope": "#/properties/contact/properties/phone/properties/extension", "schema": {} } } }, { "type": "Control", "scope": "#/properties/contact/properties/phone/properties/isMobile", "label": "Is Mobile?", "rule": { "effect": "HIDE", "condition": { "scope": "#/properties/contact/properties/phone/properties/isMobile", "schema": {} } } } ] }, { "type": "Control", "scope": "#/properties/contact/properties/email", "label": "Email Address" } ] }, { "type": "Control", "scope": "#/properties/contactOrganizationalAffiliation", "label": "Organizational Affiliation" }, { "type": "Control", "scope": "#/properties/contactCounty", "label": "County" }, { "type": "Control", "scope": "#/properties/contactFax", "label": "Fax Number" }, { "type": "Control", "scope": "#/properties/projectRole", "label": "Project Role" } ]}Mapping to CommonGrants
How to translate this form into the CommonGrants data model.
{ "organizations": { "primary": { "name": { "field": "org.name" } } }, "contacts": { "primary": { "name": { "prefix": { "field": "contact.name.prefix" }, "firstName": { "field": "contact.name.firstName" }, "middleName": { "field": "contact.name.middleName" }, "lastName": { "field": "contact.name.lastName" }, "suffix": { "field": "contact.name.suffix" } }, "title": { "field": "contact.title" }, "addresses": { "primary": { "street1": { "field": "contact.address.street1" }, "street2": { "field": "contact.address.street2" }, "city": { "field": "contact.address.city" }, "stateOrProvince": { "field": "contact.address.state" }, "country": { "field": "contact.address.country" }, "postalCode": { "field": "contact.address.postalCode" } } }, "phones": { "primary": { "countryCode": { "field": "contact.phone.countryCode" }, "number": { "field": "contact.phone.number" }, "extension": { "field": "contact.phone.extension" }, "isMobile": { "field": "contact.phone.isMobile" } } }, "emails": { "primary": { "field": "contact.email" } } } }}Mapping from CommonGrants
How to pre-fill this form with data from the CommonGrants data model.
{ "org": { "name": { "field": "organizations.primary.name" } }, "contact": { "name": { "prefix": { "field": "contacts.primary.name.prefix" }, "firstName": { "field": "contacts.primary.name.firstName" }, "middleName": { "field": "contacts.primary.name.middleName" }, "lastName": { "field": "contacts.primary.name.lastName" }, "suffix": { "field": "contacts.primary.name.suffix" } }, "title": { "field": "contacts.primary.title" }, "address": { "street1": { "field": "contacts.primary.addresses.primary.street1" }, "street2": { "field": "contacts.primary.addresses.primary.street2" }, "city": { "field": "contacts.primary.addresses.primary.city" }, "state": { "field": "contacts.primary.addresses.primary.stateOrProvince" }, "country": { "field": "contacts.primary.addresses.primary.country" }, "postalCode": { "field": "contacts.primary.addresses.primary.postalCode" } }, "phone": { "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" } }, "email": { "field": "contacts.primary.emails.primary" } }, "projectRole": { "field": "customFields.projectRole.value" }}Per-form overrides (x-overrides)
The raw x-overrides block declared on the form spec.
Already merged into the UI schema and mappings shown above.
{ "uiSchema": { "contactOrganizationalAffiliation": { "label": "Organizational Affiliation" }, "contactCounty": { "label": "County" }, "contactFax": { "label": "Fax Number" }, "projectRole": { "label": "Project Role" }, "org.name": { "label": "Applicant Organization Name" }, "contact.phone.number": { "label": "Telephone Number" }, "contact.phone.countryCode": { "rule": { "effect": "HIDE", "condition": { "scope": "#/properties/contact/properties/phone/properties/countryCode", "schema": {} } } }, "contact.phone.extension": { "rule": { "effect": "HIDE", "condition": { "scope": "#/properties/contact/properties/phone/properties/extension", "schema": {} } } }, "contact.phone.isMobile": { "rule": { "effect": "HIDE", "condition": { "scope": "#/properties/contact/properties/phone/properties/isMobile", "schema": {} } } }, "contact.address.street1": { "label": "Street Address Line 1" }, "contact.address.street2": { "label": "Street Address Line 2" }, "contact.address.postalCode": { "label": "Zip / Postal Code" } }}