Menü der Dokumentation

Einrichten von Weiterleitungen (integrator)

Mit dem Feature Weiterleitungen in d.velop documents for Microsoft 365 können Sie mit generischen Links, Aufrufe für Dokumente und Akten aus Drittsystemen definieren.

So geht's

  1. Öffnen Sie die Webseite d.velop for Microsoft 365 - Admin in Ihrem Browser unter der URL https://admin.d-velop365.com.

  2. Melden Sie sich an.

  3. Klicken Sie auf das Neun-Punkte-Menü.

  4. Klicken Sie auf Weiterleitungen unterhalb von d.velop documents for Microsoft 365.

  5. Klicken Sie auf Neu.

  6. Benennen Sie die Weiterleitung im Feld Name mit einem eindeutigen Namen.

  7. Geben Sie eine Beschreibung für die Weiterleitung an.

  8. Wählen Sie eine Suchmethodik aus, mit der das Ziel gesucht werden soll. Zur Auswahl steht die übergreifende Suche im Suchindex (SharePoint-Suche, KeyWordQuery) und die direkte Suche in einer Liste oder Bibliothek (SPQuery).

Erstellen einer neuen Weiterleitung für die Suche im Suchindex

  1. Geben Sie die gewünschte Ziel-URL ein. Zur Vereinfachung wählen Sie eine gespeicherte Vorlage aus Vorlage für die Ziel-URL aus.

    Wenn Sie die integrierte Ansicht (Embedded View) adressieren möchten, tragen Sie manuell die URL für den Aufruf ein. Die URL finden Sie im Aktenplan.

  2. Definieren Sie unter SharePoint-Suchabfrage die gewünschten Abfrageparameter. Legen Sie die SharePoint KeyWordQuery-Abfrage in Form der KQL-Syntax (KeyWordQuery Language) fest.

    Wollen Sie mehrere Abfragen miteinander verknüpfen, verwenden Sie AND als Operator.

    Beispiel

    • Aufruf eines Beleges über DocumentNumber:

      ecsDocumentID={DocumentNumber}

    • Aufruf eines Beleges vom Inhaltstypen Invoice über DocumentNumber und Mandanten:

      ecsDocumentID={DocumentNumber} AND contentType=Invoice AND ecsCompanyCode={CompanyCode}

  3. Testen Sie die Abfrage, indem Sie die Abfrageparameter im Feld Testparameter definieren.

    • Sie erhalten eine Tabelle mit den Testergebnissen.

    • Klicken Sie auf eine Zeile, um weitere Informationen zu dem entsprechenden Ergebnis zu erhalten.

  4. Entnehmen Sie die generierte URL zur Integration in externe Systeme und tragen Sie die URL im aufrufenden System ein. Ersetzen Sie den Platzhalter ggf. mit systemspezifischen Platzhaltern, beispielsweise %1.

  5. Speichern Sie die Weiterleitung.

    Warnung

    Bitte aktivieren Sie die Option Übersteuerung der SharePoint Basis-URL nur dann, wenn der Suchindex des Mandanten Probleme aufweist und Suchergebnisse beispielsweise nicht auf Mandantenebene, sondern nur auf Websitesammlungsebene gefunden werden.

Erstellen einer neuen Weiterleitung für die Suche im Liste oder Bibliothek

  1. Geben Sie die gewünschte Ziel-URL ein. Zur Vereinfachung wählen Sie eine gespeicherte Vorlage aus Vorlage für die Ziel-URL aus.

  2. Vervollständigen Sie die Eingabe unter URL der Liste/Bibliothek und geben Sie die Liste bzw. Bibliothek an, in der gesucht werden soll.

  3. Vervollständigen Sie die Eigenschaft URL der Website mit der absoluten URL der SharePoint-Websitesammlung.

  4. Definieren Sie unter Parameter Mapping die gewünschten Abfrageparameter. Legen Sie für die SharePoint-SPQuery die Abfrage in Form der Syntax ecsPlaneID:{PlaneID} fest. ecsPlaneID stellt den internen Namen der Websitespalte dar und {PlaneID} gibt den Parameter an.

    Beispiel

    • ecsVorgangsnummer:{Vorgangsnr}

    • (ecsArticlePackagingCode:{ArticlePackagingCode}) and (ecsArticle:{Article})

  5. Testen Sie die Abfrage, indem Sie die Abfrage im Feld Testparameter definieren.

    • Sie erhalten eine Tabelle mit den Testergebnissen.

    • Klicken Sie auf eine Zeile, um weitere Informationen zu dem entsprechenden Ergebnis zu erhalten.

  6. Entnehmen Sie die generierte URL zur Integration in externe Systeme und tragen Sie die URL im aufrufenden System ein.

  7. Speichern Sie die Weiterleitung.