# Build Record Map from Field

Takes a collection of records as `input` and the name of a field and builds a [RecordMap](https://docs.gradient.works/kb/automation-builder-kit-abk/models/recordmap) where the keys are the values of the specified `keyField`. You can then use [Get Record from Record Map](https://docs.gradient.works/kb/automation-builder-kit-abk/actions/advanced/gwfxrecordmapgetaction) to get a record based on a key.

To use the [RecordMap](https://docs.gradient.works/kb/automation-builder-kit-abk/models/recordmap) later in your Flow, make sure to select `Store Output Variables` and assign it to a variable resource with a data type of `Apex-Defined` and an apex class of `GradientWorks__RecordMap`. When creating the resource, **do not** check "Allow multiple values (collection)".

For example, if you specify `input` as a collection of Leads and `keyField` as `Id`, this will generate a [RecordMap](https://docs.gradient.works/kb/automation-builder-kit-abk/models/recordmap) you can use to look up a Lead based on its `Id`.

## Inputs

| Name     | Required | Type           | Description                                                                                                                                                               |
| -------- | -------- | -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| input    | Yes      | List\<SObject> | A collection of input records to use for creating a [RecordMap](https://docs.gradient.works/kb/automation-builder-kit-abk/models/recordmap)                               |
| keyField | Yes      | String         | The field on each record containing the value to use for that record's key in the [RecordMap](https://docs.gradient.works/kb/automation-builder-kit-abk/models/recordmap) |

## Outputs

| Name      | Type                                                                                    | Description                                                                                                              |
| --------- | --------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| recordMap | [RecordMap](https://docs.gradient.works/kb/automation-builder-kit-abk/models/recordmap) | Contains records from the `input` collection that can be looked up using key values obtained from each item's `keyField` |