Joindre des fichiers aux enregistrements à partir des pages du portail

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 2024
  • 7 minutes de lecture

    • Les pièces jointes peuvent être ajoutées aux 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-déplacer des fichiers.

    Par défaut, plusieurs widgets du 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 des pages de votre portail, consultez l’événement Joindre un fichier SP dans Analyse de l'expérience utilisateur pour Portail de services. Pour plus d’informations sur les événements disponibles, consultez Portail de services événements.

    Ajouter des pièces jointes en collant ou en déplaçant des fichiers

    Autorisez les utilisateurs du portail à joindre des fichiers en collant ou en déplaçant des fichiers 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éplaçant 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 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 Tous > Portail de services > Configuration du Portail de services.
    2. Sélectionnez É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 de l’élément sp-attachment-button .
      • modal : active la prise en charge du copier-coller et du glisser-déposer 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 fichiers 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 fichiers 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 dotée du 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, déposer ou 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 de ce type, 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 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 placer des pièces jointes sur une zone d’une demande de 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 Tous > Portail de services > Configuration du Portail de services.
    2. Sélectionnez É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=&quot;attachmentHandler » en tant qu’attribut d’un <div> élément or <section> .
      La zone peut inclure le widget en entier ou seulement une partie de celui-ci.
      <div sp-attachment-picker attachment-handler="attachmentHandler">
    5. Facultatif : Configurez les attributs de la directive sp-attachment-picker .
      • disable-picker-overlay=&quot;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 une 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=&quot;attachFiles($files) ». Parmi les exemples de logique personnalisée pouvant être implémentée, citons la prévisualisation des fichiers, les validations personnalisées ou la logique de chargement personnalisée. Si cet attribut est configuré, l’attribut attachment-handler=&quot;attachmentHandler » n’est pas nécessaire et peut être supprimé.
    6. Facultatif : Masquer la zone de pièces jointes sur les équipements mobiles.
      1. Ajoutez la directive ng-if=&quot;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 dotée du 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 de ce type, 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 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 Éditeur de widget.
    3. Dans le menu Modifier un widget existant, sélectionnez le widget que vous avez cloné pour 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’endroit où vous souhaitez que la section des pièces jointes s’affiche. 
      <sp-attachment-picker attachment-handler="attachmentHandler"></sp-attachment-picker>
    5. Facultatif : Configurez les attributs de la directive sp-attachment-picker .
      • disable-picker-overlay=&quot;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 une 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=&quot;attachFiles($files) ». Parmi les exemples de logique personnalisée pouvant être implémentée, citons la prévisualisation des fichiers, les validations personnalisées ou la logique de chargement personnalisée.
    6. Facultatif : Masquer la section des pièces jointes sur les équipements mobiles.
      1. Ajoutez la directive ng-if=&quot;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 dotée du 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.