Anhängen von Dateien an Datensätze aus Portalseiten

  • Freigeben Version: Xanadu
  • Aktualisiert 1. August 2024
  • 6 Minuten Lesedauer

    • Anhänge können Datensätzen von Portalseiten aus hinzugefügt werden, indem Sie im Dateisystem navigieren, Dateien aus der Zwischenablage einfügen oder Dateien per Drag-and-Drop verschieben.

    Standardmäßig akzeptieren mehrere Basissystem-Widgets Anhänge von Portalbenutzern, die eine oder mehrere der folgenden Methoden verwenden. Um zu ändern, wie Portalbenutzer Anhänge hinzufügen können, können Sie Widgets klonen und bearbeiten, um die Dateianhang-Experience wie in den folgenden Verfahren beschrieben anzupassen.

    Um nachzuverfolgen, wie Portalbenutzer Dateien von Seiten in Ihrem Portal an Datensätze anhängen, sehen Sie sich das Ereignis SP-Dateianhang in User Experience Analytics für Serviceportalan. Weitere Informationen zu verfügbaren Ereignissen finden Sie unter Serviceportal Events.

    Fügen Sie Anhänge hinzu, indem Sie Dateien einfügen oder ablegen

    Ermöglicht Portalbenutzern das Anhängen von Dateien durch Einfügen oder Ablegen von Dateien im Dialogfeld „Anhänge hinzufügen“.

    Vorbereitungen

    Standardmäßig unterstützen die Basissystem-Widgets „Formular“, „Ticketanhänge“, „Ticketkonversationen“ und „SC-Katalogelement“ das Hinzufügen von Anhängen durch Einfügen oder Ablegen von Dateien im Dialogfeld „Anhänge hinzufügen“ und nicht nur durch Navigieren im Dateisystem.

    Um diese Funktionalität für andere Widgets zu konfigurieren, können Sie ein Widget klonen oder erstellen, das das Hinzufügen von Anhängen mit der Direktive „ sp-attachment-button “ unterstützt. Weitere Informationen zum Klonen von Widgets finden Sie unter Widget klonen.

    Hinweis:
    Basissystem-Widgets sind schreibgeschützt, damit Sie von zukünftigen Updates profitieren können. Um Änderungen vorzunehmen, können Sie Basis-System-Widgets klonen. Geklonte Widgets gelten jedoch als benutzerdefiniert und profitieren nicht von zukünftigen Updates der Widgets, aus denen sie geklont wurden.

    Erforderliche Rolle: sp_admin oder admin

    Prozedur

    1. Navigieren zu Alle > Service Portal > Serviceportal-Konfigurationan.
    2. Wählen Sie Widget-Editor aus.
    3. Wählen Sie im Menü Ein vorhandenes Widget bearbeiten das geklonte Widget aus.
    4. Suchen Sie in der HTML-Vorlage des Widgets das Element „ sp-attachment-button “.
    5. Konfigurieren Sie Attribute für das Element „ sp-attachment-button “.
      • modal: Aktiviert die Unterstützung von Kopieren, Einfügen und Drag-and-Drop, wenn die Option auf truefestgelegt ist.

        Um die Unterstützung für Kopieren, Einfügen und Drag-and-Drop zu deaktivieren, setzen Sie die Option auf false.

      • unterstützt-Erweiterungen: Zeigt eine Liste der unterstützten Dateierweiterungen für Anhänge am unteren Rand des Dialogfelds „Anhänge hinzufügen“ an.

        Um die unterstützten Dateierweiterungen aufzulisten, die von der Systemeigenschaft glide.attachment.extensions angegeben werden, legen Sie sie auf {{::data.supportedAttachmentExtensions}} fest.

      <sp-attachment-button modal="true" supported-extensions="{{::data.supportedAttachmentExtensions}}"></sp-attachment-button>
    6. Wählen Sie Speichern.

    Ergebnisse

    Auf einer Seite mit dem Widget können Sie Dateien über das Dialogfeld Anhang hinzufügen einfügen oder ablegen, um sie an den Datensatz anzuhängen (siehe folgendes Beispiel).

    Hinweis:
    Diese Funktionalität wird für Mobile-Experiences nicht unterstützt. Das Einfügen von Anhängen wird in Firefox nicht unterstützt.

    Option zum Auswählen, Ablegen oder Einfügen von Dateien im Dialogfeld „Anhänge hinzufügen“.

    Fügen Sie eine Drag-and-Drop-Zone zum Anhängen von Dateien hinzu

    Ermöglichen Sie Portalbenutzern, Anhänge in einer dedizierten Zone einer Seite abzulegen und so schnell Dateien an einen Datensatz anzuhängen.

    Vorbereitungen

    Um eine Drag-and-Drop-Anhangzone auf einer Seite zu konfigurieren, müssen Sie ein Widget klonen oder erstellen, das das Hinzufügen von Anhängen unterstützt, indem Sie „ attachmentHandler “ in seinem Client-Skript auf eine Instanz von „nowAttachmentHandler “ festlegen. Ein Beispiel für ein solches Widget finden Sie unter Formular-Widget. Weitere Informationen zum Klonen von Widgets finden Sie unter Widget klonen.

    Hinweis:
    Basissystem-Widgets sind schreibgeschützt, damit Sie von zukünftigen Updates profitieren können. Um Änderungen vorzunehmen, können Sie Basis-System-Widgets klonen. Geklonte Widgets gelten jedoch als benutzerdefiniert und profitieren nicht von zukünftigen Updates der Widgets, aus denen sie geklont wurden.

    Erforderliche Rolle: sp_admin oder admin

    Warum und wann dieser Vorgang ausgeführt wird

    Standardmäßig können Portalbenutzer auf vielen Basissystemseiten Anhänge hinzufügen, indem sie das Symbol „Anhänge hinzufügen“ (Symbol „Anhang”) wählen, um das Dialogfeld „Anhänge hinzufügen“ zu öffnen. Mit einer Drag-and-Drop-Anhangzone können Portalbenutzer Anhänge mit weniger Klicks hinzufügen. Sie können beispielsweise Anhänge über einen Bereich einer Kataloganforderung oder eines Formulars legen.

    In diesem Beispiel ist die Zone ein Bereich über dem Textkörper eines Formular-Widgets. Die Zone ist nur sichtbar, wenn eine Datei darüber verschoben wird.
    Abbildung : 1. Anhangszone über einem Widget
    Ziehen einer Datei über die Anhangzone in einem Formular-Widget

    Prozedur

    1. Navigieren zu Alle > Service Portal > Serviceportal-Konfigurationan.
    2. Wählen Sie Widget-Editor aus.
    3. Wählen Sie im Menü Ein vorhandenes Widget bearbeiten das Widget aus, das Sie geklont haben, um die Anhangzone hinzuzufügen.
    4. Fügen Sie in der HTML-Vorlage des Widgets die Direktive sp-attachment-picker Attachment-Handler="attachmentHandler" als Attribut eines <div> - oder <section> -Elements hinzu.
      Die Zone kann das gesamte Widget oder nur einen Teil davon enthalten.
      <div sp-attachment-picker attachment-handler="attachmentHandler">
    5. Wahlweise: Konfigurieren Sie Attribute für die Direktive „sp-attachment-picker “.
      • disable-picker-overlay="true": Deaktiviert die Anzeige einer Überlagerung über der Anhangzone, wenn Sie eine Datei darüber ziehen. Standardmäßig ist die Überlagerung aktiviert.
      • onFilePick: Implementiert anwenderdefinierte Logik, indem ein Ereignis ausgelöst wird, wenn eine Datei ausgewählt wird. Legen Sie den Wert auf eine Funktion fest, die als ersten Parameter die Referenzen aller ausgewählten Dateien als Array übernimmt. Beispiel: on-file-pick="attachFiles($files)" Beispiele für anwenderdefinierte Logik, die implementiert werden könnte, umfassen eine Vorschau der Dateien, anwenderdefinierte Validierungen oder anwenderdefinierte Upload-Logik. Wenn dieses Attribut konfiguriert ist, wird das Attribut „attachment-handler="attachmentHandler"“ nicht benötigt und kann entfernt werden.
    6. Wahlweise: Blenden Sie die Anhangszone auf Mobilgeräten aus.
      1. Fügen Sie der Direktive „ sp-attachment- picker“ die Direktive „ng-if="isDesktopBrowser"" hinzu. 
        <div sp-attachment-picker attachment-handler="attachmentHandler" ng-if="isDesktopBrowser">
      2. Fügen Sie im Client-Skript des Widgets das folgende Skript hinzu. 
        $scope.isNative = cabrillo.isNative();
$scope.isMobileBrowser = spUtil.isMobile() && !$scope.isNative;
$scope.isDesktopBrowser = !$scope.isNative && !$scope.isMobileBrowser;
    7. Wählen Sie Speichern.

    Ergebnisse

    Auf einer Seite mit dem Widget können Sie eine oder mehrere ausgewählte Dateien über die Anhangzone ziehen und ablegen, um sie an den Datensatz anzuhängen.

    Fügen Sie einem Widget einen Abschnitt „Anhänge“ hinzu

    Ermöglichen Sie Portalanwendern, Dateien in einem Abschnitt eines Widgets einzufügen, abzulegen oder zu ihnen zu navigieren, um Dateien schnell an einen Datensatz anzuhängen.

    Vorbereitungen

    Um einen Abschnitt mit Anhängen in einem Widget zu konfigurieren, müssen Sie ein Widget klonen oder erstellen, das das Hinzufügen von Anhängen unterstützt, indem Sie „ attachmentHandler “ in seinem Client-Skript aufrufen, das auf eine Instanz von „nowAttachmentHandler“ festgelegt ist. Ein Beispiel für ein solches Widget finden Sie unter Formular-Widget. Weitere Informationen zum Klonen von Widgets finden Sie unter Widget klonen.

    Hinweis:
    Basissystem-Widgets sind schreibgeschützt, damit Sie von zukünftigen Updates profitieren können. Um Änderungen vorzunehmen, können Sie Basis-System-Widgets klonen. Geklonte Widgets gelten jedoch als benutzerdefiniert und profitieren nicht von zukünftigen Updates der Widgets, aus denen sie geklont wurden.

    Erforderliche Rolle: sp_admin oder admin

    Warum und wann dieser Vorgang ausgeführt wird

    Standardmäßig können Portalbenutzer auf vielen Basissystemseiten Anhänge hinzufügen, indem sie das Symbol „Anhänge hinzufügen“ (Symbol „Anhang”) wählen, um das Dialogfeld „Anhänge hinzufügen“ zu öffnen. Mit einem Anhangabschnitt können Portalbenutzer Anhänge mit weniger Klicks hinzufügen.

    In diesem Beispiel wird der Abschnitt „Anhänge“ am unteren Rand eines Katalogelement-Widgets hinzugefügt.
    Abbildung : 2. Anhangabschnitt in einem Widget
    Ein Abschnitt zum Hinzufügen von Anhängen im Katalogelement-Widget

    Prozedur

    1. Navigieren zu Alle > Service Portal > Serviceportal-Konfigurationan.
    2. Wählen Sie Widget-Editor aus.
    3. Wählen Sie im Menü Ein vorhandenes Widget bearbeiten das Widget aus, das Sie geklont haben, um den Anhangsabschnitt hinzuzufügen.
    4. Fügen Sie in der HTML-Vorlage des Widgets die Direktive „ sp-attachment-picker “ als Element hinzu, an der der Abschnitt „Anhänge“ angezeigt werden soll. 
      <sp-attachment-picker attachment-handler="attachmentHandler"></sp-attachment-picker>
    5. Wahlweise: Konfigurieren Sie Attribute für die Direktive „sp-attachment-picker “.
      • disable-picker-overlay="true": Deaktiviert die Anzeige einer Überlagerung über dem Anhangabschnitt, wenn Sie eine Datei darüber ziehen. Standardmäßig ist die Überlagerung aktiviert.
      • onFilePick: Implementiert anwenderdefinierte Logik, indem ein Ereignis ausgelöst wird, wenn eine Datei ausgewählt wird. Legen Sie den Wert auf eine Funktion fest, die als ersten Parameter die Referenzen aller ausgewählten Dateien als Array übernimmt. Beispiel: on-file-pick="attachFiles($files)" Beispiele für anwenderdefinierte Logik, die implementiert werden könnte, umfassen eine Vorschau der Dateien, anwenderdefinierte Validierungen oder anwenderdefinierte Upload-Logik.
    6. Wahlweise: Blenden Sie den Abschnitt „Anhang“ auf Mobilgeräten aus.
      1. Fügen Sie der Direktive „ sp-attachment- picker“ die Direktive „ng-if="isDesktopBrowser"" hinzu. 
        <sp-attachment-picker attachment-handler="attachmentHandler" ng-if="isDesktopBrowser"></sp-attachment-picker>
      2. Fügen Sie im Client-Skript des Widgets das folgende Skript hinzu. 
        $scope.isNative = cabrillo.isNative();
$scope.isMobileBrowser = spUtil.isMobile() && !$scope.isNative;
$scope.isDesktopBrowser = !$scope.isNative && !$scope.isMobileBrowser;
    7. Wählen Sie Speichern.

    Ergebnisse

    Auf einer Seite mit dem Widget können Sie eine oder mehrere ausgewählte Dateien über den Anhangabschnitt einfügen oder ablegen, um sie an den Datensatz anzuhängen.

    Hinweis:
    Das Einfügen von Anhängen wird in Firefox nicht unterstützt.