Joindre des fichiers aux enregistrements à partir des pages du portail

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 7 minutes de lecture

    • Vous pouvez ajouter des pièces jointes à des enregistrements à partir des pages du 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 de système de base acceptent les pièces jointes des 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 des 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 de pages de votre portail, consultez l’événement d’attachement de fichier SP dans Analyse de l'expérience utilisateur pour Portail de services. Pour plus d’informations sur les événements disponibles, reportez-vous à la section 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 les collant ou en les déposant dans la boîte de dialogue Ajouter des pièces jointes.

    Avant de commencer

    Par défaut, les widgets 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 à l’aide de la directive sp-attachment-button . Pour plus d’informations sur le clonage de widgets, reportez-vous à la section Cloner un widget.

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

    Rôle requis : sp_admin ou admin

    Procédure

    1. Accédez à la Tout > 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époser lorsqu’il est défini sur vrai.

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

      • extensions prises en charge : affiche une liste des extensions de fichier prises en charge pour les pièces jointes en 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. Le collage de 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

    Ajout d’une zone glisser-déposer 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 formulairesection . Pour plus d’informations sur le clonage de widgets, reportez-vous à la section Cloner un widget.

    Remarque :
    Les widgets du système de base sont en lecture seule afin que vous puissiez profiter des futures mises à jour. Pour apporter des modifications, vous pouvez cloner des widgets du système de base. Cependant, les widgets clonés sont considérés comme des widgets personnalisés et ne bénéficient pas des futures mises à jour apportées aux 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. Grâce à 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 du catalogue ou d’un formulaire.

    Dans cet exemple, la zone est une zone située sur le corps d’un widget de formulaire. La zone n’est visible que lors du déplacement d’un fichier dessus.
    Figure 1. Zone de pièce jointe 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 Tout > 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 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 or <section> .
      La zone peut inclure l’ensemble 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 de pièce jointe lorsque vous faites glisser un fichier dessus. Par défaut, la superposition est activée.
      • onFilePick : implémente la logique personnalisée en déclenchant un événement lorsqu’un fichier est sélectionné. Définissez la valeur sur une fonction qui prend 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 équipements 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 formulairesection . Pour plus d’informations sur le clonage de widgets, reportez-vous à la section Cloner un widget.

    Remarque :
    Les widgets du système de base sont en lecture seule afin que vous puissiez profiter des futures mises à jour. Pour apporter des modifications, vous pouvez cloner des widgets du système de base. Cependant, les widgets clonés sont considérés comme des widgets personnalisés et ne bénéficient pas des futures mises à jour apportées aux 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 pièces jointes, les utilisateurs du portail peuvent ajouter des pièces jointes en moins de clics.

    Dans cet exemple, la section des 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 Tout > 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 de pièce jointe.
    4. Dans le modèle HTML du widget, ajoutez la directive sp-attachment-picker en tant qu’élément à l’emplacement où 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 pièce jointe lorsque vous faites glisser un fichier dessus. Par défaut, la superposition est activée.
      • onFilePick : implémente la logique personnalisée en déclenchant un événement lorsqu’un fichier est sélectionné. Définissez la valeur sur une fonction qui prend 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époser un ou plusieurs fichiers sélectionnés sur la section des pièces jointes pour les joindre à l’enregistrement.

    Remarque :
    Le collage de pièces jointes n’est pas pris en charge dans Firefox.