FieldReadConfiguration 構造体 - iOS

  • リリースバージョン: Xanadu
  • 更新日 2024年08月01日
  • 所要時間:3分
  • FieldReadConfiguration 構造体を使用すると、ServiceNowインスタンステーブルからフェッチするフィールドとその形式を構成できます。

    表 : 1. プロパティ
    名前 タイプ 説明
    includeField アレイ 返される結果で返されるフィールドのリスト。
    オプション アレイ 返されるフィールドのタイプのリスト。
    可能な値:
    • actualValues:参照レコードのsys_idsを含む、各フィールドに実際に格納されている値を返します。コード化可能モデルで日付を使用して日付をデコードする必要がある場合は、この設定を使用します。
    • description: パラメーターの説明を返します。
    • displayValues:選択したフィールドの表示Display values (使用可能な場合) を返します。たとえば、ユーザー名には通常、ユーザーレコードへの参照リンク (sys_id) が含まれています。表示値を要求すると、関連付けられたフィールドに格納されているsys_idではなく、個人の名前が返されます。
      注:
      ServiceNowインスタンスによって返される表示値は、認証されたユーザーのユーザープロファイル構成に基づいてフォーマットされ、国際化されます。これは、デバイスの言語やロケールの設定とは異なる場合があります。
    • excludeReferenceLink:テーブル内の参照リンクとして定義されているデータを返しません。
    • rawValue: パラメーターの生の値を返します。

    FieldReadConfiguration init(includeFields: [フィールド名] = [], options: options = [])

    REST エンドポイント呼び出しの戻り結果で返されるように、 ServiceNow テーブルのレコード内のフィールドを構成します。

    表 : 2. パラメーター
    名前 タイプ 説明
    includeField アレイ 返される結果で返されるフィールドのリスト。
    オプション アレイ 返されるフィールドのタイプのリスト。
    可能な値:
    • actualValues:参照レコードのsys_idsを含む、各フィールドに実際に格納されている値を返します。コード化可能モデルで日付を使用して日付をデコードする必要がある場合は、この設定を使用します。
    • description: パラメーターの説明を返します。
    • displayValues:選択したフィールドの表示Display values (使用可能な場合) を返します。たとえば、ユーザー名には通常、ユーザーレコードへの参照リンク (sys_id) が含まれています。表示値を要求すると、関連付けられたフィールドに格納されているsys_idではなく、個人の名前が返されます。
      注:
      ServiceNowインスタンスによって返される表示値は、認証されたユーザーのユーザープロファイル構成に基づいてフォーマットされ、国際化されます。これは、デバイスの言語やロケールの設定とは異なる場合があります。
    • excludeReferenceLink:テーブル内の参照リンクとして定義されているデータを返しません。
    • rawValue: パラメーターの生の値を返します。
    表 : 3. 返される内容
    タイプ 説明
    なし

    次のコード例は、この関数を呼び出す方法を示しています。

    /// The configuration for what to fetch from the Table API.
    lazy var fetchConfiguration: FetchConfiguration = {
      let includeFields = [
        // Case details
        "number",
        "short_description",
        "priority",
        "state",
        "opened_at",
                
        // Account details
        "account.name",
        "account.number",
        "contact.name",
        "contact.email",
        "contact_type",
    
        // Assignment
        "assignment_group.name",
        "assigned_to.name"
      ]
      let readConfiguration = FieldReadConfiguration(includeFields: includeFields, options: .actualValues)
      let filter = Filter(criteria: [], sortBy: [.desc("opened_at")], queryCategory: nil)
      return FetchConfiguration(filter: filter, limit: 10, readConfiguration: readConfiguration)
    }()