---
sourceDocument: オーストラリア API リファレンス
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/api-reference

 Release :

    - australia

ft:locale :

    - ja-JP

ft:publication_title :

    - オーストラリア API リファレンス

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# NowAttachmentMetadata 構造体 : iOS

# NowAttachmentMetadata 構造体 : iOS {#ariaid-title1}

* リリースバージョン: Australia
* 
* 更新日 2026年03月12日
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：4分

NowAttachmentMetadata 構造体は、添付ファイルのメタデータをエンコードおよび管理できる関数を提供します。
{#NowAttachmentMetadataiOSStructure__table_vx2_klw_5pb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| averageImageColor | 文字列 | 関連付けられた画像の最も優勢な色。 |
| chunkSizeInBytes | 整数 | チャンクのサイズ。 単位:バイト |
| compressedSizeInBytes | 整数 | 添付ファイルの圧縮サイズ。 単位:バイト |
| created | 日付 | 添付ファイルが作成された日付。 |
| createdBy | 文字列 | 添付ファイルを作成したエンティティ。 |
| ダウンロード | URL | ServiceNowインスタンスの添付ファイルの URL。 |
| fileName | 文字列 | 添付ファイルの名前。 |
| hash | 文字列 | 添付ファイルに想定される SHA256 ダイジェスト。 ダウンロードされた添付 [ファイルは、](https://servicenow-prod.fluidtopics.net/y073ae_iOH8Bucur3mmDXw#NAttachiOS-validate "添付ファイルデータの計算されたハッシュを、添付ファイルのメタデータに保存されているダイジェストと比較して、添付ファイルを検証します。") 計算されたダイジェストをこの SHA256 ダイジェストと比較して検証されます。 |
| イメージの高さ | 整数 | 画像の高さ。 単位：ピクセル |
| 画像幅 | 整数 | 画像の幅。 単位：ピクセル |
| 圧縮済み | ブーリアン | 添付ファイルが圧縮されているかどうかを示すフラグ。 可能な値： * true:添付ファイルは圧縮されています。 * false:添付ファイルは圧縮されていません。 |
| mime タイプ | 文字列 | 添付ファイルの MIME タイプ。 |
| 変更カウント | 整数 | 添付ファイルが変更された回数。 |
| sizeInBytes | 整数 | 添付ファイルのサイズ。 単位:バイト |
| sourceSysId | 文字列 | 添付ファイルのSys_id。 |
| ソーステーブル名 | 文字列 | 添付ファイルが存在するソーステーブルの名前。 |
| state |   | 条件付き、利用不可、利用可能、保留中などの可用性ステータス。 |
| sysId | 文字列 | ServiceNowインスタンス内の各レコードを識別する一意の 32 文字のグローバル一意識別子 (GUID)。 |
| タグ | 文字列 | 添付ファイルに関連付けられているタグのリスト。 |
| updated | 日付 | 添付ファイルが最後に変更された日付。 |
| updatedBy | 文字列 | 添付ファイルを更新したエンティティ。 |
[表 : 1. プロパティ]

{#NowAttachmentMetadataiOSStructure__table_vx2_klw_5pb}

## NowAttachmentMetadata - encode(エンコーダーへ:エンコーダー) {#ariaid-title2}

指定されたエンコーダーを使用して、現在のオブジェクト値をデータにエンコードします。
オブジェクトがデータにエンコードされない場合、エンコーダーは代わりに空の [キー付きコンテナー](https://developer.apple.com/documentation/swift/keyeddecodingcontainer) をエンコードします。この関数は、指定されたエンコーダーの形式に無効な値がある場合にもエラーをスローします。
{#NAttMeta-encode_S__table_vx2_klw_5pb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| エンコーダーへ | [エンコーダー](https://developer.apple.com/documentation/swift/encoder) | エンコードされた出力の構造を定義するエンコーダー。 |
[表 : 2. パラメーター]

{#NAttMeta-encode_S__table_vx2_klw_5pb} {#NAttMeta-encode_S__table_wx2_klw_5pb__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 3. 返される内容]

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

    let query = "active=true^short_descriptionLIKEbroken"
    let filter = Filter(query: query)
    metadataPublisher(filter: filter, limit: 1)
    private func metadataPublisher(filter: Filter?, limit: Int?) {
      let publisher = attachmentService.attachmentMetadata(filter: filter, limit: limit)
      publisher
      .receive(on: DispatchQueue.main)
      .encode(encoder: JSONEncoder())
      .sink { [weak self] completion in
        if case let .failure(error) = completion {
          // attachment published failed, return NowDataError
        }
      } receiveValue: { [weak self] (data) in
        // Attachment published successful, return data
      }
      .store(in: &subscriptions)
    }

## NowAttachmentMetadata - init(デコーダー:デコーダーから) {#ariaid-title3}

指定されたデコーダーからオブジェクトにデータをデコードすることで、新しい NowAttachmentMetadata インスタンスを作成します。
このメソッドは、デコーダーからの読み取りが失敗した場合、またはデータの読み取りが破損している場合、またはその他の方法で無効な場合にエラーをスローします。
{#NAttMeta-init_S__table_phq_nkw_5pb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| デコーダー | デコーダー | データの読み取り元のデコーダー。 |
[表 : 4. パラメーター]

{#NAttMeta-init_S__table_phq_nkw_5pb} {#NAttMeta-init_S__table_qhq_nkw_5pb__entry__2}

| タイプ | 説明 |
|-|-|
| なし |   |
[表 : 5. 返される内容]

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

    guard 
      let metadataHeader = response.httpResponse?.value(forHTTPHeaderField: NowAttachment.attachmentMetadataHeaderKey),
      let metadataHeaderData = metadataHeader.data(using: .utf8) else {
        throw NowDataError.missingAttachmentMetadata
      }
                
    let metadata = try coder.decode(NowAttachmentMetadata.self, from: metadataHeaderData)
    let attachment = NowAttachment(metadata: metadata, data: response.data)