Eine Datenquelle in DQE One Standalone verbinden

Bevor Sie einen Process, eine DataPipeline oder ein RuleSet erstellen können, müssen Sie mindestens eine Datenquelle verbinden. DQE One Standalone unterstützt 7 Quelltypen: Salesforce, Microsoft Dynamics 365, PostgreSQL, BigQuery, Snowflake, SFTP und den CSV-Datei-Upload.

Wo Sie eine Datenquelle verbinden

Sie können eine Datenquelle an zwei Stellen verbinden:

• Im Schritt Data Source des Erstellungsassistenten für einen Process (oder eine DataPipeline, oder ein RuleSet) — Überschrift "Choose your data source", mit einem Abschnitt "Connect to your software" mit dem Hinweis "Select your software plugin and log in to your software. A system administrator account is required."
• Unter My Account → Credentials — ein Akkordeon-Abschnitt ("Update your credentials here"), in dem Sie eine Verbindung im Voraus erstellen können, unabhängig von einem Process. Wählen Sie einen Connector aus der Liste Select connector und klicken Sie dann auf New.

Beide Stellen öffnen genau dasselbe Verbindungsformular — alles Folgende gilt daher für beide Einstiegspunkte.

Eine bestehende Verbindung wiederverwenden

Wenn Sie eine bestimmte Quelle bereits zuvor verbunden haben, zeigt das Verbindungsfenster Ihre gespeicherten Anmeldedaten als Karten an (mit einem grünen oder roten Punkt, der anzeigt, ob die Verbindung aktuell gültig ist) — klicken Sie auf eine, um sie ohne erneute Eingabe wiederzuverwenden. Klicken Sie auf Use another account, um stattdessen ein leeres Formular zu öffnen, oder auf Back to existing account, um zur gespeicherten Liste zurückzukehren.

Salesforce

Klicken Sie auf Connect to Salesforce und füllen Sie aus:

• Username
• Salesforce Instance Url
• External Client App Consumer Key
• External Client App Private Key — laden Sie Ihren PEM-formatierten privaten Schlüssel hoch oder fügen Sie ihn ein (muss mit -----BEGIN PRIVATE KEY----- beginnen und mit -----END PRIVATE KEY----- enden), ausgestellt von Ihrer Salesforce External Client App.

Klicken Sie dann auf Log In.

Dies ist ein direktes Anmeldedaten-Formular, kein interaktives Salesforce-Anmeldefenster — es gibt keinen Einwilligungsbildschirm zu bestätigen. Die Instance Url muss eine echte Salesforce-Domain sein, sonst wird die Verbindung abgelehnt.

Wo Sie das in Salesforce finden

• Username: der Salesforce-Benutzername eines Benutzers mit API-Zugriff (oft ein dedizierter Integrationsbenutzer).
• Salesforce Instance Url: die URL, mit der Sie sich bei dieser Org anmelden (z. B. https://yourcompany.my.salesforce.com), ebenfalls angezeigt unter Setup → Company Information.
• External Client App Consumer Key / Private Key: erstellen Sie eine External Client App unter Setup → External Client App Manager → New External Client App, aktivieren Sie OAuth, wählen Sie den JWT Bearer Flow, und laden Sie ein digitales Zertifikat hoch. Sie erzeugen das Zertifikat und den zugehörigen privaten Schlüssel vorher selbst (z. B. mit OpenSSL) — laden Sie nur das Zertifikat zu Salesforce hoch und behalten Sie den privaten Schlüssel, um ihn hier einzufügen. Sobald die App gespeichert ist, zeigt Salesforce Ihnen den Consumer Key an.

Microsoft Dynamics 365

Klicken Sie auf Connect to Dynamics und füllen Sie aus:

• Tenant
• Client Id
• Client Secret
• Scope — die URL Ihrer Dynamics-Umgebung (z. B. https://yourorg.crm.dynamics.com/.default).

Das Kontrollkästchen Migrate Run & Process ist standardmäßig aktiviert. Lassen Sie es beim ersten Verbinden einer bestimmten Dynamics-Org aktiviert — nach der Anmeldung überträgt DQE One Standalone Process-/Run-Metadaten nach Dynamics, damit sie auch dort nachverfolgt werden können (währenddessen erscheint eine Fortschrittsanzeige).

Klicken Sie auf Log In. Ein Microsoft-Anmeldefenster öffnet sich — melden Sie sich an und stimmen Sie zu, schließen Sie dann die angezeigte Bestätigungsseite ("Successfully Connected"). DQE One Standalone schließt die Verbindung danach automatisch ab.

Voraussetzung: Ihr IT-Team muss eine Azure AD App Registration erstellen (die Ihnen die obige Tenant ID, Client ID und das Client Secret liefert) mit einer Redirect-URI von {Ihre DQE One Standalone-URL}/dynamics/code.

Wo Sie das in Azure / Dynamics finden

• Tenant und Client Id: im Azure Portal unter Microsoft Entra ID → App registrations, öffnen Sie Ihre App Registration — deren Overview-Seite zeigt die Directory (tenant) ID und die Application (client) ID.
• Client Secret: in derselben App Registration unter Certificates & secrets → New client secret. Kopieren Sie den Value sofort — Azure zeigt ihn nur einmal an.
• Scope (Ihre Umgebungs-URL): im Power Platform admin center → Environments, öffnen Sie Ihre Umgebung — ihre Environment URL wird auf der Details-Seite angezeigt.
• Redirect-URI: fügen Sie sie selbst in der App Registration unter Authentication → Add a platform → Web hinzu.

PostgreSQL

Klicken Sie auf Connect to Postgres, füllen Sie Host, Port, Username, Password und Database aus und klicken Sie dann auf Log In. Stellen Sie sicher, dass die Datenbank vom Server von DQE One Standalone aus erreichbar ist (Netzwerk- /Firewall-Zugriff).

Wo Sie das finden

Dies sind die Verbindungsdaten Ihres eigenen PostgreSQL-Servers — fragen Sie, wer diese Datenbank verwaltet (Ihr DBA- oder Infrastrukturteam), nach Host, Port, Datenbankname sowie Benutzername/Passwort mit Zugriff darauf.

BigQuery

Klicken Sie auf Connect to BigQuery. Öffnen Sie die aus der Google Cloud Console heruntergeladene Service-Account-JSON-Datei und übertragen Sie diese 5 Werte:

• Client Id
• Client Email
• Project Id
• Private Key Id
• Private Key — laden Sie den PEM-formatierten Wert hoch oder fügen Sie ihn ein (das Feld private_key in der JSON-Datei).

Klicken Sie dann auf Log In.

Wo Sie das finden

Gehen Sie in der Google Cloud Console zu IAM & Admin → Service Accounts, wählen Sie das zu verwendende Service-Konto aus (oder erstellen Sie eines), öffnen Sie dessen Tab Keys, dann Add Key → Create new key → JSON. Dies lädt eine JSON-Datei mit den 5 obigen Werten herunter — öffnen Sie sie und kopieren Sie jedes Feld in das passende Feld.

Snowflake

Klicken Sie auf Connect to Snowflake und füllen Sie aus:

• Host — der Host Ihres Snowflake-Kontos, endend auf .snowflakecomputing.com.
• Client Id
• Client Secret

Klicken Sie auf Log In. Ein Snowflake-Anmeldefenster öffnet sich — melden Sie sich an und autorisieren Sie, schließen Sie dann die Bestätigungsseite. Snowflake-Verbindungen durchlaufen diesen Anmeldeschritt immer (auch bei jeder späteren stillen Aktualisierung der Verbindung im Hintergrund).

Voraussetzung: Ihr Snowflake-Administrator muss eine Security Integration (OAuth-Client) einrichten, die Ihnen die obige Client ID/das Client Secret liefert, mit einer Redirect-URI von {Ihre DQE One Standalone-URL}/snowflake/code.

Wo Sie das finden

Ihr Host ist Ihre Snowflake-Kontokennung gefolgt von .snowflakecomputing.com (sichtbar in der URL, mit der Sie Snowflake öffnen, oder unter Admin → Accounts). Die Client Id und das Client Secret stammen aus der Security Integration — ein Snowflake-ACCOUNTADMIN erstellt sie mit einer Anweisung CREATE SECURITY INTEGRATION ... TYPE = OAUTH und ruft das Secret anschließend ab mit SELECT SYSTEM$SHOW_OAUTH_CLIENT_SECRETS('integration_name'). Fragen Sie Ihren Snowflake-Administrator, falls Sie selbst keinen ACCOUNTADMIN-Zugriff haben.

SFTP

Klicken Sie auf Connect to SFTP, füllen Sie Host, Port und Username aus und wählen Sie dann eine Authentifizierungsmethode:

• Password — geben Sie Ihr Password ein.
• Key Pair — fügen Sie den Inhalt Ihres Private Key ein, und optional dessen Private Key Password.

Klicken Sie auf Log In.

Voraussetzung: Ihr SFTP-Host muss vor dem Verbinden zu einer Allow-List hinzugefügt werden — der hier eingegebene Host muss genau übereinstimmen. Diese Allow-List ist eine serverseitige Einstellung der Maschine, auf der DQE One Standalone selbst läuft, nicht etwas, das innerhalb der App konfigurierbar ist:

• Wenn Sie DQE One Standalone selbst hosten, fügt Ihr eigenes Infrastrukturteam den Host zur Konfiguration dieses Servers hinzu.
• Wenn DQE Software es für Sie hostet, bitten Sie Ihren DQE- Projektleiter oder den DQE-Support, ihn hinzuzufügen.

Wenn beim Verbinden eine Meldung "not allowed" angezeigt wird, ist dies als Erstes zu prüfen.

Nach dem Verbinden wählen Sie 4 Speicherorte auf dem SFTP-Server: eine Input file, ein Output directory, ein Logs directory und ein Reject directory (Dateien, die während eines Runs nicht gelesen werden können, werden dorthin verschoben). Beim Durchsuchen von Dateien können Sie eine Dateimaske mit den Platzhaltern * und ? eingeben, um mehrere passende Dateien auf einmal auszuwählen.

CSV-Datei-Upload

Wählen Sie im Assistenten Import data files und ziehen Sie eine CSV-Datei auf die Ablagefläche (oder klicken Sie, um zu durchsuchen). Es gibt keinen Anmeldeschritt und nichts vorher zu konfigurieren — die Datei wird direkt hochgeladen.

Gespeicherte Anmeldedaten verwalten

Gehen Sie zu My Account → Credentials, um alle von Ihnen gespeicherten Verbindungen mit Connector-Typ und maskiertem Login zu sehen. Von hier aus können Sie:

• Eine neue Verbindung im Voraus erstellen (Schaltfläche New), ohne zuerst einen Process starten zu müssen.
• Eine Verbindung Delete — nur möglich, wenn sie von keinem bestehenden Process oder RuleSet verwendet wird.

Die Schaltfläche Edit bei einer gespeicherten Anmeldedaten-Karte ist immer deaktiviert — Sie können die Details einer gespeicherten Verbindung derzeit nicht über diesen Bildschirm aktualisieren. Um Anmeldedaten zu ändern, löschen Sie die alte Verbindung (sobald sie nicht mehr verwendet wird) und erstellen Sie eine neue.