Fichier XML pour le chargement des données sur les usagers
Note. - Ces directives exigent une connaissance de base du XML. Étant donné que les systèmes locaux de bibliothèque et les pratiques varient grandement, les informations de cette rubrique devraient être utilisées pour avoir une vue d'ensemble du processus.
Genre de fichier (File) | Description |
---|---|
Patron persona XSD | Modèle pour créer un fichier XML de données sur les usagers. |
Symboles et codes HTML équivalents
Les fichiers XML doivent contenir du code HTML valide. Les symboles ci-dessous, si présents dans les données sur les usagers, doivent être remplacés par les codes HTML équivalents.
Symbol | Code HTML |
---|---|
& | & |
< | < |
> | > |
" | " |
Nom du fichier
Les noms de fichier doivent respecter certaines règles :
- Les noms de fichier peuvent contenir des lettres, des chiffres, des points et des traits de soulignement.
- Les noms de fichier ne peuvent pas contenir des espaces ou des caractères spéciaux.
- Les fichiers XML doivent avoir l'extension de fichier XML.
Exemple : OCLCsymbolpatrons.xml
Envoi de données sur les usagers
Chargements récurrents de mises à jour des usagers
- Si de nouvelles données sont incluses dans un dossier de miss à jour, toutes les données seront remplacées par les nouvelles informations.
- Les informations pour Nom et Adresse postale sont traitées comme un groupe. S'il y avait déjà une adresse complète et que le dossier de mise à jour ne contient que le pays, les informations dans Adresse postale seront remplacées par le pays uniquement. Si aucune nouvelle information n'est fournie dans le dossier de mise à jour, l'ancienne adresse sera conservée.
- Si un dossier de mise à jour ne contient pas de données pour un champ facultatif, mais contient des données dans une mise à jour précédente, les données originales seront conservées.
- Si vous voulez supprimer en lot des dossiers d'usagers, voir Fichier XML pour la suppression en lot des données sur les usagers.
Zones | Action | |
---|---|---|
Pour WorldShare Circulation , si n'importe quel de ces champs est présent > | barcode, homeBranch, borrowerCategory, circRegistrationDate > | Il sera traité comme un dossier de Circulation WorldShare et le système supposera que les champs obligatoires de Circulation WorldShare sont présents. |
Pour Tipasa, si n'importe quel de ces champs de PEB est présent > | illId, illApprovalStatus, illPatronType, illPickupLocation > | Il sera traité comme un dossier de PEB et le système supposera que les champs obligatoires de PEB sont présents. |
Pour WorldShare Circulation , si n'importe quel des champs obligatoires de WorldShare Circulation manque > | givenName Ou familyName, institutionId, barcode, borrowerCategory, homeBranch > | Le dossier sera ignoré. |
Pour Tipasa, si n'importe quel des champs obligatoires manque > | givenName OR familyName, institutionId, illId, at least one piece of contact information (postal address, phone or email) > | Le dossier sera ignoré. |
Si des champs de Circulation WorldShare et de Tipasa sont présents > | Le système conservera les données obligatoires pour les deux types de dossiers. |
Éléments des dossiers
OCLCPersonas et Persona
complexType | Attribute / Élément | Type | Obligatoire / Répétable pour Circulation WorldShare | Obligatoire / Répétable pour Tipasa | Description | Limite de caractères |
---|---|---|---|---|---|---|
OCLCPersonas | persona | Persona |
Obligatoire |
Obligatoire |
|
|
Persona | correlationInfo | CorrelationInfo |
Facultatif Obligatoire si vous utilisez un système d'authentification autre qu'OCLC. |
Facultatif Obligatoire si vous utilisez un système d'authentification autre qu'OCLC. |
|
|
oclcUserName | string | Facultatif Non répétable |
Facultatif Non répétable |
|
50 | |
oclcExpirationDate | dateTime | Facultatif Non répétable |
Facultatif Non répétable |
|
||
nameInfo | NameInfo | Obligatoire Non répétable |
Obligatoire Non répétable |
|
||
nickname | string | Facultatif Non répétable |
Facultatif Non répétable |
|
50 | |
dateOfBirth | Date | Facultatif Non répétable |
Facultatif Non répétable |
|
||
gender | string | Facultatif Non répétable |
Facultatif Non répétable |
|
||
wmsCircPatronInfo | WmsCircPatron Info |
Obligatoire Non répétable |
Obligatoire Non répétable |
|
||
wsILLInfo | WsILLInfo | Sans objet |
Obligatoire |
|
||
contactInfo | ContactInfo |
Facultatif |
Obligatoire Répétable |
|
||
notification |
Notification |
Sans objet | Facultatif Répétable |
|
||
note | Note | Facultatif Répétable |
Facultatif Répétable |
|
||
additionalInfo | KeyValuePair | Facultatif Répétable |
Facultatif Répétable |
|
||
photoURL | anyURL | Facultatif Non répétable |
Facultatif Non répétable |
|
8 192 | |
institutionId (Attribut) |
numeric | Obligatoire Non répétable |
Obligatoire Non répétable |
|
NameInfo et WMSCircPatronInfo
complexType | Attribute / Élément | Type | Obligatoire / Répétable pour Circulation WorldShare | Obligatoire / Répétable pour Tipasa | Description | Limite de caractères |
---|---|---|---|---|---|---|
NameInfo | prefix | string | Facultatif Non répétable |
Facultatif Non répétable |
|
254 |
givenName | string |
Obligatoire givenName ou familyName est requis |
Obligatoire givenName ou familyName est requis |
|
50 | |
middleName | string | Facultatif Non répétable |
Facultatif Non répétable |
|
100 | |
familyName | string |
Obligatoire givenName ou familyName est requis |
Obligatoire givenName ou familyName est requis |
|
50 | |
suffix | string | Facultatif Non répétable |
Facultatif Non répétable |
|
254 | |
canSelfEdit | boolean | Facultatif Non répétable |
Facultatif Non répétable |
|
||
WMSCircPatronInfo | barcode | string | Obligatoire Non répétable |
Sans objet Le code-barres peut être envoyé comme illId (ID de PEB). |
|
20 |
pin | string | Facultatif Non répétable |
Sans objet |
|
||
borrowerCategory | string | Obligatoire Non répétable |
Sans objet (illPatronType peut être utilisé.) |
|
30 | |
circRegistration Date |
dateTime | Facultatif Non répétable |
Sans objet |
|
||
homeBranch | string | Obligatoire Non répétable |
Sans objet |
|
||
isCircBlocked | boolean | Facultatif Non répétable |
Sans objet |
|
||
isCollectionExempt | boolean | Facultatif Non répétable |
Sans objet |
|
||
isFineExempt | boolean | Facultatif Non répétable |
Sans objet |
|
||
isVerified | boolean |
Facultatif |
Sans objet |
|
||
storeCheckout History |
boolean | Facultatif Non répétable |
Sans objet |
|
ContactInfo et PostalAddress
complexType | Attribute / Élément | Type | Obligatoire / Répétable pour Circulation WorldShare | Obligatoire / Répétable pour Tipasa | Description | Limite de caractères |
---|---|---|---|---|---|---|
ContactInfo Note. - Au moins un élément d'information de contact, d'adresse postale/civique, d'adresse électronique (courriel) ou de numéro de téléphone est requis. |
Choix : postalAddress | PostalAddress | Facultatif Répétable |
Facultatif Répétable |
|
|
Choix : email | Adresse électronique | Facultatif Répétable |
Facultatif Répétable |
|
||
Choix : phone | Téléphone | Facultatif Répétable |
Facultatif Répétable |
|
||
label | string | Facultatif Non répétable |
Facultatif Non répétable |
|
||
isInvalid | boolean | Facultatif Non répétable |
Facultatif Non répétable |
|
||
PostalAddress Note. - Au moins un élément d'information de contact, d'adresse postale, d'adresse électronique (courriel) ou de numéro de téléphone est requis. |
streetAddressLine1 | string | Facultatif Non répétable |
Facultatif Non répétable |
|
120 |
streetAddressLine2 | string | Facultatif Non répétable |
Facultatif Non répétable |
|
120 | |
cityOrLocality | string | Facultatif Non répétable |
Facultatif Non répétable |
|
50 | |
stateOrProvince | string | Facultatif Non répétable |
Facultatif Non répétable |
|
120 | |
postalCode | string | Facultatif Non répétable |
Facultatif Non répétable |
|
20 | |
country | string | Facultatif Non répétable |
Facultatif Non répétable |
|
120 | |
isPrimary | boolean | Facultatif Non répétable |
Facultatif Non répétable |
|
||
isPermanent | boolean | Facultatif Non répétable |
Facultatif Non répétable |
|
||
validFrom | dateTime | Facultatif Non répétable |
Facultatif Non répétable |
|
||
validTo | dateTime | Facultatif Non répétable |
Facultatif Non répétable |
|
EmailAddress, Phone, CorrelationInfo, Note, KeyValuePair, NotificationDeliveryDestination et WSILLInfo
complexType | Attribute / Élément | Type | Obligatoire / Répétable pour Circulation WorldShare | Obligatoire / Répétable pour Tipasa | Description | Limite de caractères |
---|---|---|---|---|---|---|
Adresse électronique Note. - Au moins un élément d'information de contact, d'adresse postale, d'adresse électronique (courriel) ou de numéro de téléphone est requis. |
emailAddress | string | Facultatif Non répétable |
Facultatif Non répétable |
254 | |
isPrimary | boolean | Facultatif Non répétable |
Facultatif Non répétable |
|
||
Téléphone Note. - Au moins un élément d'information de contact, d'adresse postale, d'adresse électronique (courriel) ou de numéro de téléphone est requis. |
number | string | Facultatif Non répétable |
Facultatif Non répétable |
|
50 |
isPrimary | boolean | Facultatif Non répétable |
Facultatif Non répétable |
|
||
CorrelationInfo | sourceSystem (système source) | string |
Facultatif Obligatoire si vous utilisez un système d'authentification autre qu'OCLC. |
Facultatif Obligatoire si vous utilisez un système d'authentification autre qu'OCLC. |
|
255 |
idAtSource | string |
Facultatif Obligatoire si vous utilisez un système d'authentification autre qu'OCLC. |
Facultatif Obligatoire si vous utilisez un système d'authentification autre qu'OCLC. |
|
50 | |
Note | text | string | Facultatif Non répétable |
Facultatif Non répétable |
|
255 |
KeyValuePair | businessContext | string | Facultatif Non répétable |
Facultatif Non répétable |
|
|
key | string | Facultatif Non répétable |
Facultatif Non répétable |
|
||
value | string | Facultatif Non répétable |
Facultatif Non répétable |
|
8 192 | |
NotificationDelivery Note. - Si notificationDelivery |
deliveryService | string | Sans objet |
Facultatif |
|
|
destination | string | Sans objet | Facultatif Non répétable |
|
4 096 | |
WsILLInfo | illId | string | Sans objet | Obligatoire Non répétable |
|
254 |
illApprovalStatus | string | Sans objet | Facultatif Non répétable |
|
||
illPatronType | string | Sans objet | Facultatif Non répétable |
|
50 | |
illPickupLocation | string | Sans objet | Facultatif Non répétable |
|
1 000 |
Modèles de dossiers
Rapports sur le traitement des fichiers de données sur les usagers