Folio Assistant Core

Process

L1 document ingestion — a document to the L1 source knowledge graph

https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_L1DocumentIngestion

JSON-LD · diagram · in graph folio-assistant-core.jsonld ·

nameL1 document ingestion — a document to the L1 source knowledge graph
summaryL1 document ingestion — a document to the L1 source knowledge graph.
descriptionL1 document ingestion — a document to the L1 source knowledge graph. The harness holds only the basic, high-level document-ingestion flow; the detailed ingestion and cataloguing method is here. IT REFINES THE HARNESS FLOW BY CALLING IT. CallActivity_Basic runs the harness's Process_Ingestion first — accept the upload, put its metadata into the KG, catalogue the asset in library/ — and this process then reads the document into a complete L1 entry. That is the inversion the harness skill library-ingestion describes: the call points DOWN, from core to the harness, and nothing in the harness names this process. The theme branch's call into the harness's ingest-theme.bpmn is downward for the same reason; the four ingest-* phases sit beside this file. The method is the l1-document-ingestion skill.
enforcementadvisory
sourcePathcollab/processes/library/l1-document-ingestion.bpmn
sourceUrlhttps://github.com/litlfred/folio-assistant-core/blob/main/collab/processes/library/l1-document-ingestion.bpmn
depictionhttps://litlfred.github.io/folio-assistant/assets/img/workflows/l1-document-ingestion.svg
startNodeA document is offered for L1 ingestion
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_L1DocumentIngestion/node/StartEvent_Document
nodeCount22
flowCount23
inSubgraphcollab
https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab

Flows

flow/Flow_theme_yes

nameyes
partOfL1 document ingestion — a document to the L1 source knowledge graph
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_L1DocumentIngestion
fromA theme source? (author's judgement)
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_L1DocumentIngestion/node/Gateway_ThemeSource
toIngest the theme
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_L1DocumentIngestion/node/CallActivity_IngestTheme
inSubgraphcollab
https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab

flow/Flow_theme_join

partOfL1 document ingestion — a document to the L1 source knowledge graph
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_L1DocumentIngestion
fromIngest the theme
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_L1DocumentIngestion/node/CallActivity_IngestTheme
toBuild the L1 knowledge graph
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_L1DocumentIngestion/node/CallActivity_BuildKg
inSubgraphcollab
https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab

flow/Flow_theme_no

nameno
partOfL1 document ingestion — a document to the L1 source knowledge graph
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_L1DocumentIngestion
fromA theme source? (author's judgement)
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_L1DocumentIngestion/node/Gateway_ThemeSource
toBuild the L1 knowledge graph
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_L1DocumentIngestion/node/CallActivity_BuildKg
inSubgraphcollab
https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab

flow/Flow_i1

partOfL1 document ingestion — a document to the L1 source knowledge graph
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_L1DocumentIngestion
fromA document is offered for L1 ingestion
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_L1DocumentIngestion/node/StartEvent_Document
toOpen the bean
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_L1DocumentIngestion/node/Call_BeanOpen
inSubgraphcollab
https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab

flow/Flow_i1a

partOfL1 document ingestion — a document to the L1 source knowledge graph
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_L1DocumentIngestion
fromBasic ingestion (harness)
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_L1DocumentIngestion/node/CallActivity_Basic
toDetect media type, mint a doc id
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_L1DocumentIngestion/node/Task_Detect
inSubgraphcollab
https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab

flow/Flow_i2

partOfL1 document ingestion — a document to the L1 source knowledge graph
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_L1DocumentIngestion
fromDetect media type, mint a doc id
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_L1DocumentIngestion/node/Task_Detect
toEstablish the licence from the upload
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_L1DocumentIngestion/node/Task_Licence
inSubgraphcollab
https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab

flow/Flow_i2a

partOfL1 document ingestion — a document to the L1 source knowledge graph
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_L1DocumentIngestion
fromEstablish the licence from the upload
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_L1DocumentIngestion/node/Task_Licence
toExtract structure
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_L1DocumentIngestion/node/CallActivity_Extract
inSubgraphcollab
https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab

flow/Flow_i3

partOfL1 document ingestion — a document to the L1 source knowledge graph
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_L1DocumentIngestion
fromExtract structure
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_L1DocumentIngestion/node/CallActivity_Extract
toDerive content from the assets
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_L1DocumentIngestion/node/CallActivity_Derive
inSubgraphcollab
https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab

flow/Flow_i4

partOfL1 document ingestion — a document to the L1 source knowledge graph
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_L1DocumentIngestion
fromDerive content from the assets
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_L1DocumentIngestion/node/CallActivity_Derive
toA theme source? (author's judgement)
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_L1DocumentIngestion/node/Gateway_ThemeSource
inSubgraphcollab
https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab

flow/Flow_i5

partOfL1 document ingestion — a document to the L1 source knowledge graph
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_L1DocumentIngestion
fromBuild the L1 knowledge graph
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_L1DocumentIngestion/node/CallActivity_BuildKg
toL1 completeness gate
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_L1DocumentIngestion/node/CallActivity_Gate
inSubgraphcollab
https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab

flow/Flow_i6

partOfL1 document ingestion — a document to the L1 source knowledge graph
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_L1DocumentIngestion
fromL1 completeness gate
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_L1DocumentIngestion/node/CallActivity_Gate
toL1 complete?
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_L1DocumentIngestion/node/Gateway_Complete
inSubgraphcollab
https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab

flow/Flow_i7

namegap
partOfL1 document ingestion — a document to the L1 source knowledge graph
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_L1DocumentIngestion
fromL1 complete?
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_L1DocumentIngestion/node/Gateway_Complete
toRecord the gap as a bean
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_L1DocumentIngestion/node/Task_OpenBean
inSubgraphcollab
https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab

flow/Flow_i8

partOfL1 document ingestion — a document to the L1 source knowledge graph
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_L1DocumentIngestion
fromRecord the gap as a bean
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_L1DocumentIngestion/node/Task_OpenBean
toDerive content from the assets
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_L1DocumentIngestion/node/CallActivity_Derive
inSubgraphcollab
https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab

flow/Flow_i9

namecomplete
partOfL1 document ingestion — a document to the L1 source knowledge graph
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_L1DocumentIngestion
fromL1 complete?
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_L1DocumentIngestion/node/Gateway_Complete
toMove into library/<bib-slug>/
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_L1DocumentIngestion/node/Task_Promote
inSubgraphcollab
https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab

flow/Flow_i10

partOfL1 document ingestion — a document to the L1 source knowledge graph
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_L1DocumentIngestion
fromMove into library/<bib-slug>/
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_L1DocumentIngestion/node/Task_Promote
toPublish the extracted statements
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_L1DocumentIngestion/node/CallActivity_PublishStatements
inSubgraphcollab
https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab

flow/Flow_i10b

partOfL1 document ingestion — a document to the L1 source knowledge graph
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_L1DocumentIngestion
fromPublish the extracted statements
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_L1DocumentIngestion/node/CallActivity_PublishStatements
toSummarise prose blocks, in every language
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_L1DocumentIngestion/node/Task_SummaryQueue
inSubgraphcollab
https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab

flow/Flow_i12a

partOfL1 document ingestion — a document to the L1 source knowledge graph
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_L1DocumentIngestion
fromSummarise prose blocks, in every language
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_L1DocumentIngestion/node/Task_SummaryQueue
toRecord errata in the source's own text
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_L1DocumentIngestion/node/Task_Errata
inSubgraphcollab
https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab

flow/Flow_i12

partOfL1 document ingestion — a document to the L1 source knowledge graph
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_L1DocumentIngestion
fromRecord errata in the source's own text
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_L1DocumentIngestion/node/Task_Errata
toAvailable to cite as an L1 source
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_L1DocumentIngestion/node/Task_Citeable
inSubgraphcollab
https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab

flow/Flow_i11

partOfL1 document ingestion — a document to the L1 source knowledge graph
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_L1DocumentIngestion
fromAvailable to cite as an L1 source
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_L1DocumentIngestion/node/Task_Citeable
toClose the bean
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_L1DocumentIngestion/node/Call_BeanClose
inSubgraphcollab
https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab

flow/SF_Bean_1

nameclaimed
partOfL1 document ingestion — a document to the L1 source knowledge graph
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_L1DocumentIngestion
fromBean claimed?
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_L1DocumentIngestion/node/GW_BeanYours
toBasic ingestion (harness)
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_L1DocumentIngestion/node/CallActivity_Basic
inSubgraphcollab
https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab

flow/SF_Bean_2

partOfL1 document ingestion — a document to the L1 source knowledge graph
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_L1DocumentIngestion
fromOpen the bean
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_L1DocumentIngestion/node/Call_BeanOpen
toBean claimed?
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_L1DocumentIngestion/node/GW_BeanYours
inSubgraphcollab
https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab

flow/SF_Bean_3

namenot yours
partOfL1 document ingestion — a document to the L1 source knowledge graph
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_L1DocumentIngestion
fromBean claimed?
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_L1DocumentIngestion/node/GW_BeanYours
toNot yours — left alone
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_L1DocumentIngestion/node/End_BeanNotYours
inSubgraphcollab
https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab

flow/SF_Bean_4

partOfL1 document ingestion — a document to the L1 source knowledge graph
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_L1DocumentIngestion
fromClose the bean
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_L1DocumentIngestion/node/Call_BeanClose
toIngested
https://litlfred.github.io/folio-assistant/folio-assistant-core/process/Process_L1DocumentIngestion/node/EndEvent_Ingested
inSubgraphcollab
https://litlfred.github.io/folio-assistant/folio-assistant-core/directory/collab