Nastavte definice výměny dat
Business Central můžete nastavit pro výměnu dat ve specifických tabulkách s daty o externích souborech. Například pro odesílání a přijímání elektronických dokumentů, import a export bankovních dat nebo jiných dat, jako jsou mzdy a katalogy položek. Další informace najdete na Elektronická výměna dat.
Chcete-li vytvořit definici výměny dat pro datový soubor nebo proud, můžete pomocí souvisejícího schématu XML definovat, které datové prvky mají být zahrnuty do Definice sloupců FastTab. Viz krok 6 v Popis formátování řádků a sloupců v souboru. Další informace naleznete na stránce Použití schémat XML k přípravě definic výměny dat.
Normálně nastavujete definice výměny dat na stránce Definice výměny dat . Pro aktualizaci směnných kurzů je však rychlejší použít službu směnných kurzů. Další informace naleznete na stránce Aktualizace směnných kurzů.
Poznámka
Pokud je převáděný soubor ve formátu XML, výraz "sloupec" v tomto článku by měl být interpretován jako "prvek XML obsahující data".
Tento článek obsahuje následující postupy:
- Vytvořte definici výměny dat.
- Exportujte definici výměny dat jako soubor XML pro použití ostatními.
- Importujte soubor XML pro existující definici výměny dat.
Vytvořte definici výměny dat
Vytvoření definice výměny dat zahrnuje dva úkoly:
- Na stránce Definice výměny dat popište formátování řádků a sloupců v souboru. Další informace naleznete v části Popis formátování řádků a sloupců v sekci soubor .
- Na stránce Mapování výměny dat namapujte sloupce v datovém souboru na pole v Business Central. Další informace naleznete v části Mapování sloupců v datovém souboru na pole v části Business Central .
Popisuje formátování řádků a sloupců v souboru
Vyberte ikonu
, zadejte Definice výměny dat a poté vyberte související odkaz.Vyberte akci Nová .
Na rychlé záložce Obecné popište definici výměny dat a typ datového souboru vyplněním polí, jak je popsáno v následující tabulce.
Pole Definice Kód Zadejte kód pro identifikaci definice výměny dat. Jméno Zadejte název definice výměny dat. Typ souboru Určete, pro jaký typ souboru se používá definice výměny dat. Můžete si vybrat ze čtyř typů souborů:
- XML: Vrstvené řetězce obsahu a značek obklopené značkami označujícími funkci.
- Proměnný text: Záznamy mají proměnnou délku a jsou odděleny znakem, jako je čárka nebo středník, známé také jako soubor s oddělovači.
- Pevný text: Záznamy mají stejnou délku, používají znaky pad a každý záznam je na samostatném řádku, také známý jako soubor s pevnou šířkou.
- Json: Vrstvené řetězce obsahu v JavaScriptu.Typ Určete, pro jaký typ obchodní činnosti se definice výměny dat používá, například Export plateb. Kódová jednotka pro zpracování dat Zadejte proceduru, která přenáší data do az tabulek v Business Central. Ověřovací kódovací jednotka Zadejte proceduru, která se používá k ověření dat proti předdefinovanému obchodní pravidla. Kodex pro čtení/zápis Zadejte proceduru, která zpracovává importovaná data před mapováním a exportovaná data poté. Čtení/Psaní XMLport Zadejte XMLport , přes který importovaný datový soubor nebo služba vstupuje před mapováním a přes který jsou exportovaná data zapsána do datového souboru nebo služby poté. Ext. Kódová jednotka pro zpracování dat Zadejte proceduru, která přenáší externí data dovnitř a ven z rámce výměny dat. Jednotka zpětné vazby uživatele Zadejte proceduru, která po mapování provádí různá čištění, například označí řádky jako exportované a odstraní dočasné záznamy. Kódování souborů Zadejte kódování souboru. Poznámka: Toto pole je relevantní pouze pro import. Oddělovač sloupců Určete, jak jsou sloupce v datovém souboru odděleny, pokud je soubor typu Proměnný text. Řádky záhlaví Určete, kolik řádků záhlaví v souboru existuje.
Toto nastavení zajistí, že nebudou importována data záhlaví. Poznámka: Toto pole je relevantní pouze pro import.Značka záhlaví Pokud řádek záhlaví existuje na několika pozicích v souboru, zadejte text prvního sloupce na řádku záhlaví.
Tato možnost zajistí, že nebudou importována data záhlaví. Poznámka: Toto pole je relevantní pouze pro import.Značka zápatí Pokud řádek zápatí existuje na několika pozicích v souboru, zadejte text prvního sloupce na řádku zápatí.
Tato možnost zajistí, že data zápatí nebudou importována. Poznámka: Toto pole je relevantní pouze pro import.Tip
Chcete-li zjistit, které procedurální jednotky Microsoft používá ve stávajících definicích ve standardním produktu, projděte si tři Codeunit pole v Mapování polí stránce pod Obecné FastTab, pro každou definici.
Na rychlé záložce Definice řádků popište formátování řádků v datovém souboru vyplněním polí, jak je popsáno v následující tabulce.
Poznámka
Pro import bankovních výpisů vytvoříte pouze jeden řádek pro jeden formát souboru bankovního výpisu, který chcete importovat.
Pro export plateb můžete vytvořit řádek pro každý typ platby, který chcete exportovat. V takovém případě Definice sloupců FastTab zobrazuje různé sloupce pro každý typ platby.
Pole Popis Typ čáry Určuje typ řádku v souboru. Kód Zadejte kód pro identifikaci řádku v souboru. Jméno Zadejte název, který popisuje řádek v souboru. Počet sloupců Určete, kolik sloupců má řádek v datovém souboru. Poznámka: Toto pole je relevantní pouze pro import. Značka datového řádku Zadejte pozici prvku, který představuje hlavní položku datového souboru, v souvisejícím schématu XML. Poznámka: Toto pole je relevantní pouze pro import. Jmenný prostor Chcete-li povolit ověření jmenného prostoru, zadejte jmenný prostor, který se očekává v souboru. Pokud nechcete povolit ověřování jmenného prostoru, můžete toto pole nechat prázdné. nadřazený Kód Zadejte nadřazený řádku, jak je zobrazeno v poli Kód v případech, kdy je nastavení výměny dat pro soubory s nadřazený a podřízené položky, jako je záhlaví dokumentu a řádky. Opakováním krok 4 vytvořte řádek pro každý typ dat souboru, který chcete exportovat.
Pokračujte v popisu formátování sloupců v datovém souboru vyplněním polí na Definice sloupců FastTab, jak je popsáno v tabulce v krok 8. Pro předvyplnění pevné záložky příslušnými prvky můžete pro datový soubor použít soubor struktury, jako je soubor .xsd. Další informace naleznete na stránce Použití schémat XML k přípravě definic výměny dat.
Na rychlé záložce Definice sloupců vyberte akci Získat strukturu souboru .
Na stránce Získat strukturu souboru vyberte související soubor struktury a poté zvolte OK. Řádky na Definice sloupců FastTab jsou vyplněny podle struktury datového souboru.
Na rychlé záložce Definice sloupců upravte nebo vyplňte pole podle popisu v následující tabulce.
Pole Popis Sloupec č. Zadejte číslo, které odráží pozici sloupce na řádku v souboru.
U souborů XML zadejte číslo, které odráží typ prvku v souboru, který obsahuje data.Jméno Zadejte název sloupce.
U souborů XML zadejte označení, které označuje data, která mají být vyměněna.Typ dat Zadejte, zda jsou data, která mají být vyměňována, typu Text, Datum nebo Desetinné. Formát dat Zadejte formát dat, pokud existují. Například MM-dd-rrrr pokud je typ dat Datum. Poznámka: Pro export určete formát dat podle Business Central. Pro import určete formát dat podle .NET Framework. Další informace naleznete na stránce Standardní řetězce formátu data a času. Kultura formátování dat Zadejte regionální formát dat, pokud existuje. Například en-US pokud je datový typ Desetinné , abyste zajistili, že čárka bude použita jako 0,000 oddělovač podle amerického formátu. Další informace naleznete na stránce Standardní řetězce formátu data a času. Poznámka: Toto pole je relevantní pouze pro import. Délka Pokud je datový soubor typu Pevný text, zadejte délku čáry s pevnou šířkou, která obsahuje sloupec. Popis Určuje popis sloupce pro informační účely. Cesta Zadejte polohu prvku v souvisejícím schématu XML. Identifikátor záporného znaménka Zadejte hodnotu, která se používá v datovém souboru k identifikaci záporných částek v datových souborech, které nemohou obsahovat záporná znaménka. Tento identifikátor se pak používá k obrácení identifikovaných množství na záporná znaménka během importu. Poznámka: Toto pole je relevantní pouze pro import. Konstantní V tomto sloupci zadejte všechna data, která chcete exportovat, například další informace o typu platby. Poznámka: Toto pole je relevantní pouze pro export. Je vyžadováno odsazení textu Určete, že data musí obsahovat odsazení textu. Pad Character Zadejte znak odsazení textu. Zarovnání Určete, zda je zarovnání sloupce vlevo nebo vpravo. Opakujte krok 8 pro každý sloupec nebo prvek XML v datovém souboru, který obsahuje data, která chcete vyměnit s Business Central.
Dalším krok při vytváření definice výměny dat je rozhodnout, které sloupce nebo prvky XML v datovém souboru mapují na která pole v Business Central.
Poznámka
Konkrétní mapování závisí na obchodním účelu datového souboru, který se má vyměňovat, a na místních variacích. Dokonce i bankovní standard SEPA má místní odchylky. Business Central podporuje import souborů bankovních výpisů SEPA CAMT ihned po vybalení. To je reprezentováno SEPA CAMT kódem záznamu definice výměny dat na stránce Definice výměny dat . Informace o konkrétním mapování polí této podpory SEPA CAMT naleznete v části Mapování polí při importu souborů SEPA CAMT.
Chcete-li namapovat sloupce v datovém souboru na pole v Business Central
Tip
Někdy se hodnoty v polích, která chcete mapovat, liší. Například v jedné obchodní aplikaci je kód jazyka pro Spojené státy americké, ale v jiné je to „USA“. To znamená, že při výměně dat musíte transformovat hodnotu. To se děje prostřednictvím transformačních pravidel, která definujete pro pole. Další informace najdete na Transformační pravidla.
Můžete také seskupit podle libovolného pole, použít index klíče k řazení výsledků a nové typy transformací zaokrouhlování a Vyhledávání pole.
Na rychlé záložce Definice řádků vyberte řádek, pro který chcete namapovat sloupce na pole, a poté vyberte Mapování polí. Otevře se stránka Mapování výměny dat .
Na rychlé záložce Obecné zadejte nastavení mapování vyplněním polí, jak je popsáno v následující tabulce.
Pole Popis ID tabulky Zadejte tabulku, která obsahuje pole, do kterých nebo ze kterých se vyměňují data podle mapování. Použít jako mezitabulku Určete, zda tabulka, kterou vyberete v poli ID tabulky , je přechodnou tabulkou, kde jsou uložena importovaná data před mapováním do cílové tabulky.
Zprostředkující tabulku obvykle používáte, když definice výměny dat importuje a převádí elektronické dokumenty v Business Central. Například dokumenty, jako jsou faktury dodavatele, do nákupních faktur. Další informace najdete na Elektronická výměna dat.Jméno Zadejte název nastavení mapování. Klíčový index Před exportem určete index klíče pro řazení zdrojových záznamů. Pre-Mapping Codeunit Zadejte proceduru, která připraví mapování mezi poli v Business Central a externími daty. Mapovací kódová jednotka Zadejte proceduru, která se používá k mapování zadaných sloupců nebo datových prvků XML na pole v Business Central. Kódová jednotka po mapování Zadejte proceduru, která dokončí mapování mezi poli v Business Central a externími daty. Poznámka: Když použijete funkci rozšíření AMC Banking 365 Fundamentals , procedura převede exportovaná data z Business Central do obecného formátu, který je připraven k exportu. Pro import převede procedura externí data do formátu, který je připraven k importu do Business Central. Na rychlé záložce Mapování polí určete, které sloupce mapují ke kterým polím v Business Central, vyplněním polí, jak je popsáno v následujících tabulkách, v závislosti na tom, zda Použít jako mezilehlou tabulku bylo nebo nebylo povoleno.
S vypnutým přepínačem Použít jako přechodnou tabulku :
Pole Popis Sloupec č. Určete, pro který sloupec v datovém souboru chcete definovat mapu.
Na rychlé záložce Definice sloupců na stránce Definice výměny dat můžete vybrat pouze sloupce, které jsou reprezentovány čarami.Popis sloupce Pokud pro import dat používáte přechodnou tabulku, zadejte popisek sloupce v externím souboru, který je namapován na pole v poli ID cílové tabulky . ID pole Určete, na které pole se má sloupec v poli Číslo sloupce mapovat.
Můžete vybírat pouze z polí, která existují v tabulce, která jste zadali v poli ID tabulky v poli Obecné FastTab.Popisek pole Pokud pro import dat používáte přechodnou tabulku, zadejte titulek pole v externím souboru, který je mapován na pole v poli ID cílové tabulky . Volitelný Určete, zda má být mapa přeskočena, pokud je pole prázdné. Pokud tuto možnost nevyberete, dojde v případě, že je pole prázdné, k chybě exportu. Transformační pravidlo Zadejte pravidlo, které transformuje importovaný text na podporovanou hodnotu, než jej lze namapovat na zadané pole. Když v tomto poli vyberete hodnotu, stejná hodnota se zadá do pole Transformační pravidlo v Výměna dat. Field Mapping Buf. tabulka a naopak. Chcete-li se dozvědět více o tom, jak aplikovat transformační pravidla, přejděte na Transformační pravidla. Přepsat hodnotu Určete, že nová hodnota může přepsat aktuální hodnotu. Přednost Zadejte pořadí, ve kterém musí být mapování polí zpracováno. Nejprve je zpracováno mapování pole s nejvyšší prioritou. Násobitel Zadejte násobitel, který se má použít na číselná data, včetně záporných hodnot. Se zapnutým přepínačem Použít jako mezilehlou tabulku :
Pole Popis Sloupec č. Určete, pro který sloupec v datovém souboru chcete definovat mapu.
Na rychlé záložce Definice sloupců na stránce Definice výměny dat můžete vybrat pouze sloupce, které jsou reprezentovány čarami.Popis sloupce Pokud pro import dat používáte přechodnou tabulku, zadejte popisek sloupce v externím souboru, který je namapován na pole v poli ID cílové tabulky . ID cílové tabulky Určete tabulku, na kterou je mapována hodnota v poli Popis sloupce , když pro import dat používáte přechodnou tabulku. Popis tabulky Zadejte název tabulky do pole ID cílové tabulky , což je tabulka, jejíž hodnota v Popis sloupce pole je mapováno na, když pro import dat používáte přechodnou tabulku. ID cílového pole Určete pole v cílové tabulce, na které je mapována hodnota v poli Popis sloupce , když pro import dat používáte přechodnou tabulku. Popisek pole Pokud pro import dat používáte přechodnou tabulku, zadejte název pole v cílové tabulce, na které je mapována hodnota v poli Popis sloupce . Pouze ověřit Určete, že mapa element-to-field se nepoužívá k převodu dat, ale pouze k ověření dat. Transformační pravidlo Zadejte pravidlo, které transformuje importovaný text na podporovanou hodnotu, než jej lze namapovat na zadané pole. Když v tomto poli vyberete hodnotu, stejná hodnota se zadá do pole Transformační pravidlo v Výměna dat. Field Mapping Buf. tabulka a naopak. Chcete-li se dozvědět více o transformačních pravidlech, přejděte na Transformační pravidla. Přednost Zadejte pořadí, ve kterém musí být mapování polí zpracováno. Nejprve je zpracováno mapování pole s nejvyšší prioritou.
Na rychlé záložce Seskupování polí určete pravidla, která chcete použít k seskupování polí při vytváření souboru vyplněním polí, jak je popsáno v následující tabulce.
Pole Popis ID pole Zadejte číslo pole v externím souboru, které se používá pro seskupování, a že uživatel musí toto pole nastavit. Popisek pole Zadejte titulek pole v externím souboru, který se používá pro seskupování.
Pravidla transformace
Pokud se hodnoty v polích, která mapujete, liší, musíte použít transformační pravidla pro definice výměny dat, aby byly stejné. Pravidla transformace pro definice výměny dat definujete otevřením existující definice nebo vytvořením nové definice a poté na rychlé záložce Definice řádků vyberte Spravovat a poté Mapování pole. K dispozici jsou předdefinovaná pravidla, ale můžete si také vytvořit vlastní. Následující tabulka popisuje typy transformací, které můžete provádět.
| Volba | Popis |
|---|---|
| Velká písmena | Všechna písmena velká. |
| Malá písmena | Udělejte všechna písmena malá. |
| Název případ | U každého slova napiš první písmeno velkým písmenem. |
| Oříznout | Odstraňte prázdná místa před a za hodnotou. |
| Podřetězec | Transformujte určitou část hodnoty. Chcete-li určit, kde má být transformace zahájena, vyberte buď a Počáteční pozice nebo Počáteční text. Počáteční pozice je číslo, které představuje první transformovaný znak. Počáteční text je písmeno bezprostředně před písmenem, které má být nahrazeno. Pokud chcete začít prvním písmenem hodnoty, použijte místo toho počáteční pozici. Chcete-li určit, kde se má transformace zastavit, vyberte buď Délku, což je počet znaků, které se mají nahradit, nebo Konečný text, což je znak, který je bezprostředně za posledním znakem, který se má transformovat. |
| Nahradit | Najděte hodnotu a nahraďte ji jinou. Tato transformace je užitečná pro nahrazení jednoduchých hodnot, jako je konkrétní slovo. |
| Regulární výraz – nahradit | Použijte regulární výraz jako součást operace hledání a nahrazení. Tato transformace je užitečná pro nahrazení více nebo složitějších hodnot. |
| Odstraňte nealfanumerické znaky | Odstraňte znaky, které nejsou písmeny nebo číslicemi, jako jsou symboly nebo speciální znaky. |
| Formátování data | Určete způsob zobrazení dat. Můžete například transformovat DD-MM-RRRR na RRRR-MM-DD. |
| Desetinné formátování | Definujte pravidla pro umístění v desítkové soustavě a přesnost zaokrouhlování. |
| Regulární výraz – shoda | Chcete-li najít jednu nebo více hodnot, použijte regulární výraz. Toto pravidlo je podobné možnostem Podřetězec a Regulární výraz – nahradit . |
| Zvyk | Toto pravidlo transformace je pokročilá možnost, která vyžaduje pomoc vývojáře. Umožňuje integrační událost, ke které se můžete přihlásit, pokud chcete použít svůj vlastní transformační kód. Pokud jste vývojář a chcete tuto možnost použít, přejděte na Tip pro vývojáře: Příklad vlastní možnosti. |
| Formátování data a času | Definujte způsob zobrazení aktuálního data a denního času. |
| Vyhledávání v poli | Použijte pole z různých tabulek. Chcete-li jej používat, musíte dodržovat některá pravidla. Nejprve pomocí ID tabulky zadejte ID tabulky, která obsahuje záznam pro vyhledávání pole. Potom v poli ID zdrojového pole zadejte ID pole, které obsahuje záznam pro vyhledávání pole. Nakonec v poli ID cílového pole zadejte ID pole, abyste našli záznam pro vyhledávání pole. Volitelně použijte pole Pravidlo vyhledávání v poli k určení typu vyhledávání pole. Pro pole Cíl se použije hodnota z ID cílového pole , i když je prázdné. Pro pole Původní, pokud je cíl prázdný , se použije původní hodnota, pokud je cíl prázdný. |
| Kolo | Zaokrouhlete hodnotu v tomto poli pomocí dalších pravidel. Nejprve do pole Přesnost zadejte přesnost zaokrouhlování. Poté v poli Směr zadejte směr zaokrouhlování. |
Poznámka
Další informace o formátování data a času naleznete na stránce Standardní řetězce formátu data a času.
Tip pro vývojáře: Příklad vlastní možnosti
Následující příklad ukazuje, jak implementovat svůj vlastní transformační kód.
codeunit 60100 "Hello World"
{
[EventSubscriber(ObjectType::Table, Database::"Transformation Rule", 'OnTransformation', '', false, false)]
procedure OnTransformation(TransformationCode: Code[20]; InputText: Text; var OutputText: Text)
begin
if TransformationCode = 'CUST' then
OutputText := InputText + ' testing';
end;
}
Po definování pravidel je můžete otestovat. Na rychlé záložce Test zadejte příklad hodnoty, kterou chcete transformovat, a poté zkontrolujte výsledky výběrem možnosti Aktualizovat.
Exportujte definici výměny dat jako soubor XML pro použití ostatními
Po vytvoření definice výměny dat pro konkrétní datový soubor můžete exportovat definici výměny dat jako soubor XML, který můžete importovat. Tento úkol je popsán v následujícím postupu.
Vyberte ikonu
, zadejte Definice výměny dat a poté vyberte související odkaz.Vyberte definici výměny dat, kterou chcete exportovat.
Vyberte akci Exportovat definici výměny dat .
Uložte soubor XML, který představuje definici výměny dat, na vhodné místo.
Pokud již byla vytvořena definice výměny dat, stačí importovat soubor XML do Data Exchange Framework. Tento úkol je popsán v následujícím postupu.
Importujte existující definici výměny dat
- Uložte soubor XML, který představuje definici výměny dat, na vhodné místo.
- Vyberte ikonu , zadejte Definice výměny dat a poté vyberte související odkaz.
- Vyberte akci Importovat definici výměny dat .
- Vyberte soubor, který jste uložili do krok 1.
Viz také
Nastavit výměnu dat
Nastavte elektronické odesílání a přijímání dokumentů
Inkasovat platby pomocí SEPA inkasa
Provádějte platby s AMC Banking 365 Fundamentals prodloužením nebo SEPA převodem
Příchozí dokumenty
Obecná obchodní funkce
Zde najdete bezplatné e-learningové moduly pro Business Central