Connection String Types

Einleitung

Es gibt verschiedene Arten von Verbindungszeichenfolgen, die verwendet werden können. In diesem Handbuch werden die verschiedenen Typen von Verbindungszeichenfolgen beschrieben.

Dateien

Dateien können in eine Tabelle geladen werden, indem ein Treiberparameter der Verbindungszeichenfolge auf {mvfile} wird.

driver={mvfile}

Die folgenden Dateitypen können geladen werden:

• Excel-Dateien .xls und .xlsx
• Textdateien .csv , .tsv und .txt

Zum Laden von Dateien können zusätzliche Parameter angegeben werden.

Nachfolgend finden Sie eine Übersicht über die generischen Parameter, die verfügbar sind oder Dateien laden.

Parameter	Beschreibung
FileName	Dies kann entweder ein relativer Pfad zu einer Datei auf dem Server oder eine HTTP-URL sein. Wenn sich die Datei auf dem Server befindet, sollte die Datei auf der Registerkarte Entwicklungsdaten oder Serverdaten platziert werden , und der Tabellenbereich der Tabelle muss entsprechend festgelegt werden. Wenn Sie eine HTTP-URL verwenden, können Sie die Parameter user und pass für die Authentifizierung angeben.
ext	Standardmäßig wird die Dateinamenerweiterung verwendet, um den Dateityp zu bestimmen, aber dies kann überschrieben werden.
Benutzer	Der Benutzername für die Remote-Datei bei Verwendung einer HTTP-URL.
bestanden	Das Kennwort für die Remotedatei bei Verwendung einer HTTP-URL.

Excel-Dateien

Nachfolgend finden Sie eine Übersicht über die zusätzlichen Parameter, die zum Laden von Excel-Dateien verwendet werden können.

Parameter	Beschreibung
Blatt	Das zu importierende Blatt oder benannte Bereich. Bei Blattnamen sollte am Ende ein Dollarzeichen angehängt werden. Wenn nicht angegeben, wird das erste Blatt geladen.
Erste Spalte	Die erste Spalte, mit der begonnen werden soll. Die Standardeinstellung ist {autodetect}.
Erste Zeile	Die erste Zeile, mit der begonnen werden soll. Die Standardeinstellung ist {autodetect}.

Die folgende Tabelle enthält Beispielverbindungszeichenfolgen zum Laden von Excel-Dateien.

Verbindungszeichenfolge	Lädt ...
'driver={mvfile}; filename=Data/Dataset.xlsx;'	das erste Blatt einer Excel-Datei
'driver={mvfile}; filename=Data/Dataset.xlsx; sheet=MySheet$;'	das Blatt mit dem Namen „MySheet“

Textdateien

Nachfolgend finden Sie eine Übersicht über die zusätzlichen Parameter, die zum Laden von Textdateien verwendet werden können.

Parameter	Beschreibung
Hat Header	Ob die erste Zeile der Datei eine Kopfzeile ist. Die Standardeinstellung ist {true} .
delim	Das Trennzeichen. Die Standardeinstellung ist {tab} .
Zitat	Das Zeichen, das verwendet wird, um Werte in Anführungszeichen zu setzen. Die Standardeinstellung ist {autodetect} .
entkommen	Das Zeichen, das als Escape-Zeichen verwendet wird. Die Standardeinstellung ist {none}.
Codierung	Die in der Datei verwendete Codierung, z. B. UTF8 oder LATIN1. Die Standardeinstellung ist {UTF8} .

Die folgende Tabelle enthält Beispielverbindungszeichenfolgen zum Laden von Textdateien.

Verbindungszeichenfolge	Lädt eine Textdatei ...
driver={mvfile}; filename=Textfile.txt; delim=,; quote=";'	mit Komma (,) als Trennzeichen und „“ Anführungszeichen
'driver={mvfile}; filename=Textfile.txt; delim=|; quote=";'	mit Pipe-Trennzeichen (|) und „Anführungszeichen“
"driver={mvfile}; filename=Textfile.txt; delim=9; quote=';"	mit Tabulatortrennzeichen und „Anführungszeichen“
'driver={mvfile}; filename=Textfile.txt; delim=59; quote=none;'	mit Semikolon als Trennzeichen und ohne Anführungszeichen
'driver={mvfile}; filename=Textfile.txt; delim=,; quote="; escape=\;'	mit Komma (,) als Trennzeichen, „ Anführungszeichen und \ Escape-Zeichen
'driver={mvfile}; filename=http://www.example.com/files/example.txt;'	von einem Webserver
'driver={mvfile}; filename=http://www.example.com/files/example.txt; User=Jane; mv-credential-Pass=example_com_credentials'	von einem Webserver mit einfacher Zugriffsauthentifizierung

ODBC

ODBC wird verwendet, um eine Verbindung mit externen Datenquellen, in der Regel Datenbanken, herzustellen. Sie können dazu entweder das Betriebssystem verwenden, z. B. den ODBC-Datenquellen-Manager in Microsoft Windows, oder die Verbindungszeichenfolge direkt im richtigen Format angeben.

Es ist möglich, dass der ODBC-Treiber zum Ausführen eine Abfrage benötigt. Die Abfrage, die für die Datenbank ausgeführt werden muss, kann als Zeichenfolge im Feld Abfrage angegeben werden.

Wichtig: Stellen Sie beim Testen einer ODBC-Verbindung sicher, dass das Feld Abfrage mit einer gültigen Abfrage ausgefüllt ist.

Wichtig: Auf alle Datenbanken mit einer 64-Bit-Version kann mit einer ODBC-Verbindung zugegriffen werden. Der erforderliche ODBC-Treiber mit 64 Bit muss auf dem UiPath Process Mining-Server installiert sein und der Server muss auf dieses spezielle System zugreifen können.

Nachfolgend finden Sie eine Übersicht über die Parameter, die für ODBC-Verbindungen verwendet werden können.

Parameter	Beschreibung
Fahrer	Der ODBC-Treiber, der für diese Verbindung verwendet werden soll. Bei Verwendung des Parameters 'dsn' nicht erforderlich.
dsn	Der ODBC-DSN, der für diese Verbindung verwendet werden soll. Bei Verwendung des Parameters 'driver' nicht erforderlich. Hinweis: Stellen Sie beim Einrichten eines DSN zur Verwendung in der Verbindungszeichenfolge sicher, dass es sich um einen 64-Bit-System-DSN handelt.
Benutzer	Benutzername, der zum Herstellen einer Verbindung mit der externen Datenquelle verwendet werden soll.
bestanden	Kennwort, das zum Herstellen einer Verbindung mit der externen Datenquelle verwendet werden soll.
sonstiges	Alle anderen Parameter werden wie angegeben an den ODBC-Treiber übergeben.

Die folgende Tabelle enthält Beispielverbindungszeichenfolgen für ODBC-Verbindungen.

Verbindungszeichenfolge	Verbindet ...
'Driver={SQL Server Native Client 11.0};Server=SERVERNAME;Database=MyDatabase;'	in eine SQL Server-Datenbank
'Driver={Oracle in OraClient12Home1};Dbq=MyTSN;'	in eine Oracle-Datenbank
'DSN=MeinDSN; Benutzer=MeinBenutzer; Pass=MyPass;'	Verwenden eines konfigurierten DSN mit Benutzername und Kennwort

Sowohl die Verbindungszeichenfolge als auch das Abfragefeld sind Ausdrücke. Beispielsweise könnte eine Verbindungszeichenfolgentabelle für eine imaginäre Datenbank erstellt werden.

Siehe Abbildung unten.

Hinweis: Daten in der Tabelle können nur verwendet werden, wenn die Tabelle geladen wurde. In diesem Beispiel wird die Globals -Tabelle benötigt, um Daten aus anderen Tabellen zu verwenden.

Tipps und Tricks

Informationen zu Verbindungszeichenfolgenformaten anderer Systeme finden Sie beim Hersteller dieses Systems oder in einer Online-Ressource wie https://www.connectionstrings.com/.

Wenn der Benutzer mit Zugriff auf die Datenbank ein Windows-Benutzer ist, stellen Sie sicher, dass dieser Windows-Benutzer:

• ist ein Dienstkonto und kein tatsächlicher Benutzer.
• hat Lese-/Schreibzugriff auf den Process Mining- Installationsordner.
• ist der Benutzer, der die Skripte (z. B. in den geplanten Aufgaben) zum Laden von Daten ausführt.
• wird zum Ausführen des Anwendungspools in IIS verwendet.

SAP HANA

Sie können eine ODBC-Verbindung verwenden, um eine Verbindung mit SAP HANA herzustellen.

Nachfolgend finden Sie eine Beispielverbindungszeichenfolge für SAP HANA.

'Driver={HDBODBC};User=MyUser;Pass=MyPass;ServerNode=MyServer:30015;DatabaseName=TDB1'

Hinweis: Anstatt eine Verbindung mit einer SAP-Datenbank herzustellen, wird empfohlen, den Typ der SAP -Verbindungszeichenfolge zu verwenden, um eine Verbindung mit dem SAP-Anwendungsserver herzustellen.

Generische Skripte

Sie können eine Verbindungszeichenfolge verwenden, um ein Skript auszuführen, um Daten aus Datenquellen zu laden.

Wichtig: Der Skript-Handler, den Sie ausführen möchten, muss auf dem UiPath Process Mining -Server installiert sein.

Dateien können in eine Tabelle geladen werden, indem Sie den Treiberparameter der Verbindungszeichenfolge auf {mvscript} und den Skriptparameter auf „generic“ festlegen:

driver={mvscript}; script=generic

Hinweis: Sie müssen die Skriptparameter im Feld „ Abfrage “ mithilfe der URL-Codierung angeben.

Nachfolgend finden Sie eine Übersicht über die Parameter, die im Feld „ Abfrage “ angegeben werden können.

Parameter	Beschreibung	Obligatorisch/Optional
scriptText	Der Text des Skripts.	Obligatorisch Hinweis: Nur wenn scriptFile nicht verwendet wird.
scriptFile	Dateiname, aus dem das Skript geladen werden soll. Dies kann ein relativer Pfad zu einer Datei auf dem Server sein. Wenn sich die Datei auf dem Server befindet, sollte die Datei auf der Registerkarte Entwicklungsdaten oder Serverdaten platziert werden , und der Tabellenbereich der Tabelle muss entsprechend festgelegt werden.	Obligatorisch Hinweis: Nur wenn scriptText nicht verwendet wird.
Eingabedaten	Ein durch Semikolon getrennter Text mit Spaltenüberschriften, der die Eingabe für das Skript enthält. Hinweis: Die Funktion csvtable kann verwendet werden, um Daten im richtigen Format zu generieren.	Obligatorisch
Skripttyp	Der Name des zu verwendenden Handles, wie in der Einstellung GenericScriptHandlers in den Servereinstellungenangegeben. Hinweis: Wenn scriptFile angegeben ist, wird dies basierend auf der Dateierweiterung automatisch erkannt.	Optional
Argumente	Passen Sie die Argumente an, die an das Skript übergeben werden sollen. Dies sollte eine JSON- codierte Liste sein. Es gibt zwei spezielle Argumente; '<SCRIPT>' und '<INPUT>' . Vorkommen von '<SCRIPT>' werden durch den Pfad zu einer Skriptdatei ersetzt, und Vorkommen von '<INPUT>' werden durch den Pfad zur Eingabedatei ersetzt. Auf diese Weise können Sie den Aufruf des Skripthandlers mit zusätzlichen Argumenten anpassen. Der Standardwert ist ["<SCRIPT>", "<INPUT>"] .	Optional
debugPath	Ein absoluter Pfad zu einem Ordner. Wenn dieser Parameter angegeben ist, gibt UiPath Process Mining die Eingabedatei (wie an den externen Prozess übergeben) und die Ausgabe des externen Prozesses (wie aus der Standardausgabe des externen Prozesses gelesen) in diesem Ordner zu Debugzwecken aus.	Optional

Nachfolgend finden Sie ein Beispiel für eine einfache Abfrage.

+'&scriptFile=' + urlencode("script.py")
+'&inputData='  + urlencode("a;b;c"+#10+"1;2;3"+#10+"4;5;6")

Nachfolgend finden Sie ein Beispiel für eine erweiterte Abfrage.

+'&scriptText=' + urlencode(/* your script as text */)
+'&scriptType=' + urlencode("HandlerName")
+'&inputData='  + urlencode(csvtable(
    "Case_ID", jsontolist(InputData_Case_ID)
    "Amount" , jsontolist(InputData_Amount)
))
+'&args='       + urlencode(listtojson(["<SCRIPT>", "--filename", "<INPUT>"]))

Siehe auch: Verwenden von generischen Skriptdatenquellen

SAP

SAP-Verbindungszeichenfolgen können verwendet werden, um eine Verbindung mit einem SAP-Anwendungsserver herzustellen, z. B. SAP R3, SAP ERP, SAP ECC 5.0, SAP ECC 6.0, S/4HANA.

Wichtig: Die Bibliothek SAP NWRFC muss auf dem UiPath Process Mining -Server installiert sein, um eine SAP-Datenquelle aus der Verbindungszeichenfolge zu verwenden.

SAP-Datenquellen können geladen werden, indem der Treiberparameter der Verbindungszeichenfolge auf {SAP} festgelegt wird.

driver={SAP}

Nachfolgend finden Sie eine Übersicht über die Parameter, die für SAP-Datenquellen verwendet werden können.

Parameter	Beschreibung	Obligatorisch/Optional
Host	Der Hostname oder die IP-Adresse des SAP-Anwendungsservers.	Obligatorisch
SystemNumber	Die zweistellige Zahl zwischen 00 und 99, die die angegebene Instanz identifiziert.	Obligatorisch
Funktionsmodul	Beim Einrichten einer nativen SAP-Extraktion ist das SAP Z_XTRACT_IS_TABLE-Funktionsmodul erforderlich. Wenn beispielsweise das Funktionsmodul in Ihrem SAP-System umbenannt wird, können Sie den richtigen Namen im Parameter FunctionModule in der SAP-Verbindungszeichenfolge angeben.FunctionModule Parameter. Überschreibt das standardmäßige Z_XTRACT_IS_TABLE -Funktionsmodul, das beim Abfragen dieser Tabelle verwendet wird.	Optional
Benutzername	Der Benutzername des Kontos, das zum Anmelden bei der SAP-Instanz verwendet wird.	Obligatorisch
bestanden	Das Kennwort des obigen Benutzers. Kann in Kombination mit dem Anmeldeinformationsspeicher verwendet werden. Verwenden Sie in diesem Fall mv-credential-pass .	Obligatorisch
Client	Der verwendete Client.	Obligatorisch
Sprache	Die Sprache, die beim Anmelden verwendet wird.	Obligatorisch

Nachfolgend finden Sie eine Übersicht über die Parameter, die im Feld „ Abfrage “ angegeben werden können.

Parameter	Beschreibung	Obligatorisch/Optional
Tabelle	Der SAP-Tabellenname, aus dem die Daten geladen werden müssen. Zum Beispiel EKPO .	Obligatorisch
Felder	Ein Array von Feldern, die aus der SAP-Tabelle abgerufen werden, die in der Eigenschaft table angegeben ist. Hinweis: Wenn die Eigenschaft fields leer ist, werden alle Felder abgerufen.	Obligatorisch
Wo	Eine where -Klausel zum Abrufen einer Teilmenge einer Tabelle.	Optional
limit	Eine ganze Zahl, die eine feste Anzahl von Datensätzen angibt, die aus der Tabelle abgerufen werden sollen. Hinweis: Wenn limit auf „0“ festgelegt ist, gibt es keine Begrenzung.	Optional

Hinweis: Jedes Feld in SAP hat eine Länge. Stellen Sie aus Leistungsgründen sicher, dass die Summe aller abgerufenen Feldlängen für eine Tabelle 512 nicht überschreitet.

Nachfolgend finden Sie ein Beispiel für eine SAP-Verbindungszeichenfolge.

'Driver={SAP};Host=10.10.10.10;SystemNumber=00;Username=MyUser;pass=secretPassword;client=100;Language=EN'

Nachfolgend finden Sie einige Beispielabfragen.

Abfrage	Ruft ab...
'table=' + urlencode("EKPO")	alle Felder aller Datensätze der Tabelle EKPO .
'table=' + urlencode("EKPO") + '&fields=' + urlencode(listtojson(["MANDT", "EBELN"]))	die Felder MANDT und EBELN für alle Datensätze der Tabelle EKPO .
'table=' + urlencode("EKPO") + '&where=' + urlencode("EBELN = 4500000001")	alle Felder aus Tabelle EKPO , wobei EBELN gleich 4500000001 ist.