1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
|
.. -*- coding: utf-8 -*-
.. _annexe-technique-3-variables:
==============================
Annexe technique 3 - Variables
==============================
:Auteur: Étienne Loks
:Date: 2020-11-24
:Copyright: CC-BY 3.0
----------------------------------
Ces variables sont utilisées pour les configurations des imports, les patrons de documents et la configuration des identifiants, des index personnalisés.
Ces variables correspondent aux noms des champs utilisés en base de données (exemple : ``code_patriarche`` pour accéder au code patriarche d'une opération) ainsi que des « facilitateurs » qui permettent de disposer de champs plus évolués (exemple : ``get_next_index`` pour accéder au prochain numéro d'index).
On peut passer d'un élément lié à un autre (par exemple, accéder à l'opération d'une unité d'enregistrement) avec la notation double tiret `__` et ensuite accéder aux variables de l'élément lié (exemple : ``operation__code_patriarche`` permet d'accéder au code patriarche de l'opération ).
Ci-dessous la liste des variables pour chaque type d'éléments.
.. _valeurs-champs-adresse:
Champs adresse
==============
Les champs adresse sont une liste de variables partagées par plusieurs éléments :
- `address` : adresse
- `address_complement` : complément d'adresse
- `postal_code` : code postal
- `precise_town__` : commune (`name` nom de la commune, `numero_insee` code INSEE, `cached_label` nom commune avec numéro du département entre parenthèses)
- `town` : nom de la commune (saisie libre)
- `country` : nom de pays
- `alt_address` : adresse alternative
- `alt_address_complement` : complément d'adresse de l'adresse alternative
- `alt_postal_code` : code postal de l'adresse alternative
- `alt_town` : nom de la commune (saisie libre) de l'adresse alternative
- `alt_country` : nom de pays de l'adresse alternative
- `phone` : numéro de téléphone
- `phone_desc` : numéro de téléphone - description
- `phone2` : numéro de téléphone (2)
- `phone_desc2` : numéro de téléphone (2) - description
- `phone3` : numéro de téléphone (3)
- `phone_desc3` : numéro de téléphone (3) - description
- `mobile_phone` : numéro de mobile
- `email` : courriel
- `alt_address_is_prefered` : (booléen) l'adresse alternative est préférée
.. _valeurs-champs-geo:
Champs géographiques
====================
Les champs géographiques sont une liste de variables partagées par plusieurs éléments :
- `spatial_reference_system` : système de référence spatial des coordonnées
- `x` : coordonnée x
- `y` : coordonnée y
- `z` : coordonnée z
- `estimated_error_x` : erreur estimée sur la coordonnée x
- `estimated_error_y` : erreur estimée sur la coordonnée y
- `estimated_error_z` : erreur estimée sur la coordonnée z
- `point` : champ base de données du point (3D) - déduit automatiquement depuis les coordonnées
- `point_2d` : champ base de données du point (2D) - déduit automatiquement depuis les coordonnées
- `point_source` : origine des coordonnées (**P** précis, **T** commune, **M** polygone)
- `point_source_item` : source des coordonnées - géré automatiquement
- `multi_polygon` :
- `multi_polygon_source` : origine du polygone (**P** précis, **T** commune, **M** polygone)
- `multi_polygon_source_item` : source du polygone - géré automatiquement
Le détail du fonctionnement de ces champs est explicité dans :ref:`« Principes > Notions avancées > Données géographiques » <donnees-geographiques>`.
Personne
========
Chaque personne dispose des :ref:`champs adresse <valeurs-champs-adresse>`, ainsi que des champs suivants :
- `title` : titre
- `salutation` : formule d'appel
- `surname` : prénom
- `name` : nom
- `raw_name` : nom + prénom
- `contact_type__` : type de contact (`label` libellé, `txt_idx` identifiant textuel)
- `comment` : commentaire
- `person_types__` : types de personnes
- `attached_to__` : organisation actuelle (-> Organisation)
- `cached_label` : nom généré depuis la formule `person_raw_name` du profil
Auteur
======
- `person` : personne (-> Personne)
- `author_type` : type d'auteur (`label` libellé, `txt_idx` identifiant textuel)
- `cached_label` : cache textuel « nom, prénom de la personne - type d'auteur » - à utiliser pour l'affichage
Organisation
============
Chaque organisation dispose des :ref:`champs adresse <valeurs-champs-adresse>`, ainsi que des champs suivants :
- `name` : nom
- `organization_type__` : type de contact (`label` libellé, `txt_idx` identifiant textuel)
- `cached_label` : nom généré - nom ou si non disponible « type d'organisation - adresse - commune »
Documentation
=============
- `title` : titre
- `associated_file` : fichier associé
- `image` : image associée
- `thumbnail` : vignette associée (généré automatiquement depuis une image)
- `associated_url` : adresse web associée (avec ``http://``)
- `index` : index
- `external_id` : identifiant interne
- `reference` : référence
- `internal_reference` : référence interne
- `source_type` : type de document (`label` libellé, `txt_idx` identifiant textuel, `code` code)
- `publisher__` : éditeur (-> Organisation)
- `licenses__` : liste de licence d'utilisation (`label` libellé, `txt_idx` identifiant textuel)
- `tags` : liste d'étiquettes (`label` libellé, `txt_idx` identifiant textuel)
- `language` : langue
- `issn` : code ISSN
- `isbn` : code ISBN
- `source` : source / document parent (-> Document)
- `source_free_input` : source / document parent - saisie libre
- `support_type` : type de support (`label` libellé, `txt_idx` identifiant textuel)
- `format_type` : format (`label` libellé, `txt_idx` identifiant textuel)
- `scale` : échelle
- `authors__` : liste d'auteurs (-> Auteur)
- `authors_raw` : saisie libre des auteurs
- `creation_date` : date de création de l'élément en base de données
- `receipt_date` : date de réception
- `receipt_date_in_documentation` : date de réception en documentation
- `item_number` : nombre d'élément
- `description` : description
- `container_id` : ID du contenant contenant le document
- `container_ref_id` : ID du contenant de référence du document
- `comment` : commentaire
- `additional_information` : information additionnelles
- `duplicate` : a des doublons
- `complete_identifier` : identifiant complet personnalisé
- `custom_index` : index personnalisé
- `qrcode` : QR code
Opération
=========
Chaque opération dispose des :ref:`champs géographiques <valeurs-champs-geo>`, ainsi que des champs suivants :
- `code_patriarche` : code patriarche (ou équivalent)
- `year` : année de l'opération
- `common_name` : nom générique
- `operation_code` : code de l'opération
- `old_code` : ancien code
- `start_date` : date de début du chantier
- `excavation_end_date` : date de fin du chantier
- `end_date` : date de clôture de l'opération
- `report_delivery_date` : date de livraison du rapport
- `scientist__` : responsable d'opération (-> Personne)
- `operator__` : opérateur (-> Organisation)
- `in_charge__` : responsable
- `collaborators__` : collaborateurs
- `creation_date` : date de création de l'élément en base de données
- `associated_file__` : dossier archéologique associé (-> Dossier archéologique)
- `operation_type__` : type d'opération (`label` libellé, `txt_idx` identifiant textuel)
- `surface` : surface totale (m²)
- `remains` : liste des vestiges (`label` libellé, `txt_idx` identifiant textuel)
- `cached_remains` : cache textuel de la liste des vestiges - à utiliser pour l'affichage
- `towns` : liste des communes liées (-> Commune, `name` nom de la commune, `numero_insee` code INSEE, `cached_label` nom commune avec numéro du département entre parenthèses)
- `cached_towns_label` : cache textuel de la liste des communes - à utiliser pour l'affichage
- `periods` : liste des périodes (`label` libellé, `txt_idx` identifiant textuel)
- `cached_periods` : cache textuel des périodes - à utiliser pour l'affichage
- `scheduled_man_days` : hommes-jours prévus
- `optional_man_days` : hommes-jours optionnels
- `effective_man_days` : hommes-jours effectifs
- `cost` : coût de l'opération
- `report_processing` : état de traitement du rapport (`label` libellé, `txt_idx` identifiant textuel)
- `fnap_financing` : financement FNAP (%)
- `fnap_cost` : financement FNAP (€)
- `zoning_prescription` : booléen - prescription sur zonage
- `large_area_prescription` : booléen - prescription sur une vaste surface
- `geoarchaeological_context_prescription` : booléen - prescription sur un contexte géoarchéologique
- `negative_result` : booléen - résultat considéré comme négatif
- `cira_rapporteur` : rapporteur CIRA (-> Personne)
- `cira_date` : date d'avis CIRA
- `operator_reference` : référence d'opérateur
- `address` : adresse
- `comment` : commentaire
- `scientific_documentation_comment` : commentaire sur la documentation scientifique
- `documents__` : documents associés (-> Document)
- `main_image__` : image principale (-> Document)
- `cached_label` : libellé en cache ("commune - code opération - nom")
- `archaeological_sites__` : sites associés à cette opération (-> Site/Entité archéologique)
- `top_sites__` : sites pour lesquels cette opération est une opération « chapeau » (-> Site/Entité archéologique)
- `virtual_operation` : booléen - est une opération virtuelle ?
- `record_quality_type__` : qualité d'enregistrement (`label` libellé, `txt_idx` identifiant textuel)
- `abstract` : résumé
- `documentation_deadline` : date limite d'envoi de documentation
- `documentation_received` : booléen - documentation reçue
- `finds_deadline` : date limite de réception du mobilier
- `finds_received` : booléen - mobilier reçu
- `drassm_code` : code DRASSM
- `seizure_name` : nom de la saisie
- `official_report_number` : numéro de procès-verbal ou de saisine
- `protagonist__` : protagonistes (-> Personne)
- `applicant_authority__` : autorité requérante (-> Organisation)
- `minutes_writer__` : rédacteur du procès verbal (-> Personne)
- `complete_identifier` : identifiant complet personnalisé
- `custom_index` : index personnalisé
- `qrcode` : QR code
Site/Entité archéologique
=========================
Chaque opération dispose des :ref:`champs géographiques <valeurs-champs-geo>`, ainsi que des champs suivants :
- `reference` : référence
- `other_reference` : autre référence
- `name` : nom
- `comment` : commentaire
- `collaborators__` : collaborateurs (-> Personne)
- `locality_ngi` :
- `locality_cadastral` :
- `towns` : liste des communes liées (-> Commune, `name` nom de la commune, `numero_insee` code INSEE, `cached_label` nom commune avec numéro du département entre parenthèses)
- `cached_towns_label` : cache textuel de la liste des communes - à utiliser pour l'affichage
- `remains` : liste des vestiges (`label` libellé, `txt_idx` identifiant textuel)
- `cached_remains` : cache textuel de la liste des vestiges - à utiliser pour l'affichage
- `periods` : liste des périodes (`label` libellé, `txt_idx` identifiant textuel)
- `cached_periods` : cache textuel des périodes - à utiliser pour l'affichage
- `cultural_attributions__` : liste des attributions culturelles (`label` libellé, `txt_idx` identifiant textuel)
- `documents__` : documents associés (-> Document)
- `main_image__` : image principale (-> Document)
- `cached_label` : libellé en cache ("référence - nom - communes - vestiges [périodes]")
- `complete_identifier` : identifiant complet personnalisé
- `custom_index` : index personnalisé
- `qrcode` : QR code
- `shipwreck_name` : nom de l'épave
- `shipwreck_code` : code de l'épave
- `oceanographic_service_localisation` : localisation SHOM
- `sinking_date` : date de naufrage
- `discovery_area` : aire de découverte
- `affmar_number` : numéro Affaires Maritimes
- `drassm_number` : numéro DRASSM
Dossier archéologique
=====================
|
