---
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


---

# GlideSysAttachment - スコープ指定

# GlideSysAttachment - スコープ指定 {#ariaid-title1}

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

GlideSysAttachment API は、添付ファイルを処理するメソッドを提供します。

getContent() が呼び出されると、コンテンツはバイト配列ではなく文字列として返されます。

getContentStream() が呼び出されると、コンテンツは GlideScriptableInputStream オブジェクトとして返されます。GlideScriptableInputStream には、文字列に変換されていない実際のバイトが含まれています。

## スコープ対象 GlideSysAttachment:GlideSysAttachment() {#ariaid-title2}

GlideSysAttachment クラスのインスタンスを作成します。
{#r_SGSA-GlideSysAttachment__table_iys_ctb_fv__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| なし |   |   |
[表 : 1. パラメーター]

{#r_SGSA-GlideSysAttachment__table_iys_ctb_fv}

## スコープ対象 GlideSysAttachment - addAttribute(String sysAttachmentID, String attrKey, String attrValue) {#ariaid-title3}

既存の添付ファイルレコードに単一の属性を追加します。
関連項目：

* [追加複数属性()](https://servicenow-prod.fluidtopics.net/~hUvydAM6YVlMlO8eJ4Gxw#SGSA-addMultipleAttributes_S_O "添付ファイルレコードに複数の属性を追加します。")
* [deleteAllAttributes()](https://servicenow-prod.fluidtopics.net/~hUvydAM6YVlMlO8eJ4Gxw#SGSA-deleteAllAttributes_S "既存の添付ファイルレコードからすべての属性を削除します。")
* [deleteAttribute()](https://servicenow-prod.fluidtopics.net/~hUvydAM6YVlMlO8eJ4Gxw#SGSA-deleteAttribute_S_S "添付ファイルレコードから指定された属性を削除します。")
* [fetchAllAttributes()](https://servicenow-prod.fluidtopics.net/~hUvydAM6YVlMlO8eJ4Gxw#SGSA-fetchAllAttributes_S "指定された添付ファイルレコードからすべての属性をフェッチします。")
* [fetchAttribute()](https://servicenow-prod.fluidtopics.net/~hUvydAM6YVlMlO8eJ4Gxw#SGSA-fetchAttribute_S_S "添付ファイルレコードから指定された属性をフェッチします。")
* [updateAllAttributes()](https://servicenow-prod.fluidtopics.net/~hUvydAM6YVlMlO8eJ4Gxw#SGSA-updateAllAttributes_S_O "既存の添付ファイルレコードのすべての属性を更新します。")
* [updateAttribute()](https://servicenow-prod.fluidtopics.net/~hUvydAM6YVlMlO8eJ4Gxw#SGSA-updateAttribute_S_S_S "既存の添付ファイルレコードの 1 つの属性を更新します。")

{#SGSA-addAttribute_S_S_S__ul_uwj_4yq_zfc}このメソッドをグローバルに同等にするには、 [GlideSysAttachment - addAttribute(String attrKey, String attrValue)](https://servicenow-prod.fluidtopics.net/J5vP65X5~TgcCegkFdQmGw#GSA-addAttribute_S_S "既存の添付ファイルレコードに単一の属性を追加します。")を使用します。
{#SGSA-addAttribute_S_S_S__table_rql_3mg_5fc__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| sysAttachmentID | 文字列 | 添付ファイル \[sys_attachment\] テーブルにリストされている添付ファイルの sys_id。 |
| 属性キー | 文字列 | 添付ファイル属性のキーと値のペアのキー部分。 |
| 属性値 | 文字列 | 添付ファイル属性のキーと値のペアの値の部分。 |
[表 : 2. パラメーター]

{#SGSA-addAttribute_S_S_S__table_rql_3mg_5fc} {#SGSA-addAttribute_S_S_S__table_sql_3mg_5fc__entry__2}

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

{#SGSA-addAttribute_S_S_S__table_sql_3mg_5fc}  
次の例は、キー <kbd class="ph userinput">作成者</kbd> と値 <kbd class="ph userinput">Fred Luddy</kbd> を持つ属性を、指定された添付ファイルに追加する方法を示しています。結果は、添付ファイル属性 \[sys_attachment_attribute\] テーブルに表示されます。

    var attach = new GlideSysAttachment();
    attach.addAttribute("9e1b714601932210f877b455304df0af", "author", "Fred Luddy");

    var result = attach.fetchAttribute("9e1b714601932210f877b455304df0af", "author");

    while(result.next()) {
       gs.info("Key: " + result.getValue('key') + " \nValue: " + result.getValue('value')); 
    }

出力:

    Key: author 
    Value: Fred Luddy

## スコープ付き GlideSysAttachment - addMultipleAttributes(String sysAttachmentID, Object attrsKeyValuePair) {#ariaid-title4}

添付ファイルレコードに複数の属性を追加します。
関連項目：

* [追加属性()](https://servicenow-prod.fluidtopics.net/~hUvydAM6YVlMlO8eJ4Gxw#SGSA-addAttribute_S_S_S "既存の添付ファイルレコードに単一の属性を追加します。")
* [deleteAllAttributes()](https://servicenow-prod.fluidtopics.net/~hUvydAM6YVlMlO8eJ4Gxw#SGSA-deleteAllAttributes_S "既存の添付ファイルレコードからすべての属性を削除します。")
* [deleteAttribute()](https://servicenow-prod.fluidtopics.net/~hUvydAM6YVlMlO8eJ4Gxw#SGSA-deleteAttribute_S_S "添付ファイルレコードから指定された属性を削除します。")
* [fetchAllAttributes()](https://servicenow-prod.fluidtopics.net/~hUvydAM6YVlMlO8eJ4Gxw#SGSA-fetchAllAttributes_S "指定された添付ファイルレコードからすべての属性をフェッチします。")
* [fetchAttribute()](https://servicenow-prod.fluidtopics.net/~hUvydAM6YVlMlO8eJ4Gxw#SGSA-fetchAttribute_S_S "添付ファイルレコードから指定された属性をフェッチします。")
* [updateAllAttributes()](https://servicenow-prod.fluidtopics.net/~hUvydAM6YVlMlO8eJ4Gxw#SGSA-updateAllAttributes_S_O "既存の添付ファイルレコードのすべての属性を更新します。")
* [updateAttribute()](https://servicenow-prod.fluidtopics.net/~hUvydAM6YVlMlO8eJ4Gxw#SGSA-updateAttribute_S_S_S "既存の添付ファイルレコードの 1 つの属性を更新します。")

{#SGSA-addMultipleAttributes_S_O__ul_uwj_4yq_zfc}このメソッドをグローバルに同等にするには、 [GlideSysAttachment:addMultipleAttributes(オブジェクトattrsKeyValuePair)](https://servicenow-prod.fluidtopics.net/J5vP65X5~TgcCegkFdQmGw#GSA-addMultipleAttributes_O "添付ファイルレコードに複数の属性を追加します。")を使用します。
{#SGSA-addMultipleAttributes_S_O__table_rql_3mg_5fc__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| sysAttachmentID | 文字列 | 添付ファイル \[sys_attachment\] テーブルにリストされている添付ファイルの sys_id。 |
| attrsKeyValuePair | オブジェクト | 一連のキーと値のペアの添付ファイル属性。各属性キーとその値は文字列として指定する必要があります。 たとえば、次のようになります。 var attachmentAttributes = { "description" : "Photo of the solar system", "dimensions" : "1600 x 300" } |
[表 : 4. パラメーター]

{#SGSA-addMultipleAttributes_S_O__table_rql_3mg_5fc} {#SGSA-addMultipleAttributes_S_O__table_sql_3mg_5fc__entry__2}

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

{#SGSA-addMultipleAttributes_S_O__table_sql_3mg_5fc}  
次の例は、指定した添付ファイルに属性を追加する方法を示しています。結果は、添付ファイル属性 \[sys_attachment_attribute\] テーブルでも確認できます。

    var attach = new GlideSysAttachment();

    var attachmentID = '9e1b714601932210f877b455304df0af';

    var attrsKeyValuePair = { };
      attrsKeyValuePair["title"]  = "Add multiple attributes to an attachment";
      attrsKeyValuePair["category"] =  "KB";
      attrsKeyValuePair["length"] =  "5000";

    attach.addMultipleAttributes(attachmentID, attrsKeyValuePair);

    var result = attach.fetchAllAttributes(attachmentID);

    while(result.next()) {
       gs.info("Key: " + result.getValue('key') + ", Value: " + result.getValue('value'));
    }

出力:

    Key: title, Value: Add multiple attributes to an attachment
    Key: author, Value: Abel Tuter
    Key: category, Value: KB
    Key: length, Value: 5000

## スコープ対象 GlideSysAttachment - copy(String sourceTable, String sourceID, String targetTable, String targetID) {#ariaid-title5}

ソースレコードからターゲットレコードに添付ファイルをコピーします。
注:  
添付ファイルをコピーすると、それに割り当てられているすべての属性もコピーされます。添付ファイル属性 \[sys_attachment_list\] テーブルでアサインされた属性のリストを表示するか、 fetchAllAttributes() メソッドを実行できます。
{#r_SGSA-copy_S_S_S_S__id_kdj_vjz_g5b__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| sourceTable | 文字列 | コピーする添付ファイルを含むテーブルの名前。 |
| ソース ID | 文字列 | ソーステーブルのsys_id。 |
| targetTable | 文字列 | 添付ファイルを追加するテーブルの名前。 |
| ターゲット ID | 文字列 | 添付ファイルをコピーするターゲットテーブル内のレコードのsys_id。 |
[表 : 6. パラメーター]

{#r_SGSA-copy_S_S_S_S__id_kdj_vjz_g5b} {#r_SGSA-copy_S_S_S_S__id_db3_wjz_g5b__entry__2}

| タイプ | 説明 |
|-|-|
| 文字列 | コピーされた添付ファイルの sys_ids のアレイ。 テーブル:添付ファイル \[sys_attachment\] |
[表 : 7. 返される内容]

{#r_SGSA-copy_S_S_S_S__id_db3_wjz_g5b}  
この例では、インシデントレコードから問題レコードに添付ファイルをコピーする方法を示します。

    var attachment = new GlideSysAttachment();
    var incidentSysID = 'ab1b30031b04ec101363ff37dc4bcbfc';
    var incGR = new GlideRecord('incident');
    incGR.get(incidentSysID);

    var copiedAttachments = attachment.copy('incident', incidentSysID, 'problem', incGR.getValue('problem_id'));
    gs.info('Copied attachments: ' + copiedAttachments);

出力：

    Copied attachments: 6e4621df1bc420501363ff37dc4bcbb0,a87769531b0820501363ff37dc4bcba2

## スコープ付き GlideSysAttachment - deleteAllAttributes(String sysAttachmentID) {#ariaid-title6}

既存の添付ファイルレコードからすべての属性を削除します。
関連項目：

* [追加属性()](https://servicenow-prod.fluidtopics.net/~hUvydAM6YVlMlO8eJ4Gxw#SGSA-addAttribute_S_S_S "既存の添付ファイルレコードに単一の属性を追加します。")
* [追加複数属性()](https://servicenow-prod.fluidtopics.net/~hUvydAM6YVlMlO8eJ4Gxw#SGSA-addMultipleAttributes_S_O "添付ファイルレコードに複数の属性を追加します。")
* [deleteAttribute()](https://servicenow-prod.fluidtopics.net/~hUvydAM6YVlMlO8eJ4Gxw#SGSA-deleteAttribute_S_S "添付ファイルレコードから指定された属性を削除します。")
* [fetchAllAttributes()](https://servicenow-prod.fluidtopics.net/~hUvydAM6YVlMlO8eJ4Gxw#SGSA-fetchAllAttributes_S "指定された添付ファイルレコードからすべての属性をフェッチします。")
* [fetchAttribute()](https://servicenow-prod.fluidtopics.net/~hUvydAM6YVlMlO8eJ4Gxw#SGSA-fetchAttribute_S_S "添付ファイルレコードから指定された属性をフェッチします。")
* [updateAllAttributes()](https://servicenow-prod.fluidtopics.net/~hUvydAM6YVlMlO8eJ4Gxw#SGSA-updateAllAttributes_S_O "既存の添付ファイルレコードのすべての属性を更新します。")
* [updateAttribute()](https://servicenow-prod.fluidtopics.net/~hUvydAM6YVlMlO8eJ4Gxw#SGSA-updateAttribute_S_S_S "既存の添付ファイルレコードの 1 つの属性を更新します。")

{#SGSA-deleteAllAttributes_S__ul_uwj_4yq_zfc}このメソッドをグローバルに同等にするには、 [GlideSysAttachment:deleteAllAttributes()](https://servicenow-prod.fluidtopics.net/J5vP65X5~TgcCegkFdQmGw#GSA-deleteAllAttributes "既存の添付ファイルレコードからすべての属性を削除します。")を使用します。
{#SGSA-deleteAllAttributes_S__table_rql_3mg_5fc__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| sysAttachmentID | 文字列 | 添付ファイル \[sys_attachment\] テーブルにリストされている添付ファイルの sys_id。 |
[表 : 8. パラメーター]

{#SGSA-deleteAllAttributes_S__table_rql_3mg_5fc} {#SGSA-deleteAllAttributes_S__table_sql_3mg_5fc__entry__2}

| タイプ | 説明 |
|-|-|
| ブール | 属性が正常に削除されたかどうかを示すフラグ。 有効な値： * true:属性が正常に削除されました。 * false:属性は正常に削除されませんでした。 {#SGSA-deleteAllAttributes_S__ul_kwy_cth_5fc} |
[表 : 9. 返される内容]

{#SGSA-deleteAllAttributes_S__table_sql_3mg_5fc}  
次の例は、指定した添付ファイルに割り当てられたすべての属性を削除する方法を示しています。結果は、添付ファイル属性 \[sys_attachment_attribute\] テーブルでも確認できます。

    var attach = new GlideSysAttachment();

    var attachmentID = '9e1b714601932210f877b455304df0af';

    attach.deleteAllAttributes(attachmentID);

    var result = attach.fetchAllAttributes(attachmentID);

    while(result.next()) {
       gs.info("Key: " + result.getValue('key') + ", Value: " + result.getValue('value')); 
    }

出力：

    Attribute "null" not found for attachment "04f48541083e2e50f877df7a115e31f3"

## スコープ対象 GlideSysAttachment:deleteAttachment(文字列 attachmentID) {#ariaid-title7}

指定した添付ファイルを削除します。
注:  
添付ファイルを削除すると、その添付ファイルにアサインされている属性も削除されます。アサインされた属性のリストを添付ファイル属性 \[sys_attachment\] テーブルで表示するか、 fetchAllAttributes() メソッドを実行できます。
{#r_SGSA-deleteAttachment_S__id_ajy_dlz_g5b__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| attachmentID | 文字列 | 添付ファイルのsys_id。 テーブル:添付ファイル \[sys_attachment\] |
[表 : 10. パラメーター]

{#r_SGSA-deleteAttachment_S__id_ajy_dlz_g5b} {#r_SGSA-deleteAttachment_S__table_gjy_lyb_fv__entry__2}

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

{#r_SGSA-deleteAttachment_S__table_gjy_lyb_fv}  

    var attachment = new GlideSysAttachment();
    var attachmentSysID = 'a87769531b0820501363ff37dc4bcba2';
    attachment.deleteAttachment(attachmentSysID);

## スコープ対象 GlideSysAttachment - deleteAttribute(String sysAttachmentID, String attrKey) {#ariaid-title8}

添付ファイルレコードから指定された属性を削除します。
関連項目：

* [追加属性()](https://servicenow-prod.fluidtopics.net/~hUvydAM6YVlMlO8eJ4Gxw#SGSA-addAttribute_S_S_S "既存の添付ファイルレコードに単一の属性を追加します。")
* [追加複数属性()](https://servicenow-prod.fluidtopics.net/~hUvydAM6YVlMlO8eJ4Gxw#SGSA-addMultipleAttributes_S_O "添付ファイルレコードに複数の属性を追加します。")
* [deleteAllAttributes()](https://servicenow-prod.fluidtopics.net/~hUvydAM6YVlMlO8eJ4Gxw#SGSA-deleteAllAttributes_S "既存の添付ファイルレコードからすべての属性を削除します。")
* [fetchAllAttributes()](https://servicenow-prod.fluidtopics.net/~hUvydAM6YVlMlO8eJ4Gxw#SGSA-fetchAllAttributes_S "指定された添付ファイルレコードからすべての属性をフェッチします。")
* [fetchAttribute()](https://servicenow-prod.fluidtopics.net/~hUvydAM6YVlMlO8eJ4Gxw#SGSA-fetchAttribute_S_S "添付ファイルレコードから指定された属性をフェッチします。")
* [updateAllAttributes()](https://servicenow-prod.fluidtopics.net/~hUvydAM6YVlMlO8eJ4Gxw#SGSA-updateAllAttributes_S_O "既存の添付ファイルレコードのすべての属性を更新します。")
* [updateAttribute()](https://servicenow-prod.fluidtopics.net/~hUvydAM6YVlMlO8eJ4Gxw#SGSA-updateAttribute_S_S_S "既存の添付ファイルレコードの 1 つの属性を更新します。")

{#SGSA-deleteAttribute_S_S__ul_uwj_4yq_zfc}このメソッドをグローバルに同等にするには、 [GlideSysAttachment:deleteAttribute(文字列 attrKey)](https://servicenow-prod.fluidtopics.net/J5vP65X5~TgcCegkFdQmGw#GSA-deleteAttribute_S "添付ファイルレコードから指定された属性を削除します。")を使用します。
{#SGSA-deleteAttribute_S_S__table_rql_3mg_5fc__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| sysAttachmentID | 文字列 | 添付ファイル \[sys_attachment\] テーブルにリストされている添付ファイルの sys_id。 |
| 属性キー | 文字列 | 添付ファイル属性のキーと値のペアのキー部分。 |
[表 : 12. パラメーター]

{#SGSA-deleteAttribute_S_S__table_rql_3mg_5fc} {#SGSA-deleteAttribute_S_S__table_sql_3mg_5fc__entry__2}

| タイプ | 説明 |
|-|-|
| ブール | 添付ファイル属性が正常に削除されたかどうかを示すフラグ。 有効な値： * true:添付ファイル属性が正常に削除されました。 * false:添付ファイル属性は正常に削除されませんでした。 {#SGSA-deleteAttribute_S_S__ul_val_cth_5fc} |
[表 : 13. 返される内容]

{#SGSA-deleteAttribute_S_S__table_sql_3mg_5fc}  
次の例は、キー <kbd class="ph userinput">作成者</kbd>を持つ指定された添付ファイルに割り当てられた属性を削除する方法を示しています。結果は、添付ファイル属性 \[sys_attachment_attribute\] テーブルでも確認できます。

    var attach = new GlideSysAttachment();

    var attachmentID = '9e1b714601932210f877b455304df0af';

    attach.deleteAttribute(attachmentID, "author");

    var result = attach.fetchAttribute(attachmentID, "author");

    while(result.next()) {
       gs.info("Key: " + result.getValue('key') + " \nValue: " + result.getValue('value')); 
    }

出力：

    Attribute "author" not found for attachment "04f48541083e2e50f877df7a115e31f3"

## スコープ対象 GlideSysAttachment: fetchAllAttributes(String sysAttachmentID) {#ariaid-title9}

指定された添付ファイルレコードからすべての属性をフェッチします。
関連項目：

* [追加属性()](https://servicenow-prod.fluidtopics.net/~hUvydAM6YVlMlO8eJ4Gxw#SGSA-addAttribute_S_S_S "既存の添付ファイルレコードに単一の属性を追加します。")
* [追加複数属性()](https://servicenow-prod.fluidtopics.net/~hUvydAM6YVlMlO8eJ4Gxw#SGSA-addMultipleAttributes_S_O "添付ファイルレコードに複数の属性を追加します。")
* [deleteAllAttributes()](https://servicenow-prod.fluidtopics.net/~hUvydAM6YVlMlO8eJ4Gxw#SGSA-deleteAllAttributes_S "既存の添付ファイルレコードからすべての属性を削除します。")
* [deleteAttribute()](https://servicenow-prod.fluidtopics.net/~hUvydAM6YVlMlO8eJ4Gxw#SGSA-deleteAttribute_S_S "添付ファイルレコードから指定された属性を削除します。")
* [fetchAttribute()](https://servicenow-prod.fluidtopics.net/~hUvydAM6YVlMlO8eJ4Gxw#SGSA-fetchAttribute_S_S "添付ファイルレコードから指定された属性をフェッチします。")
* [updateAllAttributes()](https://servicenow-prod.fluidtopics.net/~hUvydAM6YVlMlO8eJ4Gxw#SGSA-updateAllAttributes_S_O "既存の添付ファイルレコードのすべての属性を更新します。")
* [updateAttribute()](https://servicenow-prod.fluidtopics.net/~hUvydAM6YVlMlO8eJ4Gxw#SGSA-updateAttribute_S_S_S "既存の添付ファイルレコードの 1 つの属性を更新します。")

{#SGSA-fetchAllAttributes_S__ul_uwj_4yq_zfc}このメソッドをグローバルに同等にするには、 [GlideSysAttachment:fetchAllAttributes()](https://servicenow-prod.fluidtopics.net/J5vP65X5~TgcCegkFdQmGw#GSA-fetchAllAttributes "指定された添付ファイルレコードからすべての属性をフェッチします。")を使用します。
{#SGSA-fetchAllAttributes_S__table_rql_3mg_5fc__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| sysAttachmentID | 文字列 | 添付ファイル \[sys_attachment\] テーブルにリストされている添付ファイルの sys_id。 |
[表 : 14. パラメーター]

{#SGSA-fetchAllAttributes_S__table_rql_3mg_5fc} {#SGSA-fetchAllAttributes_S__table_sql_3mg_5fc__entry__2}

| タイプ | 説明 |
|-|-|
| [GlideRecord](https://servicenow-prod.fluidtopics.net/sq3Fh7Z2Yb_KuRvql0AZmg#c_GlideRecordScopedAPI "スコープ対象の GlideRecord API は、データベース操作に使用されます。") | 添付ファイルレコードとそのすべての属性。 |
[表 : 15. 返される内容]

{#SGSA-fetchAllAttributes_S__table_sql_3mg_5fc}  
次の例は、指定された添付ファイルに割り当てられたすべての属性を取得する方法を示しています。

    var attach = new GlideSysAttachment();

    var attachmentID = '9e1b714601932210f877b455304df0af';

    var result = attach.fetchAllAttributes(attachmentID);

    while(result.next()) {
       gs.info("Key: " + result.getValue('key') + ", Value: " + result.getValue('value')); 
    }

出力：

    Key: title, Value: Add multiple attributes to an attachment
    Key: author, Value: Abel Tuter
    Key: category, Value: KB
    Key: length, Value: 5000

## スコープ対象 GlideSysAttachment - fetchAttribute(String sysAttachmentID, String attrKey) {#ariaid-title10}

添付ファイルレコードから指定された属性をフェッチします。
関連項目：

* [追加属性()](https://servicenow-prod.fluidtopics.net/~hUvydAM6YVlMlO8eJ4Gxw#SGSA-addAttribute_S_S_S "既存の添付ファイルレコードに単一の属性を追加します。")
* [追加複数属性()](https://servicenow-prod.fluidtopics.net/~hUvydAM6YVlMlO8eJ4Gxw#SGSA-addMultipleAttributes_S_O "添付ファイルレコードに複数の属性を追加します。")
* [deleteAllAttributes()](https://servicenow-prod.fluidtopics.net/~hUvydAM6YVlMlO8eJ4Gxw#SGSA-deleteAllAttributes_S "既存の添付ファイルレコードからすべての属性を削除します。")
* [deleteAttribute()](https://servicenow-prod.fluidtopics.net/~hUvydAM6YVlMlO8eJ4Gxw#SGSA-deleteAttribute_S_S "添付ファイルレコードから指定された属性を削除します。")
* [fetchAllAttributes()](https://servicenow-prod.fluidtopics.net/~hUvydAM6YVlMlO8eJ4Gxw#SGSA-fetchAllAttributes_S "指定された添付ファイルレコードからすべての属性をフェッチします。")
* [updateAllAttributes()](https://servicenow-prod.fluidtopics.net/~hUvydAM6YVlMlO8eJ4Gxw#SGSA-updateAllAttributes_S_O "既存の添付ファイルレコードのすべての属性を更新します。")
* [updateAttribute()](https://servicenow-prod.fluidtopics.net/~hUvydAM6YVlMlO8eJ4Gxw#SGSA-updateAttribute_S_S_S "既存の添付ファイルレコードの 1 つの属性を更新します。")

{#SGSA-fetchAttribute_S_S__ul_uwj_4yq_zfc}このメソッドをグローバルに同等にするには、 [GlideSysAttachment:fetchAttribute(文字列 attrKey)](https://servicenow-prod.fluidtopics.net/J5vP65X5~TgcCegkFdQmGw#GSA-fetchAttribute "添付ファイルレコードから指定された属性をフェッチします。")を使用します。
{#SGSA-fetchAttribute_S_S__table_rql_3mg_5fc__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| sysAttachmentID | 文字列 | 添付ファイル \[sys_attachment\] テーブルにリストされている添付ファイルの sys_id。 |
| 属性キー | 文字列 | 添付ファイル属性のキーと値のペアのキー部分。 |
[表 : 16. パラメーター]

{#SGSA-fetchAttribute_S_S__table_rql_3mg_5fc} {#SGSA-fetchAttribute_S_S__table_sql_3mg_5fc__entry__2}

| タイプ | 説明 |
|-|-|
| [GlideRecord](https://servicenow-prod.fluidtopics.net/sq3Fh7Z2Yb_KuRvql0AZmg#c_GlideRecordScopedAPI "スコープ対象の GlideRecord API は、データベース操作に使用されます。") | 添付ファイルと指定された属性の GlideRecord。 |
[表 : 17. 返される内容]

{#SGSA-fetchAttribute_S_S__table_sql_3mg_5fc}  
次の例は、キー <kbd class="ph userinput">作成者</kbd>を持つ添付ファイル属性を取得する方法を示しています。

    var attach = new GlideSysAttachment();

    var attachmentID = '9e1b714601932210f877b455304df0af';

    var result = attach.fetchAttribute(attachmentID, "author");

    while(result.next()) {
       gs.info("Key: " + result.getValue('key') + " \nValue: " + result.getValue('value')); 
    }

出力：

    Key: author 
    Value: Abel Tuter

## スコープ対象 GlideSysAttachment:getAttachments(String tableName, String sys_id) {#ariaid-title11}

名前、タイプ、サイズなど、一致する添付ファイルメタデータを含む GlideRecord を返します。
{#r_SGSA-getAttachments_S_S__id_bvk_jmz_g5b__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| tableName | 文字列 | 添付ファイルが属するテーブルの名前。たとえば、インシデントなどです。 |
| sys_id | 文字列 | 添付ファイルが属するレコードのSys_id。 |
[表 : 18. パラメーター]

{#r_SGSA-getAttachments_S_S__id_bvk_jmz_g5b} {#r_SGSA-getAttachments_S_S__id_urm_kmz_g5b__entry__2}

| タイプ | 説明 |
|-|-|
| GlideRecord | 名前、タイプ、サイズなど、一致する添付ファイルのメタデータを含む GlideRecord オブジェクト。 |
[表 : 19. 返される内容]

{#r_SGSA-getAttachments_S_S__id_urm_kmz_g5b}  
次のスクリプトは、2 つの添付ファイルを持つレコードの添付ファイル名を一覧表示します。

    var attachment = new GlideSysAttachment();

    var agr = attachment.getAttachments('<table_name>', '<record_sys_id>');

    while(agr.next())
    gs.info(agr.getValue('file_name'));

出力：

    *** Script: filename1.txt
    *** Script: filename2.txt

## スコープ付き GlideSysAttachment - getContent(GlideRecord sysAttachment) {#ariaid-title12}

添付ファイルの内容を文字列として返します。
このメソッドは、スコープ対象のアプリケーションでのみ使用します。このメソッドは、グローバルスコープで使用される場合、 `undefined` を返します。グローバルスコープで添付ファイルの内容を読み取るには、GlideSysAttachment - グローバル API の getContentStream() メソッドを使用します。  
このメソッドは、添付ファイルに対して次のファイルタイプをサポートしています。

* CSV (\*.csv)
* JSON (\*.json)
* テキスト (\*.txt)
{#r_SGSA-getContent_GR__ul_zd2_w21_cwb}
{#r_SGSA-getContent_GR__table_r2d_cng_2v__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| sysAttachment | GlideRecord | 添付ファイルレコード。 |
[表 : 20. パラメーター]

{#r_SGSA-getContent_GR__table_r2d_cng_2v} {#r_SGSA-getContent_GR__table_s2d_cng_2v__entry__2}

| タイプ | 説明 |
|-|-|
| 文字列 | 文字列としての添付ファイルのコンテンツ。最大 5 MB のデータを返します。 |
[表 : 21. 返される内容]

{#r_SGSA-getContent_GR__table_s2d_cng_2v}  

    var attachment = new GlideSysAttachment();

    var agr = attachment.getAttachments('incident', '78271e1347c12200e0ef563dbb9a7109'); //create attachment GlideRecord

    while(agr.next()) { //for each attachment on the incident record
       gs.info(agr.getValue('file_name')); //print file name of attachment
       var attachmentContent = attachment.getContent(agr);
       gs.info('Attachment content: ' + attachmentContent); //print attachment content
    }

出力:

    Doc1.txt
    Attachment content: I am text in a txt file attached to a record.

## スコープ付き GlideSysAttachment:getContentBase64(GlideRecord sysAttachment) {#ariaid-title13}

添付ファイルの内容を base64 エンコーディングの文字列として返します。
このメソッドは、スコープ対象のアプリケーションでのみ使用します。このメソッドは、グローバルスコープで使用される場合、 `undefined` を返します。グローバルスコープで添付ファイルのコンテンツを読み取るには、GlideSysAttachment - グローバル API の getContentStream メソッドを使用します。
{#r_SGSA-getContentBase64_GR__table_kds_4sb_fv__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| sysAttachment | GlideRecord | 添付ファイルレコード。 |
[表 : 22. パラメーター]

{#r_SGSA-getContentBase64_GR__table_kds_4sb_fv} {#r_SGSA-getContentBase64_GR__table_lds_4sb_fv__entry__2}

| タイプ | 説明 |
|-|-|
| 文字列 | base64 エンコーディングの文字列としての添付ファイルのコンテンツ。最大 5 MB のデータを返します。 |
[表 : 23. 返される内容]

{#r_SGSA-getContentBase64_GR__table_lds_4sb_fv}  

    var attachment = new GlideSysAttachment();

    var agr = attachment.getAttachments('incident', '78271e1347c12200e0ef563dbb9a7109'); //create attachment GlideRecord

    while(agr.next()) { //for each attachment on the incident record
       gs.info(agr.getValue('file_name')); //print file name of attachment
       var attachmentContent = attachment.getContentBase64(agr);
       gs.info('Attachment content: ' + attachmentContent); //print attachment content
    }

出力:

    Doc1.txt
    Attachment content: SSBhbSB0ZXh0IGluIGEgdHh0IGZpbGUgYXR0YWNoZWQgdG8gYSByZWNvcmQuIA0=

## スコープ対象 GlideSysAttachment:getContentStream(文字列 sysID) {#ariaid-title14}

添付ファイルのsys_idを指定して GlideScriptableInputStream オブジェクトを返します。
[GlideTextReader](https://servicenow-prod.fluidtopics.net/Wv_A3GOCGt_m5ont94na7w#c_GlideTextReaderScopedAPI "GlideTextReader API は、入力ストリームから 1 行を読み取る機能を提供します。入力ストリームが使用されるため、5MB の添付ファイルサイズ制限の対象になりません。") API を使用してコンテンツストリームを読み取ることができます。
{#r_SGSA-getContentStream_S__id_xhr_q4z_g5b__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| sysID | 文字列 | 添付ファイルsys_id。 |
[表 : 24. パラメーター]

{#r_SGSA-getContentStream_S__id_xhr_q4z_g5b} {#r_SGSA-getContentStream_S__id_yry_q4z_g5b__entry__2}

| タイプ | 説明 |
|-|-|
| GlideScriptableInputStream | 添付ファイルのコンテンツを含むストリーム。 |
[表 : 25. 返される内容]

{#r_SGSA-getContentStream_S__id_yry_q4z_g5b}  

    var attachment = new GlideSysAttachment();
    var attachmentSysID = '6e4621df1bc420501363ff37dc4bcbb0';
    var attachmentContentStream = attachment.getContentStream(attachmentSysID);
    gs.info('Attachment content stream: ' + attachmentContentStream);

出力：

    Attachment content stream: com.glide.communications.GlideScriptableInputStream@14bd299

## スコープ対象 GlideSysAttachment - updateAllAttributes(String sysAttachmentID, Object attrsKeyValuePair) {#ariaid-title15}

既存の添付ファイルレコードのすべての属性を更新します。
関連項目：

* [追加属性()](https://servicenow-prod.fluidtopics.net/~hUvydAM6YVlMlO8eJ4Gxw#SGSA-addAttribute_S_S_S "既存の添付ファイルレコードに単一の属性を追加します。")
* [追加複数属性()](https://servicenow-prod.fluidtopics.net/~hUvydAM6YVlMlO8eJ4Gxw#SGSA-addMultipleAttributes_S_O "添付ファイルレコードに複数の属性を追加します。")
* [deleteAllAttributes()](https://servicenow-prod.fluidtopics.net/~hUvydAM6YVlMlO8eJ4Gxw#SGSA-deleteAllAttributes_S "既存の添付ファイルレコードからすべての属性を削除します。")
* [deleteAttribute()](https://servicenow-prod.fluidtopics.net/~hUvydAM6YVlMlO8eJ4Gxw#SGSA-deleteAttribute_S_S "添付ファイルレコードから指定された属性を削除します。")
* [fetchAllAttributes()](https://servicenow-prod.fluidtopics.net/~hUvydAM6YVlMlO8eJ4Gxw#SGSA-fetchAllAttributes_S "指定された添付ファイルレコードからすべての属性をフェッチします。")
* [fetchAttribute()](https://servicenow-prod.fluidtopics.net/~hUvydAM6YVlMlO8eJ4Gxw#SGSA-fetchAttribute_S_S "添付ファイルレコードから指定された属性をフェッチします。")
* [updateAttribute()](https://servicenow-prod.fluidtopics.net/~hUvydAM6YVlMlO8eJ4Gxw#SGSA-updateAttribute_S_S_S "既存の添付ファイルレコードの 1 つの属性を更新します。")

{#SGSA-updateAllAttributes_S_O__ul_uwj_4yq_zfc}このメソッドをグローバルに同等にするには、 [GlideSysAttachment - updateAllAttributes(オブジェクトattrsKeyValuePair)](https://servicenow-prod.fluidtopics.net/J5vP65X5~TgcCegkFdQmGw#GSA-updateAllAttributes_O "既存の添付ファイルレコードのすべての属性を更新します。")を使用します。
{#SGSA-updateAllAttributes_S_O__table_rql_3mg_5fc__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| sysAttachmentID | 文字列 | 添付ファイル \[sys_attachment\] テーブルにリストされている添付ファイルの sys_id。 |
| attrsKeyValuePair | オブジェクト | 一連のキーと値のペアの添付ファイル属性。各属性キーとその値は文字列として指定する必要があります。 たとえば、次のようになります。 var attachmentAttributes = { "description" : "Photo of the solar system", "dimensions" : "1600 x 300" } |
[表 : 26. パラメーター]

{#SGSA-updateAllAttributes_S_O__table_rql_3mg_5fc} {#SGSA-updateAllAttributes_S_O__table_sql_3mg_5fc__entry__2}

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

{#SGSA-updateAllAttributes_S_O__table_sql_3mg_5fc}  
次の例は、指定した添付ファイルの各属性を更新する方法を示しています。結果は、添付ファイル属性 \[sys_attachment_attribute\] テーブルでも確認できます。

    var attach = new GlideSysAttachment();

    var attachmentID = '9e1b714601932210f877b455304df0af';

    var attachmentAttributes = {
        "category" : "Training",
        "title" : "Updating attachment attributes", 
        "author" : "Abraham Lincoln",
        "length" : "6000"
    }

    attach.updateAllAttributes(attachmentID, attachmentAttributes);

    var result = attach.fetchAllAttributes(attachmentID);

    while(result.next()) {
       gs.info("Key: " + result.getValue('key') + ", Value: " + result.getValue('value'));
    }

出力:

    Key: title, Value: Updating attachment attributes
    Key: author, Value: Abraham Lincoln
    Key: category, Value: Training
    Key: length, Value: 6000

## スコープ付き GlideSysAttachment - updateAttribute(String sysAttachmentID, String attrKey, String attrValue) {#ariaid-title16}

既存の添付ファイルレコードの 1 つの属性を更新します。
関連項目：

* [追加属性()](https://servicenow-prod.fluidtopics.net/~hUvydAM6YVlMlO8eJ4Gxw#SGSA-addAttribute_S_S_S "既存の添付ファイルレコードに単一の属性を追加します。")
* [追加複数属性()](https://servicenow-prod.fluidtopics.net/~hUvydAM6YVlMlO8eJ4Gxw#SGSA-addMultipleAttributes_S_O "添付ファイルレコードに複数の属性を追加します。")
* [deleteAllAttributes()](https://servicenow-prod.fluidtopics.net/~hUvydAM6YVlMlO8eJ4Gxw#SGSA-deleteAllAttributes_S "既存の添付ファイルレコードからすべての属性を削除します。")
* [deleteAttribute()](https://servicenow-prod.fluidtopics.net/~hUvydAM6YVlMlO8eJ4Gxw#SGSA-deleteAttribute_S_S "添付ファイルレコードから指定された属性を削除します。")
* [fetchAllAttributes()](https://servicenow-prod.fluidtopics.net/~hUvydAM6YVlMlO8eJ4Gxw#SGSA-fetchAllAttributes_S "指定された添付ファイルレコードからすべての属性をフェッチします。")
* [fetchAttribute()](https://servicenow-prod.fluidtopics.net/~hUvydAM6YVlMlO8eJ4Gxw#SGSA-fetchAttribute_S_S "添付ファイルレコードから指定された属性をフェッチします。")
* [updateAllAttributes()](https://servicenow-prod.fluidtopics.net/~hUvydAM6YVlMlO8eJ4Gxw#SGSA-updateAllAttributes_S_O "既存の添付ファイルレコードのすべての属性を更新します。")

{#SGSA-updateAttribute_S_S_S__ul_uwj_4yq_zfc}このメソッドをグローバルに同等にするには、 [GlideSysAttachment - updateAttribute(String attrKey, String attrValue)](https://servicenow-prod.fluidtopics.net/J5vP65X5~TgcCegkFdQmGw#GSA-updateAttribute_S_S "既存の添付ファイルレコードの 1 つの属性を更新します。")を使用します。
{#SGSA-updateAttribute_S_S_S__table_rql_3mg_5fc__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| sysAttachmentID | 文字列 | 添付ファイル \[sys_attachment\] テーブルにリストされている添付ファイルの sys_id。 |
| 属性キー | 文字列 | 添付ファイル属性のキーと値のペアのキー部分。 |
| 属性値 | 文字列 | 添付ファイル属性のキーと値のペアの値の部分。 |
[表 : 28. パラメーター]

{#SGSA-updateAttribute_S_S_S__table_rql_3mg_5fc} {#SGSA-updateAttribute_S_S_S__table_sql_3mg_5fc__entry__2}

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

{#SGSA-updateAttribute_S_S_S__table_sql_3mg_5fc}  
次の例は、キー <kbd class="ph userinput">作成者</kbd> を使用して、指定された添付ファイルに割り当てられた属性を更新し、値を Abel Tuter に変更する方法を示しています。結果は、添付ファイル属性 \[sys_attachment_attribute\] テーブルでも確認できます。

    var attach = new GlideSysAttachment();

    var attachmentID = '9e1b714601932210f877b455304df0af';

    var originalVal = attach.fetchAttribute(attachmentID, "author");
    while(originalVal.next()) {
       gs.info("Original attribute value: " + originalVal.getValue('value') + "\n"); 
    }

    attach.updateAttribute(attachmentID, "author", "Abel Tuter");

    var updatedVal = attach.fetchAttribute(attachmentID, "author"); 
    while(updatedVal.next()) {
       gs.info("Updated attribute value: " + updatedVal.getValue('value')); 
    }

出力:

    Original attribute value: Fred Luddy

    Updated attribute value: Abel Tuter

## スコープ付き GlideSysAttachment - write(GlideRecord record, String fileName, String contentType, String content) {#ariaid-title17}

指定された添付ファイルを指定されたレコードに添付します。
{#r_SGSA-write_GR_S_S_S__id_zx4_v4z_g5b__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| レコード | GlideRecord | 添付ファイルを添付するレコード。 |
| fileName | 文字列 | 添付ファイル名。 |
| contentType | 文字列 | 添付ファイルの MIME タイプ ( `image/png` など)。添付ファイル \[sys_attachment\] テーブルの \[コンテンツタイプ \] フィールドにあります。 |
| コンテンツ | 文字列 | 添付ファイルのコンテンツ。 |
[表 : 30. パラメーター]

{#r_SGSA-write_GR_S_S_S__id_zx4_v4z_g5b} {#r_SGSA-write_GR_S_S_S__id_rnx_v4z_g5b__entry__2}

| タイプ | 説明 |
|-|-|
| 文字列 | 添付ファイルsys_id。添付ファイルが追加されなかった場合は null を返します。 |
[表 : 31. 返される内容]

{#r_SGSA-write_GR_S_S_S__id_rnx_v4z_g5b}  

    var attachment = new GlideSysAttachment();

    //set up inputs
    var rec = new GlideRecord('incident');
    rec.get('78271e1347c12200e0ef563dbb9a7109');
    var fileName = 'example.txt';
    var contentType = 'text/csv';
    var content = 'The text that is stored inside my file';

    var agr = attachment.write(rec, fileName, contentType, content);

    gs.info('The attachment sys_id is: ' + agr);

出力：

    The attachment sys_id is: 01271e4317c13311e0ef563dbb9abe34

## スコープ付き GlideSysAttachment - writeBase64(GlideRecord now_GR、文字列 fileName、文字列 contentType、文字列 content_base64Encoded) {#ariaid-title18}

base64 エンコードコンテンツを使用して、指定されたレコードの添付ファイルを挿入します。
{#r_SGSA-writeBase64_GR_S_S_S__table_nfx_fwx_hx__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| now_GR | GlideRecord | 添付ファイルを添付するレコード。 |
| fileName | 文字列 | 添付ファイル名。 |
| contentType | 文字列 | 添付ファイルの MIME タイプ ( `image/png` など)。添付ファイル \[sys_attachment\] テーブルの \[コンテンツタイプ \] フィールドにあります。 |
| コンテンツ | 文字列 | base64 形式の添付ファイルのコンテンツ。 |
[表 : 32. パラメーター]

{#r_SGSA-writeBase64_GR_S_S_S__table_nfx_fwx_hx} {#r_SGSA-writeBase64_GR_S_S_S__table_ofx_fwx_hx__entry__2}

| タイプ | 説明 |
|-|-|
| 文字列 | 作成された添付ファイルのSys_id。 |
[表 : 33. 返される内容]

{#r_SGSA-writeBase64_GR_S_S_S__table_ofx_fwx_hx}  

    var attachment = new GlideSysAttachment();

    var rec = new GlideRecord('incident');
    var incidentSysID = 'ab1b30031b04ec101363ff37dc4bcbfc';
    rec.get(incidentSysID);
    var fileName = 'example.txt';
    var contentType = 'text/csv';
    var base64Encodedcontent = 'SSBhbSB0ZXh0Lg==';

    var agr = attachment.writeBase64(rec, fileName, contentType, base64Encodedcontent);

    gs.info('The attachment sys_id is: ' + agr);

出力:

    The attachment sys_id is: 10cde9971b0820501363ff37dc4bcba6

## スコープ対象 GlideSysAttachment - writeContentStream(GlideRecord now_GR, 文字列 fileName, 文字列 contentType, GlideScriptableInputStream inputStream) {#ariaid-title19}

入力ストリームを使用して添付ファイルを挿入します。
{#r_SGS-writeContentStrm_GR_S_S_GSIS__id_n5v_npz_g5b__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| now_GR | GlideRecord | 添付ファイルを添付するレコード。 |
| fileName | 文字列 | 添付ファイル名。 |
| contentType | 文字列 | 添付ファイルの MIME タイプ ( `image/png` など)。添付ファイル \[sys_attachment\] テーブルの \[コンテンツタイプ \] フィールドにあります。 |
| コンテンツ | GlideScriptableInputStream | 添付ファイルのコンテンツ。 |
[表 : 34. パラメーター]

{#r_SGS-writeContentStrm_GR_S_S_GSIS__id_n5v_npz_g5b} {#r_SGS-writeContentStrm_GR_S_S_GSIS__id_lkf_npz_g5b__entry__2}

| タイプ | 説明 |
|-|-|
| 文字列 | 作成された添付ファイルのSys_id。 |
[表 : 35. 返される内容]

{#r_SGS-writeContentStrm_GR_S_S_GSIS__id_lkf_npz_g5b}  
sys_attachmentテーブルからtest_tableレコードにコンテンツストリームを添付します。

    function copyAttachmentToGlideRecord(conceptSysId) {

      // Get record from test_table using sys_id
      var targetGlideRecord = new GlideRecord("test_table");
      if (!targetGlideRecord.get(conceptSysId)) {
         throw ("Cannot find record created by test with sys_id: " + conceptSysId);
      }

      // Get record from sys_attachment table
      var sourceAttachmentGlideRecord = new GlideRecord('sys_attachment');    
      sourceAttachmentGlideRecord.query();
      sourceAttachmentGlideRecord.next();

      // Get field values from retrieved sys_attachment record
      var fileName = sourceAttachmentGlideRecord.getValue('file_name');
      var contentType = sourceAttachmentGlideRecord.getValue('content_type');
      var sourceAttachmentSysId = sourceAttachmentGlideRecord.getValue('sys_id');

      // Attach sys_attachment record content stream to test_table record
      var gsa = new GlideSysAttachment();
      gsa.writeContentStream(
        targetGlideRecord,
        fileName,
        contentType,
        gsa.getContentStream(sourceAttachmentSysId));
      gs.info("Attachment created");
    }