{"revision":"c10276e953456835cdbb1f3a60d58ae1980be353","document":{"id":206,"path":"api-reference/cllent-mobile-api-reference/FieldReadConfigurationiOSStruct.md","title":"FieldReadConfiguration structure - iOS","bundle":null,"doc_type":null,"release":"australia","body":"\n# FieldReadConfiguration structure- iOS\n\nThe FieldReadConfiguration structure enables you to configure which fields to fetch from a ServiceNow instance table and in which format.\n\n<table id=\"table_vx2_klw_5pb\" class=\"parameters\"><thead><tr><th>\n\nName\n\n</th><th>\n\nType\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nincludeFields\n\n</td><td>\n\nArray\n\n</td><td id=\"mobile_sdk_ios-includeFields-entry\">\n\nList of fields to pass back in the return results.\n\n</td></tr><tr><td>\n\noptions\n\n</td><td>\n\nArray\n\n</td><td id=\"mobile_sdk_ios-options-entry\">\n\nList of the types of fields to return.Possible values:\n\n-   actualValues: Returns the values actually stored in each of the fields, including the sys\\_ids for referenced records. Use this setting if dates need to be decoded in Codable models using Date.\n-   description: Returns the description of the parameter.\n-   displayValues: Returns the [display values](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/platform-administration/c_DisplayValues.md), if available, for the selected fields. For example, user names typically contain a reference link \\(sys\\_id\\) to the user record. If you request the display value, the person's name is returned instead of the sys\\_id that is stored in the associated field.\n\n**Note:** Display values returned by a ServiceNow instance are formatted and internationalized based on the user profile configuration of the authenticated user. This may differ from the device language and locale settings on the device.\n\n-   excludeReferenceLink: Does not return any data that is defined as reference links within the table.\n-   rawValue: Returns the raw value of the parameter.\n\n</td></tr></tbody>\n</table>**Parent Topic:**[Mobile SDK - iOS](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/cllent-mobile-api-reference/MobileSDKiOSAPI.md)\n\n## FieldReadConfiguration - init\\(includeFields: \\[FieldName\\] = \\[\\], options: Options = \\[\\]\\)\n\nConfigures the fields within a record in a ServiceNow table to pass back in the return results of a REST endpoint call.\n\n<table id=\"table_b5w_5sp_kqb\" class=\"parameters\"><thead><tr><th>\n\nName\n\n</th><th>\n\nType\n\n</th><th>\n\nDescription\n\n</th></tr></thead><tbody><tr><td>\n\nincludeFields\n\n</td><td>\n\nArray\n\n</td><td id=\"mobile_sdk_ios-includeFields-entry\">\n\nList of fields to pass back in the return results.\n\n</td></tr><tr><td>\n\noptions\n\n</td><td>\n\nArray\n\n</td><td id=\"mobile_sdk_ios-options-entry\">\n\nList of the types of fields to return.Possible values:\n\n-   actualValues: Returns the values actually stored in each of the fields, including the sys\\_ids for referenced records. Use this setting if dates need to be decoded in Codable models using Date.\n-   description: Returns the description of the parameter.\n-   displayValues: Returns the [display values](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/platform-administration/c_DisplayValues.md), if available, for the selected fields. For example, user names typically contain a reference link \\(sys\\_id\\) to the user record. If you request the display value, the person's name is returned instead of the sys\\_id that is stored in the associated field.\n\n**Note:** Display values returned by a ServiceNow instance are formatted and internationalized based on the user profile configuration of the authenticated user. This may differ from the device language and locale settings on the device.\n\n-   excludeReferenceLink: Does not return any data that is defined as reference links within the table.\n-   rawValue: Returns the raw value of the parameter.\n\n</td></tr></tbody>\n</table>|Type|Description|\n|----|-----------|\n|None| |\n\nThe following code example shows how to call this function.\n\n```\n/// The configuration for what to fetch from the Table API.\nlazy var fetchConfiguration: FetchConfiguration = {\n  let includeFields = [\n    // Case details\n    \"number\",\n    \"short_description\",\n    \"priority\",\n    \"state\",\n    \"opened_at\",\n            \n    // Account details\n    \"account.name\",\n    \"account.number\",\n    \"contact.name\",\n    \"contact.email\",\n    \"contact_type\",\n\n    // Assignment\n    \"assignment_group.name\",\n    \"assigned_to.name\"\n  ]\n  let readConfiguration = FieldReadConfiguration(includeFields: includeFields, options: .actualValues)\n  let filter = Filter(criteria: [], sortBy: [.desc(\"opened_at\")], queryCategory: nil)\n  return FetchConfiguration(filter: filter, limit: 10, readConfiguration: readConfiguration)\n}()\n```\n\n"}}