Anhängen von Dateien an Datensätze von Portalseiten

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 6 Minuten Lesedauer

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

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

    Informationen zum Nachverfolgen, wie Portalbenutzer Dateien an Datensätze von Seiten in Ihrem Portal anhängen, finden Sie unter SP-Dateianhänge-Ereignis in User Experience Analytics für Serviceportal. Weitere Informationen zu verfügbaren Events finden Sie unter Serviceportal Events.

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

    Ermöglichen Sie 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-Konfiguration.
    2. Wählen Sie Widget-Editor aus.
    3. Wählen Sie im Menü 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 sp-attachment-button- Element.
      • 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, legen Sie die Option auf falsefest.

      • unterstützte 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, wie im folgenden Beispiel gezeigt.

    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 das Ablegen von Anhängen in einem dedizierten Bereich einer Seite, um Dateien schnell 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 im Client-Skript auf eine Instanz von nowAttachmentHandler festlegen. Ein Beispiel für ein Widget wie dieses 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 Anhänge auf vielen Basissystemseiten hinzufügen, indem sie auf das Symbol „Anhänge hinzufügen“ (Symbol „Anhang”) klicken, um das Dialogfeld „Anhänge hinzufügen“ zu öffnen. Mit einer Zone für Drag-and-Drop-Anhänge können Portalbenutzer Anhänge mit weniger Klicks hinzufügen. Beispielsweise können Sie Anhänge über einem Bereich einer Kataloganforderung oder einem Formular ablegen.

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

    Prozedur

    1. Navigieren zu Alle > Service Portal > Serviceportal-Konfiguration.
    2. Wählen Sie Widget-Editor aus.
    3. Wählen Sie im Menü 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 benutzerdefinierte Logik, indem ein Ereignis ausgelöst wird, wenn eine Datei ausgewählt wird. Legen Sie den Wert auf eine Funktion fest, die die Referenzen aller ausgewählten Dateien als Array als ersten Parameter übernimmt. Beispiel: on-file-pick="attachFiles($files)". Beispiele für benutzerdefinierte Logik, die implementiert werden könnte, sind die Vorschau der Dateien, benutzerdefinierte Validierungen oder benutzerdefinierte 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 Anhangzone auf Mobilgeräten aus.
      1. Fügen Sie die Direktive ng-if="isDesktopBrowser" der Direktive sp-attachment-picker 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 Portalbenutzern das Einfügen, Ablegen oder Navigieren zu Dateien in einem Abschnitt eines Widgets, um Dateien schnell an einen Datensatz anzuhängen.

    Vorbereitungen

    Um einen Anhangsabschnitt 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 auf eine Instanz von nowAttachmentHandler festlegen. Ein Beispiel für ein Widget wie dieses 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 Anhänge auf vielen Basissystemseiten hinzufügen, indem sie auf das Symbol „Anhänge hinzufügen“ (Symbol „Anhang”) klicken, um das Dialogfeld „Anhänge hinzufügen“ zu öffnen. Mit einem Abschnitt „Anhänge“ können Portalbenutzer Anhänge mit weniger Klicks hinzufügen.

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

    Prozedur

    1. Navigieren zu Alle > Service Portal > Serviceportal-Konfiguration.
    2. Wählen Sie Widget-Editor aus.
    3. Wählen Sie im Menü Vorhandenes Widget bearbeiten das Widget aus, das Sie geklont haben, um den Anhangabschnitt 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 benutzerdefinierte Logik, indem ein Ereignis ausgelöst wird, wenn eine Datei ausgewählt wird. Legen Sie den Wert auf eine Funktion fest, die die Referenzen aller ausgewählten Dateien als Array als ersten Parameter übernimmt. Beispiel: on-file-pick="attachFiles($files)". Beispiele für benutzerdefinierte Logik, die implementiert werden könnte, sind die Vorschau der Dateien, benutzerdefinierte Validierungen oder benutzerdefinierte Upload-Logik.
    6. Wahlweise: Blenden Sie den Anhangsabschnitt auf Mobilgeräten aus.
      1. Fügen Sie die Direktive ng-if="isDesktopBrowser" der Direktive sp-attachment-picker 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.