---
sourceDocument: Yokohama-API-Referenz
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/yokohama/api-reference

 Release :

    - yokohama

ft:locale :

    - de-DE

ft:publication_title :

    - Yokohama-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# GlideSysAnhang -- Umfang

# GlideSysAnhang -- Umfang {#ariaid-title1}

* Freigeben Version: Yokohama
* 
* Aktualisiert 30. Januar 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 5 Minuten Lesedauer

Die GlideSysAnhang API stellt Methoden zur Verarbeitung von Anhängen bereit.

Inhalt wird als Zeichenfolge und nicht als Byte-Array zurückgegeben, wenn GetContent() Wird aufgerufen.

Inhalt wird als GlideScriptableInputStream-Objekt zurückgegeben, wenn GetContentStream() Wird aufgerufen. Der GlideScriptableInputStream enthält die tatsächlichen Bytes, die nicht in eine Zeichenfolge konvertiert wurden.

## Bereichsbezogener GlideSysAttachment -- GlideSysAttachment() {#ariaid-title2}

Erstellt eine Instanz der GlideSysAttachment-Klasse.
{#r_SGSA-GlideSysAttachment__table_iys_ctb_fv__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 1. Parameter]

{#r_SGSA-GlideSysAttachment__table_iys_ctb_fv}

## Bereichsbezogener GlideSysAttachment -- Copy(Zeichenfolge quelletabelle, Zeichenfolge quelleID, Zeichenfolge targetTable, Zeichenfolge targetID) {#ariaid-title3}

Kopiert Anhänge aus dem Quelldatensatz in den Zieldatensatz.
{#r_SGSA-copy_S_S_S_S__id_kdj_vjz_g5b__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| sourceTable | Zeichenfolge | Name der Tabelle mit den zu kopierenden Anhängen. |
| Quell-ID | Zeichenfolge | Sys_ID der Quelltabelle |
| targetTable | Zeichenfolge | Name der Tabelle, der die Anhänge hinzugefügt werden sollen. |
| TargetID | Zeichenfolge | Sys_ID der Zieltabelle |
[Tabelle : 2. Parameter]

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

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Array von sys_IDs der Anhänge, die kopiert wurden. |
[Tabelle : 3. Rückgaben]

{#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);

Ausgabe:

    Copied attachments: 6e4621df1bc420501363ff37dc4bcbb0,a87769531b0820501363ff37dc4bcba2

## Bereichsbezogener GlideSysAttachment -- deleteAttachment(ZeichenfolgenanhangID) {#ariaid-title4}

Löscht den angegebenen Anhang.
{#r_SGSA-deleteAttachment_S__id_ajy_dlz_g5b__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| AttachmentID | Zeichenfolge | Sys_ID des Anhangs |
[Tabelle : 4. Parameter]

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

| Typ | Beschreibung |
|-|-|
| Ungültig |   |
[Tabelle : 5. Rückgaben]

{#r_SGSA-deleteAttachment_S__table_gjy_lyb_fv}  

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

## Bereichsbezogener GlideSysAttachment -- getAttachments (Zeichenfolge tableName, Zeichenfolge sys_ID) {#ariaid-title5}

Gibt einen GlideRecord zurück, der die übereinstimmenden Anhangsmetadaten wie Name, Typ oder Größe enthält.
{#r_SGSA-getAttachments_S_S__id_bvk_jmz_g5b__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| tableName | Zeichenfolge | Name der Tabelle, zu der der Anhang gehört, z. B. Incident. |
| sys_id | Zeichenfolge | SYS_ID des Datensatzes, zu dem der Anhang gehört. |
[Tabelle : 6. Parameter]

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

| Typ | Beschreibung |
|-|-|
| GlideRecord | GlideRecord-Objekt, das die übereinstimmenden Anhangsmetadaten wie Name, Typ oder Größe enthält. |
[Tabelle : 7. Rückgaben]

{#r_SGSA-getAttachments_S_S__id_urm_kmz_g5b}  
Das folgende Skript listet die Namen der Anhangsdateien für einen Datensatz mit zwei Anhängen auf.

    var attachment = new GlideSysAttachment();

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

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

Ausgabe:

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

## Bereichsbezogener GlideSysAttachment -- getContent(GlideRecord sysAttachment) {#ariaid-title6}

Gibt den Anhangsinhalt als Zeichenfolge zurück.
Diese Methode ist nur zur Verwendung in bereichsbezogenen Anwendungen vorgesehen. Diese Methode gibt zurück `Nicht definiert `Bei Verwendung im globalen Bereich. Verwenden Sie zum Lesen von Anhangsinhalten im globalen Bereich GetContentStream() Methode aus GlideSysAnhang: Global API.  
Diese Methode unterstützt die folgenden Dateitypen für Anhänge.

* CSV (\*.CSV)
* JSON (\*.JSON)
* Text (\*.txt)
{#r_SGSA-getContent_GR__ul_zd2_w21_cwb}
{#r_SGSA-getContent_GR__table_r2d_cng_2v__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| SysAnhang | GlideRecord | Anhangsdatensatz. |
[Tabelle : 8. Parameter]

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

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Anhangsinhalte als Zeichenfolge. Gibt bis zu 5 MB Daten zurück. |
[Tabelle : 9. Rückgaben]

{#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
    }

Ausgabe:

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

## Bereichsbezogener GlideSysAttachment -- getContentBase64(GlideRecord sysAttachment) {#ariaid-title7}

Gibt den Anhangsinhalt als Zeichenfolge mit base64-Codierung zurück.
Diese Methode ist nur zur Verwendung in bereichsbezogenen Anwendungen vorgesehen. Diese Methode gibt zurück `Nicht definiert `Bei Verwendung im globalen Bereich. Verwenden Sie zum Lesen von Anhangsinhalten im globalen Bereich GetContentStream Methode aus GlideSysAnhang: Global API.
{#r_SGSA-getContentBase64_GR__table_kds_4sb_fv__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| SysAnhang | GlideRecord | Anhangsdatensatz. |
[Tabelle : 10. Parameter]

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

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Anhangsinhalte als Zeichenfolge mit base64-Codierung. Gibt bis zu 5 MB Daten zurück. |
[Tabelle : 11. Rückgaben]

{#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
    }

Ausgabe:

    Doc1.txt
    Attachment content: SSBhbSB0ZXh0IGluIGEgdHh0IGZpbGUgYXR0YWNoZWQgdG8gYSByZWNvcmQuIA0=

## Bereichsbezogener GlideSysAttachment -- getContentStream(Zeichenfolge sysID) {#ariaid-title8}

Gibt ein GlideScriptableInputStream-Objekt anhand der sys_ID eines Anhangs zurück.
Sie können verwenden [GlideTextReader](https://servicenow-prod.fluidtopics.net/Fwd2q5qkg9h~Q5A_r5fX1g#c_GlideTextReaderScopedAPI "Die GlideTextReader API bietet die Möglichkeit, einzelne Zeilen aus einem Eingabestrom zu lesen. Da ein Eingabestrom verwendet wird, unterliegt er nicht der Größenbeschränkung von 5 MB für Anhänge.")API zum Lesen des Inhaltsstroms.
{#r_SGSA-getContentStream_S__id_xhr_q4z_g5b__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| sysID | Zeichenfolge | Sys_ID des Anhangs |
[Tabelle : 12. Parameter]

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

| Typ | Beschreibung |
|-|-|
| GlideScriptableInputStream | Stream, der den Inhalt des Anhangs enthält. |
[Tabelle : 13. Rückgaben]

{#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);

Ausgabe:

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

## Bereichsbezogener GlideSysAttachment -- write (GlideRecord-Datensatz, Zeichenfolgendateiname, ZeichenfolgeninhaltType, Zeichenfolgeninhalt) {#ariaid-title9}

Hängt einen angegebenen Anhang an den angegebenen Datensatz an.
{#r_SGSA-write_GR_S_S_S__id_zx4_v4z_g5b__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| record | GlideRecord | Datensatz, an den der Anhang angehängt werden soll. |
| fileName | Zeichenfolge | Name der Anhangsdatei. |
| Inhaltstyp | Zeichenfolge | MIME-Typ des Anhangs, z. B. `Bild/PNG `. Befindet sich in der Tabelle „Anhang" \[sys_attachment\] in Inhaltstyp Feld. |
| Content | Zeichenfolge | Anhangsinhalt. |
[Tabelle : 14. Parameter]

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

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Sys_ID des Anhangs Gibt Null zurück, wenn der Anhang nicht hinzugefügt wurde. |
[Tabelle : 15. Rückgaben]

{#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);

Ausgabe:

    The attachment sys_id is: 01271e4317c13311e0ef563dbb9abe34

## Bereichsbezogener GlideSysAttachment -- writeBase64(GlideRecord Now_GR, Zeichenfolgendateiname, ZeichenfolgeninhaltType, Zeichenfolge content_base64Encoded) {#ariaid-title10}

Fügt einen Anhang für den angegebenen Datensatz mit base64-codiertem Inhalt ein.
{#r_SGSA-writeBase64_GR_S_S_S__table_nfx_fwx_hx__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Now_GR | GlideRecord | Datensatz, an den der Anhang angehängt werden soll. |
| fileName | Zeichenfolge | Name der Anhangsdatei. |
| Inhaltstyp | Zeichenfolge | MIME-Typ des Anhangs, z. B. `Bild/PNG `. Befindet sich in der Tabelle „Anhang" \[sys_attachment\] in Inhaltstyp Feld. |
| Content | Zeichenfolge | Anhangsinhalt im base64-Format. |
[Tabelle : 16. Parameter]

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

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | SYS_ID des erstellten Anhangs. |
[Tabelle : 17. Rückgaben]

{#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);

Ausgabe:

    The attachment sys_id is: 10cde9971b0820501363ff37dc4bcba6

## Bereichsbezogener GlideSysAttachment -- writeContentStream(GlideRecord Now_GR, Zeichenfolgendateiname, ZeichenfolgeninhaltType, GlideScriptableInputStream) {#ariaid-title11}

Fügt einen Anhang mithilfe des Eingabestreams ein.
{#r_SGS-writeContentStrm_GR_S_S_GSIS__id_n5v_npz_g5b__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Now_GR | GlideRecord | Datensatz, an den der Anhang angehängt werden soll. |
| fileName | Zeichenfolge | Name der Anhangsdatei. |
| Inhaltstyp | Zeichenfolge | MIME-Typ des Anhangs, z. B. `Bild/PNG `. Befindet sich in der Tabelle „Anhang" \[sys_attachment\] in Inhaltstyp Feld. |
| Content | GlideScriptableInputStream | Anhangsinhalt. |
[Tabelle : 18. Parameter]

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

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | SYS_ID des erstellten Anhangs. |
[Tabelle : 19. Rückgaben]

{#r_SGS-writeContentStrm_GR_S_S_GSIS__id_lkf_npz_g5b}  
Hängt einen Content Stream aus der Tabelle „sys_attachment" an einen Test_table-Datensatz an.

    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");
    }


