Import KBART

Last modified by Admin on 2026/01/29 14:20

KBART standard

KBART regroupe les métadonnées des bouquets commercialisés par les fournisseurs de documents numériques.

Ces métadonnées sont stockées dans un fichier texte tabulé de 25 champs dont les libellés (en-têtes de colonnes) sont mentionnés ci-dessous.

L'encodage du fichier doit être UTF-8,  le caractère séparateur entre les champs est la tabulation et le nom des champs ne doit pas comporter de caractères accentués. Vous trouverez des informations en français sur cette recommandation à l'adresse suivante : http://www.couperin.org/relations-editeurs/kbart

Decalog ERMS est capable d'importer des informations au format KBART.

Le nom des fichiers KBART est structuré comme suit [ProviderName]_[Region/Consortium]_[PackageName]_[YYYY-MM-DD]#[packageID]@[vendorID].txt où :

  • [ProviderName] = Nom du fournisseur
  • [Region/Consortium] = Groupe régional ou consortium
  • [PackageName] = Nom du bouquet
  • [YYYY-MM-DD] = Date de mise à jour du bouquet
  • #[packageID]@[vendorID] = cette partie est optionnelle elle est utilisée uniquement si vous souhaitez lier un bouquet KBART à son équivalant EBSCO (cf. Lier un bouquet KBART à son équivalant EBSCO)

Si la liste des titres d'un bouquet est standard, alors Region/Consortium = "Global" (exemple, CAIRN_GLOBAL_ALLJOURNALS_2016-11-15).
En revanche, si le bouquet est personnalisé pour un groupe ou pour un consortium, on met un nom significatif du regroupement (exemple, CAIRN_COUPERIN_REVUES-HUMANITES_2016-09-15).

La référence actuelle de la recommandation NISO KBART est disponible ici : http://www.niso.org/apps/group_public/download.php/11426/rp-9-201x_KBART_draft_for_comments_final.pdf
 

Field Name

Description

publication_title

Publication title for serial or monograph

Conference proceedings series titles should be entered as serial titles, while volume titles should be entered as monograph titles.

print_identifier

Print-format identifier

ISSN for serials, ISBN for monographs, etc. Conference proceedings may have serial ISSNs while each proceeding volume may have its own ISBN.

online_identifier

Online-format identifier 

(i..e, eISSN for serials, eISBN for monographs, etc.; conference proceedings may have serial eISSNs while each proceeding volume many have its own eISBN)

date_first_issue_online

Date of first serial issue available online.  Applicable only to serials. 

 

num_first_vol_online

Number of first volume available online  Applicable only to serials.

num_first_issue_online

Number of first issue available online  Applicable only to serials.

date_last_issue_online

Date of last issue available online 

Leave blank, if coverage is to the present.

Applicable only to serials.

num_last_vol_online

Number of last volume available online  Leave blank if coverage is to the present.

Applicable only to serials.

num_last_issue_online

Number of last issue available online  Leave blank if coverage is to present.

Applicable only to serials.

title_url

Title-level URL. 

Applicable to both serials and monograph 

For conference proceedings, the title_url for the proceedings series and the title_url for each volume should be different.

first_author

First author 

Applicable only to monographs.

title_id

Title identifier

Applicable to both serials and monographs. 

For conference proceedings, the title_id for the conference proceedings series and the title_id for each proceeding volume should be different.

embargo_info

Embargo information

Describes any limitations on when resources become available online.

coverage_depth

Coverage depth 

For example, abstracts or full text.

coverage_notes

Coverage notes

Free-text field to describe the specifics of the coverage policy.

publisher_name

Publisher name.  Especially important in cases of aggregated full-text content and third party content hosting.  Not to be confused with platform hosting name. 

-

publication_type

Serial or monograph

Use serial for journals and conference proceeding series. Use monograph  for books, e-books, and conference proceeding volumes.

date_monograph_published_print 

Date the monograph is first published in print

date_monograph_published_online

Date the monograph is first published online

monograph_volume

Number of volume for monograph

Applicable to e-books and conference proceedings

For proceedings, the volume within the conference proceedings series.

monograph_edition

Edition  of the monograph

first_editor

First editor

Applicable to monographs, i.e., e-books or conference proceedings volumes.

parent_publication_title_id

Title identifier of the parent publication 

For a conference proceeding volume, the parent_publication_title_id is the title_id of the conference proceedings series.

preceding_publication_title_id

Title identifier of any preceding publication title 

Applicable to serials and conference proceedings series.

access_type

Access type

May be fee-based (F) or Open Access (OA).

Lier un bouquet KBART à son équivalant EBSCO

Commencer par récupérer le numéro identifiant d'un bouquet EBSCO dans HLM (au survol du nom du bouquet l'identifiant est visible dans la cible du lien ici : 2478115)

1532509427894-985.png

Puis récupérer le numéro identifiant d'un vendeur EBSCO dans HLM (au survol du nom du vendeur l'identifiant est visible dans la cible du lien ici : 990)

1532509744623-853.png

Il suffira alors de nommer votre fichier : "Numérique Premium_GLOBAL_Sciences éducation_2018-07-25#2478115@990.txt"

Une fois le bouquet importé lié à un bouquet HLM vous pouvez Synchroniser les informations depuis HLM

Le KBART « augmenté »

En plus des champs prévus par la recommandation KBART, il est possible d’aller plus loin et d’envoyer à Decalog ERMS des champs qui ne se trouvent pas encore dans la recommandation.

Ce fichier KBART un peu spécial est appelé KBART « augmenté », il vous permet :

  1. de passer des données de gestion telle que le statut de l'abonnement ou la méthode d'accès.
  2. d'ajouter à des bouquets ou à des titres autant de notes que souhaitées.
  3. d'associer un bouquet à son bouquet dans EBSCO

Contrairement aux 25 premières colonnes (Kbart standard), les intitulés du Kbart "augmenté" peuvent contenir des caractères diacritiques. Notez que les caractères "_" (underscore) seront automatiquement remplacés par des espaces dans les intitulés de notes. L'ordre des colonnes dans le fichier n'est pas important.

Les intitulés des champs du Kbart "augmenté", qui débutent à la 26e colonne, doivent obligatoirement contenir le préfixe "DECA_". Les champs se rapportant :

  • aux abonnements sont préfixés par DECA_ABO. Le module d'import Kbart est conçu pour interpréter sept colonnes de gestion lies à l'abonnement :
    • DECA_ABO_CONSORTIUM = liste des institutions ERMS bénéficiaires de l'abonnement, noms séparés par des ";" (ex : "INEE;INP;INS2I")
    • DECA_ABO_STATUT = statut de l’abonnement (valeurs = "actif", "inactif", "en test")
    • DECA_ABO_TEST_DEBUT = date de début de l’abonnement dans le cas d'un test (format YYYY-MM-DD)
    • DECA_ABO_TEST_FIN = date de fin de l’abonnement dans le cas d'un test (format YYYY-MM-DD)
    • DECA_ABO_ACQUISITION = date de début de l'abonnement dans le cas d'une acquisition (pas de date de fin) (format YYYY-MM-DD)
    • DECA_ABO_DATE_DEBUT = date de début de l’abonnement (format YYYY-MM-DD)
    • DECA_ABO_DATE_FIN = date de fin de l’abonnement (format YYYY-MM-DD)
  • aux méthodes d'accès sont préfixées par DECA_ACCESS. Le module d'import Kbart est conçu pour interpréter deux colonnes pour les méthodes d'accès :
    • DECA_ACCESS_METHOD_TYPE = Type de méthode d'accès associée au bouquet / abonnement
    • DECA_ACCESS_METHOD_VALUE = Valeur spécifique au type de méthode d'accès choisi (nom du proxy, adresse IP, login/mot de passe, etc.)
  • aux notes sur les bouquets sont préfixées par « DECA_BOUQUET_ ». Vous pouvez en créer autant que vous le souhaitez. 
  • aux notes sur les titres par « DECA_TITRE_ ». Vous pouvez en créer autant que vous le souhaitez. 
  • aux statuts d'activation : DECA_TITLES_ACTIVATION pour indiquer si le titre est actif ou inactif.
    • DECA_TITLES_ACTIVATION = On / Off, permet d'indiquer si le titre associé est actif (On) ou inactif (Off) dans le bouquet et pour l'abonnement en cours.

Détails de la gestion des notes

Les données des champs notes seront chargées dans Decalog ERMS sous la forme de notes associées à leur libellé. Le libellé de la note correspond à la partie après le préfixe.

Par exemple, le champ "DECA_BOUQUET_Contact_technique" contenant "MARTIN Françoise" et le champ "DECA_BOUQUET_Contact_commercial" contenant "DIDEROT Denis" provoqueront la création de deux notes au niveau bouquet intitulées respectivement "Contact technique" avec pour valeur "MARTIN Françoise" et "Contact commercial" avec la valeur "DIDEROT Denis".

Les contenus des notes sur les bouquets sont automatiquement dédoublonnés.
Par exemple, si le bouquet contient 10 titres et que pour une colonne DECA_BOUQUET donnée, chaque titre contient la même note, alors une seule note sera créée. Si, par contre, sept des 10 titres contiennent une même valeur et que trois autres contiennent une autre valeur, alors deux notes seront créées au niveau du bouquet. Elles porteront le même nom, mais auront chacune un contenu différent.

Fichier d'exemple

Exemple d'un fichier Kbart "augmenté" : Exemple de fichier kbart augmenté