{"componentChunkName":"component---smooth-doc-smooth-doc-src-templates-doc-js","path":"/docs/metadata/bulk-import/","result":{"data":{"mdx":{"fields":{"pageType":"doc","title":"Bulk Import","editLink":""},"body":"var _excluded = [\"components\"];\nfunction _extends() { return _extends = Object.assign ? Object.assign.bind() : function (n) { for (var e = 1; e < arguments.length; e++) { var t = arguments[e]; for (var r in t) ({}).hasOwnProperty.call(t, r) && (n[r] = t[r]); } return n; }, _extends.apply(null, arguments); }\nfunction _objectWithoutProperties(e, t) { if (null == e) return {}; var o, r, i = _objectWithoutPropertiesLoose(e, t); if (Object.getOwnPropertySymbols) { var s = Object.getOwnPropertySymbols(e); for (r = 0; r < s.length; r++) o = s[r], t.includes(o) || {}.propertyIsEnumerable.call(e, o) && (i[o] = e[o]); } return i; }\nfunction _objectWithoutPropertiesLoose(r, e) { if (null == r) return {}; var t = {}; for (var n in r) if ({}.hasOwnProperty.call(r, n)) { if (e.includes(n)) continue; t[n] = r[n]; } return t; }\n/* @jsxRuntime classic */\n/* @jsx mdx */\n\nvar _frontmatter = {\n  \"title\": \"Bulk Import\",\n  \"description\": \"bulk import\",\n  \"order\": 30,\n  \"section\": \"Metadata\"\n};\nvar layoutProps = {\n  _frontmatter: _frontmatter\n};\nvar MDXLayout = \"wrapper\";\nreturn function MDXContent(_ref) {\n  var components = _ref.components,\n    props = _objectWithoutProperties(_ref, _excluded);\n  return mdx(MDXLayout, _extends({}, layoutProps, props, {\n    components: components,\n    mdxType: \"MDXLayout\"\n  }), mdx(\"h1\", {\n    \"id\": \"bulk-import\"\n  }, mdx(\"a\", {\n    parentName: \"h1\",\n    \"href\": \"#bulk-import\",\n    \"aria-label\": \"bulk import permalink\",\n    \"className\": \"anchor\"\n  }, mdx(\"svg\", {\n    parentName: \"a\",\n    \"aria-hidden\": \"true\",\n    \"focusable\": \"false\",\n    \"height\": \"16\",\n    \"version\": \"1.1\",\n    \"viewBox\": \"0 0 16 16\",\n    \"width\": \"16\"\n  }, mdx(\"path\", {\n    parentName: \"svg\",\n    \"fillRule\": \"evenodd\",\n    \"d\": \"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"\n  }))), \"Bulk Import\"), mdx(\"h5\", {\n    \"id\": \"biopharma\"\n  }, mdx(\"a\", {\n    parentName: \"h5\",\n    \"href\": \"#biopharma\",\n    \"aria-label\": \"biopharma permalink\",\n    \"className\": \"anchor\"\n  }, mdx(\"svg\", {\n    parentName: \"a\",\n    \"aria-hidden\": \"true\",\n    \"focusable\": \"false\",\n    \"height\": \"16\",\n    \"version\": \"1.1\",\n    \"viewBox\": \"0 0 16 16\",\n    \"width\": \"16\"\n  }, mdx(\"path\", {\n    parentName: \"svg\",\n    \"fillRule\": \"evenodd\",\n    \"d\": \"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"\n  }))), \"[BioPharma]\"), mdx(\"p\", null, \"Metadata fields can be imported from a CSV file in bulk. Values imported from CSV can be mapped to new or existing metadata fields and attached to any file in the Repository.\"), mdx(\"p\", null, \"When importing metadata from CSV, the entries in the first non-empty row will be treated as headers and the subsequent non-empty rows will be treated as metadata values. The values on each row will only be applied to a single file. The import process will attempt to identify the file in the Repository that matches each CSV row using the provided \", mdx(\"a\", {\n    parentName: \"p\",\n    \"href\": \"#file-naming-scheme\"\n  }, \"File Naming Scheme\"), \". Once a file is matched to a row in the CSV, the selected values from the row will be attached to the file according to the field mapping defined.\"), mdx(\"details\", null, mdx(\"summary\", null, \" To import metadata from a CSV file \"), mdx(\"ol\", null, mdx(\"li\", {\n    parentName: \"ol\"\n  }, mdx(\"p\", {\n    parentName: \"li\"\n  }, \"Click on the \", mdx(\"img\", {\n    parentName: \"p\",\n    \"src\": \"/flow/manual/latest/48d4454b8169bfddf1ca97c4c830eaaa/nav-settings.svg\",\n    \"alt\": \"Settings\"\n  }), \" \", mdx(\"strong\", {\n    parentName: \"p\"\n  }, \"Settings\"), \" button from the \", mdx(\"a\", {\n    parentName: \"p\",\n    \"href\": \"/flow/manual/latest/docs/repository/repository-overview/#navigation-menu\"\n  }, \"Navigation Menu\"))), mdx(\"li\", {\n    parentName: \"ol\"\n  }, mdx(\"p\", {\n    parentName: \"li\"\n  }, \"Click on the \", mdx(\"strong\", {\n    parentName: \"p\"\n  }, \"Fields\"), \" tab\")), mdx(\"li\", {\n    parentName: \"ol\"\n  }, mdx(\"p\", {\n    parentName: \"li\"\n  }, \"Click on the \", mdx(\"strong\", {\n    parentName: \"p\"\n  }, \"Import metadata\"), \" button\")), mdx(\"li\", {\n    parentName: \"ol\"\n  }, mdx(\"p\", {\n    parentName: \"li\"\n  }, \"Click in the blue box to activate the CSV file selection dialog or simply drag a CSV file into the blue box\")), mdx(\"li\", {\n    parentName: \"ol\"\n  }, mdx(\"p\", {\n    parentName: \"li\"\n  }, \"Define the \", mdx(\"strong\", {\n    parentName: \"p\"\n  }, \"File Naming Scheme\"), \". See \", mdx(\"a\", {\n    parentName: \"p\",\n    \"href\": \"#file-naming-scheme\"\n  }, \"File Naming Scheme\"), \" for details\")), mdx(\"li\", {\n    parentName: \"ol\"\n  }, mdx(\"p\", {\n    parentName: \"li\"\n  }, \"(Optional) From the \", mdx(\"strong\", {\n    parentName: \"p\"\n  }, \"Choose a Field\"), \" dropdown menus, select or create a field that corresponds to each column of the CSV file (column names are shown adjacent to each dropdown menu). If a column is not assigned in this way, the values from that column are not imported\")), mdx(\"li\", {\n    parentName: \"ol\"\n  }, mdx(\"p\", {\n    parentName: \"li\"\n  }, \"Click on the \", mdx(\"strong\", {\n    parentName: \"p\"\n  }, \"Preview Changes\"), \" button to see the results\")), mdx(\"li\", {\n    parentName: \"ol\"\n  }, mdx(\"p\", {\n    parentName: \"li\"\n  }, \"Click \", mdx(\"strong\", {\n    parentName: \"p\"\n  }, \"Commit Changes\"), \" if satisfied with the summary of results. Otherwise, click on \", mdx(\"strong\", {\n    parentName: \"p\"\n  }, \"CSV Mapping\"), \" to reopen that section and adjust the import settings\"))), mdx(\"div\", {\n    className: \"info\"\n  }, \"Once the changes have been committed, they cannot be undone.\")), mdx(\"h2\", {\n    \"id\": \"file-naming-scheme\"\n  }, mdx(\"a\", {\n    parentName: \"h2\",\n    \"href\": \"#file-naming-scheme\",\n    \"aria-label\": \"file naming scheme permalink\",\n    \"className\": \"anchor\"\n  }, mdx(\"svg\", {\n    parentName: \"a\",\n    \"aria-hidden\": \"true\",\n    \"focusable\": \"false\",\n    \"height\": \"16\",\n    \"version\": \"1.1\",\n    \"viewBox\": \"0 0 16 16\",\n    \"width\": \"16\"\n  }, mdx(\"path\", {\n    parentName: \"svg\",\n    \"fillRule\": \"evenodd\",\n    \"d\": \"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"\n  }))), \"File Naming Scheme\"), mdx(\"p\", null, \"The file naming scheme is used to associate rows of a CSV file with records in the Repository. It takes the form of a pattern used to assemble a file name from fixed text and column data from the CSV file. The file name computed for each row is matched against those in the database. If a single match is found, the specified metadata is applied to the record. If more than one record in the Repository would match, then this is considered a failed match and the metadata is not applied to any of them.\"), mdx(\"p\", null, \"The first row of the CSV is assumed to be the header row and the remaining rows are assumed to be metadata that are imported. Headers that are enclosed in {} within the naming scheme are considered placeholders and are processed as defined above.\"), mdx(\"div\", {\n    className: \"info\"\n  }, mdx(\"div\", null, \"Use the green \", mdx(\"b\", null, \"+\"), \" button beside a field to add that header as a placeholder in the file naming scheme template.\")), mdx(\"h3\", {\n    \"id\": \"example\"\n  }, mdx(\"a\", {\n    parentName: \"h3\",\n    \"href\": \"#example\",\n    \"aria-label\": \"example permalink\",\n    \"className\": \"anchor\"\n  }, mdx(\"svg\", {\n    parentName: \"a\",\n    \"aria-hidden\": \"true\",\n    \"focusable\": \"false\",\n    \"height\": \"16\",\n    \"version\": \"1.1\",\n    \"viewBox\": \"0 0 16 16\",\n    \"width\": \"16\"\n  }, mdx(\"path\", {\n    parentName: \"svg\",\n    \"fillRule\": \"evenodd\",\n    \"d\": \"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z\"\n  }))), \"Example\"), mdx(\"ol\", null, mdx(\"li\", {\n    parentName: \"ol\"\n  }, mdx(\"p\", {\n    parentName: \"li\"\n  }, \"Assuming the layout of an imported CSV file is:\"), mdx(\"table\", {\n    parentName: \"li\"\n  }, mdx(\"thead\", {\n    parentName: \"table\"\n  }, mdx(\"tr\", {\n    parentName: \"thead\"\n  }, mdx(\"th\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Study\"), mdx(\"th\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Animal\"), mdx(\"th\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Dose Group\"), mdx(\"th\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Stain\"))), mdx(\"tbody\", {\n    parentName: \"table\"\n  }, mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"2021-365\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Dog\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"5\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"H&E\")), mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"2021-365\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Dog\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"6\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"H&E\"))))), mdx(\"li\", {\n    parentName: \"ol\"\n  }, mdx(\"p\", {\n    parentName: \"li\"\n  }, \"And the File Naming Scheme is: \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"Image_{Study}_{Animal}_{Dose Group}.svs\"))), mdx(\"li\", {\n    parentName: \"ol\"\n  }, mdx(\"p\", {\n    parentName: \"li\"\n  }, \"The import process would match the rows in the CSV file to the following items in the Repository:\"), mdx(\"ul\", {\n    parentName: \"li\"\n  }, mdx(\"li\", {\n    parentName: \"ul\"\n  }, \"Image_2021-365_Dog_5.svs\"), mdx(\"li\", {\n    parentName: \"ul\"\n  }, \"Image_2021-365_Dog_6.svs\")))));\n}\n;\nMDXContent.isMDXComponent = true;","tableOfContents":{"items":[{"url":"#bulk-import","title":"Bulk Import","items":[{"items":[{"items":[{"items":[{"url":"#biopharma","title":"BioPharma"}]}]}]},{"url":"#file-naming-scheme","title":"File Naming Scheme","items":[{"url":"#example","title":"Example"}]}]}]}}},"pageContext":{"id":"659490ba-46b9-538b-9753-7ffe79ab883c"}},"staticQueryHashes":["1086510573","1106176283","1122327541","2140385554","2719290676","3597609067","4027383558"]}