External Entities

Fianakaviana modiolin'i Drupal mamadika angona ivelany (API, andiam-angona, pejy voakiky) ho entity Drupal izay mampiseho, manondro ary mikaroka toy ny votoaty eo an-toerana, ka afaka manolo izay saha rehetra ny mpamoaka.

 

## Inona izany

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](/mg/vokatra/species-ext) sy [Editorial Intelligence](/mg/vokatra/editorial-intelligence) dia naorina amin'ity fomba ity, ary ny katalaogin'ny [Research Library](/mg/vokatra/research-library) dia mipetraka eo amboniny.



 

 





 

## Raha jerena amin'ny indray mipi-maso

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 sahaKarazana ankapobeny`entity_ext`: karazana entity ivelany tohanan'ny API HTTP, voafaritry ny fikirakirana fa tsy plugin fitehirizana manokanaModules loharanoIray 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 core10 na 11Mitaky`key`; `entities_ext` dia mitaky `request_bus` koa, izay tsy mila afa-tsy Drupal core sy `key`SataNoforonina 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](/mg/tetikasa/biodiversa), [Museo Avellonia](/mg/tetikasa/museo-avellonia) ary ny [Quercus Project](/mg/tetikasa/quercus-project); ny ankamaroan'ny modules loharano dia mbola amboarina ao amin'ny sehatra fikarohana an'ny MADDev manokana.

 

 





 

## Izay ampiany amin'ny tranokala Drupal

### 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.



 

 





 

## Loharanom-baovao sy fahazoan-dalana

- **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](/mg/vokatra/copyrights-guard) avy eo.



 

 





 

## Fanapahan-kevitra momba ny famolavolana

- **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.



 

 





## Manomboha tetikasa.

Lazao anay izay angona ivelany iankinan'ny tranokalao, ary hatraiza ny fahavaozany no ilaina.



[Mifandraisa aminay →](/mg/fifandraisana)