External Entities

External Entities dia fianakaviana sosona misy maody Drupal ho an'ny tranokala izay mipetraka any an-kafa ny ampahany amin'ny votoatiny. Ny firaketana avy amin'ny API na tahirin-kevitra ivelany dia lasa entity Drupal misy saha, fomba fijery ary Fitantanana ny fampisehoana, ka afaka mampiseho azy ireo, manondro azy ireo ary manisa azy ireo toy ny votoaty hafa rehetra ny pejy, ary mijanona mifandray amin'ny loharano ny angona.

Ny fototra ifampizarana dia mitantana izay ilain'ny fampidirana tsirairay: HTTP voatahiry, fangatahana iray isaky ny loharano na dia misy ampahany maro amin'ny pejy mangataka azy, ary fitarafana isaky ny saha. Noho izany, ny loharano angona vaovao dia maody kely mifandray amin'ny rafitra, fa tsy fampidirana vaovao. Species External Entity sy Editorial Intelligence dia naorina amin'ity fomba ity, ary ny katalaogin'ny Research Library dia mipetraka eo amboniny.

Fototra

entities_ext, natsangana amin'ny motera an'ny module External Entities natolotra; request_bus, ny sosona fiantsoana mivoaka; dynamic_mirror_base, fitaratra isaky ny saha

Karazana ankapobeny

entity_ext: karazana entity ivelany tohanan'ny API HTTP, voafaritry ny fikirakirana fa tsy plugin fitehirizana manokana

Modules loharano

Iray isaky ny loharano na dataset ivelany, anisan'izany wikipedia_ext, data_ext, scripture_x, books_ext, scholar_ext, places_ext, artworks_ext, iiif_x, wikidata_x ary authority_x

Drupal core

10 na 11

Mitaky

key; entities_ext dia mitaky request_bus koa, izay tsy mila afa-tsy Drupal core sy key

Sata

Noforonina ary mbola amboarina mavitrika, tsy misy famoahana 1.0 (modules ao amin'ny 0.1.0-dev). Ny fototra dia miasa amin'ny famokarana ao amin'ny Biodiversa, Museo Avellonia ary ny Quercus Project; ny ankamaroan'ny modules loharano dia mbola amboarina ao amin'ny sehatra fikarohana an'ny MADDev manokana.

Karazana entity ivelany

entities_ext dia tsy mamaritra karazana votoatiny manokana. Ny maody mpampiasa tsirairay dia manoratra ny karazana entity ivelany ao aminy ao amin'ny substrate iraisana, ohatra wikipedia_page, species_x na editorial_news. Ny submodule xntt_views dia mitanisa entity ivelany ao amin'ny Views, ny xnttsql dia mamaky schema SQL ivelany, ary ny entities_ext_mng dia mijery ny loharano tsirairay raha misy endpoint tsy ampy na saha niova ary miaro ny rendering raha mijanona ny loharano.

Mirroring isaky ny saha

dynamic_mirror_base dia manapa-kevitra, isaky ny saha, avy aiza ny sanda: mivantana avy amin'ny loharano, kopia mirror, na sanda eo an-toerana tehirizina maharitra. Afaka manidy saha rehetra amin'ny sanda eo an-toerana ny mpamoaka izay tafita amin'ny fanavaozana rehetra avy any ambony. Ny dmb_ui dia manome hetsika fanidiana, fanovana, fampifanarahana indray ary famoahana hidy ho an'ny mpamoaka, ary ny dmb_harvest dia manavao ny sanda miror amin'ny fandaharam-potoana.

Zava-misy tokana

data_ext dia mamaha zava-misy ivelany iray, toy ny caption, ny vidiny na ny koordinate, tsy manao mirror ny rakitra iray manontolo. Izy io dia miaraka amin'ny caption Library of Congress Classification sy Universal Decimal Classification.

Karazana plugin

• @StorageClient sy @ExternalSource: plugin iray isaky ny API upstream, andramana araka ny lanjany mandra-pamalian'ny iray
• plugin field mapper, property mapper, data processor ary data aggregator hamolavola ny angona avy amin'ny loharano ho saha
• @DmbAdapter: mampifandray karazana entity amin'ny mirroring isaky ny saha
• plugin loharano isaky ny maody, toy ny @WikipediaSource, @ScriptureSource, @ScholarSource, @ArtworkSource ary @DatumSource

Serivisy

request_bus.bus (hita koa amin'ny entities_ext.request_bus), data_ext.resolver, wikidata_x.client, authority_x.resolver, scholar_ext.resolver, iiif_x.manifest_loader.

Fitantanana

• /admin/config/services/dmb/policy: politika mirroring isaky ny saha
• /admin/content/dmb-overrides: ny override eo an-toerana rehetra
• /admin/config/services/dmb/harvest: ny fandaharam-potoana fanavaozana
• /admin/config/services/wikipedia-ext: safidy Wikipedia

Toeram-piasana ho an'ny mpamorona

entities_ext_builder, mbola amin'ny fampandrosoana, dia manangana karazana entity ivelany tsy misy config voasoratra an-tanana: mikaroka endpoint mivantana izy, mampiseho mialoha ny fomba hakana ny saha alohan'ny hitahirizana na inona na inona, ary afaka mampiasa mpamatsy AI hahitana ny documentation API iray. Tsy mitazona lojika runtime izy, ka rehefa esorina dia mbola mandeha avokoa ny karazana entity ivelany rehetra namboariny.

• Rakipahalalana: Wikipedia sy ny tranonkala MediaWiki rehetra (wikipedia_ext); Wikidata (wikidata_x)
• Boky sy fikarohana: Open Library sy Google Books, ampifanarahana amin'ny alalan'ny ISBN (books_ext); OpenAlex, Crossref, arXiv, PubMed ary Semantic Scholar (scholar_ext)
• Anarana: ny identifier VIAF, ORCID, ULAN, Wikidata ary ISNI ampifanarahana amin'ny olona na fikambanana iray (authority_x)
• Toerana: Pleiades sy ny World Historical Gazetteer (places_ext)
• Fanangonana: ny Metropolitan Museum of Art, ny Art Institute of Chicago ary ny Cleveland Museum of Art, tsy misy mila fanalahidy (artworks_ext); manifest sary IIIF, kinova 2 sy 3 (iiif_x)
• Soratra: loharano sy fandikan-teny amin'ny soratra masina hebreo, grika ary koptika (scripture_x)
• Lohateny fanasokajiana: id.loc.gov sy ny UDC Summary (data_ext)

Ny antso mivoaka rehetra dia mandalo amin'ny request_bus, izay mitahiry sy mampifangaro ny fangatahana; ireo loharano mila fanalahidy dia mitazona azy ao amin'ny maodely key, fa tsy ao anaty kaody. Rehefa avy amin'ny loharano ivelany ny votoaty, dia soratan'ny copyrights_ext ny fahazoan-dàlana sy ny fankasitrahana ao amin'ny sahan'ny zo-tsoratra an'ny tranonkala rehefa ampidirina na atao dika mitovy izy, ary izany no ampiharin'ny Copyrights Guard avy eo.

• Misoratra filàna, fa tsy mandefa fangatahana. Ny mpiantso dia milaza amin'ny bus fangatahana izay ilainy; ampifangaroiny ny fangatahana mitovy, ampifangaroiny ny saha angatahin'ny ampahany samihafa amin'ny pejy, ataony andiany isaky ny loharano ary tadidiny ny valiny, ao anatin'izany ny "tsy misy angona", mandritra ny sisa amin'ny fangatahana. Ny pejy misy fizarana folo miankina amin'ny Wikipedia dia manao antso Wikipedia iray.
• Loharano maty tsy manapotika pejy mihitsy. Loharano tsy mandeha, miadana na diso endrika dia tsy mamerina na inona na inona fa tsy mamoaka hadisoana, ary mipoitra ny pejy tsy misy azy.
• Ireo saha angatahin'ny pejy ihany. Ny fampidirana entity ivelany dia mamaha ny saha tena takiana, fa tsy ny rakitra ivelany manontolo.
• Safidy telo isaky ny saha, fa tsy fomba tokana. Ny loharano ivoahan'ny sanda iray (mivantana, fitaratra na eo an-toerana), izay mitranga rehefa manary azy ny loharano (esory na tehirizo), ary aiza no itahirizana ny sanda dia voafaritra tsy miankina; ny fanidiana ataon'ny mpamoaka dia manjaka amin'ireo telo ireo.
• Fiankinana malefaka. Ny maody dia miankina mafy amin'ny fototra sy key ihany; ny fampidirana hafa rehetra dia dinihina mandritra ny fampandehanana, ka mitohy miasa ny fianakaviana rehefa tsy misy maody iray.
• Anarana milaza izay maha-maody azy. Ny _ext dia manamarika maody loharano, ny _x maody manitatra ny rafitra, ary ny tsy misy tovana dia fitaovana tsy miankina amin'ny rafitra.