Joindre des fichiers à des enregistrements à partir de pages de portail

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 7 minutes de lecture

    • Les pièces jointes peuvent être ajoutées aux enregistrements à partir de pages de portail en naviguant dans le système de fichiers, en collant des fichiers à partir du presse-papiers ou en faisant glisser et en déplaçant des fichiers.

    Par défaut, plusieurs widgets du système de base acceptent les pièces jointes provenant d’utilisateurs du portail à l’aide d’une ou de plusieurs de ces méthodes. Pour modifier la façon dont les utilisateurs du portail peuvent ajouter des pièces jointes, vous pouvez cloner et modifier les widgets pour personnaliser l’expérience de pièce jointe, comme décrit dans les procédures suivantes.

    Pour suivre la façon dont les utilisateurs du portail joignent des fichiers aux enregistrements à partir des pages de votre portail, consultez l’événement Joindre un fichier SP dans Aperçus d'utilisationPortail de services. Pour plus d’informations sur les événements disponibles, reportez-vous à .Portail de services événements

    Ajouter des pièces jointes en collant ou en déposant des fichiers

    Autorisez les utilisateurs du portail à joindre des fichiers en collant ou en déposant des fichiers dans la boîte de dialogue Ajouter des pièces jointes.

    Avant de commencer

    Par défaut, les widgets du système de base Formulaire, Pièces jointes de ticket, Conversations de ticket et Élément de catalogue SC prennent en charge l’ajout de pièces jointes en collant ou en déposant des fichiers dans la boîte de dialogue Ajouter des pièces jointes plutôt qu’en naviguant uniquement dans le système de fichiers.

    Pour configurer cette fonctionnalité pour d’autres widgets, vous pouvez cloner ou créer un widget qui prend en charge l’ajout de pièces jointes avec la directive sp-attachment-button . Pour plus d’informations sur le clonage des widgets, reportez-vous à la section Cloner un widget.

    Remarque :
    Les widgets du système de base sont en lecture seule afin que vous puissiez bénéficier des futures mises à jour. Pour apporter des changements, vous pouvez cloner les widgets du système de base. Cependant, les widgets clonés sont considérés comme personnalisés et ne bénéficient pas des futures mises à jour des widgets à partir desquels ils ont été clonés.

    Rôle requis : sp_admin ou admin

    Procédure

    1. Accédez à la Tous > Portail de services > Configuration du Portail de services.
    2. Sélectionnez l’éditeur de widget.
    3. Dans le menu Modifier un widget existant, sélectionnez le widget que vous avez cloné.
    4. Dans le modèle HTML du widget, localisez l’élément sp-attachment-button .
    5. Configurez les attributs pour l’élément sp-attachment-button .
      • modal : active la prise en charge du copier-coller et du glisser-déplacer lorsqu’elle est définie sur vrai.

        Pour désactiver la prise en charge du copier-coller et du glisser-déposer, définissez-la sur faux.

      • supported-extensions : affiche une liste des extensions de fichier prises en charge pour les pièces jointes au bas de la boîte de dialogue Ajouter des pièces jointes.

        Pour répertorier les extensions de fichier prises en charge spécifiées par la glide.attachment.extensions propriété système, définissez-la sur {{ ::d ata.supportedAttachmentExtensions}}.

      <sp-attachment-button modal="true" supported-extensions="{{::data.supportedAttachmentExtensions}}"></sp-attachment-button>
    6. Sélectionnez Enregistrer.

    Résultats

    Sur une page avec le widget, vous pouvez coller ou déposer des fichiers sur la boîte de dialogue Ajouter une pièce jointe pour les joindre à l’enregistrement, comme illustré dans l’exemple suivant.

    Remarque :
    Cette fonctionnalité n’est pas prise en charge pour les expériences mobiles. Coller des pièces jointes n’est pas pris en charge dans Firefox.

    Option permettant de choisir, de déposer ou de coller des fichiers dans la boîte de dialogue Ajouter des pièces jointes

    Ajouter une zone de glisser-déplacer pour joindre des fichiers

    Autorisez les utilisateurs du portail à déposer des pièces jointes dans une zone dédiée d’une page pour joindre rapidement des fichiers à un enregistrement.

    Avant de commencer

    Pour configurer une zone de pièces jointes par glisser-déposer sur une page, vous devez cloner ou créer un widget qui prend en charge l’ajout de pièces jointes en appelant attachmentHandler défini sur une instance de nowAttachmentHandler dans son script client. Pour obtenir un exemple de widget comme celui-ci, reportez-vous à la Widget de formulaire section . Pour plus d’informations sur le clonage des widgets, reportez-vous à la section Cloner un widget.

    Remarque :
    Les widgets du système de base sont en lecture seule afin que vous puissiez bénéficier des futures mises à jour. Pour apporter des changements, vous pouvez cloner les widgets du système de base. Cependant, les widgets clonés sont considérés comme personnalisés et ne bénéficient pas des futures mises à jour des widgets à partir desquels ils ont été clonés.

    Rôle requis : sp_admin ou admin

    Pourquoi et quand exécuter cette tâche

    Par défaut, les utilisateurs du portail peuvent ajouter des pièces jointes sur de nombreuses pages du système de base en sélectionnant l’icône Ajouter des pièces jointes (Icône de pièce jointe) pour ouvrir la boîte de dialogue Ajouter des pièces jointes. Avec une zone de pièces jointes par glisser-déplacer, les utilisateurs du portail peuvent ajouter des pièces jointes en moins de clics. Par exemple, vous pouvez déposer des pièces jointes sur une zone d’une demande de catalogue ou d’un formulaire.

    Dans cet exemple, la zone est une zone au-dessus du corps d’un widget de formulaire. La zone n’est visible que lorsque vous déplacez un fichier dessus.
    Figure 1. Zone d’attachement sur un widget
    Faire glisser un fichier sur la zone de pièce jointe dans un widget de formulaire

    Procédure

    1. Accédez à la Tous > Portail de services > Configuration du Portail de services.
    2. Sélectionnez l’éditeur de widget.
    3. Dans le menu Modifier un widget existant, sélectionnez le widget que vous avez cloné pour ajouter la zone de pièce jointe.
    4. Dans le modèle HTML du widget, ajoutez la directive sp-attachment-picker attachment-handler="attachmentHandler » en tant qu’attribut d’un <div> élément ou <section> .
      La zone peut inclure l’intégralité du widget ou seulement une partie de celui-ci.
      <div sp-attachment-picker attachment-handler="attachmentHandler">
    5. Facultatif : Configurez les attributs pour la directive sp-attachment-picker .
      • disable-picker-overlay="true » : désactive l’affichage d’une superposition sur la zone d’attachement lorsque vous faites glisser un fichier dessus. Par défaut, la superposition est activée.
      • onFilePick : Implémente une logique personnalisée en déclenchant un événement lorsqu’un fichier est choisi. Définissez la valeur sur une fonction qui prend en compte les références de tous les fichiers sélectionnés sous forme de tableau comme premier paramètre. Par exemple, on-file-pick="attachFiles($files) ». Parmi les exemples de logique personnalisée pouvant être implémentée, citons l’aperçu des fichiers, les validations personnalisées ou la logique de chargement personnalisée. Si cet attribut est configuré, l’attribut attachment-handler="attachmentHandler » n’est pas nécessaire et peut être supprimé.
    6. Facultatif : Masquez la zone de pièce jointe sur les appareils mobiles.
      1. Ajoutez la directive ng-if="isDesktopBrowser » à la directive sp-attachment-picker . 
        <div sp-attachment-picker attachment-handler="attachmentHandler" ng-if="isDesktopBrowser">
      2. Dans le script client du widget, ajoutez le script suivant. 
        $scope.isNative = cabrillo.isNative();
$scope.isMobileBrowser = spUtil.isMobile() && !$scope.isNative;
$scope.isDesktopBrowser = !$scope.isNative && !$scope.isMobileBrowser;
    7. Sélectionnez Enregistrer.

    Résultats

    Sur une page avec le widget, vous pouvez faire glisser un ou plusieurs fichiers sélectionnés sur la zone de pièce jointe et les déposer pour les joindre à l’enregistrement.

    Ajouter une section de pièces jointes à un widget

    Autorisez les utilisateurs du portail à coller, déposer ou accéder à des fichiers dans une section d’un widget pour joindre rapidement des fichiers à un enregistrement.

    Avant de commencer

    Pour configurer une section de pièces jointes dans un widget, vous devez cloner ou créer un widget qui prend en charge l’ajout de pièces jointes en appelant attachmentHandler défini sur une instance de nowAttachmentHandler dans son script client. Pour obtenir un exemple de widget comme celui-ci, reportez-vous à la Widget de formulaire section . Pour plus d’informations sur le clonage des widgets, reportez-vous à la section Cloner un widget.

    Remarque :
    Les widgets du système de base sont en lecture seule afin que vous puissiez bénéficier des futures mises à jour. Pour apporter des changements, vous pouvez cloner les widgets du système de base. Cependant, les widgets clonés sont considérés comme personnalisés et ne bénéficient pas des futures mises à jour des widgets à partir desquels ils ont été clonés.

    Rôle requis : sp_admin ou admin

    Pourquoi et quand exécuter cette tâche

    Par défaut, les utilisateurs du portail peuvent ajouter des pièces jointes sur de nombreuses pages du système de base en sélectionnant l’icône Ajouter des pièces jointes (Icône de pièce jointe) pour ouvrir la boîte de dialogue Ajouter des pièces jointes. Avec une section de pièces jointes, les utilisateurs du portail peuvent ajouter des pièces jointes en moins de clics.

    Dans cet exemple, la section Pièces jointes est ajoutée au bas d’un widget d’élément de catalogue.
    Figure 2. Section de pièce jointe dans un widget
    Section pour ajouter des pièces jointes dans le widget d’élément de catalogue

    Procédure

    1. Accédez à la Tous > Portail de services > Configuration du Portail de services.
    2. Sélectionnez l’éditeur de widget.
    3. Dans le menu Modifier un widget existant, sélectionnez le widget que vous avez cloné pour y ajouter la section des pièces jointes.
    4. Dans le modèle HTML du widget, ajoutez la directive sp-attachment-picker en tant qu’élément dans lequel vous souhaitez que la section des pièces jointes apparaisse. 
      <sp-attachment-picker attachment-handler="attachmentHandler"></sp-attachment-picker>
    5. Facultatif : Configurez les attributs pour la directive sp-attachment-picker .
      • disable-picker-overlay="true » : désactive l’affichage d’une superposition sur la section de la pièce jointe lorsque vous faites glisser un fichier dessus. Par défaut, la superposition est activée.
      • onFilePick : Implémente une logique personnalisée en déclenchant un événement lorsqu’un fichier est choisi. Définissez la valeur sur une fonction qui prend en compte les références de tous les fichiers sélectionnés sous forme de tableau comme premier paramètre. Par exemple, on-file-pick="attachFiles($files) ». Parmi les exemples de logique personnalisée pouvant être implémentée, citons l’aperçu des fichiers, les validations personnalisées ou la logique de chargement personnalisée.
    6. Facultatif : Masquez la section des pièces jointes sur les équipements mobiles.
      1. Ajoutez la directive ng-if="isDesktopBrowser » à la directive sp-attachment-picker . 
        <sp-attachment-picker attachment-handler="attachmentHandler" ng-if="isDesktopBrowser"></sp-attachment-picker>
      2. Dans le script client du widget, ajoutez le script suivant. 
        $scope.isNative = cabrillo.isNative();
$scope.isMobileBrowser = spUtil.isMobile() && !$scope.isNative;
$scope.isDesktopBrowser = !$scope.isNative && !$scope.isMobileBrowser;
    7. Sélectionnez Enregistrer.

    Résultats

    Sur une page avec le widget, vous pouvez coller ou déplacer un ou plusieurs fichiers sélectionnés sur la section des pièces jointes pour les joindre à l’enregistrement.

    Remarque :
    Coller des pièces jointes n’est pas pris en charge dans Firefox.