Import z pliku Xml

Import danych z pliku XML do
programu Budżetowanie Forte
Powielanie w jakiejkolwiek formie całości lub fragmentów podręcznika bez pisemnej zgody
firmy Sage Symfonia Sp. z o.o. jest zabronione.
Copyright© Sage Symfonia Sp. z o.o. Wszelkie prawa zastrzeżone.
All Rights Reserved.
Windows™ jest znakiem towarowym firmy Microsoft Corporation.
Microsoft® SQL Server™ jest znakiem towarowym firmy Microsoft Corporation.
Adobe, Acrobat, Acrobat Reader, Acrobat Distiller są zastrzeżonymi znakami towarowymi
firmy Adobe Systems Inc.
Opracowanie i skład: Sage Symfonia Sp. z o.o.
Warszawa, styczeń 2008
Symbol dokumentu MXBUFV2007P0001
Spis treści
Spis treści
I
Opis formatu.................................................................................................................................................... 0-1
Korzeń dokumentu ........................................................................................................................................ 0-1
Symbole czy Guid-y ...................................................................................................................................... 0-1
Typ wielkości budżetowej ............................................................................................................................. 0-1
Wielkości budżetowe..................................................................................................................................... 0-3
Atrybuty......................................................................................................................................................... 0-4
Opis formatu
Korzeń dokumentu
Każdy plik XML musi mieć następującą strukturę, a importowane dane muszą zawierać się w elemencie: ‘mxBCImport’ podanym z parametrem ‘xmlns="SageSymfonia”’:
<?xml version="1.0" encoding="utf-8" ?>
<mxBCImport xmlns="SageSymfonia">
…
…
…
</mxBCImport>
Symbole czy Guid-y
Następnie musimy sprecyzować czy ustawiając parametry mapowania odwołujemy się poprzez symbole czy guid-y
Guid (Globally Unique Identifier) – jest używany w tym przypadku jako unikalny identyfikator w
bazie danych.
.Jeżeli odwołujemy się poprzez symbole nasz dokument powinien wyglądać następująco:
<?xml version="1.0" encoding="utf-8" ?>
<mxBCImport xmlns="SageSymfonia">
<mxBCValuesBySymbols>
…
…
…
</mxBCValuesBySymbols>
</mxBCImport>
Jeżeli odwołujemy się poprzez identyfikatory nasz dokument powinien wyglądać następująco:
<?xml version="1.0" encoding="utf-8" ?>
<mxBCImport xmlns="SageSymfonia">
<mxBCValuesByGuids>
…
…
…
</mxBCValuesByGuids>
</mxBCImport>
Typ wielkości budżetowej
Musimy określić typy wielkości budżetowych poprzez element ‘mxBCValue’ z parametrem Symbol
lub Id:
0–2
Import danych z pliku XML do programu Budżetowanie Forte Budżetowanie Forte
Jeżeli odwołujemy się poprzez symbole nasz dokument powinien wyglądać następująco:
<?xml version="1.0" encoding="utf-8" ?>
<mxBCImport xmlns="SageSymfonia">
<mxBCValuesBySymbols>
<mxBCValue Symbol="Sprzedaz_towaru">
…
…
…
</mxBCValue>
</mxBCValuesBySymbols>
</mxBCImport>
Gdzie ‘Symbol’ jest symbolem typu wielkości budżetowej.
Jeżeli odwołujemy się poprzez guid-y nasz dokument powinien wyglądać następująco:
<?xml version="1.0" encoding="utf-8" ?>
<mxBCImport xmlns="SageSymfonia">
<mxBCValuesByGuids>
<mxBCValue Id="E89BEAC6-E187-4dd8-9054-76022510FE82">
…
…
…
</mxBCValue>
</mxBCValuesByGuids>
</mxBCImport>
Gdzie ‘Id’ jest identyfikatorem typu wielkości budżetowej.
W jednym pliku możemy dokonywać importu do wielu różnych typów wielkości budżetowych. Na
przykład:
<?xml version="1.0" encoding="utf-8" ?>
<mxBCImport xmlns="SageSymfonia">
<mxBCValuesBySymbols>
<mxBCValue Symbol="Sprzedaz_towaru">
…
…
…
</mxBCValue>
<mxBCValue Symbol="Zakup_towaru">
…
…
…
MXBUFV2007P0001
Import danych z pliku XML do programu Budżetowanie Forte
0–3
</mxBCValue>
</mxBCValuesBySymbols>
</mxBCImport>
Wielkości budżetowe
Wielkości budżetowe wybieramy poprzez element: ‘SimpleValue’, który posiada parametry przedstawione w tabeli.
Parametr
Value
ValDate
Opis
Wartość
Data, do której przypisywana
jest wprowadzana wartość.
Data wprowadzenia lub
zmodyfikowania wartości.
Ten parametr jest na razie
pomijany. Być może będzie
używany w przyszłości.
Identyfikator dokumentu, z
którego pochodzi wartość.
Numer dokumentu, z którego
pochodzi wartość.
Timestemp
DocId
DocNr
Czy wymagany?
Tak
Tak
Nie
Nie
Nie
Tabela1 Atrybuty elementu ‘SimpleValue’
Przykład:
<?xml version="1.0" encoding="utf-8" ?>
<mxBCImport xmlns="SageSymfonia">
<mxBCValuesBySymbols>
<mxBCValue Symbol="Sprzedaz_towaru">
<SimpleValue
Value="100"
ValDate="2007-03-20T00:00:00"
DocId="65557"
DocNr="0001/07/FVS">
…
…
…
</SimpleValue>
<SimpleValue
Value="200"
ValDate="2007-03-20T00:00:00"
DocId="65557"
DocNr="0001/07/FVS">
…
…
0–4
Import danych z pliku XML do programu Budżetowanie Forte Budżetowanie Forte
…
</SimpleValue>
</mxBCValue>
</mxBCValuesBySymbols>
</mxBCImport>
Atrybuty
Atrybuty dla każdej wielkości budżetowej wybieramy poprzez element ValAttribute, który charakteryzuje się następującymi cechami:
•
•
w przypadku odwołania poprzez symbole posiada parametry:
o
ElementSymbol – symbol elementu słownika
o
DimensionSymbol – symbol kategorii budżetowej
w przypadku odwołania poprzez guid-y posiada parametry:
o
ElementGuid – guid elementu słownika
o
DimensionGuid – guid kategorii budżetowej
Przykład z odwołaniami poprzez symbole:
<?xml version="1.0" encoding="utf-8" ?>
<mxBCImport xmlns="SageSymfonia">
<mxBCValuesBySymbols>
<mxBCValue Symbol="Sprzedaz_towaru">
<SimpleValue
Value="100"
ValDate="2007-03-20T00:00:00"
DocId="65557"
DocNr="0001/07/FVS">
<ValAttribute ElementSymbol="Szczecin"
DimensionSymbol="Osrodki_odpowiedzialnosci" />
<ValAttribute ElementSymbol="towary"
DimensionSymbol="marchewka" />
</SimpleValue>
<SimpleValue
Value="200"
ValDate="2007-03-20T00:00:00"
DocId="65558"
DocNr="0002/07/FVS">
<ValAttribute ElementSymbol="Warszawa"
DimensionSymbol="Osrodki_odpowiedzialnosci" />
<ValAttribute ElementSymbol="towary"
DimensionSymbol="marchewka" />
<ValAttribute ElementSymbol="kontrahent"
MXBUFV2007P0001
Import danych z pliku XML do programu Budżetowanie Forte
DimensionSymbol="Iksinski" />
</SimpleValue>
</mxBCValue>
</mxBCValuesBySymbols>
</mxBCImport>
Przykład z odwołaniami poprzez guid-y:
<?xml version="1.0" encoding="utf-8" ?>
<mxBCImport xmlns="SageSymfonia">
<mxBCValuesByGuids>
<mxBCValue Id="E89BEAC6-E187-4dd8-9054-76022510FE82">
<SimpleValue
Value="100"
ValDate="2007-03-20T00:00:00"
DocId="65557"
DocNr="0001/07/FVS">
<ValAttribute ElementGuid=
"510428E3-B403-457f-B3F2-F2A5DA6D6E6B"
DimensionGuid=
"E8EFDB14-509F-4124-8A2D-9570448CE4BA" />
<ValAttribute ElementGuid=
"C23B4FA9-6D9C-4b50-99BF-1F6AEBBD5E5D"
DimensionGuid=
"B2294674-B942-4725-95A7-0D08BCD90FA4" />
</SimpleValue>
<SimpleValue
Value="200"
ValDate="2007-03-20T00:00:00"
DocId="65558"
DocNr="0002/07/FVS">
<ValAttribute ElementGuid=
"947A7D96-19EC-4d92-9114-E1DE3BF38B0E"
DimensionGuid=
"E8EFDB14-509F-4124-8A2D-9570448CE4BA" />
<ValAttribute ElementGuid=
"B2294674-B942-4725-95A7-0D08BCD90FA4"
DimensionGuid=
"5284AC6D-F1BB-4de7-AF20-876B85E2AE49" />
<ValAttribute ElementGuid=
"2BD99746-41EA-446d-8683-E5581B869804"
DimensionGuid=
0–5
0–6
Import danych z pliku XML do programu Budżetowanie Forte Budżetowanie Forte
"804683D6-17C7-424b-8576-6A699272583E" />
</SimpleValue>
</mxBCValue>
</mxBCValuesByGuids>
</mxBCImport>
W podanych przykładach zaimportowane zostaną następujące wartości sprzedaży towaru:
•
•
Wartość 100 zł o atrybutach
o
Szczecin
o
Marchewka
o
2007-03-20
Wartość 200 zł o atrybutach
o
Warszawa
o
Iksiński
o
Marchewka
o
2007-03-20
MXBUFV2007P0001