> Documentation index: https://www.gooddata.ai/docs/gooddata-ui/llms.txt lists every page of these docs as Markdown.

# IElementsQueryFactory

- Package: [@gooddata/sdk-backend-spi](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-backend-spi/index.md)
- Kind: interface
- Source: https://github.com/gooddata/gooddata-ui-sdk/blob/rel/11.64/libs/sdk-backend-spi/src/workspace/attributes/elements/index.ts

The attribute itself contains no view data, it's just a sequence of id's.

**Signature:**

```typescript
export interface IElementsQueryFactory 
```

## Remarks

To get data that is useful to users, we need to represent these id's with specific values. For this purpose, we pair the attribute with it's display form (specific representation of attribute values). An attribute can have multiple display forms.

## Methods

| Method | Description |
| --- | --- |
| [forDisplayForm(ref)](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-backend-spi/sdk-backend-spi.ielementsqueryfactory/index.md#ielementsqueryfactoryfordisplayform) | Query attribute elements represented by concrete display form |
| [forFilter(filter, dateFilterDisplayForm)](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-backend-spi/sdk-backend-spi.ielementsqueryfactory/index.md#ielementsqueryfactoryforfilter) | Query attribute elements used by provided filter |

## Method details

### IElementsQueryFactory.forDisplayForm()

Query attribute elements represented by concrete display form

**Signature:**

```typescript
forDisplayForm(ref: ObjRef): IElementsQuery;
```

#### Parameters

| Parameter | Type | Description |
| --- | --- | --- |
| ref | [ObjRef](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.objref/index.md) | display form ref |

**Returns:**

[IElementsQuery](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-backend-spi/sdk-backend-spi.ielementsquery/index.md)

instance that can be used to query attribute elements

### IElementsQueryFactory.forFilter()

Query attribute elements used by provided filter

**Signature:**

```typescript
forFilter(filter: FilterWithResolvableElements, dateFilterDisplayForm?: ObjRef): IFilterElementsQuery;
```

#### Parameters

| Parameter | Type | Description |
| --- | --- | --- |
| filter | [FilterWithResolvableElements](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-backend-spi/sdk-backend-spi.filterwithresolvableelements/index.md) | resolvable filter |
| dateFilterDisplayForm | [ObjRef](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-model/sdk-model.objref/index.md) | _(Optional)_ display form of resolvable filter if it is date filter |

**Returns:**

[IFilterElementsQuery](https://www.gooddata.ai/docs/gooddata-ui/latest/api-reference/sdk-backend-spi/sdk-backend-spi.ifilterelementsquery/index.md)

instance that can be used to query attribute elements