Dateien werden von Portalseiten an Datensätze angehängt

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 6 Minuten Lesedauer
  • Anhänge können Datensätzen von Portalseiten 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 Portalanwendern mit einer oder mehreren dieser Methoden. Um zu ändern, wie Portalanwender Anhänge hinzufügen können, können Sie Widgets klonen und bearbeiten, um die Dateianhänge-Experience wie in den folgenden Verfahren beschrieben anzupassen.

    Informationen zum Nachverfolgen, wie Portalanwender Dateien an Datensätze von Seiten in Ihrem Portal anhängen, finden Sie unter SP-Dateianhang-Ereignis in User Experience Analytics Für Serviceportal. 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öglichen Sie Portalanwendern das Anhängen von Dateien, indem Sie Dateien im Dialogfeld „Anhänge hinzufügen“ einfügen oder ablegen.

    Vorbereitungen

    Standardmäßig unterstützen die Widgets „Formular“, „Ticketanhänge“, „Ticketkonversationen“ und „SC-Katalogelement-Basissystem“ das Hinzufügen von Anhängen durch Einfügen oder Ablegen von Dateien im Dialogfeld „Anhänge hinzufügen“ anstatt nur durch Navigation 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 unterstützt sp-attachment-button richtlinie. 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 Aus Widget-Editor .
    3. Wählen Sie im Menü Vorhandenes Widget bearbeiten das geklonte Widget aus.
    4. In HTML-Vorlage Suchen Sie des Widgets nach sp-attachment-button Element.
    5. Konfigurieren Sie Attribute für sp-attachment-button Element.
      • Modal : Aktiviert die Unterstützung beim Kopieren/Einfügen und Drag-and-Drop, wenn sie auf festgelegt wird Wahr .

        Um die Unterstützung für Kopieren/Einfügen und Drag-and-Drop zu deaktivieren, legen Sie sie auf fest Falsch .

      • Unterstützte Erweiterungen : Zeigt eine Liste der unterstützten Dateierweiterungen für Anhänge unten im Dialogfeld „Anhänge hinzufügen“ an.

        Zum Auflisten der unterstützten Dateierweiterungen, die von angegeben werden glide.attachment.extensionsSystemeigenschaft, legen Sie sie auf fest {{::Data.supportedAttachmentExtensions}} .

      <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 Portalanwendern, Anhänge in einer dedizierten Zone einer Seite abzulegen, um schnell Dateien an einen Datensatz anzuhängen.

    Vorbereitungen

    Um eine Drag-and-Drop-Anhangszone auf einer Seite zu konfigurieren, müssen Sie ein Widget klonen oder erstellen, das das Hinzufügen von Anhängen durch Aufruf unterstützt AttachmentHandler Auf eine Instanz von festlegen NowAttachmentHandler In seinem Client-Skript. 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 Portalanwender Anhänge auf vielen Basissystemseiten hinzufügen, indem sie das Symbol Anhänge hinzufügen ( wählen Symbol „Anhang”), um das Dialogfeld Anhänge hinzufügen zu öffnen. Mit einer Drag-and-Drop-Anhangszone können Portalanwender Anhänge mit weniger Klicks hinzufügen. Sie können beispielsweise Anhänge über einem Bereich einer Kataloganforderung oder eines Formulars ablegen.

    In diesem Beispiel ist die Zone ein Bereich über dem Kö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 Aus Widget-Editor .
    3. Wählen Sie im Menü „Vorhandenes Widget bearbeiten“ das geklonte Widget aus, dem die Anhangszone hinzugefügt werden soll.
    4. In HTML-Vorlage Fügen Sie des Widgets hinzu sp-attachment-Picker attachment-Handler="attachmentHandler" richtlinie als Attribut von <div>Oder <section>Element.
      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 sp-attachment-Picker richtlinie.
      • Disable-Picker-Overlay="wahr" : 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 die Referenzen aller ausgewählten Dateien als Array als ersten Parameter verwendet. Beispiel: On-file-pick="attachFiles($files)" . Beispiele für anwenderdefinierte Logik, die implementiert werden könnte, umfassen die Vorschau der Dateien, anwenderdefinierte Validierungen oder anwenderdefinierte Upload-Logik. Wenn dieses Attribut konfiguriert ist, wird AttachmentHandler="attachmentHandler" Attribut ist nicht erforderlich und kann entfernt werden.
    6. Wahlweise: Blenden Sie die Anhangszone auf Mobilgeräten aus.
      1. Fügen Sie hinzu Ng-if="isDesktopBrowser" richtlinie an sp-attachment-Picker richtlinie.
        <div sp-attachment-picker attachment-handler="attachmentHandler" ng-if="isDesktopBrowser">
      2. In Client-Skript Fügen Sie 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 Anhangszone ziehen und ablegen, um sie an den Datensatz anzuhängen.

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

    Ermöglichen Sie Portalanwendern das Einfügen, Ablegen oder Navigieren zu Dateien in einem Abschnitt eines Widgets, um Dateien schnell an einen Datensatz anzuhängen.

    Vorbereitungen

    Um einen Abschnitt „Anhänge“ in einem Widget zu konfigurieren, müssen Sie ein Widget klonen oder erstellen, das das Hinzufügen von Anhängen durch Aufruf unterstützt AttachmentHandler Auf eine Instanz von festlegen NowAttachmentHandler In seinem Client-Skript. 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 Portalanwender Anhänge auf vielen Basissystemseiten hinzufügen, indem sie das Symbol Anhänge hinzufügen ( wählen Symbol „Anhang”), um das Dialogfeld Anhänge hinzufügen zu öffnen. Mit einem Abschnitt „Anhänge“ können Portalanwender 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. Abschnitt „Anhang“ 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 Aus Widget-Editor .
    3. Wählen Sie im Menü „Vorhandenes Widget bearbeiten“ das geklonte Widget aus, dem der Anhang hinzugefügt werden soll.
    4. In HTML-Vorlage Fügen Sie des Widgets hinzu sp-attachment-Picker richtlinie als Element, in dem der Abschnitt „Anhänge“ angezeigt werden soll.
      <sp-attachment-picker attachment-handler="attachmentHandler"></sp-attachment-picker>
    5. Wahlweise: Konfigurieren Sie Attribute für sp-attachment-Picker richtlinie.
      • Disable-Picker-Overlay="wahr" : Deaktiviert die Anzeige einer Überlagerung über dem Anhangsabschnitt, 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 die Referenzen aller ausgewählten Dateien als Array als ersten Parameter verwendet. Beispiel: On-file-pick="attachFiles($files)" . Beispiele für anwenderdefinierte Logik, die implementiert werden könnte, umfassen die Vorschau der Dateien, anwenderdefinierte Validierungen oder anwenderdefinierte Upload-Logik.
    6. Wahlweise: Blenden Sie den Abschnitt „Anhang“ auf Mobilgeräten aus.
      1. Fügen Sie hinzu Ng-if="isDesktopBrowser" richtlinie an sp-attachment-Picker richtlinie.
        <sp-attachment-picker attachment-handler="attachmentHandler" ng-if="isDesktopBrowser"></sp-attachment-picker>
      2. In Client-Skript Fügen Sie 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 Anhang einfügen oder ablegen, um sie an den Datensatz anzuhängen.

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