Fichier délimité par tabulations pour le chargement des données sur les usagers
Genre de fichier (File) | Description |
---|---|
Tab-delimited patron data template (Microsoft Excel) | Contient 46 colonnes. Enregistrez en tant que fichier texte délimité par des tabulations (un fichier Excel ne peut pas être utilisé pour envoyer des données). |
Colonnes
Respectez les critères suivants pour créer des colonnes pour vos données :
- Le fichier texte doit contenir la totalité des 46 colonnes délimitées par des tabulations dans l'ordre indiqué dans les tableaux plus bas dans cet écran.
- La première ligne du fichier texte est l'en-tête et doit contenir des noms de colonne séparés par des tabulations.
- Les noms d'en-tête de colonne ne sont pas sensibles à la casse, mais doivent être orthographiés correctement.
- Chaque ligne du fichier délimité par des tabulations doit contenir 45 caractères de tabulation qui servent de séparateurs de colonne.
- Toutes les valeurs dans les colonnes sont des chaînes (chaîne de texte, chaîne numérique, etc.).
- Si vous n'avez pas de données à mettre dans une colonne, laissez-la vide.
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.
- Si vous utilisez un ordinateur avec un système d'exploitation autre que Windows, enregistrez le fichier sous forme de fichier texte dans un format Windows.
Exemple : symboleOCLCusagers.txt
Envoi de données sur les usagers
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. Assistance OCLC que vous avez chargé un fichier dans le répertoire test et expliquez brièvement quel type d'analyse est requise. Note. - Pour garantir que votre fichier test soit traité correctement, informez l' |
/xfer/wms/in/patron | Données approuvées pour les chargements de données automatisés. |
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. Cela ne s'applique pas aux champs sourceSystem/idAtSource. Si ces champs sont modifiés, une nouvelle entrée sera ajoutée dans la section Informations sur le compte du dossier de l'usager.
- 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 délimité par tabulations 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 OR 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. |
Champs des dossiers
Colonnes 1 à 17
Numéro |
Nom de la colonne |
Exigence pour bibliothèques Circulation WorldShare |
Exigence pour bibliothèques Tipasa |
Description | Limite de caractères |
---|---|---|---|---|---|
1 | prefix | Facultatif | Facultatif |
|
254 |
2 | givenName |
Obligatoire givenName ou familyName est requis |
Obligatoire givenName ou familyName est requis |
|
50 |
3 | middleName | Facultatif | Facultatif |
|
100 |
4 | familyName |
Obligatoire givenName ou familyName est requis |
Obligatoire givenName ou familyName est requis |
|
50 |
5 | suffix | Facultatif | Facultatif |
|
254 |
6 | nickname | Facultatif | Facultatif |
|
50 |
7 | canSelfEdit | Facultatif | Facultatif |
|
|
8 | dateOfBirth | Facultatif | Facultatif |
|
|
9 | gender | Facultatif | Facultatif |
|
|
10 | institutionId | Obligatoire | Obligatoire |
|
|
11 | barcode | Obligatoire | Non applicable. Le code-barres peut être envoyé comme illId (ID de PEB). |
|
20 |
12 | idAtSource |
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 |
13 | sourceSystem (système source) |
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 |
14 | borrowerCategory | Obligatoire | Non applicable (illPatronType peut être utilisé). |
|
30 |
15 | circRegistrationDate | Facultatif | Sans objet |
|
|
16 |
oclcExpirationDate | Facultatif | Facultatif |
|
|
17 | homeBranch | Obligatoire | Sans objet |
|
Colonnes 18 à 35
Numéro |
Nom de la colonne |
Exigence pour bibliothèques Circulation WorldShare |
Exigence pour bibliothèques Tipasa |
Description | Limite de caractères |
---|---|---|---|---|---|
Au moins un élément d'information de contact, d'adresse postale, d'adresse courriel ou de numéro de téléphone est requis. | |||||
18 | primaryStreetAddressLine1 | Facultatif | Facultatif |
|
120 |
19 | primaryStreetAddressLine2 | Facultatif | Facultatif |
|
120 |
20 | primaryCityOrLocality | Facultatif | Facultatif |
|
50 |
21 | primaryStateOrProvince | Facultatif | Facultatif |
|
120 |
22 | primaryPostalCode | Facultatif | Facultatif |
|
20 |
23 | primaryCountry | Facultatif | Facultatif |
|
120 |
24 | primaryPhone | Facultatif | Facultatif |
|
50 |
25 | secondaryStreetAddressLine1 | Facultatif | Facultatif |
|
120 |
26 | secondaryStreetAddressLine2 | Facultatif | Facultatif |
|
120 |
27 | secondaryCityOrLocality | Facultatif | Facultatif |
|
50 |
28 | secondaryStateOrProvince | Facultatif | Facultatif |
|
120 |
29 | secondaryPostalCode | Facultatif | Facultatif |
|
20 |
30 | secondaryCountry | Facultatif | Facultatif |
|
120 |
31 | secondaryPhone | Facultatif | Facultatif |
|
50 |
32 | emailAddress | Facultatif | Facultatif |
|
254 |
33 | mobilePhone | Facultatif | Facultatif |
|
50 |
34 | notificationEmail | Sans objet | Facultatif |
|
4 096 |
35 | notificationTextPhone | Sans objet | Facultatif |
|
4 096 |
Colonnes 36 à 46
Numéro |
Nom de la colonne |
Exigence pour bibliothèques Circulation WorldShare |
Exigence pour bibliothèques Tipasa |
Description | Limite de caractères |
---|---|---|---|---|---|
36 | patronNotes | Facultatif | Facultatif |
|
255 |
37 | photoURL | Facultatif | Facultatif |
|
8 192 |
38 | customdata1 | Facultatif | Facultatif |
|
8 192 |
39 | customdata2 | Facultatif | Facultatif | ||
40 | customdata3 | Facultatif | Facultatif | ||
41 | customdata4 | Facultatif | Facultatif | ||
42 | username | Facultatif | Facultatif |
|
50 |
43 | illId | Sans objet | Obligatoire |
|
254 |
44 | illApprovalStatus | Sans objet | Facultatif |
|
|
45 | illPatronType | Sans objet | Facultatif |
|
50 |
46 | illPickupLocation | Sans objet | Facultatif |
|
1 000 |
Modèles de dossiers
Rapports sur le traitement des fichiers de données sur les usagers
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. |