---
title: AddAttachment Web メソッドの使用
slug: neurons-for-itsm/admin-user-help/jpn/latest/addattachment-web
createdAt: 2026-10-29T01:28:26.101Z
---

指定されたビジネス オブジェクト レコードに添付ファイルを追加します。

## リクエスト構文

リクエストを準備する際には、次の構文を使用します。

```bash
FRSHEAT統合添付ファイル応答の追加
AddAttachment(文字列セッションキー、文字列テナントID、オブジェクトアタッチメントコマンドデータコマンドデータ)
```

## パラメータ

リクエストに次のパラメータを指定します。

:::Paragraph{indent="1"}
**sessionKey**: **Connect** Web メソッドからのセッション キー。
:::

:::Paragraph{indent="1"}
**tenantId**: セッション キーが認証されるテナント。
:::

:::Paragraph{indent="1"}
**commandData**: 作成要求に関する情報を含む構造体。
:::

```bash
パブリッククラス ObjectAttachmentCommandData
{
パブリック文字列 ObjectId;
パブリック文字列 ObjectType;
パブリック文字列ファイル名;
パブリックByte[]ファイルデータ;
パブリック ブール値 ForceSaveInDatabase;
}
```

:::Paragraph{indent="1"}
O`bjectAttachmentCommandDataに`次の属性を含めます:
:::

:::Paragraph{listStyleType="disc" indent="3"}
**ObjectId**: 新しい添付ファイルの RecID。
:::

:::Paragraph{listStyleType="disc" indent="3"}
**ObjectType**: この添付ファイルが添付されるメインビジネス オブジェクトのタイプ (オブジェクト参照表記法)。
:::

:::Paragraph{listStyleType="disc" indent="3"}
**fileName**: ファイルの名前。
:::

:::Paragraph{listStyleType="disc" indent="3"}
**fileData**: 実際のファイルバイト数。
:::

:::Paragraph{listStyleType="disc" indent="3"}
**ForceSaveInDatabase**: クライアントの構成に関係なく、添付ファイルをデータベースに保存します。 この属性はデフォルトでは false です。
:::

## 戻り値

**FRSHEATIntegrationAddAttachmentResponse** オブジェクトは次のように定義されます。

```bash
パブリッククラス FRSHEATIntegrationAddAttachmentResponse
    {
パブリック文字列ステータス { 取得; 設定; }
パブリック文字列例外理由 { 取得; 設定; }
    }
```

F**RSHEATIntegrationAddAttachmentResponse&#x20;**&#x30AF;ラスには次のフィールドがあります。

- **ステータス**: 接続の状態に関するステータスを提供します。 以下の表には、使用可能なステータス値の詳細な説明が記載されています。
- **exceptionReason**: この Web メソッドの実行時にアプリケーションが例外をスローした場合の例外情報が含まれます。

次の表に、使用可能なステータス値とその解釈方法を示します。

| <font color="#FFFFFF">**状態**</font> | <font color="#FFFFFF">**説明**</font>                                                                                                                                                                                                                                                                                                                                              |
| ----------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **成功**                              | ビジネス オブジェクト レコードに添付ファイルが正常に追加されました。                                                                                                                                                                                                                                                                                                                                              |
| **エラー**                             | ビジネス オブジェクト レコードに添付ファイルを追加できません。 例外情報は **exceptionReason** フィールドに保存されます。<br />よくあるエラーは次のとおりです。<br />アップロードされたファイルは制限されたファイル拡張子です。 アップロードに許可されているファイル拡張子のリストについては、システム管理者にお問い合わせください。<br />添付ファイルのファイル拡張子は、指定されたテナントでは許可されていません。<br />添付ファイルのアップロードに失敗しました。<br />アプリケーションはビジネス オブジェクト レコードを見つけることができません。<br />ビジネスオブジェクトの定義 \<Business Object><br />指定されたビジネス オブジェクトはテナントに存在しません。 |

## 例

次の例では、ユーザーのローカル ファイル アプリケーションからサンプル イメージを読み取り、指定されたインシデント レコードにファイルを添付します。

```bash
定数文字列ファイル名 = "C:\\\\Temp\\\\sample.jpg";

(FileStream fs = new FileStream(fileName, FileMode.Open, FileAccess.Read) を使用します)
{
(BinaryReader r = new BinaryReader(fs)) を使用します
{
byte[] AttachmentData = 新しいbyte[fs.Length];

(int i = 0; i < fs.Length; i ) の場合
{
AttachmentData[i] = r.ReadByte();
}

ObjectAttachmentCommandData data = new ObjectAttachmentCommandData()
{
ObjectId = "9981FBEBAA8B4EE2820364505855ABC2",
オブジェクトタイプ = "インシデント
ファイル名 = "sample.png",
ファイルデータ = 添付ファイルデータ
};

FRSHEATIntegrationAddAttachmentResponse response = frSvc.AddAttachment(authSessionKey, tenantId, data);
if (response.status != "Success")
{
Console.WriteLine("レコードに添付ファイルを追加中に次のエラーが発生しました: " response.exceptionReason);
}
}
}
```
