Mobile SDK API reference - iOS

The Mobile SDK for iOS provides the classes necessary to interface iOS-based devices with the ServiceNow platform.

It provides classes that enable you to create feature services such as chat, REST API interface, GraphQL, and web access, that allow you to create interactive applications on any iOS device.

For additional information on how to implement specific use cases using this API, see the Mobile SDK Developer Guide - iOS.

Table 1. Enumeration cases

Type	Description
NowAttachmentMetadata.State	Attachment metadata state. Possible values: available conditionally none pending unavailable
NowSDKError	Errors that can be thrown from the NowSDK module. Values configurationError missingAuthorizationProvider missingPermissionDelegate

• FetchConfiguration structure - iOS
  The FetchConfiguration structure provides the ability to define the configuration for fetching records from your ServiceNow instance.
• FieldReadConfiguration structure - iOS
  The FieldReadConfiguration structure enables you to configure which fields to fetch from a ServiceNow instance table and in which format.
• FieldWriteOptions class - iOS
  The FieldWriteOptions class provides functions that set the options for updating or creating fields in a record on a ServiceNow instance.
• Filter structure - iOS
  The Filter structure provides the ability to configure filters that define the data to return in the return results of a REST endpoint query.
• NowAnalyticsService protocol - iOS
  The NowAnalyticsService protocol provides functions that enable you to configure analytics properties, user settings, and events for managing the collection of user analytics data.
• NowAnalyticsServiceDelegate protocol - iOS
  The NowAnalyticsServiceDelegate protocol provides callback functions that provide information about the starting and ending of a user session and screen change detection.
• NowAPIEndpoint protocol - iOS
  The NowAPIEndpoint protocol provides an interface for accessing any publicly exposed ServiceNow REST APIs.
• NowAPIService class - iOS
  The NowAPIService class provides functions that enable you to perform requests to a specified ServiceNow REST API.
• NowAttachment structure - iOS
  The NowAttachment structure provides functions that enable you to validate attachments by comparing their computed hash.
• NowAttachmentMetadata structure - iOS
  The NowAttachmentMetadata structure provides functions that enable you to encode and manage attachment metadata.
• NowAttachmentService class - iOS
  The NowAttachmentService class provides functions that enable you to upload and query attachments that are associated with records within a table on a ServiceNow instance.
• NowAttachmentUploadConfiguration structure - iOS
  The NowAttachmentUploadConfiguration structure enables you to define the configuration information for an attachment that you are uploading to your ServiceNow instance.
• NowChat API - iOS
  The NowChat API is a top-level global API that enables users to instantiate a NowChat service instance.
• NowChatColoring protocol - iOS
  The NowChatColoring protocol defines default colors for the elements in the Live Agent and Virtual Agent chat UI.
• NowChatConfiguration - iOS
  The NowChatConfiguration class enables you to configure options on a chat session, such as showing a prompt before closing a chat window, disabling features while using chat, applying different conversation options when using chat, and configuring UI components in NowChat.
• NowChatService class - iOS
  The NowChatService class provides Virtual and Live Agent chat capabilities.
• NowChatServiceDelegate protocol - iOS
  The NowChatServiceDelegate protocol provides callbacks for notification of actions within the NowChatService such as a request to open a URL or dismiss the chat view controller.
• NowChatThemeable protocol - iOS
  The NowChatThemeable protocol provides properties that enable you to override the colors used within chat pages hosted on your ServiceNow instance.
• NowCoreService class - iOS
  The NowCoreService class provides fundamental services to the various SDK feature services. This class should only be instantiated by NowSDK.
• NowData framework - iOS
  The NowData framework contains methods that enable the instantiation of NowData services, such as NowGraphQLService, NowTableService, NowAPIService (for custom APIs), and NowAttachmentService.
• NowGraphQLService class - iOS
  The NowGraphQLService class provides functions that enable you to make requests using GraphQL queries against data on your ServiceNow instance through its GraphQL REST API.
• NowLoggingService class - iOS
  The NowLoggingService class provides functions that provide logging capabilities to feature services with the NowSDK.
• NowPush API - iOS
  The NowPush API is a top-level global API that enables users to instantiate a NowPush service instance.
• NowPushPayload protocol
  NowPushPayload is a generic protocol you can use to define a push notification protocol within the NowSDK framework.
• NowPushService class - iOS
  The NowPushService class provides functions that enable interaction with the Push Notification service.
• NowRecord class - iOS
  The NowRecord class defines a model that represents a record in a table on a ServiceNow instance.
• NowSDK framework - iOS
  The NowSDK framework contains methods that enable the instantiation of various feature services.
• NowSDKConfiguration class - iOS
  The NowSDKConfiguration class contains configuration information needed to initialize the NowSDK.
• NowService protocol - iOS
  The NowService protocol provides a single interface to the NowSDK for all feature services. It defines the configuration parameters needed to access your ServiceNow instance.
• NowServiceConfiguration structure - iOS
  The NowServiceConfiguration structure defines configuration information for a feature service.
• NowTableService class - iOS
  The NowTableService class provides functions that enable you to perform create, read, update, and delete operations on records of existing ServiceNow tables.
• NowWeb API - iOS
  The NowWeb API is a top-level global API that enables uses to instantiate a NowWeb service instance.
• NowWebColoring protocol - iOS
  The NowWebColoring protocol provides default values for the colors used within web pages hosted on your ServiceNow instance in a native web view.
• NowWebService class - iOS
  The NowWebService class provides functions that enable the browsing of web pages on a ServiceNow instance.
• NowWebThemeable protocol - iOS
  The NowWebThemeable protocol provides properties that enable you to override the colors used within web pages hosted on your ServiceNow instance in a native web view.
• NowWebViewController class - iOS
  The NowWebViewController class provides functions that enable you to manage a web viewer.
• NowWebViewControllerDelegate protocol - iOS
  The NowWebViewControllerDelegate protocol provides callbacks for notification of issues within the NowWebViewController processing such as when a flow ends or a navigation fails.
• Paginator API - iOS
  The Paginator class provides methods for iterating through a record set returned by a call to the ServiceNow Table API through the NowTableService. It is the object that is returned by the NowTableService paginator() methods. Do not call this method outside of that environment.
• SNMobileAnalytics API
  The SNMobileAnalytics API provides methods that you can call within a WebView using JavaScript. These methods enable you to push custom analytics data (events, pages, and user properties) to the User Experience Analytics for Service Portal dashboard.