Cart@DS CS¶

Connecteur développé dans #27144.

Note 20/07/2023 : Aujourd'hui ce connecteur est déprécié et n'est plus utilisé. La mise en place d'une connexion SSO au service Cart@DS est à privilégier pour simplifier le parcours usager.

Nous avons pu échanger avec GFi (éditeur de la solution) qui nous a donné accès aux documentations fonctionnelles et techniques de leur application. Nous allons développer le connecteur avec Publik conformément à ce qui suit.

Description fonctionnelle¶

Ce connecteur permettra de déverser dans Cart@ds les demandes des usagers et de leur offrir le suivi de celles-ci. Le recours au pdf interactif sera malgré tout obligatoire puisque c'est le mode de fonctionnement adopté par cette application. La demande référence donc les informations principales (demandeur, adresse...) mais le contenu de la demande elle-même sera stockée dans le pdf interactif.

Les fonctionnalités envisagées pour cette interface sont les suivantes :

• Accès aux référentiels (en particuliers liste des pièces à fournir pour le type de demande sélectionné)
• Envoi/mise à disposition des informations et documents à Cart@ds (dépôt de DOC (ouverture de chantier) et DAACT (achèvement de travaux) en lien avec un dossier existant)
• Remontée d'informations vers l'usager (suivi d'instruction)
• Possibilité de dépôt d'informations complémentaires par l'usager
• Suivi d'un dossier déposé en papier
• Définition et paramétrage du formulaire et workflow de dépôt Publik
• Développement des mécanismes d'affichage des pièces attendues (en fonction de la nature de la demande, les champs proposés varient).

Déroulé d'une demande¶

• On clique sur la demande dans Publik
• On sélectionne la commune
• On sélectionne le type de dossier (par exemple "certificat d'urbanisme")
• On accède à un ou plusieurs CERFA
• On les télécharge, les complète, et les joint à la demande avec les autres justificatifs nécessaires
• On valide
• Le dossier est envoyé dans cart@ds
• On peut voir l'état de celui-ci et l'afficher dans Publik

Sources de données¶

• Communes, /communes
• Types de dossier, /types_dossier?commune_id=...
• Objets de la demande, /objets_demande?type_dossier_id=...
• CERFAs, /liste_pdf?type_dossier_id=...

Avec ces sources on peut créer une page unique, avec les listes qui se rafraichiront selon les choix, pour créer une démarche de téléchargement de CERFA, en retirant la page de validation et mettant derrière un workflow qui fasse juste redirection vers {{form_var_cerfa_url}}.

Appels webservice¶

Pour le dépôt de dossier, une première page pareil, avec communes/types de deossier/objets de la demande, puis une deuxième page pour permettre à l'usager de transmettre les pièces.

Cela se passe via un gabarit dédié, à attacher à un champ commentaire (template-pieces-cartads en classes CSS). Ce gabarit assurera la présentation de l'interface de transmission des pièces, en transférant celles-ci directement à Cart@DS, sans stockage dans des fichiers côtés w.c.s.

Ce gabarit utilise ces deux appels, à définir :

• CERFAs, /liste_pdf (le slug doit être "cartads_cerfa")
  • Données envoyées en paramètres de l'URL :
    • type_dossier_id : {{form_var_type_dossier_raw}}

• Pièces, /pieces (le slug doit être "cartads_pieces")
  • Données envoyées en paramètres de l'URL :
    • tracking_code : {{form_tracking_code}}
    • type_dossier_id : {{form_var_type_dossier_raw}}
    • objet_demande_id : {{form_var_objet_demande_raw}}

Ensuite, pour la validation des données, en condition de sortie de page, webservice.cartds_check_pieces['result'] is True.

• check_pieces
  • données envoyées en paramètres de l'URL :
    • tracking_code : {{form_tracking_code}}
    • type_dossier_id : {{form_var_type_dossier_raw}}
    • objet_demande_id : {{form_var_objet_demande_raw}}

Pour la transmission de la demande, appel webservice depuis le workflow, vers send, en GET, avec dans l'URL :

• commune_id : {{form_var_commune_raw}}
• type_dossier_id : {{form_var_type_dossier_raw}}
• objet_demande_id : {{form_var_objet_demande_raw}}
• tracking_code : {{form_tracking_code}}
• email : {{...}} (email de l'usager)

En lui mettant comme identifiant "cartads", on reçoit cartads_response_dossier_id avec le numéro de dossier (interne passerelle).

Pour le suivi du dossier, appel en GET vers status, en GET, avec dans l'URL :

• dossier_id : {{...}}

En retour, les clés status_id et status_label.

Debug côté Cart@DS CS¶

• fichiers posés dans le FTP et en attente de lecture par Cart@DS :
  • https://.../adscs/pages/common/gestion/NotificationsPortailDepotEnLigne.aspx

• fichiers de logs : https://.../adscs/Admin/LogsApplication
  • C'est dans la section "Autres" que sont les fichiers utiles : Application.log (cron de lecture des dossiers) et Services.log (appels webservices).