GraphQL Verbindungsdetails

Einführung

Connector-Version

Diese Dokumentation basiert auf Version 21.0.8662 des Connectors.

Erste Schritte

GraphQL Versionsunterstützung

Der Connector nutzt die GraphQL API, um einen bidirektionalen Zugriff auf GraphQL zu ermöglichen.

Herstellen einer Verbindung

Mit GraphQL verbinden

Stellen Sie zum Verbinden Folgendes ein:

• URL: Geben Sie die URL des GraphQL Dienstes an;
• Location: Legen Sie dies auf den Dateipfad fest, der die zuvor definierten benutzerdefinierten Schemas enthält.

Der Treiber unterstützt die folgenden Authentifizierungsarten:

• Basis: Set AuthScheme auf Basic. Sie müssen die angeben User Und Password des GraphQL Dienstes.
• OAuth 1.0 und 2.0: Siehe Verwenden der OAuth-Authentifizierung für detaillierte Anweisungen.
• AwsCognitoSrp
• AwsCognitoBasic

Authentifizieren mit AWS Cognito-Anmeldeinformationen

Wenn Sie den Connector mit einem Benutzer verwenden möchten, der in einem Benutzerpool in AWS Cognito registriert ist, legen Sie zur Authentifizierung die folgenden Eigenschaften fest:

• AuthScheme: Stellen Sie dies auf AwsCognitoSrp ein (empfohlen). Sie können auch AwsCognitoBasic verwenden.
• AWSCognitoRegion: Stellen Sie dies auf die Region des Benutzerpools ein.
• AWSUserPoolId: Setzen Sie dies auf die Benutzerpool-ID.
• AWSUserPoolClientAppId: Setzen Sie dies auf die Client-App-ID des Benutzerpools.
• AWSUserPoolClientAppSecret: Setzen Sie dies auf das Client-Geheimnis des Benutzerpools.
• AWSIdentityPoolId: Setzen Sie dies auf die Identitätspool-ID des Identitätspools, der mit dem Benutzerpool verknüpft ist.
• User: Setzen Sie dies auf den Benutzernamen des im Benutzerpool registrierten Benutzers.
• Password: Setzen Sie dies auf das Passwort des im Benutzerpool registrierten Benutzers.

OAuth-Authentifizierung verwenden

In diesem Abschnitt wird gezeigt, wie Sie den Connector zur Authentifizierung bei jeder Datenquelle verwenden, die OAuth unterstützt.

OAuth erfordert, dass der authentifizierende Benutzer über den Browser mit GraphQL interagiert. Der Connector erleichtert dies auf verschiedene Weise, wie in den folgenden Abschnitten beschrieben.

Bevor Sie die folgenden Schritte ausführen, müssen Sie eine OAuth-App beim Dienst registrieren, um die OAuthClientId Und OAuthClientSecret. Sie sollten auch die AuthScheme zu OAuth.

Benutzerdefinierte Anmeldeinformationen

Benutzerdefinierte Anmeldeinformationen beschreibt die Desktop-Authentifizierung mithilfe der Anmeldeinformationen für Ihre benutzerdefinierte OAuth-App.

Kopflose Maschinen

In den Headless Machines OAuth-Flow: Benutzer müssen sich über einen Browser auf einem anderen Computer authentifizieren. Sie müssen eine benutzerdefinierte OAuth-App erstellen.

Benutzerdefinierte Anmeldeinformationen

Authentifizieren bei GraphQL

Nachdem Sie die folgenden Verbindungseigenschaften festgelegt haben, können Sie eine Verbindung herstellen:

• OAuthVersion: Stellen Sie dies auf die OAuth-Version ein, entweder 1.0 oder 2.0.
• OAuthRequestTokenURL: Erforderlich für OAuth 1.0. In OAuth 1.0 ist dies die URL, unter der die App eine Anforderung für das Anforderungstoken stellt.
• OAuthAuthorizationURL: Erforderlich für OAuth 1.0 und 2.0. Dies ist die URL, unter der sich der Benutzer beim Dienst anmeldet und der Anwendung Berechtigungen erteilt. In OAuth 1.0 wird das Anforderungstoken autorisiert, wenn Berechtigungen erteilt werden.
• OAuthAccessTokenURL: Erforderlich für OAuth 1.0 und 2.0. Dies ist die URL, an die die Anforderung des Zugriffstokens gestellt wird. In OAuth 1.0 wird der autorisierte Anforderungstoken gegen den Zugriffstoken ausgetauscht.
• OAuthRefreshTokenURL: Erforderlich für OAuth 2.0. In OAuth 2.0 ist dies die URL, unter der das Aktualisierungstoken gegen ein neues Zugriffstoken ausgetauscht wird, wenn das alte abläuft. Beachten Sie, dass dies für Ihre Datenquelle mit der Zugriffstoken-URL identisch sein kann.
• OAuthClientId: Legen Sie dies in Ihren App-Einstellungen auf die Client-ID fest. Dies wird auch als Consumer-Schlüssel bezeichnet.
• OAuthClientSecret: Legen Sie dies in Ihren App-Einstellungen auf das Client-Geheimnis fest. Dies wird auch als Consumer-Geheimnis bezeichnet.
• CallbackURL: Setzen Sie dies auf http://localhost:33333 Wenn Sie in Ihren App-Einstellungen eine Umleitungs URL angegeben haben, muss diese übereinstimmen.
• InitiateOAuth: Setzen Sie dies auf GETANDREFRESH. Sie können InitiateOAuth verwenden, um die Wiederholung des OAuth-Austauschs und das manuelle Festlegen des Zugriffstokens in der Verbindungszeichenfolge zu vermeiden.

Wenn Sie eine Verbindung herstellen, öffnet der Connector den OAuth-Endpoint in Ihrem Standardbrowser. Melden Sie sich an und erteilen Sie der Anwendung Berechtigungen. Anschließend schließt der Connector den OAuth-Prozess ab:

1. Extrahiert das Zugriffstoken aus der Rückruf URL und authentifiziert Anfragen.
2. Aktualisiert den Zugriffstoken, wenn er abläuft.
3. Speichert OAuth-Werte in OAuthSettingsLocation soll über mehrere Verbindungen hinweg bestehen bleiben.

Kopflose Maschinen

Verwenden von OAuth auf einer Headless-Maschine

Um GraphQL Datenquellen auf Headless-Servern oder anderen Maschinen zu erstellen, auf denen der Connector keinen Browser öffnen kann, müssen Sie sich von einer anderen Maschine aus authentifizieren. Die Authentifizierung erfolgt in zwei Schritten.

1. Anstatt den Connector auf einem anderen Computer zu installieren, können Sie die folgenden Schritte ausführen, um den OAuthVerifier-Wert. Oder Sie können den Connector auf einem anderen Computer installieren und die OAuth-Authentifizierungswerte übertragen, nachdem Sie sich über den üblichen browserbasierten Ablauf authentifiziert haben.
2. Anschließend können Sie den Connector so konfigurieren, dass das Zugriffstoken vom Headless-Computer automatisch aktualisiert wird.

Sie können dem Headless-OAuth-Authentifizierungsablauf mit den OAuth-Anmeldeinformationen für Ihre benutzerdefinierte OAuth-App folgen.

Verwenden der Anmeldeinformationen für eine benutzerdefinierte OAuth-App

Besorgen Sie sich einen Prüfcode

Legen Sie die folgenden Eigenschaften auf der Headless-Maschine fest:

• InitiateOAuth: Stellen Sie dies auf AUS.
• OAuthClientId: Legen Sie dies in Ihren App-Einstellungen auf die App-ID fest.
• OAuthClientSecret: Legen Sie dies in Ihren App-Einstellungen auf das App-Geheimnis fest.

Sie können dann die folgenden Schritte ausführen, um sich von einem anderen Computer aus zu authentifizieren und das zu erhalten OAuthVerifier Verbindungseigenschaft.

1. Rufen Sie die GetOAuthAuthorizationURL auf gespeicherte Prozedur mit dem CallbackURL-Eingabeparameter, der auf die genaue Umleitungs-URI eingestellt ist, die Sie in Ihren App-Einstellungen angegeben haben.
2. Speichern Sie den Wert des zurückgegebenen AuthToken und AuthKey, wenn OAuthVersion ist auf 1,0 gesetzt. Sie werden im nächsten Schritt verwendet.
3. Öffnen Sie die zurückgegebene URL in einem Browser. Melden Sie sich an und erteilen Sie dem Connector Berechtigungen. Sie werden dann zur Callback-URL weitergeleitet, die den Prüfcode enthält.
4. Speichern Sie den Wert des Prüfcodes. Sie setzen diesen in OAuthVerifier Verbindungseigenschaft.

Legen Sie auf der Headless-Maschine die folgenden Verbindungseigenschaften fest, um die OAuth-Authentifizierungswerte zu erhalten:

• OAuthVersion: Stellen Sie dies auf die OAuth-Version ein, entweder 1.0 oder 2.0.
• OAuthRequestTokenURL: Erforderlich für OAuth 1.0. In OAuth 1.0 ist dies die URL, unter der die App eine Anfrage für das Anforderungstoken stellt.
• OAuthAuthorizationURL: Erforderlich für OAuth 1.0 und 2.0. Dies ist die URL, unter der sich der Benutzer beim Dienst anmeldet und der Anwendung Berechtigungen erteilt. In OAuth 1.0 wird das Anforderungstoken autorisiert, wenn Berechtigungen erteilt werden.
• OAuthAccessTokenURL: Erforderlich für OAuth 1.0 und 2.0. Dies ist die URL, an die die Anforderung des Zugriffstokens gestellt wird. In OAuth 1.0 wird der autorisierte Anforderungstoken gegen den Zugriffstoken ausgetauscht.
• OAuthRefreshTokenURL: Erforderlich für OAuth 2.0. In OAuth 2.0 ist dies die URL, unter der das Aktualisierungstoken gegen ein neues Zugriffstoken ausgetauscht wird, wenn das alte abläuft. Beachten Sie, dass dies für Ihre Datenquelle mit der Zugriffstoken-URL identisch sein kann.
• OAuthClientId: Legen Sie dies in Ihren App-Einstellungen auf die Client-ID fest. Dies wird auch als Consumer-Schlüssel bezeichnet.
• OAuthClientSecret: Legen Sie dies in Ihren App-Einstellungen auf das Client-Geheimnis fest. Dies wird auch als Consumer-Geheimnis bezeichnet.
• CallbackURL: Setzen Sie dies auf http://localhost:33333 Wenn Sie in Ihren App-Einstellungen eine Umleitungs URL angegeben haben, muss diese übereinstimmen.
• InitiateOAuth: Setzen Sie dies auf GETANDREFRESH. Sie können InitiateOAuth verwenden, um die Wiederholung des OAuth-Austauschs und das manuelle Festlegen des Zugriffstokens in der Verbindungszeichenfolge zu vermeiden.

Mit Daten verbinden

Nachdem die OAuth-Einstellungsdatei generiert wurde, legen Sie die folgenden Eigenschaften fest, um eine Verbindung mit Daten herzustellen:

• OAuthSettingsLocation: Legen Sie dies auf die Datei fest, die die verschlüsselten OAuth-Authentifizierungswerte enthält. Stellen Sie sicher, dass diese Datei dem Anbieter Lese- und Schreibberechtigungen erteilt, um die automatische Aktualisierung des Zugriffstokens zu ermöglichen.
• InitiateOAuth: Stellen Sie dies auf REFRESH ein.

OAuth-Einstellungen übertragen

Befolgen Sie die nachstehenden Schritte, um den Connector auf einem anderen Computer zu installieren, zu authentifizieren und dann die resultierenden OAuth-Werte zu übertragen.

Installieren Sie den Connector auf einem zweiten Computer und stellen Sie eine Verbindung mit den folgenden festgelegten Eigenschaften her:

• OAuthSettingsLocation: Legen Sie dies auf eine beschreibbare Textdatei fest.
• InitiateOAuth: Setzen Sie dies auf GETANDREFRESH.
• OAuthClientId: Legen Sie dies in Ihren App-Einstellungen auf die Client-ID fest.
• OAuthClientSecret: Legen Sie dies in Ihren App-Einstellungen auf das Client-Geheimnis fest.
• CallbackURL: Legen Sie dies in Ihren App-Einstellungen auf die Rückruf URL fest.

Testen Sie die Verbindung zur Authentifizierung. Die resultierenden Authentifizierungswerte werden verschlüsselt in den durch angegebenen Pfad geschrieben OAuthSettingsLocation. Nachdem Sie die Verbindung erfolgreich getestet haben, kopieren Sie die OAuth-Einstellungsdatei auf Ihren Headless-Rechner. Legen Sie auf dem Headless-Rechner die folgenden Verbindungseigenschaften fest, um eine Verbindung zu Daten herzustellen:

• InitiateOAuth: Stellen Sie dies auf REFRESH ein.
• OAuthSettingsLocation: Legen Sie hier den Pfad zu Ihrer OAuth-Einstellungsdatei fest. Stellen Sie sicher, dass diese Datei dem Connector Lese- und Schreibberechtigungen erteilt, um die automatische Aktualisierung des Zugriffstokens zu ermöglichen.

Modellieren von GraphQL Daten

In diesem Abschnitt wird gezeigt, wie die verschiedenen Schemas gesteuert werden, die der Connector anbietet, um die Lücke zwischen relationalen SQL- und GraphQL Diensten zu schließen.

Schema-Introspektion

GraphQL Dienste bieten einen Abfrage, mit dem der Connector Ansichts- und Spaltennamen abrufen kann.

Alle SCALAR-Mutationsfelder werden direkt angezeigt und alle Objektfelder werden erweitert.

Mutationen

Der Connector sucht automatisch nach verfügbaren Using Mutations. Da GraphQL keine Methode bereitstellt, um zu bestimmen, welche Mutationen für welche Tabelle verwendet werden können, wird jede Mutation als gespeicherte Prozedur verfügbar gemacht.

LIST-Felder werden als temporäre Tabellen verfügbar gemacht (GraphQL -Tabellen vom Typ TEMPORARY_TABLE). Die erkannten temporären Tabellen können durch Abfragen der Systemtabellen sys_tables und sys_tablecolumns abgerufen werden.

Schemata anpassen

Operationen beschreibt detailliert den Vorgang zum Konfigurieren benutzerdefinierter Schema. Das Einrichten dieser benutzerdefinierten Schema ist ein erforderlicher Schritt zum Herstellen einer Verbindung zu GraphQL Daten.

Systemtabellen

Siehe Systemtabellen, um die aktuellen Tabellenmetadaten Abfrage.

Gespeicherte Prozeduren

Der Connector verwendet gespeicherte Prozeduren, um verschiedene Funktionen auszuführen, wie z. B. das Abrufen und Aktualisieren von OAuth-Tokens.

Automatische Schemaerkennung

Standardmäßig liest der Connector automatisch Metadaten aus GraphQL.

Schema-Introspektion

GraphQL Dienste bieten einen Abfrage, mit dem der Connector Ansichts- und Spaltennamen abrufen kann.

Ein GraphQL Abfrage hat an seiner Wurzel ein Abfrage. Andere Objekte sind im Abfrage verschachtelt, das wiederum seine eigenen verschachtelten Objekte haben kann.

Der Connector liest Objekte vom Typ LIST oder Relay Connection als Ansichten. Wenn ein Feld SCALAR ist, wird es als Spalte gelesen, und wenn ein Feld ein einfaches OBJEKT ist, wird es erweitert.

Legen Sie die Tiefe der Metadaten-Introspektion wie folgt fest:

• ExpandTablesDepth: Wenn Sie den Wert auf 0 setzen, wird nur aus dem Abfrage gelesen. In Szenarien, in denen Listen in anderen Listen verschachtelt sind, setzen Sie den Wert ExpandTablesDepth zur Anzahl der zu scannenden verschachtelten Ebenen.
• ExpandColumnsDepth: Hiermit wird festgelegt, wie viele weitere Schichten (ausgehend von der ExpandTablesDepth), um Objekte zu erweitern und Felder aus ihren verschachtelten untergeordneten Objekten einzuschließen.

Mutationen verwenden

Der Connector sucht automatisch nach verfügbaren Mutationen. Da GraphQL keine Methode bereitstellt, um zu bestimmen, welche Mutationen für welche Tabelle verwendet werden können, wird jede Mutation als gespeicherte Prozedur bereitgestellt.

Alle SCALAR-Mutationsfelder werden direkt angezeigt und alle Objektfelder werden erweitert.

LIST-Felder werden als temporäre Tabellen (GraphQL -Tabellen vom Typ TEMPORARY_TABLE) bereitgestellt. Die ermittelten temporären Tabellen können durch Abfragen der Systemtabellen sys_tables und sys_tablecolumns abgerufen werden. Diese Tabellen enthalten ein RowId- und ParentId-Feld, um die Zeile und die übergeordnete (übergeordnete) Tabelle einer bestimmten untergeordneten Tabelle zu kennzeichnen.

Ein Beispiel für eine Mutation ist productCreate. Rufen Sie Mutationen als gespeicherte Prozedur auf, nachdem Sie zuerst die für die Operation benötigten relevanten untergeordneten Tabellen geladen haben:

INSERT INTO productCreate_metafields(namespace,key,value,type) VALUES('MRproductInfo','ALU','449788022','string')

INSERT INTO productCreate_variants(RowId,price,sku,inventoryManagement,weightUnit,weight,options,metafields,inventoryQuantities) VALUES(1,'39.99','38536314-0acb-4d3f-b8ff-a0f2014d2c75','SHOPIFY','POUNDS',1,'L,XL,XXL','productCreate_variants_metafields','productCreate_variants_inventoryQuantities')

INSERT INTO productCreate_variants_metafields(ParentId,namespace,key,value,type) VALUES('1','MRproductInfo','ALU','449788022-M-','string')

INSERT INTO productCreate_variants_metafields(ParentId,namespace,key,value,type) VALUES('1','MRproductInfo','ItemNumber','400000881201','string')

INSERT INTO productCreate_variants_inventoryQuantities(ParentId,locationId,availableQuantity) VALUES('1','gid://shopify/Location/1448280087',5)

INSERT INTO productCreate_media(originalSource,alt,mediaContentType) VALUES('https://static.nike.com/a/images/t_PDP_1280_v1/f_auto,q_auto:eco/qwqfyddzikcgc4ozwigp/revolution-5-road-running-shoes-szF7CS.png','Magic Shoes','IMAGE')

EXECUTE productCreate title='NIKE  - 449788022', descriptionHtml=' - MEN\'S SHOES  42-MENS L/S TEES',productType='Staging', vendor='NIKE', published='false', options='size,width',metafields='productCreate_metafields', variants='productCreate_variants', media='productCreate_media'

Anpassen von Schemas

Benutzerdefinierte Schemata werden in Konfigurationsdateien definiert. In diesem Kapitel wird die Struktur dieser Dateien beschrieben.
Hinweis: Die Eigenschaft GenerateSchemaFiles ermöglicht es Ihnen, Tabellenmetadaten in statischen Schema zu speichern, die einfach anzupassen sind (um beispielsweise Ihre Änderungen an Spaltendatentypen zu speichern). Setzen Sie diese Eigenschaft auf „OnStart“, um bei der Verbindung Schema für alle Tabellen in Ihrer Datenbank zu generieren. Alternativ können Sie diese Eigenschaft auf „OnUse“ setzen, um Schemas zu generieren, während Sie SELECT-Abfragen an Tabellen ausführen. Es ist auch möglich, mit CreateSchema eine spezifische Schema für eine Tabelle zu erstellen gespeicherte Prozedur.

Bearbeiten von Schemadateien

Tabellen und Ansichten werden durch die Erstellung von Schema in APIScript definiert. APIScript ist eine einfache Konfigurationssprache, mit der Sie die Spalten und das Verhalten der Tabelle definieren können. Es verfügt auch über integrierte Operationen, mit denen Sie GraphQL verarbeiten können. Zusätzlich zu diesen Datenverarbeitungsprimitiven ist APIScript eine voll funktionsfähige Sprache mit Konstrukten für Bedingungen, Schleifen usw. Wie das Schema jedoch zeigt, müssen Sie diese Funktionen für die meisten Tabellendefinitionen nicht verwenden.

Beispielschema

Unten finden Sie ein voll funktionsfähiges Schema, das die Labels-Tabelle modelliert und alle Komponenten enthält, die Sie zum Ausführen von SQL für GraphQL Datenquellen benötigen.

Weitere Informationen zu den einzelnen Komponenten eines Schema finden Sie in Spaltendefinitionen, SELECT-Ausführung.

<rsb:script xmlns:rsb="http://apiscript.com/ns?v1" xmlns:xs="http://www.cdata.com/ns/rsbscript/2" xmlns:other="http://apiscript.com/ns?v1">
<rsb:info title="Labels" desc="Lists information about the different labels you can apply on an issue." other:possiblePaths="{'path':'/repository/labels/edges/node','Name':{'path':'/repository/label'}}" andere:paginationObjects="{'labels':{'cursorName':'nach','pageSizeArgumentName':'erste','paginationType':'Cursor','isConnection':'True','pageInfo':['endCursor','hasNextPage','hasPreviousPage','startCursor']}}">
<attr   name="Id"               xs:type="string"     key="true"   other:relativePath="id"             desc="The ID of the label."                                                                                                                                                                                                                                                                                                                     />
<attr   name="RepositoryName"   xs:type="string"                            other:relativePath="name"           desc="The name of the repository."                                     other:filter="name:="    other:argumenttype="String!"    other:depth="1"                                           references="Repositories.Name"                                                                                />
<attr   name="UserLogin"        xs:type="string"                                                                          desc="The login name of the user."                                     other:filter="owner:="   other:argumenttype="String!"    other:depth="1"                                           references="Users.Login"            other:mirror="true"         other:canBeSliced="true"  />
<attr   name="Color"            xs:type="string"                            other:relativePath="color"          desc="Identifies the label color."                                                                                                                                                                                                                                                                                                              />
<attr   name="CreatedAt"        xs:type="datetime"                          other:relativePath="createdAt"      desc="Identifies the date and time when the label was created."                                                                                                                  other:orderby="CREATED_AT"                                                                                                                           />
<attr   name="Description"      xs:type="string"                            other:relativePath="description"    desc="A brief description of this label."                                                                                                                                                                                                                                                                                                       />
<attr   name="IsDefault"        xs:type="boolean"                           other:relativePath="isDefault"      desc="Indicates whether or not this is a default label."                                                                                                                                                                                                                                                                                        />
<attr   name="Name"             xs:type="string"                            other:relativePath="name"           desc="Identifies the label name."                                      other:filter="name:="    other:argumenttype="String!"                                 other:orderby="NAME"                                                       other:isPathFilter="true"                                       />
<attr   name="ResourcePath"     xs:type="string"                            other:relativePath="resourcePath"   desc="The HTTP path for this label."                                                                                                                                                                                                                                                                                                            />
<attr   name="UpdatedAt"        xs:type="datetime"                          other:relativePath="updatedAt"      desc="Identifies the date and time when the label was last updated."                                                                                                                                                                                                                                                                            />
<attr   name="Url"              xs:type="string"                            other:relativePath="url"            desc="The HTTP URL for this label."                                                                                                                                                                                                                                                                                                             />
</rsb:info>

<rsb:script method="GET">
<rsb:push op="graphqladoSelect" />
</rsb:script>
</rsb:script>

Spaltendefinitionen

Die grundlegenden Attribute einer Spalte sind der Name der Spalte, der Datentyp, ob die Spalte ein Primärschlüssel ist, der relative Pfad und die Tiefe. Der Connector verwendet das Tiefenattribut, um Knoten aus hierarchischen Daten zu extrahieren.

Markieren Sie Spaltenattribute im Block der Schema. Sie können mit der Eigenschaft desc auch eine Beschreibung jedes Attributs angeben.

<rsb:script xmlns:rsb="http://apiscript.com/ns?v1" xmlns:xs="http://www.cdata.com/ns/rsbscript/2" xmlns:other="http://apiscript.com/ns?v1">
<rsb:info title="Labels" desc="Lists information about the different labels you can apply on an issue." other:possiblePaths="{'path':'/repository/labels/edges/node','Name':{'path':'/repository/label'}}" andere:paginationObjects="{'labels':{'cursorName':'nach','pageSizeArgumentName':'erste','paginationType':'Cursor','isConnection':'True','pageInfo':['endCursor','hasNextPage','hasPreviousPage','startCursor']}}">
<attr   name="Id"               xs:type="string"     key="true"   other:relativePath="id"             desc="The ID of the label."                                                                                                                                                                                                                                                                                                                  />
<attr   name="RepositoryName"   xs:type="string"                            other:relativePath="name"           desc="The name of the repository."                                     other:filter="name:="    other:argumenttype="String!"    other:depth="1"                                           references="Repositories.Name"                                                                             />
<attr   name="UserLogin"        xs:type="string"                                                                          desc="The login name of the user."                                     other:filter="owner:="   other:argumenttype="String!"    other:depth="1"                                           references="Users.Login"         other:mirror="true"         other:canBeSliced="true"  />
<attr   name="Color"            xs:type="string"                            other:relativePath="color"          desc="Identifies the label color."                                                                                                                                                                                                                                                                                                           />
<attr   name="CreatedAt"        xs:type="datetime"                          other:relativePath="createdAt"      desc="Identifies the date and time when the label was created."                                                                                                                  other:orderby="CREATED_AT"                                                                                                                        />
<attr   name="Description"      xs:type="string"                            other:relativePath="description"    desc="A brief description of this label."                                                                                                                                                                                                                                                                                                    />
<attr   name="IsDefault"        xs:type="boolean"                           other:relativePath="isDefault"      desc="Indicates whether or not this is a default label."                                                                                                                                                                                                                                                                                     />
<attr   name="Name"             xs:type="string"                            other:relativePath="name"           desc="Identifies the label name."                                      other:filter="name:="    other:argumenttype="String!"                                 other:orderby="NAME"                                                    other:isPathFilter="true"                                       />
<attr   name="ResourcePath"     xs:type="string"                            other:relativePath="resourcePath"   desc="The HTTP path for this label."                                                                                                                                                                                                                                                                                                         />
<attr   name="UpdatedAt"        xs:type="datetime"                          other:relativePath="updatedAt"      desc="Identifies the date and time when the label was last updated."                                                                                                                                                                                                                                                                         />
<attr   name="Url"              xs:type="string"                            other:relativePath="url"            desc="The HTTP URL for this label."                                                                                                                                                                                                                                                                                                          />
</rsb:info>

<rsb:script method="GET">
<rsb:push op="graphqladoSelect" />
</rsb:script>

</rsb:script>

In den folgenden Abschnitten erfahren Sie mehr über die Verwendung von Pfaden zum Extrahieren von Spalten und Zeilen. Informationen zu den Spaltendefinitionen in einem vollständigen Schema finden Sie unter Anpassen von Schemas.

Ordnen Sie die SELECT-Projektion GraphQL Feldern zu.

Steuern Sie den Erstellungsprozess eines GraphQL Feldpfads mit den unten aufgeführten Eigenschaften:

1. Die other:possiblePaths Die-Eigenschaft wird verwendet, um die Basispfade anzugeben, die den Wert der Spalte auswählen.

   Basispfade beginnen mit einem „/“ und enthalten den vollständigen Pfad zum letzten verschachtelten GraphQL Objekt.

     <rsb:info title="Labels" desc="Lists information about the different labels you can apply to an issue." other:possiblePaths="{'path':'/repository/labels/edges/node','Name':{'path':'/repository/label'}}" andere:paginationObjects="{'labels':{'cursorName':'nach','pageSizeArgumentName':'erste','paginationType':'Cursor','isConnection':'True','pageInfo':['endCursor','hasNextPage','hasPreviousPage','startCursor']}}">
   

   Die folgende GraphQL Abfrage basiert auf dem obigen Script:

   { # base path=/repository/labels/edges/node
     repository {
       labels {
         edges {
           node {
             ...
           }
         }
       }
     }
   }
   

2. Die other:relativePath Die Eigenschaft muss für jede Spalte angegeben werden. Diese Eigenschaft wird in Verbindung mit der Eigenschaft other:possiblePaths verwendet, um den GraphQL Feldpfad zu erstellen.

     <attr   name="Name"  xs:type="string"  other:relativePath="name"  desc="Identifies the label name."    />
   

   Basierend auf dem obigen Script erstellt der Connector die folgende GraphQL Abfrage:

   { # base path=/repository/labels/edges/node
     repository { # depth=1
       labels { # depth=2
         edges {
           node {
             name # path=base path + relative path.
           }
         }
       }
     }
   }
   

3. Verwenden Sie die other:depth Eigenschaft zum Angeben eines Elements innerhalb eines bestimmten GraphQL Objekts. Die Indizes sind 1-basiert. Wenn dieses Attribut nicht angegeben ist, entspricht der Standardwert dem letzten verschachtelten GraphQL Objekt.

     <attr   name="RepositoryName"   xs:type="string"  other:relativePath="name"   desc="The name of the repository."  other:depth="1" />
   

   Die folgende GraphQL Abfrage wird aus dem obigen Script erstellt:

   { # base path=/repository/labels/edges/node
     repository { # depth=1
       name # This is mapped to the RepositoryName column
       labels { # depth=2
         edges {
           node {
             ...
           }
         }
       }
     }
   }
   

4. Verwenden Sie die other:fragment Eigenschaft zum Angeben einer Gruppe von Feldern. Diese Eigenschaft kann verwendet werden, wenn der GraphQL Server ein Array von Objekten zurückgibt und der Connector diese Informationen möglicherweise als Aggregat übertragen muss.

     <attr   name="ColumnValues"   xs:type="string"  other:relativePath="column_values"   desc="Column values."  other:fragment="fragment ItemColumnValues on ColumnValue {  ID \r\n value }" />
   

   Basierend auf dem obigen Script erstellt der Connector die folgende GraphQL Abfrage:

   query {
       items {
           column_values {
               ...ItemColumnValues
           }
       }
   }
   fragment ItemColumnValues on ColumnValue {
       id
       value
   }
   

5. Verwenden Sie die other:canbesliced Eigenschaft aktiviert Slicing-Verhalten im Connector

   Zum Beispiel:

   SELECT * FROM Table WHERE Col IN ('1','2','3')
   

   wird

   SELECT * FROM Table WHERE Col=1
   SELECT * FROM Table WHERE Col=2
   SELECT * FROM Table WHERE Col=3
   

6. Verwenden Sie die other:mirror-Eigenschaft, um den in den Kriterien angegebenen Wert widerzuspiegeln. Verwenden Sie diese Eigenschaft für Spalten, die nicht in der Serverantwort angegeben sind.

   Beispiel:

   SELECT * FROM Table WHERE Col=X (If other:mirror=true the connector will artificially set the value of Col to X for every row.)
   

7. Verwenden Sie references um auf die Schlüsselspalte der übergeordneten Tabelle zu verweisen. Beispiel: Wenn es zwei Tabellen „Orders“ und „OrderLineItems“ gibt und „OrderLineItems“ eine Spalte „OrderId“ hat, lautet das Referenzfeld für diese Spalte „Orders.Id“.

*Notes*:

• Pfade und Spaltennamen (wenn sie zur Pfadgenerierung verwendet werden) müssen Groß- und Kleinschreibung beachten.
• Es muss mindestens ein möglicher Pfad angegeben werden.
• Das other:relativePath Die Eigenschaft muss für jede Spalte angegeben werden. Andernfalls kann der Connector die SELECT-Spalte keinem GraphQL Feld zuordnen.

SELECT-Ausführung

Wenn eine SELECT Abfrage ausgegeben wird, führt der Connector die GET-Methode des Schema aus, die die integrierten Operationen des Connectors aufruft, um GraphQL zu verarbeiten. In der GET-Methode haben Sie Kontrolle über die Datenanforderung. Die folgenden Verfahren zeigen mehrere Möglichkeiten, dies zu verwenden: Durchsuchen Sie die Remote-Daten serverseitig mit SELECT WHERE oder implementieren Sie Paging.

Gemeinsame Abfrageverarbeitung

Standardmäßig verarbeitet der Connector die Abfrage clientseitig im Speicher, sodass die URL Die Verbindungseigenschaft ist alles, was Sie festlegen müssen, um eine SELECT-Anweisung auszuführen.

Der Connector kann unterstützte Abfragen auch auf den Server auslagern, während der Rest der Abfrage clientseitig verarbeitet wird. Beispielsweise filtert eine serverseitige Suche die Daten, sodass ein kleinerer Datensatz clientseitig verarbeitet werden kann. Weitere Informationen finden Sie in der Dokumentation zum SupportEnhancedSQL-Eigenschaft für weitere Informationen zur Funktion zur kollaborativen Abfrage. Sie können das resultierende Script erweitern, um Unterstützung für die Verarbeitung von Anfragen auf der Serverseite hinzuzufügen.

Zuordnen von SELECT-Kriterien zu GraphQL -Argumenten

In den folgenden Abschnitten wird gezeigt, wie eine SELECT WHERE-Anweisung in eine GraphQL Abfrage an GraphQL APIs übersetzt wird. Das Verfahren verwendet die folgende Anweisung:

SELECT *
FROM <table>
WHERE ModifiedAt<'2019-10-30 05:05:36.001'

Wenn dieser Filter auf dem Server über Abfrage unterstützt wird, können Sie die Eigenschaft other:filter der Spaltendefinition api:info verwenden, um die gewünschte Zuordnung anzugeben. Für die obige Abfrage verwendet der Connector diese Eigenschaft, um den Filter modifiedAt < '<date>' dem Abfrage zuzuordnen, der Ergebnisse zurückgibt, die vor einem bestimmten Datum geändert wurden, und den Filter modifedAt > '<date>' dem Abfrage, der Ergebnisse filtert, die nach diesem Datum geändert wurden.

• other:filter ist eine durch Semikolon getrennte Liste von <Parametername>:<Operatorliste>. <Parametername> ist der Name des Abfrage und <Operatorliste> ist eine durch Kommas getrennte Liste von Operatoren, die für die Zuordnung verwendet werden. Gültige Operatoren sind <, <=, =, > und >=.
• other:argumentType ist eine erforderliche Zusatzinformation. Sie sollte den Typ des Arguments basierend auf der GraphQL Schema enthalten.

Um diese Zuordnung durchzuführen, würde der Connector die folgende Auszeichnung für die Spaltendefinition modifedAt verwenden:

<attr name="ModifiedAt" xs:type="datetime" other:relativePath="modifiedAt" other:argumentType="DateTime" description="When the vendor was last modified." other:filter="modifiedAtAfter:>;modifiedAtBefore:<" />

Diese Abfrage führt zu den folgenden Postdaten:

{
    "variables": {
        "ModifiedAt_modifiedAtBefore": "2019-10-30T09:05:36.001Z"
    },
    "query": "query($ModifiedAt_modifiedAtBefore:DateTime) {\r\nbusinesses {\r\nedges {\r\nnode {\r\ncustomers(modifiedAtBefore:$ModifiedAt_modifiedAtBefore) {\r\nedges {\r\nnode {\r\nid\r\nmodifiedAt\r\n}\r\n}\r\npageInfo {\r\ntotalPages\r\ncurrentPage\r\n}\r\n}\r\nid\r\n}\r\n}\r\npageInfo {\r\ntotalPages\r\ncurrentPage\r\n}\r\n}\r\n}\r\n"
}

Pfadfilter

Es gibt GraphQL Dienste, bei denen das GraphQL -Argument nicht ausreicht, um den Filter Servereport Suite ID (RSID) zu verarbeiten. Der Pfad sollte geändert werden. Um einen Pfadfilter korrekt zu verwenden, müssen Sie die folgenden Schritte ausführen:

1. Fügen Sie den Pfad zum hinzu other:possiblePaths zusätzliche Informationen und ordnen Sie sie dem Spaltennamen zu, den Sie filtern möchten.

   Beispiel: other:possiblepaths="{'path':'/businesses/edges/node','id':{'path':'/business'}}"

2. Set the Sonstiges:isPathFilter to TRUE in the column defintion.

   <attr name="Id" xs:type="string" key="true" other:relativePath="id" other:isPathFilter="true" other:filter="id:=" />
   

After completing these steps the following SQL query

SELECT Id,Name,CreatedAt FROM Unternehmen WHERE Id='QnVzaW5M6ZTY4ZDA2MmQtYzkzZS00MGZkLTk4YWUtNDg2YzcxMmExNzFl'

will be converted to the postdata:

{
    "Variablen": {
        „Id_id“: „QnVzaW5M6ZTY4ZDA2MmQtYzkzZS00MGZkLTk4YWUtNDg2YzcxMmExNzFl“
    },
    "Abfrage": "Abfrage($Id_id:ID) {\r\nGeschäft(id:$Id_id) {\r\nid\r\nName\r\nErstelltam\r\n}\r\n}\r\n"
}

Seitennummerierung

Der Treiber unterstützt zwei Paginierungsmodi.

• Cursor

  other:paginationObjects = "{
      'labels': {
          'cursorName': 'after',
          'pageSizeArgumentName': 'first',
          'paginationType': 'Cursor',
          'isConnection': 'True',
          'pageInfo': ['endCursor', 'hasNextPage', 'hasPreviousPage', 'startCursor']
      }
  }"
  

  Nach der Verarbeitung der werden die folgenden Postdaten generiert other:paginationObjects Zusätzliche Tabelleninformationen wie oben angegeben:

  {
      "variables": {
          "UserLogin_owner": "testaccount71",
          "RepositoryName_name": "test",
          "first": <Pagesize>
      },
      "query": "query($UserLogin_owner:String!, $RepositoryName_name:String!, $first:Int) {\r\nrepository(owner:$UserLogin_owner, name:$RepositoryName_name) {\r\nlabels(first:$first) {\r\nedges {\r\nnode {\r\nid\r\ncolor\r\ncreatedAt\r\ndescription\r\nisDefault\r\nname\r\nresourcePath\r\nupdatedAt\r\nurl\r\n}\r\n}\r\npageInfo {\r\nendCursor\r\nhasNextPage\r\n}\r\n}\r\nname\r\n}\r\n}\r\n"
  }
  

• Offset

  other:pageInfoObjects="{
      'businesses': {
          'offsetArgumentName': 'page',
          'pageSizeArgumentName': 'pageSize',
          'paginationType': 'Offset',
          'isConnectionObject': 'True',
          'pageInfo': ['currentPage', 'totalPages', 'totalCount']
      }
  }"
  

  Nach der Verarbeitung der werden die folgenden Postdaten generiert other:paginationObjects Zusätzliche Tabelleninformationen wie oben angegeben:

  {
      "variables": {
          "pageSize_1": <Pagesize>
      },
      "query": "query($pageSize_1:Int) {\r\nbusinesses(pageSize:$pageSize_1) {\r\nedges {\r\nnode {\r\nid\r\n}\r\n}\r\npageInfo {\r\ntotalPages\r\ncurrentPage\r\n}\r\n}\r\n}\r\n"
  }
  

Andere SELECT-Anweisungen serverseitig verarbeiten

BESTELLEN BIS

Sie können die Ergebnisse nach der Server-Report-Suite-ID (RSID) sortieren, wenn der GraphQL Dienst dies unterstützt, indem Sie die folgenden Eigenschaften angeben:

• Der other:orderByFormat kann in der Tabellendefinition oder in der Spaltendefinition angegeben werden.

  <rsb:info title="Labels" desc="Lists information about the different labels you can apply on an issue." other:orderByFormat="{field: {orderByArgumentValue}, direction: {sortOrder}}">
  <attr name="ErstelltAm" xs:type="datetime" other:relativePath="erstelltAm" other:orderByFormat="{field: {orderByArgumentValue}, direction: {sortOrder}}" other:orderBy="orderBy:CREATED_AT" />
  

• Das other:orderBy sollte nur in der Spaltendefinition angegeben werden. Das Format dieser Eigenschaft ist <orderByArgumentName>:<orderByArgumentValue>

  <attr name="CreatedAt" xs:type="datetime" other:relativePath="createdAt"  other:orderBy="orderBy:CREATED_AT" />
  

Nach Abschluss dieser Schritte die folgende SQL- Abfrage

SELECT ID FROM Labels ORDER BY CreatedAt ASC

wird in die Postdaten umgewandelt:

{
    "variables": {
        "first": <Pagesize>
    },
    "query": "query($first:Int) {\r\nrepository {\r\nlabels(sort:{field: CREATED_AT, direction: ASC}, first:$first) {\r\nedges {\r\nnode {\r\nid\r\n}\r\n}\r\npageInfo {\r\nendCursor\r\nhasNextPage\r\n}\r\n}\r\n}\r\n}\r\n"
}

Operationen

Der Connector verfügt über leistungsstarke Operationen zur Verarbeitung von GraphQL Datenquellen. Diese Operationen sind plattformneutral: Schemadateien, die diese Operationen aufrufen, können sowohl in .NET als auch in Java verwendet werden. Sie können den Connector auch mit Ihren eigenen Operationen erweitern, die in .NET oder Java geschrieben sind.

Der Connector verfügt über die folgenden Funktionen:

OAuthGetAccessToken

Der OAuthGetAccessToken Operation ist ein APIScript-Operation, der verwendet wird, um die OAuth-Authentifizierung und Aktualisierungsabläufe zu erleichtern.

Der Connector enthält gespeicherte Prozeduren, die diesen Operation aufrufen, um den OAuth-Austausch abzuschließen. Das folgende Schema listet kurz einige der normalerweise erforderlichen Eingaben auf, bevor sie in den folgenden Abschnitten ausführlicher erläutert werden.

Eine Anleitung zur Verwendung des Connectors zur Authentifizierung finden Sie unter Verwenden der OAuth-Authentifizierung Kapitel.

Erstellen einer gespeicherten Prozedur „GetOAuthAccessToken“

Rufen Sie den OAuthGetAccessToken auf mit der gespeicherten Prozedur GetOAuthAccessToken. Die folgenden Eingaben sind für die meisten Datenquellen erforderlich und liefern Standardwerte für die gleichnamigen Verbindungseigenschaften.

<api:script xmlns:api="http://www.rssbus.com/ns/rsbscript/2">

  <api:info title="GetOAuthAccessToken"   description="Obtains the OAuth access token to be used for authentication with various APIs."                                                         >
    <input  name="AuthMode"               desc="The OAuth flow. APP or WEB."                                                                                                                    />
    <input  name="CallbackURL"            desc="The URL to be used as a trusted redirect URL, where the user will return with the token that verifies that they have granted your app access. " />
    <input  name="OAuthAccessToken"       desc="The request token. OAuth 1.0 only."                                                                                                             />
    <input  name="OAuthAccessTokenSecret" desc="The request token secret. OAuth 1.0 only."                                                                                                      />
    <input  name="Verifier"               desc="The verifier code obtained when the user grants permissions to your app."                                                                       />

    <output name="OAuthAccessToken"       desc="The access token."                                                                                                                              />
    <output name="OAuthTokenSecret"       desc="The access token secret."                                                                                                                       />
    <output name="OAuthRefreshToken"      desc="A token that may be used to obtain a new access token."                                                                                         />
 </api:info>

  <!-- Set OAuthVersion to 1.0 or 2.0. -->
  <api:set attr="OAuthVersion"                                                    value="MyOAuthVersion"                 />
  <!-- Set RequestTokenURL to the URL where the request for the request token is made. OAuth 1.0 only.-->
  <api:set attr="OAuthRequestTokenURL"                                            value="http://MyOAuthRequestTokenURL" />
  <!-- Set OAuthAuthorizationURL to the URL where the user logs into the service and grants permissions to the application. -->
  <api:set attr="OAuthAuthorizationURL"                                           value="http://MyOAuthAuthorizationURL" />
  <!-- Set OAuthAccessTokenURL to the URL where the request for the access token is made. -->
  <api:set attr="OAuthAccessTokenURL"                                             value="http://MyOAuthAccessTokenURL"   />
  <!-- Set GrantType to the authorization grant type. OAuth 2.0 only. -->
  <api:set attr="GrantType"                                                       value="CODE"                           />
  <!-- Set SignMethod to the signature method used to calculate the signature of the request. OAuth 1.0 only.-->
  <api:set attr="SignMethod"                                                      value="HMAC-SHA1"                      />
  <api:call op="oauthGetAccessToken">
    <api:push/>
  </api:call>

</api:script>

Schreiben der gespeicherten Prozedur „RefreshOAuthAccessToken“

Sie können auch OAuthGetAccessToken verwenden, um das Zugriffstoken zu aktualisieren, indem Sie die folgenden Eingaben machen:

<api:script xmlns:api="http://www.rssbus.com/ns/rsbscript/2">

  <api:info title="RefreshOAuthAccessToken" description="Refreshes the OAuth access token used for authentication." >
    <input  name="OAuthRefreshToken"        desc="A token that may be used to obtain a new access token."           />

    <output name="OAuthAccessToken"         desc="The authentication token returned."                               />
    <output name="OAuthTokenSecret"         desc="The authentication token secret returned. OAuth 1.0 only."        />
    <output name="OAuthRefreshToken"        desc="A token that may be used to obtain a new access token."           />
    <output name="ExpiresIn"                desc="The remaining lifetime on the access token."                      />

  </api:info>

  <!-- Set OAuthVersion to 1.0 or 2.0. -->
  <api:set attr="OAuthVersion"                                                    value="MyOAuthVersion"                 />
    <!-- Set GrantType to REFRESH. OAuth 2.0 only. -->
    <api:set attr="GrantType"            value="REFRESH" />
    <!-- Set SignMethod to the signature method used to calculate the signature of the request. OAuth 1.0 only.-->
    <api:set attr="SignMethod"           value="HMAC-SHA1" />
    <!-- Set OAuthAccessTokenURL to the URL where the request for the access token is made. -->
    <api:set attr="OAuthAccessTokenURL"  value="http://MyOAuthAccessTokenURL" />
    <!-- Set AuthMode to 'WEB' when calling RefreshOAuthAccessToken -->
    <api:set attr="AuthMode" value="WEB"/>
  <api:call op="oauthGetAccessToken">
    <api:push/>
  </api:call>

</api:script>

Eingabeparameter

• OAuthVersion: Die OAuth-Version.

  Die zulässigen Werte sind 1.0, 2.0. Der Standardwert ist 1.0.

• AuthMode: Der OAuth-Flow. Nur OAuth 2.0. Wenn Sie den App-Modus wählen, wird bei diesem Operation Ihr Browser gestartet und Sie werden aufgefordert, sich mit Ihren Kontoanmeldeinformationen zu authentifizieren. Setzen Sie diesen Parameter auf WEB, um eine Web-App zu authentifizieren oder wenn der Connector keinen Webbrowser öffnen darf. Der Standardwert ist APP.

• OAuthRequestTokenURL: Die URL, unter der der Connector eine Anforderung für das Anforderungstoken stellt. Nur OAuth 1.0. Erforderlich für OAuth 1.0.

• OAuthAuthorizationURL: Die URL, unter der sich der Benutzer beim Dienst anmeldet und der Anwendung Berechtigungen erteilt. In OAuth 1.0 wird das Anforderungstoken autorisiert, wenn Berechtigungen erteilt werden.

• OAuthAccessTokenURL: Die URL, unter der die Anforderung des Zugriffstokens erfolgt. In OAuth 1.0 wird das autorisierte Anforderungstoken gegen das Zugriffstoken ausgetauscht.

• CallbackURL: Die URL, die als vertrauenswürdige Umleitungs URL verwendet werden soll, zu der der Benutzer mit dem Token zurückkehrt, das bestätigt, dass er Ihrer App Zugriff gewährt hat. Dieser Wert muss mit der Rückruf-URL übereinstimmen, die Sie beim Registrieren einer App angeben. Beachten Sie, dass Ihre Datenquelle möglicherweise zusätzlich den Port benötigt.

• OAuthClientId: Die Client-ID, die Sie erhalten, wenn Sie eine App registrieren. Wird auch Consumer Key genannt.

• OAuthClientSecret: Das Client-Geheimnis, das Sie erhalten, wenn Sie eine App registrieren. Wird auch Consumer-Geheimnis genannt.

• OAuthAccessToken: Das Anforderungstoken. Nur OAuth 1.0.

• OAuthAccessTokenSecret: Das Anforderungstoken-Geheimnis. Nur OAuth 1.0.

• OAuthRefreshToken: Ein Token, mit dem ein neues Zugriffstoken abgerufen werden kann.

• GrantType: Autorisierungsgewährungstyp. Nur OAuth 2.0. Die zulässigen Werte sind CODE, PASSWORD, CLIENT, REFRESH. Der Standardwert ist CODE.

• Verifier: Der Prüfcode, der abgerufen wird, wenn der Benutzer dem Connector Berechtigungen erteilt. Beim OAuth 2.0-Code-Erteilungstyp befindet sich der Prüfcode im Code-Abfrage der Rückruf URL. In OAuth 1.0 befindet sich der Prüfer im oauth_verifier-Abfrage der Rückruf URL.

• SignMethod: Die Signaturmethode, die zur Berechnung der Signatur für OAuth 1.0 verwendet wird. Die zulässigen Werte sind HMAC-SHA1, PLAINTEXT. Der Standardwert ist HMAC-SHA1.

• Cert: Pfad für die persönliche PFX-Zertifikatdatei. Nur OAuth 1.0.

• CertPassword: Persönliches Zertifikatspasswort. Nur OAuth 1.0.

• OtherOptions: Weitere Optionen zur Steuerung des Verhaltens von OAuth.

• OAuthParam:\*: Andere Parameter.

• PostData: Die HTTP-POST-Daten.

• Timeout: Das Timeout in Sekunden, bis der Operation abgeschlossen ist. Null (0) bedeutet kein Timeout. Der Standardwert ist 60.

• LogFile: Gibt eine Datei an, in der die Anfrage und die Antwort protokolliert werden.

• Proxy_Auto: Ob der Proxy aus den Windows-Systemeinstellungen erkannt werden soll oder nicht. Dies hat Vorrang vor anderen Proxy-Einstellungen und ist in Java nicht verfügbar. Die zulässigen Werte sind TRUE und FALSE. Der Standardwert ist FALSE.

• Proxy_Server: IP-Adresse oder Host des für die Anfrage verwendeten Proxyservers.

• Proxy_Port: Die Port des Proxyservers.

• Proxy_User: Die Benutzer-ID, die zur Authentifizierung beim Proxy-Server verwendet wird.

• Proxy_Password: Das zur Authentifizierung beim Proxyserver verwendete Passwort.

• Proxy_AuthScheme: Das Authentifizierungsschema des Proxyservers. Die zulässigen Werte sind BASIC, DIGEST, PROPRIETARY, NONE, NTLM. Der Standardwert ist BASIC.

• Proxy_AuthToken: Das Proxy-Authentifizierungstoken.

• Proxy_SSLType: Der SSL-Typ des Proxyservers. Die zulässigen Werte sind AUTO, ALWAYS, NEVER und TUNNEL. Der Standardwert ist AUTO.

• Firewall_Type: Der Typ der Firewall. Die zulässigen Werte sind NONE, TUNNEL, SOCKS4, SOCKS5. Der Standardwert ist NONE.

• Firewall_Server: Die IP-Adresse oder der Host der Firewall.

• Firewall_Port: Die Port der Firewall.

• Firewall_User: Die Benutzer-ID, die zur Authentifizierung bei der Firewall verwendet wird.

• Firewall_Password: Das zur Authentifizierung bei der Firewall verwendete Passwort.

Ausgabeparameter

• OAuthAccessToken: Der Zugriffstoken.
• OAuthTokenSecret: Das Geheimnis des Zugriffstokens.
• OAuthRefreshToken: Ein Token, der zum Erhalt eines neuen Zugriffstokens verwendet werden kann.
• ExpiresIn: Die verbleibende Lebensdauer des Zugriffstokens.
• OAuthParam:\*: Andere vom Server gesendete Parameter.

OAuthGetUserAuthorizationURL

Die OAuthGetUserAuthorizationURL ist ein APIScript Operation, der verwendet wird, um den OAuth-Authentifizierungsfluss für Web-Apps, Offline-Apps und in Situationen zu erleichtern, in denen der Connector keinen Webbrowser öffnen darf. Um die erforderlichen Eingaben an diesen Operation zu übergeben, definieren Sie die gespeicherte Prozedur GetOAuthAuthorizationURL. Der Connector kann diese intern aufrufen.

Definieren Sie gespeicherte Prozeduren in .rsb-Dateien mit demselben Dateinamen wie der Titel des Schemas. Das Schema listet kurz einige der normalerweise erforderlichen Eingaben auf, bevor sie in den folgenden Abschnitten ausführlicher erläutert werden.

Eine Anleitung zur Authentifizierung im OAuth-Flow finden Sie unter Verwenden der OAuth-Authentifizierung Kapitel.

Schreiben der gespeicherten Prozedur „GetOAuthAuthorizationURL“

Rufen Sie OAuthGetUserAuthorizationURL in der gespeicherten Prozedur GetOAuthAuthorizationURL.

<api:script xmlns:api="http://www.rssbus.com/ns/rsbscript/2">

  <api:info title="Get OAuth Authorization URL" description="Obtains the OAuth authorization URL used for authentication with various APIs."                                                          >
    <input  name="CallbackURL"                  desc="The URL to be used as a trusted redirect URL, where the user will return with the token that verifies that they have granted your app access. " />

    <output name="URL"                          desc="The URL where the user logs in and is prompted to grant permissions to the app. "                                                               />
    <output name="OAuthAccessToken"             desc="The request token. OAuth 1.0 only."                                                                                                             />
    <output name="OAuthTokenSecret"             desc="The request token secret. OAuth 1.0 only."                                                                                                      />
  </api:info>

  <!-- Set OAuthVersion to 1.0 or 2.0. -->
  <api:set attr="OAuthVersion"          value="MyOAuthVersion"                 />
  <!-- Set ResponseType to the desired authorization grant type. OAuth 2.0 only.-->
  <api:set attr="ResponseType"           value="code"                           />
  <!-- Set SignMethod to the signature method used to calculate the signature. OAuth 1.0 only.-->
  <api:set attr="SignMethod"            value="HMAC-SHA1"                      />
  <!-- Set OAuthAuthorizationURL to the URL where the user logs into the service and grants permissions to the application. -->
  <api:set attr="OAuthAuthorizationURL"  value="http://MyOAuthAuthorizationURL" />
  <!-- Set OAuthAccessTokenURL to the URL where the request for the access token is made. -->
  <api:set attr="OAuthAccessTokenURL"   value="http://MyOAuthAccessTokenURL"/>
  <!-- Set RequestTokenURL to the URL where the request for the request token is made. OAuth 1.0 only.-->
  <api:set attr="OAuthRequestTokenURL"   value="http://MyOAuthRequestTokenURL"       />
  <api:call op="oauthGetUserAuthorizationUrl">
    <api:push/>
  </api:call>

</api:script>

<p>

Eingabeparameter

• OAuthVersion: Die OAuth-Version.

  Die zulässigen Werte sind 1.0, 2.0. Der Standardwert ist 1.0.

• OAuthAuthorizationURL: Die URL, unter der sich der Benutzer beim Dienst anmeldet und der Anwendung Berechtigungen erteilt. In OAuth 1.0 wird das Anforderungstoken autorisiert, wenn Berechtigungen erteilt werden.

• OAuthRequestTokenURL: Die URL, unter der der Connector eine Anforderung für das Anforderungstoken stellt. Nur OAuth 1.0. Erforderlich für OAuth 1.0.

• CallbackURL: Die URL, die als vertrauenswürdige Umleitungs URL verwendet werden soll, zu der der Benutzer mit dem Token zurückkehrt, das bestätigt, dass er Ihrer App Zugriff gewährt hat. Dieser Wert muss mit der Rückruf-URL übereinstimmen, die Sie beim Registrieren einer App angeben. Beachten Sie, dass Ihre Datenquelle möglicherweise zusätzlich den Port benötigt. Der Standardwert ist http://127.0.0.1/.

• OAuthClientId: Die Client-ID. Wird auch Consumer-Schlüssel genannt.

• OAuthClientSecret: Das Client-Geheimnis. Wird auch Consumer-Geheimnis genannt.

• ResponseType: Der gewünschte Autorisierungstyp. Nur OAuth 2.0. Die zulässigen Werte sind CODE und IMPLICIT. Der Standardwert ist CODE.

• SignMethod: Die Signaturmethode, die zur Berechnung der Signatur für OAuth 1.0 verwendet wird. Die zulässigen Werte sind HMAC-SHA1, RSA-SHA1, PLAINTEXT. Der Standardwert ist HMAC-SHA1.

• Cert: Pfad für die PFX-Datei des persönlichen Zertifikats. Nur OAuth 1.0.

• CertPassword: Persönliches Zertifikatspasswort. Nur OAuth 1.0.

• OtherOptions: Weitere Optionen zur Steuerung des Verhaltens von OAuth.

• OAuthParam:\*: Andere Parameter. Nur OAuth 1.0.

• Timeout: Das Timeout in Sekunden, bis der Operation abgeschlossen ist. Null (0) bedeutet kein Timeout. Der Standardwert ist 60.

• Proxy_Auto: Ob der Proxy aus den Windows-Systemeinstellungen erkannt werden soll oder nicht. Dies hat Vorrang vor anderen Proxy-Einstellungen und ist in Java nicht verfügbar. Die zulässigen Werte sind TRUE und FALSE. Der Standardwert ist FALSE.

• Proxy_Server: IP-Adresse oder Host des für die Anfrage verwendeten Proxyservers.

• Proxy_Port: Die Port des Proxyservers.

• Proxy_User: Die Benutzer-ID, die zur Authentifizierung beim Proxy-Server verwendet wird.

• Proxy_Password: Das zur Authentifizierung beim Proxyserver verwendete Passwort.

• Proxy_AuthScheme: Das Authentifizierungsschema des Proxyservers. Die zulässigen Werte sind BASIC, DIGEST, PROPRIETARY, NONE, NTLM. Der Standardwert ist BASIC.

• Proxy_AuthToken: Das Proxy-Authentifizierungstoken.

• Proxy_SSLType: Der SSL-Typ des Proxyservers. Die zulässigen Werte sind AUTO, ALWAYS, NEVER und TUNNEL. Der Standardwert ist AUTO.

• Firewall_Type: Der Typ der Firewall. Die zulässigen Werte sind NONE, TUNNEL, SOCKS4, SOCKS5. Der Standardwert ist NONE.

• Firewall_Server: Die IP-Adresse oder der Host der Firewall.

• Firewall_Port: Die Port der Firewall.

• Firewall_User: Die Benutzer-ID, die zur Authentifizierung bei der Firewall verwendet wird.

• Firewall_Password: Das zur Authentifizierung bei der Firewall verwendete Passwort.

Ausgabeparameter

• URL: Die URL, unter der sich der Benutzer anmeldet und aufgefordert wird, der App Berechtigungen zu erteilen. In OAuth 1.0 wird das Anforderungstoken autorisiert, wenn Berechtigungen erteilt werden.
• OAuthAccessToken: Das Anforderungstoken. Nur OAuth 1.0.
• OAuthTokenSecret: Das Geheimnis des Anforderungstokens. Nur OAuth 1.0.
• OAuthParam:\*: Andere vom Server gesendete Parameter. Nur OAuth 1.0.

Systemtabellen

Sie können die in diesem Abschnitt beschriebenen Systemtabellen Abfrage, um auf Schema, Informationen zur Datenquellenfunktionalität und Statistiken zu Operation Charge.

Schematabellen

Die folgenden Tabellen geben Datenbankmetadaten für GraphQL zurück:

• sys_catalogs: Listet die verfügbaren Datenbanken auf.
• sys_schemas: Listet die verfügbaren Schemata auf.
• sys_tables: Listet die verfügbaren Tabellen und Ansichten auf.
• sys_tablecolumns: Beschreibt die Spalten der verfügbaren Tabellen und Ansichten.
• sys_procedures: Beschreibt die verfügbaren gespeicherten Prozeduren.
• sys_procedureparameters: Beschreibt Parameter gespeicherter Prozeduren.
• sys_keycolumns: Beschreibt die Primär- und Fremdschlüssel.
• sys_indexes: Beschreibt die verfügbaren Indizes.

Datenquellentabellen

Die folgenden Tabellen enthalten Informationen dazu, wie eine Verbindung zur Datenquelle hergestellt und diese Abfrage wird:

• sys_connection_props: Gibt Informationen zu den verfügbaren Verbindungseigenschaften zurück.
• sys_sqlinfo: Beschreibt die SELECT-Abfragen, die der Connector an die Datenquelle auslagern kann.

Abfrageinformationstabellen

Die folgende Tabelle gibt Abfrage für Datenänderungsabfragen zurück:

• Systemidentität: Gibt Informationen zu Charge oder einzelnen Updates zurück.

Sys_catalogs

Listet die verfügbaren Datenbanken auf.

Die folgende Abfrage ruft alle durch die Verbindungszeichenfolge ermittelten Datenbanken ab:

SELECT * FROM sys_catalogs

Spalten

Sys_schemas

Listet die verfügbaren Schemas auf.

Die folgende Abfrage ruft alle verfügbaren Schemata ab:

SELECT * FROM sys_schemas

Spalten

Sys_tables

Listet die verfügbaren Tabellen auf.

Die folgende Abfrage ruft die verfügbaren Tabellen und Ansichten ab:

SELECT * FROM sys_tables

Spalten

Sys_tablecolumns

Beschreibt die Spalten der verfügbaren Tabellen und Ansichten.

Die folgende Abfrage gibt die Spalten und Datentypen für die Tabelle „Benutzer“ zurück:

SELECT ColumnName, DataTypeName FROM sys_tablecolumns WHERE TableName='Users'

Spalten

Sys_procedures

Listet die verfügbaren gespeicherten Prozeduren auf.

Die folgende Abfrage ruft die verfügbaren gespeicherten Prozeduren ab:

SELECT * FROM sys_procedures

Spalten

Sys_procedureparameters

Beschreibt Parameter gespeicherter Prozeduren.

Die folgende Abfrage gibt Informationen zu allen Eingabeparametern für die gespeicherte Prozedur SelectEntries zurück:

SELECT * FROM sys_procedureparameters WHERE ProcedureName='SelectEntries' AND Direction=1 OR Direction=2

Spalten

Sys_keycolumns

Beschreibt die Primär- und Fremdschlüssel.

Die folgende Abfrage ruft den Primärschlüssel für die Tabelle „Benutzer“ ab:

SELECT * FROM sys_keycolumns WHERE IsKey='True' AND TableName='Users'

Spalten

Sys_foreignkeys

Beschreibt die Fremdschlüssel.

Die folgende Abfrage ruft alle Fremdschlüssel ab, die auf andere Tabellen verweisen:

SELECT * FROM sys_foreignkeys WHERE ForeignKeyType = 'FOREIGNKEY_TYPE_IMPORT'

Spalten

Sys_indexes

Beschreibt die verfügbaren Indizes. Durch das Filtern nach Indizes können Sie selektivere Abfragen mit schnelleren Abfrage schreiben.

Die folgende Abfrage ruft alle Indizes ab, die keine Primärschlüssel sind:

SELECT * FROM sys_indexes WHERE IsPrimary='false'

Spalten

Sys_connection_props

Gibt Informationen zu den verfügbaren Verbindungseigenschaften und den in der Verbindungszeichenfolge festgelegten Eigenschaften zurück.

Bei der Abfrage dieser Tabelle sollte die Konfigurationsverbindungszeichenfolge verwendet werden:

jdbc:cdata:graphql:config:

Mit dieser Verbindungszeichenfolge können Sie diese Tabelle ohne eine gültige Verbindung Abfrage.

Die folgende Abfrage ruft alle Verbindungseigenschaften ab, die in der Verbindungszeichenfolge festgelegt oder über einen Standardwert gesetzt wurden:

SELECT * FROM sys_connection_props WHERE Value <> ''

Spalten

Sys_sqlinfo

Beschreibt die SELECT- Abfrage, die der Connector an die Datenquelle auslagern kann.

Gemeinsame Abfrageverarbeitung

Wenn Sie mit Datenquellen arbeiten, die SQL-92 nicht unterstützen, können Sie die Ansicht sys_sqlinfo Abfrage, um die Abfrage der zugrunde liegenden APIs in SQL-Syntax zu ermitteln. Der Connector verlagert so viel wie möglich von der Verarbeitung der SELECT-Anweisung auf den Server und verarbeitet den Rest der Abfrage dann im Speicher.

Entdecken Sie die SELECT-Funktionen der Datenquelle

Nachfolgend sehen Sie einen Beispieldatensatz mit SQL-Funktionen. Der folgende Ergebnissatz zeigt die SELECT-Funktionalität an, die der Connector auf die Datenquelle oder die Prozessclientseite auslagern kann. Ihre Datenquelle unterstützt möglicherweise zusätzliche SQL-Syntax. Einige Aspekte der SELECT-Funktionalität werden in einer durch Kommas getrennten Liste zurückgegeben, sofern sie unterstützt werden; andernfalls enthält die Spalte NO.

Die folgende Abfrage ruft die Operatoren ab, die in der WHERE-Klausel verwendet werden können:

SELECT * FROM sys_sqlinfo WHERE Name='SUPPORTED_OPERATORS'

Beachten Sie, dass einzelne Tabellen unterschiedliche Einschränkungen oder Anforderungen an die WHERE-Klausel haben können; siehe Datenmodell Abschnitt für weitere Informationen.

Spalten

Systemidentität

Gibt Informationen zu versuchten Änderungen zurück.

Die folgende Abfrage ruft die IDs der geänderten Zeilen in einer Operation Charge:

SELECT * FROM sys_identity

Spalten

Gespeicherte Prozeduren

Gespeicherte Prozeduren stehen zur Ergänzung der im Datenmodell verfügbaren Daten zur Verfügung. Es kann erforderlich sein, die in einer Ansicht verfügbaren Daten mithilfe einer gespeicherten Prozedur zu aktualisieren, da die Daten keine direkten, tabellenartigen, bidirektionalen Aktualisierungen ermöglichen. In diesen Situationen erfolgt der Abruf der Daten mithilfe der entsprechenden Ansicht oder Tabelle, während die Aktualisierung durch Aufruf einer gespeicherten Prozedur erfolgt. Gespeicherte Prozeduren verwenden eine Liste von Parametern und geben einen Datensatz zurück, der die Sammlung von Tupeln enthält, die die Antwort bilden.

Gespeicherte Prozeduren des GraphQL Konnektors

Schema erstellen

Erstellt eine Schema für die angegebene Tabelle oder Ansicht.

Eingang

Ergebnissatzspalten

GetOAuthAccessToken

Erhält den OAuth-Zugriffstoken, der zur Authentifizierung mit Datenquellen unter Verwendung von OAuth verwendet werden soll.

Eingang

Ergebnissatzspalten

GetOAuthAuthorizationURL

Ruft die OAuth-Autorisierungs URL ab, die für die Authentifizierung bei Datenquellen unter Verwendung von OAuth verwendet wird.

Eingang

Ergebnissatzspalten

Aktualisieren Sie das OAuthAccessToken

Tauscht ein Aktualisierungstoken gegen ein neues Zugriffstoken aus.

Eingang

Ergebnissatzspalten

Erweiterte Konfigurationseigenschaften

Die erweiterten Konfigurationseigenschaften sind die verschiedenen Optionen, die zum Herstellen einer Verbindung verwendet werden können. Dieser Abschnitt enthält eine vollständige Liste der Optionen, die Sie konfigurieren können. Klicken Sie auf die Links, um weitere Einzelheiten zu erfahren.

Authentifizierung

AWS-Authentifizierung

OAuth

JWT OAuth

SSL

Schema

Verschiedenes

Authentifizierung

Dieser Abschnitt enthält eine vollständige Liste der Authentifizierungseigenschaften, die Sie konfigurieren können.

AuthScheme

Die Art der Authentifizierung, die bei der Verbindung mit Remote-Diensten verwendet werden soll.

Mögliche Werte

None, Basic, OAuth, AwsCognitoSrp, AwsCognitoBasic

Datentyp

string

Standardwert

None

Hinweise

Allgemein

Die folgenden Optionen sind grundsätzlich für alle Verbindungen verfügbar:

• Keine: Verwendet keine Authentifizierung.
• Einfach: Verwendet die einfache Authentifizierung mit Benutzer und Passwort.
• OAuth: Verwendet entweder OAuth1 oder OAuth2, wobei der spezifische Ablauf durch den OAuthGrantType bestimmt wird. OAuthVersion muss festgelegt werden, um zu bestimmen, welche Version von OAuth verwendet wird.
• AwsCognitoSrp: Festlegen, um Cognito-basierte Authentifizierung zu verwenden. Dies wird gegenüber AwsCognitoBasic empfohlen, da diese Option das Passwort NICHT zur Authentifizierung an den Server sendet, sondern stattdessen das SRP-Protokoll verwendet.
• AwsCognitoBasic: Festlegen, um Cognito-basierte Authentifizierung zu verwenden.

URL

Die URL des GraphQL Dienstes.

Datentyp

string

Standardwert

""

Hinweise

Die URL des GraphQL Dienstes.

Benutzer

Das zur Authentifizierung verwendete GraphQL -Benutzerkonto.

Datentyp

string

Standardwert

""

Hinweise

Zusammen mit Passwort, wird dieses Feld zur Authentifizierung gegenüber dem GraphQL Server verwendet.

Passwort

Das zur Authentifizierung des Benutzers verwendete Passwort.

Datentyp

string

Standardwert

""

Hinweise

Der Benutzer Und Password werden zusammen zur Authentifizierung beim Server verwendet.

AWS-Authentifizierung

Dieser Abschnitt enthält eine vollständige Liste der AWS-Authentifizierungseigenschaften, die Sie konfigurieren können.

AWSCognitoRegion

Die Hostingregion für AWS Cognito.

Mögliche Werte

OHIO, NORTHERNVIRGINIA, NORTHERNCALIFORNIA, OREGON, CAPETOWN, HONGKONG, MUMBAI, OSAKA, SEOUL, SINGAPORE, SYDNEY, TOKYO, CENTRAL, BEIJING, NINGXIA, FRANKFURT, IRELAND, LONDON, MILAN, PARIS, STOCKHOLM, BAHRAIN, SAOPAULO, GOVCLOUDEAST, GOVCLOUDWEST

Datentyp

string

Standardwert

NORTHERNVIRGINIA

Hinweise

Die Hostingregion für AWS Cognito. Verfügbare Werte sind OHIO, NORTHERNVIRGINIA, NORTHERNCALIFORNIA, OREGON, CAPETOWN, HONGKONG, MUMBAI, OSAKA, SEOUL, SINGAPUR, SYDNEY, TOKIO, CENTRAL, PEKING, NINGXIA, FRANKFURT, IRLAND, LONDON, MAILAND, PARIS, STOCKHOLM, BAHRAIN, SAOPAULO, GOVCLOUDEAST und GOVCLOUDWEST.

AWSUserPoolId

Die Benutzerpool-ID.

Datentyp

string

Standardwert

""

Hinweise

Sie finden dies in AWS Cognito -> Benutzerpools verwalten -> wählen Sie Ihren Benutzerpool aus -> Allgemeine Einstellungen -> Pool-ID.

AWSUserPoolClientAppId

Die Client-App-ID des Benutzerpools.

Datentyp

string

Standardwert

""

Hinweise

Sie finden dies in AWS Cognito -> Identitätspools verwalten -> wählen Sie Ihren Benutzerpool aus -> Allgemeine Einstellungen -> App-Clients -> App-Client-ID.

AWSUserPoolClientAppSecret

Optional. Das Benutzerpool-Client-App-Geheimnis.

Datentyp

string

Standardwert

""

Hinweise

Sie finden dies in AWS Cognito -> Identitätspools verwalten -> Benutzerpool auswählen -> Allgemeine Einstellungen -> App-Clients -> App-Client-Geheimnis.

OAuth

Dieser Abschnitt enthält eine vollständige Liste der OAuth-Eigenschaften, die Sie konfigurieren können.

OAuth initiieren

Legen Sie diese Eigenschaft fest, um den Prozess zum Abrufen oder Aktualisieren des OAuth-Zugriffstokens beim Herstellen einer Verbindung zu starten.

Mögliche Werte

OFF, GETANDREFRESH, REFRESH

Datentyp

string

Standardwert

OFF

Hinweise

Folgende Optionen stehen zur Verfügung:

1. OFF: Gibt an, dass der OAuth-Flow vollständig vom Benutzer gehandhabt wird. Zur Authentifizierung ist ein OAuthAccessToken erforderlich.
2. GETANDREFRESH: Gibt an, dass der gesamte OAuth-Flow vom Connector verarbeitet wird. Wenn derzeit kein Token vorhanden ist, wird es durch eine entsprechende Aufforderung an den Benutzer über den Browser abgerufen. Wenn ein Token vorhanden ist, wird es bei Bedarf aktualisiert.
3. REFRESH: Gibt an, dass der Connector nur das Aktualisieren des OAuthAccessToken übernimmt. Der Benutzer wird vom Connector nie aufgefordert, sich über den Browser zu authentifizieren. Der Benutzer muss zunächst das Abrufen des OAuthAccessToken und des OAuthRefreshToken übernehmen.

OAuthVersion

Die verwendete OAuth-Version.

Mögliche Werte

Disabled, 1.0, 2.0

Datentyp

string

Standardwert

Disabled

Hinweise

Die verwendete OAuth-Version. Folgende Optionen sind verfügbar: Deaktiviert, 1.0, 2.0

OAuthClientId

Die Client-ID, die zugewiesen wird, wenn Sie Ihre Anwendung bei einem OAuth-Autorisierungsserver registrieren.

Datentyp

string

Standardwert

""

Hinweise

Im Rahmen der Registrierung einer OAuth-Anwendung erhalten Sie die OAuthClientId-Wert, manchmal auch Consumer-Schlüssel genannt, und ein Client-Geheimnis, das OAuthClientSecret.

OAuthClientSecret

Das Client-Geheimnis, das zugewiesen wird, wenn Sie Ihre Anwendung bei einem OAuth-Autorisierungsserver registrieren.

Datentyp

string

Standardwert

""

Hinweise

Im Rahmen der Registrierung einer OAuth-Anwendung erhalten Sie die OAuthClientId, auch Consumer-Schlüssel genannt. Sie erhalten außerdem ein Client-Geheimnis, auch Consumer-Geheimnis genannt. Legen Sie das Client-Geheimnis im OAuthClientSecret Eigentum.

OAuth-Zugriffstoken

Der Zugriffstoken für die Verbindung per OAuth.

Datentyp

string

Standardwert

""

Hinweise

Der OAuthAccessToken Eigenschaft wird für die Verbindung über OAuth verwendet. Die OAuthAccessToken wird im Rahmen des Authentifizierungsprozesses vom OAuth-Server abgerufen. Es hat ein serverabhängiges Timeout und kann zwischen Anfragen wiederverwendet werden.

Das Zugriffstoken wird anstelle Ihres Benutzernamens und Passworts verwendet. Das Zugriffstoken schützt Ihre Anmeldeinformationen, indem es sie auf dem Server speichert.

OAuthSettingsLocation

Der Speicherort der Einstellungsdatei, in der OAuth-Werte gespeichert werden, wenn InitiateOAuth auf GETANDREFRESH oder REFRESH eingestellt ist. Alternativ können Sie diesen Speicherort im Speicher halten, indem Sie einen Wert angeben, der mit beginnt 'memory://'.

Datentyp

string

Standardwert

%APPDATA%\CData\Acumatica Data Provider\OAuthSettings.txt

Hinweise

Wenn InitiateOAuth ist auf gesetzt GETANDREFRESH oder REFRESH, der Treiber speichert OAuth-Werte, damit der Benutzer die OAuth-Verbindungseigenschaften nicht manuell eingeben muss und die Anmeldeinformationen über Verbindungen oder Prozesse hinweg gemeinsam genutzt werden können.

Anstatt einen Dateipfad anzugeben, können Sie auch den Speicherort angeben. Speicherorte werden durch einen Wert angegeben, der mit 'memory://' gefolgt von einer eindeutigen Kennung für diesen Satz von Anmeldeinformationen (z. B. memory://user1). Die Kennung können Sie frei wählen, sie sollte jedoch für den Benutzer eindeutig sein. Im Gegensatz zur dateibasierten Speicherung, bei der die Anmeldeinformationen über Verbindungen hinweg bestehen bleiben, werden die Anmeldeinformationen bei der Speicherspeicherung in den statischen Speicher geladen und die Anmeldeinformationen werden für die Dauer des Prozesses unter Verwendung derselben Kennung zwischen Verbindungen geteilt. Um die Anmeldeinformationen außerhalb des aktuellen Prozesses beizubehalten, müssen Sie die Anmeldeinformationen vor dem Schließen der Verbindung manuell speichern. Auf diese Weise können Sie sie in der Verbindung festlegen, wenn der Prozess erneut gestartet wird. Sie können OAuth-Eigenschaftswerte mit einer Abfrage an abrufen sys_connection_propsSystemtabelle. Wenn mehrere Verbindungen mit denselben Anmeldeinformationen bestehen, werden die Eigenschaften aus der zuvor geschlossenen Verbindung gelesen.

Der Standardspeicherort ist „%APPDATA%\CData\ Acumatica Data Provider\OAuthSettings.txt“ mit %APPDATA% auf das Konfigurationsverzeichnis des Benutzers gesetzt. Die Standardwerte sind

• Windows: "register://%DSN"
• Unix: "%AppData%..."

wobei DSN der Name des aktuellen DSN ist, der in der offenen Verbindung verwendet wird.

Die folgende Tabelle listet den Wert von auf %APPDATA% nach Operationssystem:

OAuthAccessTokenSecret

Das OAuth-Zugriffstoken-Geheimnis für die Verbindung über OAuth.

Datentyp

string

Standardwert

""

Hinweise

Der OAuthAccessTokenSecret Eigenschaft wird für die Verbindung und Authentifizierung mit OAuth verwendet. Die OAuthAccessTokenSecret wird im Rahmen des Authentifizierungsprozesses vom OAuth-Server abgerufen. Es wird mit dem OAuthAccessToken verwendet und kann für mehrere Anfragen verwendet werden, bis die Zeit abläuft.

Rückruf-URL

Die OAuth-Rückruf URL, zu der bei der Authentifizierung zurückgekehrt werden soll. Dieser Wert muss mit der Rückruf-URL übereinstimmen, die Sie in Ihren App-Einstellungen angeben.

Datentyp

string

Standardwert

""

Hinweise

Während des Authentifizierungsprozesses leitet der OAuth-Autorisierungsserver den Benutzer an diese URL weiter. Dieser Wert muss mit der Rückruf URL übereinstimmen, die Sie in Ihren App-Einstellungen angeben.

OAuthGrantType

Der Berechtigungstyp für den OAuth-Flow.

Mögliche Werte

CODE, CLIENT, PASSWORD

Datentyp

string

Standardwert

CLIENT

Hinweise

Der Berechtigungstyp für den OAuth-Flow. Folgende Optionen sind verfügbar: CODE,CLIENT,PASSWORT

OAuthIncludeCallbackURL

Ob die Rückruf-URL in eine Zugriffstokenanforderung aufgenommen werden soll.

Datentyp

bool

Standardwert

true

Hinweise

Dies ist standardmäßig auf „true“ eingestellt, da standardkonforme OAuth-Dienste den Parameter „redirect_uri“ für Berechtigungstypen wie CLIENT oder PASSWORD ignorieren, die ihn nicht erfordern.

Diese Option sollte nur für OAuth-Dienste aktiviert werden, die Fehler melden, wenn „redirect_uri“ enthalten ist.

OAuthAuthorizationURL

Die Autorisierungs URL für den OAuth-Dienst.

Datentyp

string

Standardwert

""

Hinweise

Die Autorisierungs-URL für den OAuth-Dienst. Unter dieser URL meldet sich der Benutzer beim Server an und erteilt der Anwendung Berechtigungen. In OAuth 1.0 wird das Anforderungstoken autorisiert, wenn Berechtigungen erteilt werden.

OAuth-ZugriffstokenURL

Die URL, von der das OAuth-Zugriffstoken abgerufen werden soll.

Datentyp

string

Standardwert

""

Hinweise

Die URL, von der das OAuth-Zugriffstoken abgerufen werden soll. In OAuth 1.0 wird das autorisierte Anforderungstoken unter dieser URL gegen das Zugriffstoken ausgetauscht.

OAuthRefreshTokenURL

Die URL, von der das OAuth-Token aktualisiert werden soll.

Datentyp

string

Standardwert

""

Hinweise

Die URL, von der aus das OAuth-Token aktualisiert werden soll. In OAuth 2.0 wird unter dieser URL das Aktualisierungstoken gegen ein neues Zugriffstoken ausgetauscht, wenn das alte Zugriffstoken abläuft.

OAuthRequestTokenURL

Die vom Dienst bereitgestellte URL zum Abrufen von Anforderungstoken. Dies ist in OAuth 1.0 erforderlich.

Datentyp

string

Standardwert

""

Hinweise

Die vom Dienst bereitgestellte URL zum Abrufen von Anforderungstoken. Dies ist in OAuth 1.0 erforderlich. In OAuth 1.0 ist dies die URL, unter der die App eine Anforderung für das Anforderungstoken stellt.

OAuthVerifier

Der von der OAuth-Autorisierungs URL zurückgegebene Prüfcode.

Datentyp

string

Standardwert

""

Hinweise

Der von der OAuth-Autorisierungs URL zurückgegebene Prüfcode. Dieser kann auf Systemen verwendet werden, auf denen kein Browser gestartet werden kann, z. B. auf Headless-Systemen.

Authentifizierung auf Headless-Maschinen

Siehe, um die zu erhalten OAuthVerifier Wert.

OAuthSettingsLocation festlegen zusammen mit OAuthVerifier. Beim Verbinden tauscht der Connector die OAuthVerifier für die OAuth-Authentifizierungstoken und speichert sie verschlüsselt in der angegebenen Datei. Setzen Sie InitiateOAuth, um den Austausch mit GETANDREFRESH zu automatisieren.

Sobald die OAuth-Einstellungsdatei generiert wurde, können Sie entfernen OAuthVerifier aus den Verbindungseigenschaften und verbinden Sie sich mit OAuthSettingsLocation festgelegt.

Um die OAuth-Tokenwerte automatisch zu aktualisieren, legen Sie OAuthSettingsLocation fest und setzen Sie zusätzlich InitiateOAuth zum AKTUALISIEREN.

AuthToken

Das Authentifizierungstoken, das zum Anfordern und Abrufen des OAuth-Zugriffstokens verwendet wird.

Datentyp

string

Standardwert

""

Hinweise

Diese Eigenschaft ist nur erforderlich, wenn eine Headless-Authentifizierung in OAuth 1.0 durchgeführt wird. Sie kann aus der gespeicherten Prozedur GetOAuthAuthorizationUrl abgerufen werden.

Sie kann zusammen mit dem AuthKey bereitgestellt werden in der gespeicherten Prozedur GetOAuthAccessToken, um den OAuthAccessToken abzurufen.

Authentisierungsschlüssel

Das Authentifizierungsgeheimnis, das zum Anfordern und Abrufen des OAuth-Zugriffstokens verwendet wird.

Datentyp

string

Standardwert

""

Hinweise

Diese Eigenschaft ist nur erforderlich, wenn eine Headless-Authentifizierung in OAuth 1.0 durchgeführt wird. Sie kann aus der gespeicherten Prozedur GetOAuthAuthorizationUrl abgerufen werden.

Sie kann zusammen mit dem AuthToken bereitgestellt werden in der gespeicherten Prozedur GetOAuthAccessToken, um den OAuthAccessToken abzurufen.

OAuthParams

Eine durch Kommas getrennte Liste weiterer Parameter, die in der Anfrage für das OAuth-Zugriffstoken im Format Parametername=Wert übermittelt werden sollen.

Datentyp

string

Standardwert

""

Hinweise

Eine durch Kommas getrennte Liste weiterer Parameter, die in der Anfrage für das OAuth-Zugriffstoken im Format Parametername=Wert übermittelt werden sollen.

OAuthRefreshToken

Das OAuth-Aktualisierungstoken für das entsprechende OAuth-Zugriffstoken.

Datentyp

string

Standardwert

""

Hinweise

Der OAuthRefreshToken Eigenschaft wird verwendet, um den OAuthAccessToken zu aktualisieren bei Verwendung der OAuth-Authentifizierung.

OAuthLäuftAbIn

Die Lebensdauer des OAuth AccessToken in Sekunden.

Datentyp

string

Standardwert

""

Hinweise

Mit OAuthTokenTimestamp kombinieren, um zu bestimmen, wann der AccessToken abläuft.

OAuthTokenTimestamp

Der Unix-Epochenzeitstempel in Millisekunden, als das aktuelle Zugriffstoken erstellt wurde.

Datentyp

string

Standardwert

""

Hinweise

Kombinieren Sie es mit OAuthExpiresIn, um zu bestimmen, wann das AccessToken abläuft.

JWT OAuth

Dieser Abschnitt enthält eine vollständige Liste der JWT OAuth-Eigenschaften, die Sie konfigurieren können.

OAuthJWTCert

Der JWT-Zertifikatspeicher.

Datentyp

string

Standardwert

""

Hinweise

Der Name des Zertifikatspeichers für das Client-Zertifikat.

Der OAuthJWTCertType Feld gibt den Typ des durch angegebenen Zertifikatspeichers an OAuthJWTCert. Wenn der Store kennwortgeschützt ist, geben Sie das Kennwort in OAuthJWTCertPassword an.

OAuthJWTCert wird in Verbindung mit OAuthJWTCertSubject verwendet

Feld, um Client-Zertifikate anzugeben. Wenn OAuthJWTCert hat einen Wert und OAuthJWTCertSubject gesetzt ist, wird eine Suche nach einem Zertifikat eingeleitet. Bitte beachten Sie das OAuthJWTCertSubject für weitere Einzelheiten.

Die Bezeichnungen der Zertifikatsspeicher sind plattformabhängig.

Nachfolgend sind die Bezeichnungen der gebräuchlichsten Benutzer- und Maschinen-Zertifikatspeicher in Windows aufgeführt:

In Java ist der Zertifikatsspeicher normalerweise eine Datei, die Zertifikate und optionale private Schlüssel enthält.

Wenn der Zertifikatsspeichertyp PFXFile ist, muss diese Eigenschaft auf den Namen der Datei gesetzt werden. Wenn der Typ PFXBlob ist, muss die Eigenschaft auf den binären Inhalt einer PFX-Datei (d. h. PKCS12-Zertifikatsspeicher) gesetzt werden.

OAuthJWTCertType

Der Typ des Schlüsselspeichers, der das JWT-Zertifikat enthält.

Mögliche Werte

USER, MACHINE, PFXFILE, PFXBLOB, JKSFILE, JKSBLOB, PEMKEY_FILE, PEMKEY_BLOB, PUBLIC_KEY_FILE, PUBLIC_KEY_BLOB, SSHPUBLIC_KEY_FILE, SSHPUBLIC_KEY_BLOB, P7BFILE, PPKFILE, XMLFILE, XMLBLOB

Datentyp

string

Standardwert

USER

Hinweise

Diese Eigenschaft kann einen der folgenden Werte annehmen:

OAuthJWTCertPasswort

Das Passwort für das OAuth JWT-Zertifikat.

Datentyp

string

Standardwert

""

Hinweise

Wenn der Zertifikatspeicher von einem Typ ist, der ein Passwort erfordert, wird diese Eigenschaft verwendet, um dieses Passwort anzugeben, damit der Zertifikatspeicher geöffnet werden kann.

OAuthJWTCertSubject

Der Betreff des OAuth JWT-Zertifikats.

Datentyp

string

Standardwert

*

Hinweise

Beim Laden eines Zertifikats wird der Betreff verwendet, um das Zertifikat im Speicher zu lokalisieren.

Wenn keine genaue Übereinstimmung gefunden wird, wird der Speicher nach Betreffs durchsucht, die den Wert der Eigenschaft enthalten.

Wenn immer noch keine Übereinstimmung gefunden wird, wird die Eigenschaft auf eine leere Zeichenfolge gesetzt und kein Zertifikat ausgewählt.

Der spezielle Wert „*“ wählt das erste Zertifikat im Zertifikatspeicher aus.

Der Betreff des Zertifikats ist eine durch Kommas getrennte Liste von Distinguished Name-Feldern und-Werten. Zum Beispiel „CN=www.server.com, OU=test, C=US, E=example@jbexample.com“. Allgemeine Felder und ihre Bedeutungen werden unten angezeigt.

Wenn ein Feldwert ein Komma enthält, muss es in Anführungszeichen gesetzt werden.

OAuthJWTIssuisse

Der Herausgeber des Java Web Token.

Datentyp

string

Standardwert

""

Hinweise

Der Aussteller des Java Web Token. Dies ist normalerweise entweder die Client-ID oder die Email Adresse der OAuth-Anwendung.

OAuthJWT-Betreff

Das Benutzersubjekt, für das die Anwendung delegierten Zugriff anfordert.

Datentyp

string

Standardwert

""

Hinweise

Der Benutzer, für den die Anwendung delegierten Zugriff anfordert. Normalerweise der Benutzerkontoname oder die Email-Adresse.

SSL

Dieser Abschnitt enthält eine vollständige Liste der SSL-Eigenschaften, die Sie konfigurieren können.

SSLClientCert

Der TLS/SSL-Client-Zertifikatspeicher für die SSL-Client-Authentifizierung (bidirektionales SSL).

Datentyp

string

Standardwert

""

Hinweise

Der Name des Zertifikatspeichers für das Client-Zertifikat.

Der SSLClientCertType Feld gibt den Typ des durch angegebenen Zertifikatspeichers an SSLClientCert. Wenn der Store kennwortgeschützt ist, geben Sie das Kennwort in SSLClientCertPassword an.

SSLClientCert wird in Verbindung mit SSLClientCertSubject verwendet, um Client-Zertifikate anzugeben. Wenn SSLClientCert hat einen Wert und SSLClientCertSubject gesetzt ist, wird eine Suche nach einem Zertifikat eingeleitet. Siehe SSLClientCertSubject für weitere Informationen.

Die Bezeichnungen der Zertifikatsspeicher sind plattformabhängig.

Nachfolgend sind die Bezeichnungen der gebräuchlichsten Benutzer- und Maschinen-Zertifikatspeicher in Windows aufgeführt:

In Java ist der Zertifikatsspeicher normalerweise eine Datei, die Zertifikate und optionale private Schlüssel enthält.

Wenn der Zertifikatsspeichertyp PFXFile ist, muss diese Eigenschaft auf den Namen der Datei gesetzt werden. Wenn der Typ PFXBlob ist, muss die Eigenschaft auf den binären Inhalt einer PFX-Datei gesetzt werden (z. B. PKCS12-Zertifikatsspeicher).

SSLClientCertType

Der Typ des Schlüsselspeichers, der das TLS/SSL-Clientzertifikat enthält.

Mögliche Werte

USER, MACHINE, PFXFILE, PFXBLOB, JKSFILE, JKSBLOB, PEMKEY_FILE, PEMKEY_BLOB, PUBLIC_KEY_FILE, PUBLIC_KEY_BLOB, SSHPUBLIC_KEY_FILE, SSHPUBLIC_KEY_BLOB, P7BFILE, PPKFILE, XMLFILE, XMLBLOB

Datentyp

string

Standardwert

USER

Hinweise

Diese Eigenschaft kann einen der folgenden Werte annehmen:

SSLClientCertPassword

Das Passwort für das TLS/SSL-Client-Zertifikat.

Datentyp

string

Standardwert

""

Hinweise

Wenn der Zertifikatspeicher von einem Typ ist, der ein Passwort erfordert, wird diese Eigenschaft verwendet, um dieses Passwort zum Öffnen des Zertifikatspeichers anzugeben.

SSLClientCertSubject

Der Betreff des TLS/SSL-Client-Zertifikats.

Datentyp

string

Standardwert

*

Hinweise

Beim Laden eines Zertifikats wird der Betreff verwendet, um das Zertifikat im Speicher zu lokalisieren.

Wenn keine genaue Übereinstimmung gefunden wird, wird der Speicher nach Betreffs durchsucht, die den Wert der Eigenschaft enthalten. Wenn immer noch keine Übereinstimmung gefunden wird, wird die Eigenschaft auf eine leere Zeichenfolge gesetzt und kein Zertifikat ausgewählt.

Der spezielle Wert „*“ wählt das erste Zertifikat im Zertifikatspeicher aus.

Der Betreff des Zertifikats ist eine durch Kommas getrennte Liste von Distinguished Name-Feldern und-Werten. Beispiel: „CN=www.server.com, OU=test, C=US, E=support@company.com“. Die allgemeinen Felder und ihre Bedeutungen werden unten angezeigt.

Wenn ein Feldwert ein Komma enthält, muss es in Anführungszeichen gesetzt werden.

SSLServerCert

Das vom Server zu akzeptierende Zertifikat bei einer Verbindung per TLS/SSL.

Datentyp

string

Standardwert

""

Hinweise

Bei Verwendung einer TLS/SSL-Verbindung kann diese Eigenschaft verwendet werden, um das vom Server zu akzeptierende TLS/SSL-Zertifikat anzugeben. Jedes andere Zertifikat, dem der Computer nicht vertraut, wird abgelehnt.

Diese Eigenschaft kann folgende Formen annehmen:

Wenn nicht angegeben, wird jedes vom Computer vertrauenswürdige Zertifikat akzeptiert.

Zertifikate werden vom Computer basierend auf dem Trust Store des Systems als vertrauenswürdig validiert. Der verwendete Trust Store ist der für das System angegebene Wert „javax.net.ssl.trustStore“. Wenn für diese Eigenschaft kein Wert angegeben ist, wird der Standard-Trust Store von Java verwendet (z. B. JAVA_HOME\lib\security\cacerts).

Verwenden Sie „*“, um anzugeben, dass alle Zertifikate akzeptiert werden. Beachten Sie, dass dies aus Sicherheitsgründen nicht empfohlen wird.

Schema

Dieser Abschnitt enthält eine vollständige Liste der Schema, die Sie konfigurieren können.

Standort

Ein Pfad zum Verzeichnis, das die Schema enthält, die Tabellen, Ansichten und gespeicherte Prozeduren definieren.

Datentyp

string

Standardwert

%APPDATA%\GraphQL Data Provider\Schema

Hinweise

Der Pfad zu einem Verzeichnis, das die Schema für den Connector enthält (.rsd-Dateien für Tabellen und Ansichten, .rsb-Dateien für gespeicherte Prozeduren). Der Ordnerspeicherort kann ein relativer Pfad vom Speicherort der ausführbaren Datei sein. Der Location Die Eigenschaft wird nur benötigt, wenn Sie Definitionen anpassen (z. B. einen Spaltennamen ändern, eine Spalte ignorieren usw.) oder das Datenmodell mit neuen Tabellen, Ansichten oder gespeicherten Prozeduren erweitern möchten.

Wenn nichts angegeben wird, ist der Standardspeicherort „%APPDATA%\ GraphQL Data Provider\Schema“ mit %APPDATA% wird auf das Konfigurationsverzeichnis des Benutzers eingestellt:

DurchsuchbareSchemas

Diese Eigenschaft beschränkt die gemeldeten Schemata auf eine Teilmenge der verfügbaren Schemata. Beispiel: BrowsableSchemas=SchemaA,SchemaB,SchemaC.

Datentyp

string

Standardwert

""

Hinweise

Das Auflisten der Schemata aus Datenbanken kann aufwändig sein. Die Bereitstellung einer Liste von Schemata in der Verbindungszeichenfolge verbessert die Leistung.

Tabellen

Diese Eigenschaft beschränkt die gemeldeten Tabellen auf eine Teilmenge der verfügbaren Tabellen. Beispiel: Tabellen=TabelleA,TabelleB,TabelleC.

Datentyp

string

Standardwert

""

Hinweise

Das Auflisten der Tabellen aus einigen Datenbanken kann teuer sein. Die Bereitstellung einer Liste von Tabellen in der Verbindungszeichenfolge verbessert die Leistung des Connectors.

Diese Eigenschaft kann auch als Alternative zum automatischen Auflisten von Ansichten verwendet werden, wenn Sie bereits wissen, mit welchen Sie arbeiten möchten, und es sonst zu viele wären.

Geben Sie die gewünschten Tabellen in einer durch Kommas getrennten Liste an. Jede Tabelle sollte ein gültiger SQL-Bezeichner sein, wobei alle Sonderzeichen mit eckigen Klammern, Anführungszeichen oder Backticks maskiert werden. Beispiel: Tables=TableA,[TableB/WithSlash],WithCatalog.WithSchema.`TableC With Space`.

Beachten Sie, dass Sie beim Herstellen einer Verbindung zu einer Datenquelle mit mehreren Schemata oder Katalogen den vollqualifizierten Namen der Tabelle in dieser Eigenschaft angeben müssen, wie im letzten Beispiel hier, um Mehrdeutigkeiten zwischen Tabellen zu vermeiden, die in mehreren Katalogen oder Schemata vorhanden sind.

Ansichten

Beschränkt die gemeldeten Ansichten auf eine Teilmenge der verfügbaren Tabellen. Beispiel: Ansichten=AnsichtA,AnsichtB,AnsichtC.

Datentyp

string

Standardwert

""

Hinweise

Das Auflisten der Ansichten aus einigen Datenbanken kann teuer sein. Die Bereitstellung einer Liste von Ansichten in der Verbindungszeichenfolge verbessert die Leistung des Connectors.

Diese Eigenschaft kann auch als Alternative zum automatischen Auflisten von Ansichten verwendet werden, wenn Sie bereits wissen, mit welchen Sie arbeiten möchten, und es sonst zu viele wären.

Geben Sie die gewünschten Ansichten in einer durch Kommas getrennten Liste an. Jede Ansicht sollte ein gültiger SQL-Bezeichner sein, wobei alle Sonderzeichen mit eckigen Klammern, Anführungszeichen oder Backticks maskiert werden. Beispiel: Views=ViewA,[ViewB/WithSlash],WithCatalog.WithSchema.`ViewC With Space`.

Beachten Sie, dass Sie beim Herstellen einer Verbindung zu einer Datenquelle mit mehreren Schemata oder Katalogen den vollqualifizierten Namen der Tabelle in dieser Eigenschaft angeben müssen, wie im letzten Beispiel hier, um Mehrdeutigkeiten zwischen Tabellen zu vermeiden, die in mehreren Katalogen oder Schemata vorhanden sind.

ErweiternTabellenTiefe

Mit dieser Eigenschaft wird die Tiefe der untergeordneten Tabellen bestimmt.

Datentyp

int

Standardwert

2

Hinweise

Mit dieser Eigenschaft wird die Tiefe der untergeordneten Tabellen bestimmt.

ExpandTemporaryTablesDepth

Diese Eigenschaft wird verwendet, um die Tiefe der untergeordneten temporären Tabellen zu bestimmen. Funktioniert nur, wenn ExposeDynamicProcedures auf true gesetzt ist.

Datentyp

int

Standardwert

5

Hinweise

Diese Eigenschaft wird verwendet, um die Tiefe der untergeordneten temporären Tabellen zu bestimmen. Funktioniert nur, wenn ExposeDynamicProcedures ist auf true gesetzt.

Spaltentiefe erweitern

Mit dieser Eigenschaft wird bestimmt, wie weit der Anbieter innerhalb der GraphQL Objekte nach Spalten suchen soll.

Datentyp

int

Standardwert

2

Hinweise

Mit dieser Eigenschaft wird bestimmt, wie weit der Connector innerhalb der GraphQL Objekte nach Spalten suchen soll.

IncludeDeprecatedMetadata

Mit dieser Eigenschaft wird bestimmt, ob der Anbieter veraltete Tabellen und Spalten verfügbar machen soll oder nicht.

Datentyp

bool

Standardwert

false

Hinweise

Mit dieser Eigenschaft wird bestimmt, ob der Connector veraltete Tabellen und Spalten anzeigen soll oder nicht.

Dynamische Prozeduren offenlegen

Mit dieser Eigenschaft wird bestimmt, ob der Anbieter Mutationen als dynamische Prozeduren verfügbar machen soll oder nicht.

Datentyp

bool

Standardwert

true

Hinweise

Mit dieser Eigenschaft wird bestimmt, ob der Connector Mutationen als dynamische Prozeduren verfügbar machen soll oder nicht.

Verschiedenes

Dieser Abschnitt enthält eine vollständige Liste verschiedener Eigenschaften, die Sie konfigurieren können.

BenutzerdefinierteHeader

Andere Header nach Wahl des Benutzers (optional).

Datentyp

string

Standardwert

""

Hinweise

Diese Eigenschaft kann auf eine Zeichenfolge mit Headern festgelegt werden, die an die aus anderen Eigenschaften (wie „ContentType“, „From“ usw.) erstellten HTTP-Anforderungsheader angehängt werden.

Die Header müssen das Format „Header:Wert“ aufweisen, wie in den HTTP-Spezifikationen beschrieben. Headerzeilen sollten durch die Zeichen für Wagenrücklauf und Zeilenvorschub (CRLF) getrennt sein.

Verwenden Sie diese Eigenschaft mit Vorsicht. Wenn diese Eigenschaft ungültige Header enthält, können HTTP-Anforderungen fehlschlagen.

Diese Eigenschaft ist nützlich, um die Funktionalität des Connectors für die Integration mit spezialisierten oder nicht standardmäßigen APIs zu optimieren.

Schemadateien generieren

Gibt die Benutzerpräferenz an, wann Schemata generiert und gespeichert werden sollen.

Mögliche Werte

Never, OnUse, OnStart, OnCreate

Datentyp

string

Standardwert

Never

Hinweise

Diese Eigenschaft gibt Schemata in .rsd-Dateien im durch Location angegebenen Pfad aus.

Die folgenden Einstellungen sind verfügbar:

• Niemals: Es wird nie eine Schema generiert.
• OnUse: Beim ersten Verweis auf eine Tabelle wird eine Schema generiert, sofern die Schema für die Tabelle noch nicht vorhanden ist.
• OnStart: Zum Zeitpunkt der Verbindung wird für alle Tabellen, die aktuell keine Schema haben, eine Schema generiert.
• OnCreate: Beim Ausführen einer CREATE TABLE-SQL- Abfrage wird eine Schema generiert.

Beachten Sie, dass Sie eine Datei zuerst löschen müssen, wenn Sie sie neu generieren möchten.

Generieren von Schemas mit SQL

Wenn Sie setzen GenerateSchemaFiles Zu OnUse, der Connector generiert Schemata, während Sie SELECT-Abfragen ausführen. Schemata werden für jede in der Abfrage referenzierte Tabelle generiert.

Wenn Sie setzen GenerateSchemaFiles Zu OnCreate, Schemas werden nur generiert, wenn eine CREATE TABLE Abfrage ausgeführt wird.

Schemas bei Verbindung generieren

Eine andere Möglichkeit, diese Eigenschaft zu verwenden, besteht darin, beim Herstellen einer Verbindung Schemata für jede Tabelle in Ihrer Datenbank abzurufen. Setzen Sie dazu GenerateSchemaFiles Zu OnStart und verbinden.

MaxRows

Begrenzt die Anzahl der zurückgegebenen Zeilen, wenn in der Abfrage keine Aggregation oder Gruppierung verwendet wird. Dadurch werden Leistungsprobleme zur Entwurfszeit vermieden.

Datentyp

int

Standardwert

-1

Hinweise

Begrenzt die Anzahl der zurückgegebenen Zeilen, wenn in der Abfrage keine Aggregation oder Gruppierung verwendet wird. Dadurch werden Leistungsprobleme zur Entwurfszeit vermieden.

Andere

Diese versteckten Eigenschaften werden nur in bestimmten Anwendungsfällen verwendet.

Datentyp

string

Standardwert

""

Hinweise

Die unten aufgeführten Eigenschaften sind für bestimmte Anwendungsfälle verfügbar. Für normale Anwendungsfälle und Funktionen von Treiber sollten diese Eigenschaften nicht erforderlich sein.

Geben Sie mehrere Eigenschaften in einer durch Semikolon getrennten Liste an.

Integration und Formatierung

Seitengröße

Die maximale Anzahl der Ergebnisse, die pro Seite von GraphQL zurückgegeben werden sollen.

Datentyp

string

Standardwert

""

Hinweise

Der Pagesize Die Eigenschaft beeinflusst die maximale Anzahl von Ergebnissen, die pro Seite von GraphQL zurückgegeben werden. Das Festlegen eines höheren Wertes kann zu einer besseren Leistung führen, allerdings auf Kosten des zusätzlichen Speicherverbrauchs pro verbrauchter Seite. Die Seitengröße ist proportional zu den GraphQL Abfrage.

Pseudospalten

Diese Eigenschaft gibt an, ob Pseudospalten als Spalten in die Tabelle aufgenommen werden sollen oder nicht.

Datentyp

string

Standardwert

""

Hinweise

Diese Einstellung ist besonders hilfreich im Entity Framework, da Sie dort keinen Wert für eine Pseudospalte festlegen können, es sei denn, es handelt sich um eine Tabellenspalte. Der Wert dieser Verbindungseinstellung hat das Format „Tabelle1=Spalte1, Tabelle1=Spalte2, Tabelle2=Spalte3“. Sie können das Zeichen „*“ verwenden, um alle Tabellen und alle Spalten einzuschließen, z. B. „*=*“.

Zeitüberschreitung

Der Wert in Sekunden, bis der Timeout-Fehler auftritt und der Operation abgebrochen wird.

Datentyp

int

Standardwert

60

Hinweise

Wenn Timeout = 0, Operationen werden nicht abgebrochen. Die Operationen werden ausgeführt, bis sie erfolgreich abgeschlossen sind oder bis ein Fehler auftritt.

Wenn Timeout abläuft und der Operation noch nicht abgeschlossen ist, löst der Connector eine Ausnahme aus.