---
sourceDocument: Référence de l’API Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - fr-FR

ft:publication_title :

    - Référence de l’API Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# GlideSysAttachment : inclus dans le champ d'application

# GlideSysAttachment : inclus dans le champ d'application {#ariaid-title1}

* Rversion finale: Xanadu
* 
* Mis à jour 1 août 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 5 minutes de lecture

L'API GlideSysAttachment fournit des méthodes pour gérer les pièces jointes.

Le contenu est renvoyé sous forme de chaîne, et non sous forme de tableau d'octets lorsque getContent() est appelé.

Le contenu est renvoyé en tant qu'objet GlideScriptableInputStream lorsque getContentStream() est appelé. Le GlideScriptableInputStream contient les octets réels non convertis en chaîne.

## GlideSysAttachment inclus dans le périmètre : GlideSysAttachment() {#ariaid-title2}

Crée une instance de la classe GlideSysAttachment.
{#r_SGSA-GlideSysAttachment__table_iys_ctb_fv__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 1. Paramètres]

{#r_SGSA-GlideSysAttachment__table_iys_ctb_fv}

## GlideSysAttachment inclus dans le champ d'application : copie(String sourceTable, String sourceID, String targetTable, String targetID) {#ariaid-title3}

Copie les pièces jointes de l'enregistrement source vers l'enregistrement cible.
{#r_SGSA-copy_S_S_S_S__id_kdj_vjz_g5b__entry__3}

| Nom | Type | Description |
|-|-|-|
| sourceTable | Chaîne | Nom de la table avec les pièces jointes à copier. |
| ID source | Chaîne | sys_id de la table source. |
| targetTable | Chaîne | Nom de la table à laquelle ajouter les pièces jointes. |
| ID cible | Chaîne | sys_id de la table cible. |
[Tableau 2. Paramètres]

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

| Type | Description |
|-|-|
| Chaîne | Tableau des sys_ids des pièces jointes qui ont été copiées. |
[Tableau 3. Renvoie]

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

Sortie :

    Copied attachments: 6e4621df1bc420501363ff37dc4bcbb0,a87769531b0820501363ff37dc4bcba2

## GlideSysAttachment inclus dans le champ d'application : deleteAttachment(String attachmentID) {#ariaid-title4}

Supprime la pièce jointe spécifiée.
{#r_SGSA-deleteAttachment_S__id_ajy_dlz_g5b__entry__3}

| Nom | Type | Description |
|-|-|-|
| attachmentID | Chaîne | sys_id de la pièce jointe. |
[Tableau 4. Paramètres]

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

| Type | Description |
|-|-|
| nul |   |
[Tableau 5. Renvoie]

{#r_SGSA-deleteAttachment_S__table_gjy_lyb_fv}  

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

## GlideSysAttachment inclus dans le champ d'application : getAttachments(String, tableName, String sys_id) {#ariaid-title5}

Renvoie un objet GlideRecord contenant les métadonnées de pièce jointe correspondantes, telles que le nom, le type ou la taille.
{#r_SGSA-getAttachments_S_S__id_bvk_jmz_g5b__entry__3}

| Nom | Type | Description |
|-|-|-|
| tableName | Chaîne | Nom de la table à laquelle appartient la pièce jointe ; Par exemple, incident. |
| sys_id | Chaîne | Sys_id de l'enregistrement auquel appartient la pièce jointe. |
[Tableau 6. Paramètres]

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

| Type | Description |
|-|-|
| GlideRecord | Objet GlideRecord contenant les métadonnées de pièce jointe correspondantes, telles que le nom, le type ou la taille. |
[Tableau 7. Renvoie]

{#r_SGSA-getAttachments_S_S__id_urm_kmz_g5b}  
Le script suivant répertorie les noms de fichiers de pièces jointes pour un enregistrement comportant deux pièces jointes.

    var attachment = new GlideSysAttachment();

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

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

Sortie :

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

## GlideSysAttachment inclus dans le périmètre : getContent(GlideRecord sysAttachment) {#ariaid-title6}

Renvoie le contenu de la pièce jointe sous forme de chaîne.
Cette méthode est destinée à être utilisée uniquement dans les applications incluses dans le périmètre. Cette méthode renvoie `undefined` lorsqu'elle est utilisée dans le champ d'application global. Pour lire le contenu des pièces jointes dans le champ d'application global, utilisez la méthode getContentStream à partir de l'API GlideSysAttachment - Global .  
Cette méthode prend en charge les types de fichiers suivants pour les pièces jointes.

* CSV (\*.csv)
* JSON (\*.json)
* Texte (\*.txt)
{#r_SGSA-getContent_GR__ul_zd2_w21_cwb}
{#r_SGSA-getContent_GR__table_r2d_cng_2v__entry__3}

| Nom | Type | Description |
|-|-|-|
| sysAttachment | GlideRecord | Enregistrement de la pièce jointe. |
[Tableau 8. Paramètres]

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

| Type | Description |
|-|-|
| Chaîne | Contenu de la pièce jointe sous forme de chaîne. Renvoie jusqu'à 5 Mo de données. |
[Tableau 9. Renvoie]

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

Sortie :

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

## GlideSysAttachment inclus dans le périmètre : getContentBase64(GlideRecord sysAttachment) {#ariaid-title7}

Renvoie le contenu de la pièce jointe sous forme de chaîne avec un codage base64.
Cette méthode est destinée à être utilisée uniquement dans les applications incluses dans le périmètre. Cette méthode renvoie `undefined` lorsqu'elle est utilisée dans le champ d'application global. Pour lire le contenu des pièces jointes dans le champ d'application global, utilisez la méthode getContentStream à partir de l'API GlideSysAttachment - Global .
{#r_SGSA-getContentBase64_GR__table_kds_4sb_fv__entry__3}

| Nom | Type | Description |
|-|-|-|
| sysAttachment | GlideRecord | Enregistrement de la pièce jointe. |
[Tableau 10. Paramètres]

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

| Type | Description |
|-|-|
| Chaîne | Contenu de la pièce jointe sous forme de chaîne avec codage base64. Renvoie jusqu'à 5 Mo de données. |
[Tableau 11. Renvoie]

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

Sortie :

    Doc1.txt
    Attachment content: SSBhbSB0ZXh0IGluIGEgdHh0IGZpbGUgYXR0YWNoZWQgdG8gYSByZWNvcmQuIA0=

## GlideSysAttachment inclus dans le périmètre : getContentStream(String sysID) {#ariaid-title8}

Renvoie un objet GlideScriptableInputStream compte tenu de l'sys_id d'une pièce jointe.
Vous pouvez utiliser l'API [GlideTextReader](https://servicenow-prod.fluidtopics.net/YXBAI_tc2hFW9W9k_7ogGg#c_GlideTextReaderScopedAPI "L’API GlideTextReader offre la possibilité de lire des lignes uniques à partir d’un flux d’entrée. Étant donné qu’un flux d’entrée est utilisé, il n’est pas soumis à la limite de taille de pièce jointe de 5 Mo.") pour lire le flux de contenu.
{#r_SGSA-getContentStream_S__id_xhr_q4z_g5b__entry__3}

| Nom | Type | Description |
|-|-|-|
| sysID | Chaîne | La pièce jointe sys_id. |
[Tableau 12. Paramètres]

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

| Type | Description |
|-|-|
| GlideScriptableInputStream | Flux contenant le contenu de la pièce jointe. |
[Tableau 13. Renvoie]

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

Sortie :

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

## GlideSysAttachment inclus dans le champ d'application : write (enregistrement GlideRecord, chaîne fileName, chaîne contentType, contenu de chaîne) {#ariaid-title9}

Joint une pièce jointe spécifiée à l'enregistrement spécifié.
{#r_SGSA-write_GR_S_S_S__id_zx4_v4z_g5b__entry__3}

| Nom | Type | Description |
|-|-|-|
| enregistrement | GlideRecord | Enregistrement auquel joindre la pièce jointe. |
| fileName | Chaîne | Nom du fichier de la pièce jointe. |
| Type de contenu | Chaîne | Type de contenu de la pièce jointe. |
| contenu | Chaîne | Contenu de la pièce jointe. |
[Tableau 14. Paramètres]

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

| Type | Description |
|-|-|
| Chaîne | La pièce jointe sys_id. Renvoie null si la pièce jointe n'a pas été ajoutée. |
[Tableau 15. Renvoie]

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

Sortie :

    The attachment sys_id is: 01271e4317c13311e0ef563dbb9abe34

## GlideSysAttachment inclus dans le champ d'application : writeBase64(GlideRecord now_GR, chaîne fileName, chaîne contentType, chaîne content_base64Encoded) {#ariaid-title10}

Insère une pièce jointe pour l'enregistrement spécifié à l'aide d'un contenu codé base64.
{#r_SGSA-writeBase64_GR_S_S_S__table_nfx_fwx_hx__entry__3}

| Nom | Type | Description |
|-|-|-|
| now_GR | GlideRecord | Enregistrement auquel la pièce jointe doit être jointe. |
| fileName | Chaîne | Nom de fichier de la pièce jointe. |
| Type de contenu | Chaîne | Type de contenu de la pièce jointe. |
| contenu | Chaîne | Contenu de la pièce jointe au format base64. |
[Tableau 16. Paramètres]

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

| Type | Description |
|-|-|
| Chaîne | Sys_id de la pièce jointe créée. |
[Tableau 17. Renvoie]

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

Sortie :

    The attachment sys_id is: 10cde9971b0820501363ff37dc4bcba6

## GlideSysAttachment inclus dans le périmètre : writeContentStream(GlideRecord now_GR, chaîne, fileName, chaîne, contentType, GlideScriptableInputStream, inputStream) {#ariaid-title11}

Insère une pièce jointe à l'aide du flux d'entrée.
{#r_SGS-writeContentStrm_GR_S_S_GSIS__id_n5v_npz_g5b__entry__3}

| Nom | Type | Description |
|-|-|-|
| now_GR | GlideRecord | Enregistrement auquel la pièce jointe doit être jointe. |
| fileName | Chaîne | Nom de fichier de la pièce jointe. |
| Type de contenu | Chaîne | Type de contenu de la pièce jointe. |
| contenu | GlideScriptableInputStream | Contenu de la pièce jointe. |
[Tableau 18. Paramètres]

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

| Type | Description |
|-|-|
| Chaîne | Sys_id de la pièce jointe créée. |
[Tableau 19. Renvoie]

{#r_SGS-writeContentStrm_GR_S_S_GSIS__id_lkf_npz_g5b}  
Joint un flux de contenu de la table sys_attachment à un enregistrement 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");
    }