Verwenden von URL-Parametern—ArcGIS Knowledge Server | Dokumentation zu ArcGIS Enterprise

ArcGIS Knowledge Studio kann durch die Verwendung von Links zum Öffnen von Knowledge Studio in andere Apps integriert werden. Sie können zum Beispiel App-Links zum Starten und Öffnen von Knowledge Studio und zum Erstellen und Aktualisieren bestimmter Inhalte in einer anderen Esri App, in einem Webkarten-Pop-up oder über einen einfachen Hyperlink in einer E-Mail oder einer Website erstellen.

Ein URL-Parameter ist ein Name/Wert-Paar. In jedem Parameter werden der Name und der Wert durch ein Gleichzeichen (=) getrennt.

Hinweis:

In diesem Thema werden Werte, die für den Kontext der URL-Anforderung spezifisch sind, in Größer-als- und Kleiner-als-Zeichen (<>) eingeschlossen. In der URL https://<YourPortal>/apps/knowledge-studio/main? muss <YourPortal> beispielsweise durch den Speicherort Ihres Portals ersetzt werden.

Freigeben von Knowledge Studio-Projektinhalt

Sie können eine URL zu einem bestimmten Inhaltselement, einer gespeicherten Abfrage, einer Entität oder einer Beziehung in einem Knowledge Studio-Projekt freigeben. Alle Karten, Verbindungsdiagramme, Datenkacheln, gespeicherten Abfragen, die Dashboard-Ansicht und der ausgewählte Datensatz in der Wissensgraph-Ansicht haben eine eindeutige URL, die Sie freigeben können, um eine Verbindung zu einem bestimmten Inhalt, einer Entität oder einer Beziehung im Projekt herzustellen.

Um Karten, Verbindungsdiagramme, gespeicherte Abfragen und Datenkacheln freizugeben, müssen Sie das Projekt speichern. Sie können eine URL zu einer bestimmten Entität oder Beziehung aus jedem Projekt freigeben.

Basis-URL

Ein Knowledge Studio-Projekt generiert automatisch URLs, die Sie verwenden können, um einen bestimmten Inhalt, eine bestimmte Entität oder Beziehung in der Wissensgraph-Ansicht oder einer gespeicherten Abfrage freizugeben. Sie können diese URL-Komponenten auch verwenden, um URLs mit den URL-Authoring-Parametern zu erstellen, um neue Inhalte zu erstellen, Entitäten und Beziehungen zu bestehenden Inhalten hinzuzufügen oder gespeicherte Abfragen auszuführen.

Knowledge Studio-Projekt-URLs haben die folgende Struktur:

Der erste Abschnitt verweist auf Knowledge Studio.

https://<YourPortal>/portal/apps/knowledge-studio/main?

Die Knowledge Studio-Projekt-ID wird nach dem Fragezeichen (?) hinzugefügt. Wenn Sie ein Knowledge Studio-Projekt verwenden, das Sie im Portal gespeichert haben, wird dessen Portalelement-ID verwendet. Wenn Sie das Projekt noch nicht gespeichert haben, wird die Portalelement-ID des Wissensgraph-Service, den Sie gerade erkunden, als Projekt-ID verwendet, bis Sie das Projekt speichern.

id=b1ce0d5b814c40ba8809fb3625f476db

Inhalts-IDs

Alle Parameter nach der Projekt-ID werden mit einem kaufmännischen Und-Zeichen (&) hinzugefügt und geben an, welche Inhaltselemente ausgewählt werden, wobei zusätzliche Parameter abhängig von diesem Inhaltselement hinzugefügt werden. Da ein Knowledge Studio-Projekt jeweils nur eine der Standardansichten – Dashboard, Abfrage und Wissensgraph – enthalten kann, verfügen diese Ansichten über eine benannte ID. Alle anderen Inhaltselemente erhalten im Projekt eine eindeutige Kennung.

&selectedContentId=<contentID>


Inhaltselement	Inhalts-ID
Ansicht "Wissensgraph"	dataExplorer
Ansicht "Abfrage"	queryViewer
Ansicht "Dashboard"	dashboard
Karten und Verbindungsdiagramme	Vom Projekt generiert, wenn das Inhaltselement im Format cb4449dd-886c-4623-837b-7a5685a76fc7 hinzugefügt oder erstellt wird.

Anzeigen spezifischer Parameter

Die Ansicht "Wissensgraph" und die Ansicht "Abfrage" können zusätzliche Parameter enthalten, die zusätzlichen Kontext liefern. Allen Parametern muss ein Gleichheitszeichen (=) und anschließend der Wert folgen.


Inhaltselement	Zusätzliche Parameter	Werte	Details
Ansicht "Wissensgraph"	selectedContentElement	Die eindeutige Kennung der ausgewählten Entität oder Beziehung.	Die URL-codierte eindeutige Kennung für eine Entität oder eine Beziehung. Wenn die ID beispielsweise {B1FF2B9A6-C146-4913-A364-BC81F66A025D} lautet, müssen die geschweiften Klammern ({}) in %7B1FF2B9A6-C146-4913-A364-BC81F66A025D%7D codiert werden.
Ansicht "Wissensgraph"	selectedContentInstruction	entity relationship	Gibt an, ob die ID für eine Entität oder eine Beziehung gilt.
Ansicht "Abfrage"	selectedContentElement	Die eindeutige Kennung für eine gespeicherte Abfrage	Nur hinzugefügt, wenn eine gespeicherte Abfrage im Format cb4449dd-886c-4623-837b-7a5685a76fc7 ausgewählt wird.

Beispiel für eine URL, mit der Sie zu einer bestimmten Entität in der Ansicht "Wissensgraph" gelangen

https://<YourPortal>/portal/apps/knowledge-studio/main?id=ddd37b4f73904c7ba073d9fed75dba6c&selectedContentId=dataExplorer&selectedContentElement=%7B29018C8F-A061-4889-B5BB-77714E4ACC3D%7D&selectedContentInstruction=entity

Beispiel für eine URL, mit der Sie zu einer spezifischen gespeicherten Abfrage in der Ansicht "Abfrage" gelangen. Das Freigeben gespeicherter Abfragen auf diese Weise ist nur nach dem Speichern des Projekts möglich.

https://<YourPortal>/portal/apps/knowledge-studio/main?id=ddd37b4f73904c7ba073d9fed75dba6c&selectedContentId=queryViewer
&selectedContentElement=cb4449dd-886c-4623-837b-7a5685a76fc7

URL-Erstellungsparameter

Sie können einer Knowledge Studio-URL zusätzliche Parameter hinzufügen, um Inhalte in einem Knowledge Studio-Projekt aus einer anderen Esri App, einem Webkarten-Pop-up oder einem einfachen Hyperlink in einer E-Mail oder auf einer Website zu erstellen. Die folgenden Aktionen werden durch Erstellungsparameter unterstützt.

Erstellen neuer Karten und Verbindungsdiagramme
Hinzufügen von Entitäten und Beziehungen zu bestehenden Karten und Verbindungsdiagrammen
Erstellen neuer Karten und Verbindungsdiagramme aus einer Vorlage
Erstellen einer neuen gespeicherten Abfrage
Ausführen einer vorhandenen gespeicherten Abfrage mit neuen Parametern

Die Basis-URL für die Verwendung von Erstellungsparametern lautet:

https://<YourPortal>/portal/apps/knowledge-studio/studioApiContent?

Nach dem Fragezeichen sind für alle Erstellungsaktionen die folgenden Parameter erforderlich:


Parameter	Wert	Details
version	Die ArcGIS Enterprise-Versionsnummer
operation	createNew addToExisting executeQuery createQuery	Die Operation, die Sie mit den URL-Parametern ausführen möchten. Sie können neue Inhalte erstellen, bestehende Inhalte ergänzen oder Abfragen ausführen.
id	Knowledge Studio-Projektelement-ID oder Knowledge-Graph-Service-Element-ID	Die Portalelement-ID für ein Knowledge Studio-Projekt oder einen Wissensgraph-Service. Sie können neue Inhalte mithilfe eines Elements des Knowledge Studio-Projektportals oder eines neuen, nicht gespeicherten Projekts erstellen, das aus einem Portalelement des Wissensgraph-Service-initialisiert wurde. Das Hinzufügen zu vorhandenen Inhalten und das Ausführen vorhandener Abfragen ist nur mit einem Element des Knowledge Studio-Projektportals möglich.

Für jede Operation sind je nach der von Ihnen gewünschten Aktion zusätzliche Parameter erforderlich.

URL-Codierung

Achten Sie darauf, den Wert eines Parameters zu codieren, wenn Sie ihn zur Laufzeit an ein Dashboard übergeben. Durch die Codierung wird sichergestellt, dass ungültige Zeichen durch das Prozentzeichen (%) gefolgt vom jeweils zugehörigen hexadezimalen Äquivalent ersetzt werden. Wenn Sie mehrere Parameter angeben möchten, müssen Sie sie durch kaufmännische Und-Zeichen (&) voneinander trennen.

Hinweis:

Eine Möglichkeit zum Erstellen codierter Parameter ist die Verwendung von ArcGIS Arcade. Mit der Funktion "UrlEncode" können Sie eine Sammlung von Schlüssel-Wert-Paaren definieren und eine URL mit entsprechender Codierung erzeugen.

Hinweis:

Die Reihenfolge der Parameter ist nicht relevant. param=value&param2=value2 und param=value&param2=value2 führen beispielsweise zum selben Ergebnis.

Erstellen neuer Inhaltselemente

Mit den Entitäten und Beziehungen in einem Knowledge Studio-Projekt können Sie eine neue Karte oder ein neues Verbindungsdiagramm erstellen. Sie können auch eine neue Karte oder ein neues Verbindungsdiagramm erstellen, indem Sie ein vorhandenes Inhaltselement desselben Typs als Vorlage verwenden. Neue Inhalte können in einem bestehenden Projekt oder in einem neuen Projekt erstellt werden.

Hinweis:

Verknüpfte Portalinhaltselemente können nicht als Vorlage zum Erstellen neuer Inhaltselemente verwendet werden.

Um ein Inhaltselement in einem bestehenden Projekt zu erstellen, geben Sie die Projektelement-ID im Parameter id an. Um eine Karte oder ein Verbindungsdiagramm in einem neuen, noch nicht gespeicherten Projekt zu erstellen, geben Sie die Element-ID des Wissensgraph-Service im Parameter id an. Die folgenden Parameter werden zum Erstellen neuer Karten und Verbindungsdiagramme verwendet:


Parameter	Wert	Details
entityIds	Array eindeutiger IDs	Ein Array eindeutiger Kennungen der Entitäten, die zum Inhaltselement hinzugefügt werden sollen.
relationshipIds	Array eindeutiger IDs	Ein Array eindeutiger Kennungen der Beziehungen, die zum Inhaltselement hinzugefügt werden sollen. Wenn Sie nur Beziehungs-IDs angeben, werden deren Ursprungs- und Zielentitäten automatisch hinzugefügt.
contentType	map linkChart	Der Typ des Inhaltselements, das im Projekt erstellt werden soll
properties	linkChartProperties-Objekt	layoutType-Objekt	Der Layout-Typ des Verbindungsdiagramms, der für das neue Verbindungsdiagramm verwendet werden soll. Informationen zu den unterstützten Layout-Typen finden Sie unter Layout-Typen.
properties	linkChartProperties-Objekt	layoutSettings-Objekt (optional)	Layout-Einstellungen für alle organischen oder chronologischen Layouts. Weitere Informationen zu den konfigurierbaren Einstellungen finden Sie unter Layout-Einstellungen.
contentId (optional)	Knowledge Studio Projektinhalt-ID	Die ID des Inhaltselements, das als Vorlage verwendet werden soll. Falls angegeben, wird die Definition des Inhaltselements zum Erstellen des neuen Inhaltselements verwendet. Das Inhaltselement der Vorlage muss denselben Inhaltstyp haben wie das neue Inhaltselement.

Beispiel eines linkChartProperties-Objekts, wobei nur layoutType angegeben ist:

{ "linkChartProperties" : { "layoutType" : "force-directed" } }

Beispiel eines layoutSettings-Objekts für ein geographisches Layout. Layout-Einstellungen sind optional und werden nur für organische und chronologische Layouts unterstützt. Informationen zu weiteren Optionen für Layout-Einstellungen finden Sie unter Layout-Einstellungen. Diese Objekte müssen codiert werden, damit sie als URL-Parameterwert genutzt werden können.

{
    "linkChartProperties":{
        "layoutType":"geographic-organic-standard",
        "layoutSettings":{
            "organicLayoutSettings": {
                "absoluteIdealEdgeLength": 5,
                "computationBudgetTime": 2,
                "autoRepulsionRadius": false,
                "idealEdgeLengthType": "absolute-value"
                "multiplicativeIdealEdgeLength": 1,
                "repulsionRadiusMultiplier": 1
            }
        }
    }
}

Hinzufügen zu bestehenden Inhaltselementen

Sie können Entitäten und Beziehungen zu einer bestehenden Karte oder einem Verbindungsdiagramm in einem Knowledge Studio-Projekt hinzufügen. Das Hinzufügen zu bestehenden Inhalten ist nur unter Verwendung eines Knowledge Studio-Projektinhaltselements möglich.


Parameter	Wert	Details
entityIds	Array eindeutiger IDs	Ein Array eindeutiger Kennungen der Entitäten, die zum Inhaltselement hinzugefügt werden sollen
relationshipIds	Array eindeutiger IDs	Ein Array eindeutiger Kennungen der Beziehungen, die zum Inhaltselement hinzugefügt werden sollen. Wenn Sie nur Beziehungs-IDs angeben, werden deren Ursprungs- und Zielentitäten automatisch hinzugefügt
contentId	Knowledge Studio Projektinhalt-ID	Die Kennung für das Inhaltselement Diese kann der Knowledge Studio-Projekt-URL entnommen werden, wenn das Inhaltselement auf der geöffneten Registerkarte angezeigt wird.

Erstellen neuer Abfragen

Sie können in einem Knowledge Studio-Projekt neue Abfragen erstellen und ausführen. Neue Inhalte können in einem bestehenden Projekt oder in einem neuen Projekt erstellt werden.

Um eine neue Abfrage in einem bestehenden Projekt zu erstellen, geben Sie die Projektelement-ID im Parameter id an. Um eine Abfrage in einem neuen, noch nicht gespeicherten Projekt zu erstellen, geben Sie die Element-ID des Wissensgraph-Service im Parameter id an. Die folgenden Parameter werden zum Erstellen neuer Karten und Verbindungsdiagramme verwendet:

Die folgenden Eigenschaften können zum Erstellen einer neuen Abfrage verwendet werden:


Parameter	Wert	Details
properties	name	Der Name der neuen gespeicherten Abfrage, die erstellt werden soll.
	openCypherQuery	Die auszuführende openCypher-Abfrage. Weitere Informationen zu openCypher-Abfragen
	description (optional)	Eine Beschreibung der neuen gespeicherten Abfrage.
	provenanceBehavior (optional)	Gibt an, ob in den Abfrageergebnissen Provenienzergebnisse enthalten sein sollen. Wenn nicht angegeben, ist die Standardeinstellung "Ausschließen". include exclude
	bindParameters (optional)	Ein Array von Objekten für jeden Parameter, der in der Abfrage verwendet werden soll. Parameter sind optional. Wenn Sie jedoch einen Parameter in Ihrer Abfrage verwenden, müssen Sie die Parameterinformationen im URL-Parameter bindParameter angeben. Die URL-Parameter für die Objekte sind in der folgenden Tabelle aufgeführt. Weitere Information zur Verwendung von Parametern in Abfragen

Das Verwenden von Parametern in Abfragen ist optional. Wenn Sie jedoch einen Parameter in Ihrer Abfrage verwenden, müssen Sie die Parameterinformationen im URL-Parameter bindParameter angeben. bindParameter ist ein Array von Objekten für jeden Parameter, der in der Abfrage verwendet werden soll. Weitere Informationen über Optionen des bind-Parameters

Die URL-Parameter für die Objekte sind in der folgenden Tabelle aufgeführt:


Parameter	Details
title (optional)	Titel des bind-Parameters
parameterName	Der Name des bind-Parameters, der in der openCypher-Abfrage verwendet wird.
parameterType	Der Typ des Werts des bind-Parameters. Dieser Typ muss mit dem Typ der Eigenschaft in der Abfrage übereinstimmen, in der Sie den Parameter verwenden. Die Typen sind nachstehend aufgeführt: esriBindParameterTypeString esriBindParameterTypeNumber esriBindParameterTypeDateTime esriBindParameterTypeDate esriBindParameterTypeTime esriBindParameterTypeTimestampOffset esriBindParameterTypeEntityId esriBindParameterTypeRelationshipId esriBindParameterTypeGeometry
value	Der Wert des bind-Parameters Dieser kann ein Einzelwert des in parameterType angegebenen Typs oder ein Array von Werten dieses Typs sein.

Beispiel für die Struktur des Arrays der bind-Parameter vor der Codierung:

"bindParameters": [
      {
        "parameterName": "facilities",
        "parameterType": "esriBindParameterTypeEntityId",
        "value": ["2344","2342"]
      }
    ]
  };

Ausführen vorhandener Abfragen

Sie können vorhandene gespeicherte Abfragen in einem Knowledge Studio-Projekt ausführen. Wenn die Abfrage Parameter enthält, können Sie neue Parameterwerte unter Verwendung der URL-Parameter senden. Sie können nur unter Verwendung eines Knowledge Studio-Projektinhaltselements vorhandene Abfragen ausführen.

Die folgenden Eigenschaften können zum Ausführen einer vorhandenen Abfrage verwendet werden:


Parameter	Wert	Details
storedQueryId	ID der gespeicherten Abfrage des Knowledge Studio-Projekts	Die ID der gespeicherten Abfrage. Diese kann der Knowledge StudioProjekt-URL entnommen werden, wenn die gespeicherte Abfrage in der Ansicht "Abfrage" ausgewählt ist.
properties	openCypherQuery	Die auszuführende openCypher-Abfrage. Weitere Informationen zu openCypher-Abfragen
	description (optional)	Eine Beschreibung der neuen gespeicherten Abfrage.
	provenanceBehavior (optional)	Gibt an, ob in den Abfrageergebnissen Provenienzergebnisse enthalten sein sollen. Wenn nicht angegeben, ist die Standardeinstellung "Ausschließen". include exclude
	bindParameters (optional)	Ein Array von Objekten für jeden Parameter, der in der Abfrage verwendet werden soll. Parameter sind optional. Wenn Sie jedoch einen Parameter in Ihrer Abfrage verwenden, müssen Sie die Parameterinformationen im URL-Parameter bindParameter angeben. Die URL-Parameter für die Objekte sind in der folgenden Tabelle aufgeführt. Weitere Information zur Verwendung von Parametern in Abfragen

Die URL-Parameter für die Objekte sind in der folgenden Tabelle aufgeführt:


Parameter	Details
title (optional)	Titel des bind-Parameters
parameterName	Der Name des bind-Parameters, der in der openCypher-Abfrage verwendet wird.
parameterType	Der Typ des Werts des bind-Parameters. Dieser Typ muss mit dem Typ der Eigenschaft in der Abfrage übereinstimmen, in der Sie den Parameter verwenden. Die Typen sind nachstehend aufgeführt: esriBindParameterTypeString esriBindParameterTypeNumber esriBindParameterTypeDateTime esriBindParameterTypeDate esriBindParameterTypeTime esriBindParameterTypeTimestampOffset esriBindParameterTypeEntityId esriBindParameterTypeRelationshipId esriBindParameterTypeGeometry
value	Der Wert des bind-Parameters Dieser kann ein Einzelwert des in parameterType angegebenen Typs oder ein Array von Werten dieses Typs sein.

Beispiel für die Struktur des Arrays der bind-Parameter vor der Codierung:

"bindParameters": [
      {
        "parameterName": "facilities",
        "parameterType": "esriBindParameterTypeEntityId",
        "value": ["2344","2342"]
      }
    ]
  };

Feedback zu diesem Thema?