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. |
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 |
|---|---|
| & | & |
| < | < |
| > | > |
| " | " |
Les noms de fichier doivent respecter certaines règles :
Exemple : OCLCsymbolpatrons.xml
Après avoir préparé vos données, envoyez vos fichiers de données sur les usagers via SFTP avec votre compte pour échange de fichiers avec OCLC.
| Répertoire | Utilisé pour |
|---|---|
| /xfer/wms/test/in/patron |
Évaluation en cours des données pour les chargements de données automatisés. Note. - Pour garantir que votre fichier test soit traité correctement, informez l'Assistance OCLC que vous avez chargé un fichier dans le répertoire test et expliquez brièvement quel type d'analyse est requise. |
| /xfer/wms/in/patron | Données approuvées pour les chargements de données automatisés. |
| 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. |
| 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 |
|
| 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 |
|
| 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 |
|
| 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 |
Les fichiers d'extraction de données WorldShare sont dans le répertoire /xfer/wms/reports et peuvent être téléchargés à l'aide d'un client SFTP à code source ouvert.
Le tableau ci-dessous contient les répertoires pour le téléchargement de fichiers et de rapports.
| Type de fichier | Emplacement SFTP du répertoire de fichiers | Note |
|---|---|---|
| Rapport Exceptions d'usagers | /xfer/wms/reports | Répertorie les dossiers d'usagers qui n'ont pas été chargés dans WorldShare ainsi que la cause de l'échec. Ce rapport d'exceptions sera uniquement généré s'il y a au moins un dossier d'usager, dans un fichier d'usagers, qui na pu être chargé dans WorldShare. |
| Rapport Résumé sur les usagers | /xfer/wms/reports | Rapport généré après le chargement d'un fichier d'usagers dans WorldShare et indique le nombre d'usagers du fichier qui ont été traités, ont été chargés, n'ont pas été chargés, sont nouveaux et ont été mis à jour. |