latest
💡 Core Concepts
Referenzieren von Portalinhalten

Referenzieren von Portalinhalten

Um Portalinhalte (z.B. Layer) in Terratwin zur Verfügung zu stellen, müssen diese in den Konfigurationsdateien korrekt referenziert werden. Ein Portalelement kann nur referenziert werden, wenn es für den aktuellen Benutzer bzw. öffentlich freigegeben ist. Der Benutzer erhält keine Benachrichtigung, wenn die Referenzierung nicht erfolgreich war. Das bringt den Vorteil, dass eine große Anzahl an Portalelementen referenziert werden können und diese aber unterschiedlich freigegeben sein können. Weitere Information zur Freigabe von Elementen finden Sie hier (opens in a new tab).

Ein einzelnes Portalelement referenzieren

Einzelne Elemente müssen über die Angabe einer portalUrl und der itemid referenziert werden. Beispiel:

"portalItem": {
  "id": "5df03826a9c34d6ua0bb663e4etae932",
  "portal": {
    "url": "https://arcgis.com/"
  }
}

Mehrere Portalelemente referenzieren

Es müssen eine portalUrl und Abfrageparameter queryParams definiert werden, damit Elemente vom Portal referenziert werden können.
Die folgende Tabelle bietet eine Übersicht über die verschiedenen Parameter, die bei queryParams verwendet werden können. Diese Parameter ermöglichen es, Abfragen an das Portal präzise anzupassen und die gewünschten Ergebnisse zu filtern und zu sortieren.

EigenschaftTypBeschreibung
categoriesArray<string> oder Array<Array<string>>Ein Array von Kategorien, die im Element gespeichert sind. Ermöglicht das Filtern der Ergebnisse mithilfe von Kategorien und unterstützt AND/OR-Operationen innerhalb verschachtelter Arrays.
extentExtentBeschränkt die Abfrageergebnisse auf den angegebenen Bereich. Die Raumreferenz des Bereichs muss WGS84 (wkid 4326) oder Web Mercator (wkid 3857) sein.
filterStringEin strukturierter Filter, der anstelle der query-Eigenschaft verwendet wird. Weitere Informationen hier (opens in a new tab).
numNumberDie maximale Anzahl der in der Antwort enthaltenen Ergebnisse. Standardmäßig auf 10 gesetzt, mit einem Höchstwert von 100.
queryStringDer für die Suche verwendete Abfrage-String. Weitere Informationen hier (opens in a new tab).
sortFieldStringEine durch Kommas getrennte Liste von Feldern, nach denen sortiert werden soll. Mögliche Werte sind "title", "uploaded", "modified", "username", "created", "type", "owner", "avg-rating", "num-ratings", "num-comments", "num-views".
sortOrderStringDie Reihenfolge, in der die Ergebnisse sortiert werden. Mögliche Werte sind "asc" (aufsteigend) und "desc" (absteigend). Standardmäßig auf "asc" gesetzt.
startNumberDer Index des ersten Eintrags in der Ergebnisantwort. Diese Eigenschaft wird in Kombination mit num zur Paginierung verwendet. Standardmäßig auf 1 gesetzt.

Im folgenden Beispiel werden mehrere Elemente vom Typ Service über die Angabe einer Gruppen-Id referenziert:

"orgLayer": {
  "portalUrl": "https://arcgis.com",
  "queryParams": {
    "filter": "typekeywords:service AND group:7c61344211bd40d3ba39244aeeage7e1"
  }
}