Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/utdanningsdirektoratet/xmldataimport
XmlDataImport kjører test data inn i en SQL Server database for datadreven automatiske tester eller debugging. Verktøyet kan brukes enten fra kommandolinje eller inn i en automatiserte test.
https://github.com/utdanningsdirektoratet/xmldataimport
sqlserver test-automation testdata
Last synced: 26 days ago
JSON representation
XmlDataImport kjører test data inn i en SQL Server database for datadreven automatiske tester eller debugging. Verktøyet kan brukes enten fra kommandolinje eller inn i en automatiserte test.
- Host: GitHub
- URL: https://github.com/utdanningsdirektoratet/xmldataimport
- Owner: Utdanningsdirektoratet
- License: mit
- Created: 2017-11-28T10:59:30.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2023-04-13T17:39:54.000Z (almost 2 years ago)
- Last Synced: 2024-11-11T11:20:13.342Z (3 months ago)
- Topics: sqlserver, test-automation, testdata
- Language: C#
- Homepage: https://www.nuget.org/packages/XmlDataImport/
- Size: 201 KB
- Stars: 0
- Watchers: 4
- Forks: 1
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# xmldataimport
XmlDataImport kjører test data inn i en SQL Server eller Oracle database for datadreven automatiske tester. Verktøyet kan brukes enten fra kommandolinje eller inn i en automatiserte test.
Verktøyet støtter:
- innsetting og sletting
- forskjellige datatyper
- funksjoner
- variable
- fremmende nøkler
- Sql Server og Oracle
XmlDataImport forenkler oppretting og vedlikehold av automatiserte data-drevet tester. Det en spesielt nyttig for testdekning når en del av løsningens logikk ligger i lagrete prosedyrer.
Fra SQL Server Management Studio er det lett å ekstraher XML test data for bruk med verktøyet
## Enhetstest
### Eksempel bruk i en enhetstest
[TestClass]
public class UserTest
{
private static XmlInsert _xmlDataImport;
[ClassInitialize]
public static void ClassInitialize(TestContext testContext)
{
_xmlDataImport = new XmlInsert(false, TestConstants.TestDataDir + "\\xmld\\Application\\status.xmld");
}
[ClassCleanup]
public static void ClassCleanup()
{
_xmlDataImport.Dispose();
}
[TestMethod]
public void must_block_status_change_when_excluded_subject_code()
{
var referenceDateTime = DateTime.Parse("2016-01-07T09:00:00");
### Forklaring av anbefalt bruk i en enhetstest
1. Kjør data inn bare en gang per testkjøring i ```ClassInitialize```.
1. Slett data bare en gang i ```ClassCleanup```.
## Kommandolinje
### Bruk fra kommandolinje
Bruk med en enkel xmld fil:
```UDir.XmlDataImport.Console.exe .\examplexmld\Persons.xmld```
Bruk med flere xmld filer:
```UDir.XmlDataImport.Console.exe .\examplexmld\Persons.xmld .\examplexmld\under\othertable.xmld```
Bruk med en mappe (kjør inn data fra alle .xmld filer i mappen):
```UDir.XmlDataImport.Console.exe .\examplexmld\```
Bruk med flere mapper:
```UDir.XmlDataImport.Console.exe .\examplexmld\ .\examplexmld\under\```
## Konfigurasjon
### App.config
Når du kjører XmlDataImport i en test eller fra kommando linjen, må du ha litt konfigurasjon i din App.config fil. Du må legge en ```connectionString``` element inn i ```connectionStrings```. Du må også legg til en referanse til connectionString'en i en ```DBInstanceName``` setting blant ````appSettings````:
Parameteren ```ignoreNoChange``` styrer oppførsel når det blir ingen endring i databasen etter du har lanserert XmlDataImport. Dersom parameter er satt til true, så vil du få en varsel når kjøring resulterer i ingen endring:
No records inserted. There were 0 statements issued against the DB. Paths used: Persons.xmld
Velg den riktige ``connectionString`` for din database (Sql Server eller Oracle)
## XMLD fil
### XMLD fil eksempel
Declare @studentId int = 123
DECLARE @Group uniqueidentifier = 'EB26BB94-51D6-4507-9057-4F3CC52D0821';
DELETE FROM Answers WHERE Group = @Group;
DELETE FROM Answers WHERE DeliveryTime > '2007-10-04T12:10:00.000';
1a2c8a68-c1de-4c9d-ad52-353c59f52f7b
(select cast(N'' as xml).value('xs:base64Binary("JVBERigoyNTcyMgolJUVPRgo=")', 'varbinary(max)'))
EB26BB94-51D6-4507-9057-4F3CC52D0821
Gruppe med veeeeldig langt navn;EV;NOR1033;Norsk tegnspråk
2007-10-05T12:10:00.000
123
6
1a2c8a68-c1de-4c9d-ad52-353c59f5zzz
(select cast(N'' as xml).value('xs:base64Binary("JVBERigoyNTcyMgolJUVPRgo=")', 'varbinary(max)'))
EB26BB94-51D6-4507-9057-4F3CC52D0821
Gruppe med veeeeldig langt navn;EV;NOR1033;Norsk tegnspråk
GETDATE()
@studentId
1
### Forklaringer rundt XMLD eksempel fil struktur
En XLMD fil innholder:
1. En ```````` tag på begynnelse og slut
1. Valgfritt ```````` tag som inneholder deklarasjoner av variabler. Variablene er tilgjengelig innenfor __alle__ andre taggene.
1. En valgfrit ```````` tag med SQL som innhold. Applikasjonen kjører denne SQL i en egen transaksjon **før** innsetting av tabell data.
1. En valgfrit ```````` tag med opprydding SQL som innhold. Applikasjonen kjører denne SQL i en egen transaksjon **før** og **etter** innsetting av tabell data.
1. En valgfrit ```````` tag med opprydding SQL som innhold. Applikasjonen kjører denne SQL i en egen transaksjon **på siste**.
1. Data fra en eller flere tabeller. Bruk ```````` som tag (f.eks ````````).
1. Kolonne data innenfor hver ```````` tag. Hvis du vil ikke innsette data for en gitt kolonne bare ikke legg inn taggen for kolonnen blant kolonner for tabellen.
### Kolonner
#### Kolonne data type
- Vanligvis er kolonne innehold tolket som string.
- Unntak er kolonner:
- som inneholder funksjoner (f.eks. ```GETDATE()```)
- som inneholder ekspresjoner mellom parenteser (f.eks. ```(select cast(N'' as xml).value('xs:base64Binary("JVBERigoyNTcyMgolJUVPRgo=")```)
Bruk funksjoner eller ekspresjoner når du ikke vil innsette kolonneverdien som en string: (```Convert(uniqueidentifier, '12345678-1234-1234-1234-123456789123')```)
For Oracle, for dato kolonner, bruk:
TO_DATE('2003/07/09', 'yyyy/mm/dd')
#### Håndtering av kolonner med fremmede nøkler
Bruk en ```SELECT``` mellom ```(...)```:
1a2c8a68-c1de-4c9d-ad52-353c59f52f7b
(select cast(N'' as xml).value('xs:base64Binary("JVBERigoyNTcyMgolJUVPRgo=")', 'varbinary(max)'))
EB26BB94-51D6-4507-9057-4F3CC52D0821
Gruppe med veeeeldig langt navn;EV;NOR1033;Norsk tegnspråk
(SELECT AnswerId FROM Answers WHERE Group = 'EB26BB94-51D6-4507-9057-4F3CC52D0821')
Convert(varbinary, 'PD94bWwgdmVyc2lvbj0iMS4wIj8+DQo8T3ucz4=')
1974-12-31T12:10:00.000
2
### Variabler
Du kan, om du vil, definere SQL variabler inn i ```````` tag:
Declare @age int = 12
For Oracle, bruk:
DECLARE p_age numeric(10) := 12; emp_id NUMBER(8,2) := 207;
Om du bruker variable inn i `````` elementene, da bruk parenteser rundt variable navn:
3
Ærild
Smith
(p_age)
Disse variablene skal være tilgjengelig i alle andre steder (````````, ````````, ```````` og også inn i ``````).
Verktøyet også støtter en helt annen slags variable du kan skytte inn fra din enhetstestskode. Denne kan til å med brukes med en Oracle database. Du kan definere variabler i en dictionary argument sendt inn i konstruktøren til XmlInsert:
_xmlDataImport = new XmlInsert(true,
new Dictionary { { "StudentId", _studentId } }, //Variable i XMLD fil
TestConstants.TestDataDir + "\\xmld\\Application\\status.xmld");
Variabler skal benyttes i ```variable()``` ekspresjoner inn i XMLD filen:
DELETE FROM Answers WHERE StudentId = variable('StudentId');
1a2c8a68-c1de-4c9d-ad52-353c59f52f7b
(select cast(N'' as xml).value('xs:base64Binary("JVBERigoyNTcyMgolJUVPRgo=")', 'varbinary(max)'))
EB26BB94-51D6-4507-9057-4F3CC52D0821
Gruppe med veeeeldig langt navn;EV;NOR1033;Norsk tegnspråk
2016-01-08T09:00:00
variable('StudentId')
Om du vil ha en annen datatype enn string, da kan du benytte SQL ```Convert()``` funksjonen:
Convert(int, variable('Number1'))
Variabler er nyttige for å kunne bruke den samme XMLD fil i forskjellige test scenarier med forskjellige data. I dette tilfelle bruk XmlInsert i en ```using(...) ``` statement inn i din test metode:
public void GetAnswer_must_retrieve_expected_answer()
{
var firstCandidateNumber = "123";
var firstCandidateStatus = "8";
var answer = new Answer(new User(), null);
var group = new Guid("9BA98065-0D07-4360-B2D4-B6198B8D1082");
using (new XmlInsert(false,
new Dictionary
{
{"FirstCandidateNumber", firstCandidateNumber},
{"FirstCandidateStatus", firstCandidateStatus}
},
TestConstants.TestDataDir + "\\xmld\\web\\Application\\answer.xmld"))
{
var answerList = answer.GetAnswer(candidategroupCode, firstCandidateNumber;
Assert.IsTrue(answerList.Count >= 2,
"Failed to retreive expected answers.");
}
}
### Enkelt oppretting av XML data filer fra SQS Management Studio
Du kan hente opp nesten automatisk riktig formatert data fra SQL Server som XML med bruk av en sånn forespørsel:
SELECT TOP 1 * FROM Schools
FOR XML PATH('Schools'), ROOT('Root')
Resultat:
9876
Blabla School
Larvik
Om du har auto-genererte id'er i din database, bare slett dem og verktøyet vil ikke prøve å legger inn en verdi for kolonnen:
Blabla School
Larvik
## Oppretting av XML data filer med Oracle
Du kan bruke følge denne guide for å hente ut XML data fra en Oracle database.
Du kan bruke den følgende møt den standard Oracle HR example schema:
SELECT XMLElement("Root",
XMLAgg(XMLElement("Persons",
XMLForest(FIRSTNAME, LASTNAME, AGE))))
FROM PERSONS;
SELECT XMLElement("Root",
XMLAgg(XMLElement("Jobs",
XMLForest(PersonID, PositionID, Description, Location))))
FROM Jobs;
NB: For at dette skal kjøre denne SQL, i, for eksempel DBeaver, trenger å refererer til xdb6.jar og xmlparserv2.jar i dine driver instillinger. Se diskusjon som forklarer hvordan du kan få takk i disse bibliotekene her: https://stackoverflow.com/a/28106846