---
title: "GetItemFieldOptions"
slug: "api/basket/types/getitemfieldoptions"
sidebar:
  order: 319
---

<a id="ref-124575fdcda0"></a>
<a id="ref-455b347cf294"></a>
<a id="ref-01cb37dca08e"></a>

## Synopsis

```text
struct GetItemFieldOptions : ItemSelectionOptions {
    boolean *useDefault;
    boolean *expandVariables;
    boolean *resolveURI;
    boolean *useImageCache;
    boolean *generateImages;
}
```

See also: [`ItemSelectionOptions`](/pCon/configuratorOnline/specs/api/basket/types/itemselectionoptions#ref-96d714d65dbc)

The `options` parameter may specify the following options to control field access and representation of the return value:

**`useDefault`**

if true, and a field has no value, than the default value of the field (if any) will be used instead

**`expandVariables`**

if true, variables found in the field (or the field's default value) are expanded

**`resolveURI`**

if true, and the field is of a predefined column with attribute ID [`CatalogImage`](/pCon/configuratorOnline/specs/api/catalog/types/catalogimage), `ArticleImage` or GeneratedImage, or a user defined column with type Image, an attempt is made to interpret the field's value as an absolute URI and, if the URIs scheme is `file`, `gen` or imp, to produce an HTTP URL for this URI. If a HTTP URL could be produced, then the HTTP URL will be returned as the field's value. Otherwise, the original value of the field will be returned.

**`useImageCache`**

If specified and true, try to fetch the generated image from the global cache if the operation [`getItemFields`](/pCon/configuratorOnline/specs/api/basket/operations/getitemfields) has been called to return a generated image or article image and the current position does not already reference a generated image.

Default value: `false`

**`generateImages`**

If specified and true, try to fetch the generated image from the global cache if the operation [`getItemFields`](/pCon/configuratorOnline/specs/api/basket/operations/getitemfields) has been called to return a generated image or article image and the current position does not already reference a generated image. Generate the image if it has not been found in the cache.

Default value: `false`

Note: It is not possible to bypass the cache with useImageCache set to false and generateImages set to true. The latter one set to true always causes a cache lookup before the image is eventually generated.
