Activité principale (APE) et Nomenclature d’activité française (NAF)

Published : 16 October 2024 – by Thrax – 4 commentaires

1
2
3
4
5
2 Votes

Ce plugin propose une liste des codes APE (activité principale) et NAF (nomenclature d’activité française). Il est accompagné d’une saisie, d’une vérification, et de fonctions pour mettre à jour la liste.

Installation

Pas de dépendance : le plugin ne nécessite aucun autre plugin.
Reconnaissance : le plugin utilise, s’ils sont actifs, Saisies pour formulaires et Vérifier.

Configuration

Le plugin ne nécessite aucune configuration. Il contient une démonstration.

Utilisations

Les fonctions pour la gestion de la base de données des codes

Une API est disponible dans le répertoire /inc du plugin. Elle permet de gérer les codes stocker dans un fichier json (voir le répertoire de SPIP local/cache-json)

Exemples d’utilisation :

include_spip('inc/ape_naf');
// avoir le libellé du code 0520Z
print_r(lire_ape_naf('0520Z',['libelle' => '']));
// avoir tous les codes et libellés
print_r(lire_ape_naf('*',['libelle' => 'avec_code']));

La fonction lire_ape_naf(string $valeur, ?array $options = []) lit le fichier en local stockant les codes à la recherche d’une valeur ou des valeurs. La valeur est précisée dans la variable $valeurs. Elle peut être soit un code, soit le signe *. La fonction retournera alors soit le libellé soit le code accompagné du libellé, selon les $options précisées, soit l’ensemble des valeurs possibles.

Une gestion périodique des tâches permet de réactualiser la liste des codes.

Une gestion périodique des tâches (Cron), permet de réactualiser le fichier avec une API afin qu’il détienne les derniers codes en vigueur (voir le pipeline taches_generales_cron et le fichier genie/ape_naf_actualisation.php).

Renouvellement manuel de la liste

Pour des usages avancées, la fonction creer_ape_naf(int $jours) renouvelle ou crée le répertoire des codes APE et NAF. La variable $jours précise les jours d’ancienneté du fichier avant qu’il ne soit considéré comme obsolète. Avec 100, si le fichier en local stockant les codes à plus de 100 jours, il sera renouvelé en allant chercher les valeurs sur une API externe.

La saisie ape_naf pour sélectionner un code

Lorsque le plugin Saisies pour formulaires est actif, une nouvelle saisie peut être utilisée et est dénommée ape_naf. Il s’agit d’un sélecteur regroupant les codes et leurs libellés.

Exemple d’utilisation de la saisie:

La vérification ape_naf pour vérifier la conformité d’un code

Lorsque le plugin Vérifier est actif, une nouvelle vérification est utilisable, dénommée simplement ape_naf. Elle permet de vérifier une valeur et de la normaliser si nécessaire.

Discussion

5 years 1 year 3 months Without limit
par date
Filter

3 discussions

  • 1
    Stéphane Santon

    Bonjour,
    J’ai lancé creer_ape_naf et le fichier local/cache-json/ape_naf.json semble à jour.
    J’ai créé un champ extra sur organisations,

    	$champs['spip_organisations']['ape_naf'] = array(
        // Le type de saisie
        'saisie' => 'ape_naf',
        'options' => array(
            // Le nom du champ dans la base de données
            'nom' => 'ape_naf', 
            // Le label affiché dans l'espace privé du site
            'label' => _T('ape_naf:saisie'),
            // L'explication affichée dans l'espace privé du site
            'explication' => _T('ape_naf:saisie_explication'),
            // Le type d'info attendue
            'sql' => "varchar(127) NOT NULL DEFAULT ''",
            // La valeur par défaut
            'defaut' => '',
            // Le champ est obligatoire
            'obligatoire' => '',

    mais lors de la saisie, il ne me propose qu’une liste limitée de codes.
    Que manque-t-il ?
    Ma déclaration du champ sql est-elle suffisante ou bien faut-il la laisser vide ?
    Merci

    • Stéphane Santon

      Bonjour,
      J’ai trouvé, c’est un bug dans le plugin, ici :
      https://git.spip.net/spip-contrib-extensions/ape_naf/-/blob/master/saisies/ape_naf.html?ref_type=heads#L24

      La clé est générée 2 fois à partir du début du code 12.34A :

      	#SET{cle,#VALEUR{code}|substr{0,2}}
	#SET{cle,#GET{cle}#VALEUR{code}|substr{0,3}}

      Donc les clés sont formées par 1212. au lieu de 1234A, ce qui ne crée qu’une entrée du SELECT pour chaque couple de 2 premiers chiffres (donc 100 codes max au lieu de 752 codes).

      En remplaçant dans la seconde ligne substr{0,3} par substr{3,3}, ça marche mieux.

      De plus, afin de mieux l’utiliser avec Select2, afin de ne pas taper le point, je changerais la ligne suivante :

      #SET{data,#GET{data}|plus{#ARRAY{#GET{cle},#VALEUR{code} - #VALEUR{libelle}}}

      par

      #SET{data,#GET{data}|plus{#ARRAY{#GET{cle},#GET{cle} - #VALEUR{libelle}}}

      Merci

    Reply to this message

  • Stéphane Santon

    Bonjour,
    J’ai lancé creer_ape_naf et le fichier local/cache-json/ape_naf.json semble à jour.
    J’ai créé un champ extra sur organisations,

    	$champs['spip_organisations']['ape_naf'] = array(
        // Le type de saisie
        'saisie' => 'ape_naf',
        'options' => array(
            // Le nom du champ dans la base de données
            'nom' => 'ape_naf', 
            // Le label affiché dans l'espace privé du site
            'label' => _T('ape_naf:saisie'),
            // L'explication affichée dans l'espace privé du site
            'explication' => _T('ape_naf:saisie_explication'),
            // Le type d'info attendue
            'sql' => "varchar(127) NOT NULL DEFAULT ''",
            // La valeur par défaut
            'defaut' => '',
            // Le champ est obligatoire
            'obligatoire' => '',

    mais lors de la saisie, il ne me propose qu’une liste limitée de codes.
    Que manque-t-il ?
    Ma déclaration du champ sql est-elle suffisante ou bien faut-il la laisser vide ?
    Merci

    Reply to this message

  • Stéphane Santon

    Bonjour,
    Ça aurait été bien d’avoir une page de configuration qui mette à jour la liste.
    Parce que ma fonction creer_ape_naf(int $jours), je ne sais pas trop depuis où l’appeler.
    Merci

    Reply to this message

Add a comment

Avant de faire part d’un problème sur un plugin X, merci de lire ce qui suit :

  • Désactiver tous les plugins que vous ne voulez pas tester afin de vous assurer que le bug vient bien du plugin X. Cela vous évitera d’écrire sur le forum d’une contribution qui n’est finalement pas en cause.
  • Cherchez et notez les numéros de version de tout ce qui est en place au moment du test :
    • version de SPIP, en bas de la partie privée
    • version du plugin testé et des éventuels plugins nécessités
    • version de PHP (exec=info en partie privée)
    • version de MySQL / SQLite
  • Si votre problème concerne la partie publique de votre site, donnez une URL où le bug est visible, pour que les gens puissent voir par eux-mêmes.
  • En cas de page blanche, merci d’activer l’affichage des erreurs, et d’indiquer ensuite l’erreur qui apparaît.

Merci d’avance pour les personnes qui vous aideront !

Par ailleurs, n’oubliez pas que les contributeurs et contributrices ont une vie en dehors de SPIP.

Who are you?
[Log in]

To show your avatar with your message, register it first on gravatar.com (free et painless) and don’t forget to indicate your Email addresse here.

Enter your comment here

This form accepts SPIP shortcuts {{bold}} {italic} -*list [text->url] <quote> <code> and HTML code <q> <del> <ins>. To create paragraphs, just leave empty lines.

Add a document

Follow the comments: RSS 2.0 | Atom