Projet

Général

Profil

Bug #32411

api entreprise : revoir les libellés

Ajouté par Frédéric Péters il y a environ 5 ans. Mis à jour il y a environ 5 ans.

Statut:
Fermé
Priorité:
Normal
Assigné à:
Serghei Mihai
Version cible:
-
Début:
17 avril 2019
Echéance:
% réalisé:

0%

Temps estimé:
Patch proposed:
Oui
Planning:
Non

Description

J'avais commencé à traduire mais il y a des erreurs, genre :

                  'institution_id': {
                      'description': _('association id'),
                      'example_value': '44317013900036',
                  },
...
    def entreprises(self, request, institution_id, **kwargs):
        return self.get('entreprises/%s/' % institution_id, **kwargs)

vs

                  'institution_id': {
                      'description': _('institution id'),
                      'example_value': '44317013900036',
                  },
...
    def associations(self, request, institution_id, **kwargs):
        return self.get('associations/%s/' % institution_id, **kwargs)

Fichiers

0001-api_entreprise-fix-parameteres-names-labels-and-exam.patch (11,3 ko) 0001-api_entreprise-fix-parameteres-names-labels-and-exam.patch Serghei Mihai, 17 avril 2019 12:11
0001-api_entreprise-fix-parameteres-names-labels-and-exam.patch (11,3 ko) 0001-api_entreprise-fix-parameteres-names-labels-and-exam.patch Serghei Mihai, 17 avril 2019 13:58
0001-api_entreprise-fix-parameteres-names-labels-and-exam.patch (12,1 ko) 0001-api_entreprise-fix-parameteres-names-labels-and-exam.patch Serghei Mihai, 18 avril 2019 15:47

Révisions associées

Révision 1a60c1ac (diff)
Ajouté par Serghei Mihai il y a environ 5 ans

api_entreprise: fix parameteres names, labels and examples (#32411)

Historique

#1

Mis à jour par Benjamin Dauvergne il y a environ 5 ans

Mettre directement ce qui dit leur spec (SIREN pour entreprise, RNA ou SIRET pour une association), il ne sert à rien d'être obscure ici.

#2

Mis à jour par Frédéric Péters il y a environ 5 ans

Yep, j'oubliais de le dire, au début de ma traduction j'en étais à :

+msgid "request recipient: usually customer number" 
+msgstr "bénéficiaire de l'appel (généralement SIRET de l'administration)" 
...
+msgid "institution id" 
+msgstr "identifiant de l'organisation (SIREN)"

Il y a aussi "request context" qui gagnerait à être prolongé par une parenthèse donnant des exemples. (dans la doc de l'API, « Le cadre dans lequel l’appel est réalisé. Vous pouvez renseigner APS s'il s'agit d'aides publiques simplifiées, MPS pour les marchés publics simpifiés, Tiers [...] »).

Je serais presque à dire aussi, que vu le côté franco-français de la chose, que ces paramètres pourraient être directement en français. (mais ce serait créer un précédent qui se retournerait contre moi à un moment, je ne le dis donc pas).

#3

Mis à jour par Serghei Mihai il y a environ 5 ans

Pour les endpoints dédiés aux entreprises je mets siren comme paramètre.
Pour les association je garde association_id car on peut interroger avec SIRET ou WALDEC.

Exemples d'appels corrigés aussi.

#4

Mis à jour par Frédéric Péters il y a environ 5 ans

Il y a maintenant un mélange de association, institution et firm dans les descriptions; on pourrait avoir juste association & enterprise ?

#5

Mis à jour par Serghei Mihai il y a environ 5 ans

Si.
C'est le nom etablissements m'a fait traduire le terme en institution. Mais en fait il s'agit d'entreprise.

#6

Mis à jour par Benjamin Dauvergne il y a environ 5 ans

  • Statut changé de Solution proposée à Solution validée

Ok, juste je ne comprends pas les valeurs d'exemple "42" mais ça n'a pas grande importance; attendre le build pour vérifier qu'il n'y a pas de typo.

#7

Mis à jour par Serghei Mihai il y a environ 5 ans

On c'était dit dans le ticket initial que l'objet de la requete serait le numéro de la demande qui fait appel à l'API.
J'ai mis 42 comme exemple de numéro de demande.

#8

Mis à jour par Benjamin Dauvergne il y a environ 5 ans

Serghei Mihai a écrit :

On c'était dit dans le ticket initial que l'objet de la requete serait le numéro de la demande qui fait appel à l'API.
J'ai mis 42 comme exemple de numéro de demande.

Ok très bien, mais un lecteur n'a aucune idée que cela veut dire cela et tu l'as mis aussi pour request_context ou c'est plutôt MPS, APS qui sont attendus.

Donc plutôt "request object (form number, file identifier, ...)" et pour l'autre mettre APS (parce qu'on fait pas trop de MPS chez nous).

#9

Mis à jour par Serghei Mihai il y a environ 5 ans

Ok.

#10

Mis à jour par Benjamin Dauvergne il y a environ 5 ans

  • Statut changé de Solution proposée à Solution validée

Ack.

#11

Mis à jour par Serghei Mihai il y a environ 5 ans

  • Statut changé de Solution validée à Résolu (à déployer)
commit 1a60c1acd37c4e49e2d63e55097e3f596ad6d8eb (origin/master, origin/HEAD)
Author: Serghei Mihai <smihai@entrouvert.com>
Date:   Wed Apr 17 11:40:33 2019 +0200

    api_entreprise: fix parameteres names, labels and examples (#32411)
#12

Mis à jour par Serghei Mihai il y a environ 5 ans

  • Statut changé de Résolu (à déployer) à Solution déployée

Formats disponibles : Atom PDF