{
"id": "BE05",
"title": "Import wizard",
"topic": "bulk-editing",
"use": "Create records from a file someone else made. The file comes first, then the mapping of its columns, then the preview with the rows that do not fit, and only at the end the import. Whoever gets a file of the same layout every time needs no mapping — an upload with a result report is enough.",
"decisions": [
"The import is an ed-wizard of four steps in a fixed order — File, Mapping, Preview, Import: the records are not typed but taken over, so the work shifts from filling in to checking — map the columns, find the faulty rows, confirm the scope — and each step settles what the next one works on.",
"Nothing is written before the last step: the preview shows what will arrive and names the rows that will not go through, because what slips through here stands in the register afterwards.",
"The wizard is the screen, not a dialog over a list — a departure from the wizard's preferred home: the preview is a table of every row in the file and needs the room.",
"The columns it recognizes are preset, and the hint marks each as a suggestion until the user chooses by hand: a suggestion that looks like a choice is taken over without a look. The hint carries it rather than the select's AI state, a departure from the select's rules, because a header match is no model's guess.",
"A column nobody recognizes starts at Do not import: a guessed field writes a wrong value into every row, while leaving the column out loses nothing a choice cannot add back.",
"The preview counts the rows, those it imports and those with errors, gives every row its finding — a badge for a row with an error, plain text for one that goes in, because the badge marks the exception and not the norm — and offers the rows with errors as a list to download with their reasons: the user sees what arrives before answering for it, and whoever corrects the file needs the rows, not a number.",
"Rows with errors are skipped, not the whole import stopped, and the screen says so before the run and during it: a partial import needs a rule the user understands.",
"The button that starts the run names what it does — Import 244 rows, not Finish — so own buttons in the wizard's nav slot replace its built-in ones: the number is the scope the user confirms.",
"After the run, the way to the result stands where that button was — Show the 244 employees — not only a message that it worked: the next question is whether the employees have arrived as they should.",
"Once the run has started, Back is unavailable and the footer says why — a departure from the wizard's rule never to block it: the rows are written, and going back would offer them a second time."
],
"try": [
{
"do": "Look at the File step",
"then": "the file is chosen and shows its name and size, the delimiter is read from it, and the chain above names all four steps"
},
{
"do": "Choose Next",
"then": "every column of the file has a field, preset from its header and marked as a suggestion; Remark, which nobody recognizes, starts at Do not import"
},
{
"do": "Choose Last name for column F",
"then": "its hint is gone, as the value now comes by hand; both columns say they share the field, and the footer says why Next waits"
},
{
"do": "Set column F back to Do not import and choose Next",
"then": "the preview counts 248 rows — 244 to import, and 4 with errors that are skipped — and every row says what becomes of it"
},
{
"do": "Choose Download error list",
"then": "the four rows come as a file, each with its row number and its reason"
},
{
"do": "Choose Back twice",
"then": "the mapping and the file are as you left them — the preview is step three, and File and Mapping lie before it"
},
{
"do": "Go on to the preview and choose Import 244 rows",
"then": "the last step says that the rows with errors stay in the error list, the bar runs, and at the end Show the 244 employees stands where the button was; Back is unavailable now, and the footer says why"
}
],
"revision": 1,
"changes": [],
"reviewed": false,
"source": "\n\n\n \n \n
File
\n \n \n \n \n\n \n \n \n\n \n \n \n\n \n \n \n\n \n \n \n \n Back\n Next\n \n \n \n Download error list\n \n
\n\n\n\n\n",
"page": "https://test-apps.eurodata.de/a/eurodata-ui/docs/patterns/bulk-editing/be05-import-wizard/",
"topicPage": "https://test-apps.eurodata.de/a/eurodata-ui/docs/patterns/bulk-editing/"
}