Stappen: JDBC-databasegegevensbronnen instellen

Adaptive Planning

U kunt gebruiken

Adaptive Planning

Integratie om informatie uit JDBC-compatibele databases te extraheren. De meeste databases die worden gebruikt voor boekhoudkundige en financiële toepassingen zijn JDBC-compatibele databases (Java Database Connectivity). JDBC is een standaard die gebruikmaakt van de programmeertaal Java voor connectiviteit met een breed scala aan databases.

Voor een JDBC-compatibele databasegegevensbron is een stuurprogramma vereist. De onderstaande tabel bevat informatie over veelvoorkomende JDBC-stuurprogramma's.

Adaptive Planning-gegevensagenten maken alleen verbinding met on-premises databases. Verbinding maken met clouddatabases met een agent wordt niet ondersteund.

JDBC-bron	Overzicht	jar van de aanbieder	Klasse stuurprogramma	JDBC/URL-voorbeeld	JDBC URL-info
Oracle	Inleiding tot deOracle-database	ojdbc6-11.2.0.3.jar U kunt dit bestand downloaden van de Oracle-website of via de Maven-repository van Oracle.	oracle.jdbc.OracleDriver	jdbc:oracle:thin:@example-win-db:1521:ANACONDA	OracleDriver klasse
SQL Server	Microsoft SQL Server	jtds-1.3.1.jar gedistribueerd in de map Plug-ins voor gegevensagenten. zie Geïntegreerde beveiliging voorJDBC-gegevensbronnen voor dll-locatiedetails	net.sourceforge.jtds.jdbc.Driver	jdbc:jtds:sqlserver://127.0.0.1:1433/AGENT_TEST; domain=ADAPTIVE;instance=SQLEXPRESS	jTDS-indelingen
SQL Server	Microsoft SQL Server	sqljdbc41.jar gedistribueerd in de map Plug-ins voor gegevensagent. zie Geïntegreerde beveiliging voorJDBC-gegevensbronnen voor dll-locatiedetails	com.microsoft.sqlserver.jdbc.SQLServerDriver	jdbc:sqlserver://localhost:1433;databaseName=AdventureWorks;user=MyUserName;password=*****;	De verbindings-URL samenstellen
MySql	MySQL-referentiehandleidingen	mysql-connector-5.1.17.jar	com.mysql.jdbc.Driver	jdbc:mysql://localhost:3306/AGENT_TEST	URL Syntax
h2	H2-database-engine	Zoek naar h2*.jar in de distributie van Workday Adaptive Planning Data Agent Service Manager. Voor gegevensagentversies 7.1.44 en ouder zoekt u naar h2.jar in de Adaptive Data Agent Service Manager-distributie.	org.h2.Driver	jdbc:h2:/data/test	Cheatsheet H2

De jar-bestanden bevinden zich in de

C:/Program Files/Workday Adaptive Planning Data Agent/Plugins.

Gebruik voor gegevensagentversies 7.1.44 en ouder

C:/Program Files/Adaptive Data Agent/Plugins

map op de computer waarop de Data Agent Service wordt gehost.

Nadat u een jar-bestand hebt toegevoegd, moet u naar de lokale services gaan en de Data Agent Service opnieuw starten.

Voordat u een gegevensbron vanuit een lokale database kunt instellen, moet u een gegevensagent hebben gemaakt die vertelt:

Adaptive Planning

Integratie voor communicatie met de database. Zie voor informatie over het maken van gegevensagenten: Create Data Agents.

Ga als volgt te werk om een JDBC-databasegegevensbron in te stellen:

Open de Gegevensontwerper door naar Integratie > Gegevensontwerper
te gaan.

Klik in de map Gegevensbron in de componentenbibliotheek aan de rechterkant van het scherm op Nieuwe gegevensbron maken
. Het dialoogvenster Nieuw wordt weergegeven.

Selecteer JDBC-database als gegevensbrontype, voer de naam van de database in en selecteer de agent die u voor deze gegevensbron wilt gebruiken.

Klik op Maken
. In het midden van het scherm worden de instellingen en andere informatie van uw nieuwe gegevensbron weergegeven.

Voer de informatie voor gegevensbron in:

Gekoppelde agent:

selecteer de Adaptive Planning-gegevensagent waarmee u verbinding wilt maken. Deze lijst bevat alle gegevensagenten in de

gegevensagenten

van de componentenbibliotheek

Klasse stuurprogramma:
voer de klasse van het stuurprogramma voor de database in. (U kunt deze informatie opvragen bij de databaseleverancier.)

URL:
voer de URL van de database in.

Gebruikersnaam:
voer de gebruikersnaam in die wordt gebruikt voor toegang tot de database.

Wachtwoord:
voer het wachtwoord in dat aan de gebruikersnaam is gekoppeld.

Schemafilter:
voer de naam in van de schema's waaruit u gegevens wilt importeren. Als u de namen van meer dan één schema invoert, voert u de schemanamen in, gescheiden door een puntkomma. Gebruik dit veld om het aantal tabellen te beperken dat moet worden vernieuwd in

Adaptive Planning

Integratie. Dit veld is optioneel.

Logboekniveau:
selecteer een logboekniveau in de vervolgkeuzelijst om de details voor de logboekregistratie voor deze gegevensbron op te geven. Uw opties zijn:

Fout:
registreert alleen ernstige fouten.

Info:
registreert alle basisgegevens, zoals wanneer de gegevensbron is bijgewerkt.

Uitgebreid:
biedt zeer gedetailleerde informatie over alle fasen en acties. (Dit niveau wordt voornamelijk gebruikt voor foutopsporing of audits, omdat het meer logboekgegevens kan opleveren dan voor normaal gebruik praktisch is.)

Klik op Opslaan
in het menu Acties.

U kunt de verbindingsgegevens in de nieuwe gegevensbron testen door in het menu Acties
op Verbinding testen
te klikken. Het systeem probeert verbinding te maken met de database met behulp van de informatie in de gegevensbronvelden. Als het systeem verbinding kan maken met de database, klikt u op OK
. Als er verbindingsproblemen zijn, lost u de fouten op en probeert u het opnieuw.

Wanneer u verbinding kunt maken met de database, kunt u de gegevensstructuur importeren. Hiermee worden de tabellen en kolommen in de database weergegeven.

Alleen kolommen voor ondersteunde typen worden weergegeven. Ondersteunde kolomtypen, geeft een overzicht van de ondersteunde kolomtypen voor de verschillende typen databases.

Ga als volgt te werk om de structuur van de JDBC-database te importeren:

Klik op Structuur importeren
in het menu Acties
. De tabellen en kolommen worden weergegeven in het menu Gegevenscomponenten
.

De gegevensimportmodi zijn van invloed op de manier waarop de gegevens worden gesynchroniseerd. De standaardimportmodus (alle records vervangen) voor een JDBC-gegevensbron is als volgt:

De JDBC-gegevens worden geïmporteerd.

Gegevens uit JDBC-bron vullen faseringstabel.

Als er een aangepast SQL-filter is, wordt dit toegepast op de gegevens die worden geïmporteerd vanaf de databaseserver om te bepalen welke subset van gegevens moet worden geïmporteerd.

U kunt er ook voor kiezen om geïmporteerde gegevens toe te voegen, dan worden geïmporteerde gegevens toegevoegd aan de bestaande faseringstabel, of om geïmporteerde gegevens samen te voegen. In dat geval worden bestaande rijen in de JDBC-gegevens samengevoegd met de rijen in het faseringsgebied.

Tabellen toevoegen aan een JDBC-gegevensbron

Nadat u de databasestructuur hebt geïmporteerd, kunt u de informatie opgeven die u uit de database wilt importeren. In de sectie Te importeren tabellen
kunt u de gegevens configureren die uit de database worden geïmporteerd.

Voer de volgende stappen uit om de tabellen op te geven die uit de database moeten worden geïmporteerd:

Vouw de vermelding voor de gegevensbron uit in het menu Gegevenscomponenten
.

Elke tabel in de database wordt als een afzonderlijk item weergegeven.

Sleep de tabellen die u wilt importeren naar de sectie Te importeren tabellen
in het midden van het scherm.

Als u elke tabel naar de sectie Te importeren tabellen sleept, wordt er een tabblad weergegeven voor de tabel en wordt informatie uit de database weergegeven in de sectie Te importeren tabellen, zodat u kunt zien welk type informatie u hebt toegevoegd. Het tabblad van elke tabel heeft ook een vervolgkeuzemenu dat u kunt openen door op de pijl naast de naam te klikken.

Kolommen beheren

Als een tabel waarmee u werkt een groot aantal kolommen heeft, kunt u Kolommen beheren
gebruiken om snel te bewerken welke kolommen u wilt importeren. In het dialoogvenster Kolommen beheren
worden de kolommen in een tabel weergegeven, zodat u kolommen voor importeren kunt in- of uitschakelen.

Volg deze stappen om kolommen te beheren voor importeren:

Klik op de pijl op het tabblad rechts van de tabelnaam.

Klik in het zwevende menu op Kolommen beheren
.

Schakel het selectievakje naast een kolom in om deze te importeren.

Wanneer u een kolom inschakelt, wordt de kolom ook weergegeven in het voorbeeldvenster nadat de pop-upinhoud is opgeslagen. Als u een kolom uitschakelt, wordt de kolom uit het voorbeeldvenster verwijderd.

U kunt de importstatus voor afzonderlijke kolommen ook als volgt wijzigen:

Kolomeigenschappen selecteren en de eigenschap instellen.

Kolommen in de ontwerper slepen en neerzetten.

U kunt de importstatus niet wijzigen voor door het systeem gegenereerde velden, zoals isDeleted
.

De tabellen aanpassen

Voor elke tabel kunt u de manier aanpassen waarop gegevens worden geïmporteerd.

Volg deze stappen om de tabelinstellingen aan te passen:

Klik op de pijl op het tabblad rechts van de tabelnaam.

Klik op Tabelinstellingen
in het zwevende menu.

Voer de tabelinstellingen in:

Gegevensimportmodus:
selecteer een van de opties in de vervolgkeuzelijst.

Alle records worden vervangen telkens wanneer een gegevensimport wordt uitgevoerd
Dit is de standaardinstelling. Vervangt de gegevens in de faseringstabel door gegevens die uit de bron zijn geïmporteerd.

Externe cache die wordt gebruikt voor het identificeren en verzenden van gewijzigde records bij het importeren
Alleen databaserecords die zijn gewijzigd of nieuw zijn, worden geïmporteerd. Gewijzigde records overschrijven bestaande records in het faseringsgebied. Nieuwe records worden toegevoegd aan het einde van de informatie in het faseringsgebied.

Alle verzonden records die binnen een periodebereik vallen
Alle records in het opgegeven periodebereik worden geïmporteerd. Records in de faseringstabel die overeenkomen met de geïmporteerde perioden, worden verwijderd voordat de meest recente gegevens uit de bron worden geïmporteerd.

Filter voor gegevensimport:
gebruik dit om een SQL-expressie in te voeren waarmee gegevens die worden geïmporteerd, worden gefilterd of opgemaakt. Het SQL-filter wordt toegepast voordat gegevens uit de database worden geëxtraheerd om de hoeveelheid gegevens die moet worden geïmporteerd te verminderen, zodat u meer controle hebt over welke gegevens in het faseringsgebied worden geplaatst. Klik op het veld om het dialoogvenster SQL-filter bewerken
weer te geven (het filter dat u hier invoert, wordt toegepast op de werkelijke gegevens in de database en niet op de voorbeeldgegevens in het faseringsgebied). Niet alle gegevensbronnen ondersteunen hetzelfde niveau van SQL-filtermogelijkheden.

Klik op Toepassen
om de instellingen toe te passen.

Herhaal de stappen 1 t/m 3 voor elke tabel.

Als er sleutels zijn gedefinieerd voor een databasetabel, wordt deze informatie ook in de faseringstabel opgenomen. U kunt deze informatie bekijken en indien nodig wijzigen.

Klik op Opslaan
om de instellingen in de gegevensbron op te slaan.

Kolomopties instellen

Als u de sectie Te importeren tabellen
gebruikt, kunt u een voorbeeld van de gegevens bekijken zoals deze zich in de gegevensbron of in het faseringsgebied bevinden nadat ze zijn geïmporteerd. U kunt de opties voor elke kolom wijzigen door de muisaanwijzer op de kop te plaatsen en vervolgens op het vervolgkeuzemenu naast de naam te klikken. Deze opties zijn:

Oplopend sorteren
: sorteer de hele tabel op basis van deze kolom in oplopende volgorde.

Aflopend sorteren
: sorteer de hele tabel op basis van deze kolom in aflopende volgorde.

Kolominstellingen
: dit dialoogvenster wordt gebruikt om de eigenschappen van de kolom in de faseringstabel te wijzigen.

Naam
: de naam van de kolom die in de kop wordt weergegeven.

Kolomtype
: het type gegevens dat in de kolom wordt gebruikt.

Kolomtype converteren
: selecteer het nieuwe type in dit vervolgkeuzemenu.

Kolom uitsluiten van import
: selecteer deze optie om deze kolom te verwijderen uit de gegevens die worden geïmporteerd.

Aangepaste kolom verwijderen:
selecteer deze optie om de kolom te verwijderen. (Alleen beschikbaar voor aangepaste kolommen.)

Gegevens downloaden uit een faseringstabel

U kunt gegevens uit één faseringstabel downloaden.

Volg deze stappen om gegevens uit één faseringstabel te downloaden:

Klik op de pijl-omlaag in een tabelkop in de sectie Te importeren tabellen.

Selecteer Gegevens downloaden
.

Klik op Verzenden
bij de prompt Met deze bewerking wordt een e-mail verzonden met een URL om de gegevens te downloaden
.

Adaptive Planning

Integratie verzendt een e-mail met een URL naar het e-mailaccount dat aan de gegevensontwerper is gekoppeld.

Open de e-mail en klik op de URL.

De gegevens worden gedownload in CSV-indeling.

Het geavanceerde filter gebruiken

Onder het vervolgkeuzemenu Bron
kunt u op Geavanceerd filter
klikken om opties voor het filteren van de gegevens weer te geven in het voorbeeldgebied Te importeren tabellen
. Het geavanceerde filter
biedt tools om een subset van de gegevens in een faseringstabel of rechtstreeks vanuit de externe bron weer te geven en te bladeren (als u JDBC-database selecteert in het vervolgkeuzemenu Bron). Door filtereigenschappen te wijzigen, kunt u de weergave van de gegevens in het voorbeeldvenster wijzigen zonder de gegevens in het faseringsgebied te wijzigen.

Het voorbeeldgebied is specifiek bedoeld voor het bekijken van een voorbeeld van een klein deel van de gegevens in het faseringsgebied (of JDBC-database). U kunt de beschikbare gegevens uit de JDBC-gegevensbron verkennen en controleren of u de verwachte gegevens krijgt door het faseringsgebied te onderzoeken. U kunt dit ook gebruiken om het filter voor gegevensimport te verfijnen dat u wilt gebruiken. (Filters die zijn ingesteld in de voorbeeldfunctie hebben geen invloed op de werkelijke gegevens in het faseringsgebied.)

Geavanceerd filter
omvat:

Verschillende rijen
: schakel dit selectievakje in om dubbele rijen te verbergen.

Maximaal aantal rijen
: beperk het aantal rijen dat in het voorbeeldgebied wordt weergegeven door een getal in het tekstvak in te voeren.

Kolommen
: schakel kolommen in dit vervolgkeuzemenu in of uit om de weergegeven kolommen weer te geven of te verbergen.

Als u een kolom uit deze lijst verwijdert, wordt de kolom niet uit de importlijst verwijderd.

SQL-filter
: klik op het grote tekstvak om het dialoogvenster SQL-filter bewerken
weer te geven, waarin u een SQL-filter kunt invoeren om de rijen te beperken waarvan een voorbeeld wordt weergegeven. Klik op Toepassen
om de SQL-syntaxis van het filter automatisch te controleren. (Als er fouten zijn, wordt de fout aangegeven in de expressie.) De expressie die u hebt ingevoerd, wordt weergegeven in het veld Geavanceerd filter
. Voor gedetailleerde hulp bij SQL-syntaxis klikt u op online-Help in de sectie Opmerkingen
.

Klik op Filter verwijderen
(naast het vervolgkeuzemenu Bron) om alle geavanceerde filterinstellingen te wissen.

Als onderdeel van het tabelaanpassingsproces kunt u jointabellen en aangepaste kolommen maken met behulp van SQL-expressies.

Gegevens importeren uit een JDBC-database

Wanneer u uw JDBC-gegevensbron hebt ingesteld en opgeslagen, kunt u gegevens importeren.

Ga als volgt te werk om gegevens uit een JDBC-database te importeren:

Klik op Gegevens importeren
in het menu Acties
.

De geselecteerde gegevens worden gefilterd op eventuele SQL-expressies en in het faseringsgebied geladen. U kunt een voorbeeld van de gegevens bekijken in het faseringsgebied.

Informatie blijft in het faseringsgebied totdat u deze handmatig wist of totdat de gegevens worden gewist in overeenstemming met de importmodus.

Ga als volgt te werk om gegevens uit het faseringsgebied te wissen:

Klik op Faseringstabellen wissen
in het menu Acties
. Het faseringsgebied voor alle tabellen in de gegevensbron wordt gewist.

Opgegeven tekens verwijderen uit invoertekststromen in JDBC-gegevensbronnen:

Zie Opgegeven tekens verwijderen uit invoertekststromen in JDBC en Microsoft Dynamics GP

Een JDBC-gegevensbron koppelen aan een andere Adaptive Planning-gegevensagent

U kunt wijzigen welke Adaptive Planning-gegevensagent u aan uw JDBC-gegevensbron koppelt.

Controleer of de gegevensagent waarmee u verbinding wilt maken, wordt weergegeven in

Gegevensagenten

voor componentenbibliotheek

Navigeer naar de JDBC-gegevensbron in Integraties ontwerpen.

Selecteer de gegevensagent in het veld

Gekoppelde agent

in de sectie

Instellingen

Uitgesloten schema's voor JDBC-gegevensbron

JDBC-gegevensbronnen die verbinding maken met Oracle of MS SQL Server sluiten expliciet bepaalde schema's uit die geen betrekking hebben op financiële gegevens.

Uitgesloten schema's voor Oracle JDBC-gegevensbron

CTXSYS, MDSYS, SYSTEEM, SYS, XDB

Uitgesloten schema's voor MS SQL Server JDBC-gegevensbron

INFORMATION_SCHEMA, SYS

Tips voor het oplossen van problemen

Er zijn een aantal problemen met gegevensbronnen die u niet direct kunt oplossen.

Wanneer u de structuur voor een database importeert en de database meer dan 1000 tabellen bevat, krijgt u een foutbericht met het advies de tabellijst te filteren. U kunt deze fout op een van de volgende manieren omzeilen:

De JDBC-gegevensbron bewerken en een schemafilter invoeren.

De machtigingen wijzigen die zijn gekoppeld aan de aanmelding die u gebruikt om toegang te krijgen tot de server, zodat er minder tabellen toegankelijk zijn via die aanmelding.

Wanneer u de structuur van een Oracle-database importeert, worden de volgende schema's niet geïmporteerd als onderdeel van de structuur:

CTXSYS, MDSYS, SYSTEM, SYS,

and

XDB

. Dit zijn systeemschema's van Oracle en ze zijn niet nodig voor gegevensintegratie.

Wanneer u de structuur van een MS SQL-database importeert, worden de volgende schema's niet geïmporteerd als onderdeel van de structuur: INFORMATION_SCHEMA en sys. Dit zijn MS SQL-systeemschema's die niet nodig zijn voor gegevensintegratie.