Aller au contenu

Gérer les projets

La recherche de projets s’effectue avec Filtre, en bas de la liste, à côté du nombre de lignes. Appuyez sur / ou sur Ctrl/Cmd+F pour y accéder directement. Le filtre recherche des correspondances dans les noms et les libellés des projets et affiche les résultats dans la hiérarchie.

Pour créer un nouveau projet :

  1. Ouvrez Analyze
  2. Sélectionnez « Projets » dans la barre de menus supérieure
  3. Cliquez sur le bouton « Nouveau projet »
  4. Renseignez le formulaire, y compris la section « Access Control »
  5. Cliquez sur « Créer »

Le projet est maintenant prêt pour la mise à jour des autorisations d’accès, l’ajout de propriétaires et la création de workflows.

Sur l’accueil du projet, à côté de Environnement de connexion, choisissez un Compte de documents par défaut pour le projet, ou Aucun pour l’effacer.

Dans le projet, chaque sélecteur de fichier liste Valeur par défaut du projet en premier, à la place du compte actuellement défini pour le projet. Cette entrée disparaît de la liste dès que vous quittez le projet, dès que le projet n’a plus de valeur par défaut, dès que ce compte a été supprimé ou dès que vous n’y avez plus accès.

Une nouvelle étape de fichier présélectionne Valeur par défaut du projet lorsque le projet en possède une. Les étapes existantes ne sont jamais réécrites : chacune conserve le compte avec lequel elle a été enregistrée tant que vous ne le modifiez pas vous-même, car un compte de documents est un choix propre à chaque étape, alors qu’une étape suit normalement l’environnement de connexion du projet.

Une étape laissée sur Valeur par défaut du projet utilise, à son exécution, le compte qui est alors la valeur par défaut du projet ; modifier la valeur par défaut pendant une exécution n’affecte donc que les nœuds qui n’ont pas encore démarré, comme pour une modification de l’environnement de connexion. Si une étape s’exécute sur Valeur par défaut du projet alors que le projet n’en a pas défini, l’exécution échoue et nomme le projet, au lieu de se rabattre sur un autre compte.

Les étapes suivent l’environnement de connexion du projet : faire passer le projet de QA à Production les déplace donc toutes. Une étape dont le formulaire comporte un paramètre Environnement propose deux choix :

  • Project environment suit l’environnement de connexion du projet. Conservez ce choix, sauf raison contraire.
  • Fixed environment ignore l’environnement de connexion du projet et utilise toujours l’environnement que vous choisissez. Ne l’utilisez que pour une étape qui doit rester sur un seul environnement quel que soit l’environnement du projet, par exemple pour lire des données de référence depuis Production dans un projet défini sur QA. L’icône d’avertissement rappelle que l’étape ne suivra pas un changement d’environnement.

Une étape avec un environnement fixe ajoute un avertissement à son journal chaque fois qu’elle s’exécute sur un environnement autre que celui du projet. Si son environnement fixe n’existe plus, par exemple dans une étape copiée depuis un autre espace de travail, l’étape échoue et le signale au lieu de s’exécuter ailleurs.

Les étapes de comptabilisation ERP utilisent toujours l’environnement du projet ; Fixed environment n’est donc pas disponible pour elles.

L’environnement par défaut ne peut pas être supprimé, et aucun autre environnement ne peut l’être tant qu’un projet l’utilise, qu’une étape l’a comme environnement fixe ou qu’un agent le dessert. Le message indique ce qui l’utilise encore, en nommant les éléments auxquels vous avez accès et en comptant les autres.

Chaque objet d’un projet (une étape, une UDF, un workflow, une dimension, une disposition enregistrée, un document ou un éditeur de données, ainsi que les paramètres du projet lui-même) est couvert par des sauvegardes de l’historique des versions. Une sauvegarde n’est pas effectuée à chaque enregistrement : lorsqu’un objet n’a pas été enregistré de nouveau pendant 30 secondes, une sauvegarde est réalisée de son état stabilisé. Une rafale de modifications, c’est-à-dire plusieurs enregistrements rapprochés, produit une seule version contenant le résultat final, et non une version par enregistrement. L’enregistrement n’est jamais ralenti par l’attente d’une sauvegarde : le compte à rebours et la sauvegarde elle-même s’exécutent en arrière-plan. Si vous avez besoin d’une version immédiatement, utilisez Back up now pour capturer l’état actuel sans attendre et patienter jusqu’à la fin ; cette option est disponible dans l’interface, dans l’API et sous la forme de l’action MCP backup des outils *_versions. L’historique des versions est disponible dans toutes les formules, y compris Free.

Les versions passées permettent une récupération à un instant donné : restaurez un objet à une version antérieure. La restauration est refusée dans un projet verrouillé, comme toute autre modification qui s’y rapporte.

Une version se restaure sur place. La restauration d’une version de projet, de dimension, de fonction définie par l’utilisateur, d’étape, de workflow, d’éditeur de données ou de disposition enregistrée remplace cet élément même, et désigner un autre élément comme cible est refusé, par exemple : « A project version is restored in place. Leave the target out, or set it to this project. » La restauration est une modification de l’élément ; elle exige donc le même rôle que sa modification ; sur un projet qui restreint les lignes, la restauration du projet ou d’une dimension lue par une colonne restreinte exige un Architecte du projet. Pour récupérer d’anciennes données de table sous la forme d’une table distincte, restaurez un instantané de table vers une nouvelle table.

Les versions d’une disposition enregistrée ne sont accessibles qu’aux membres qui peuvent utiliser la disposition : son propriétaire, les membres avec lesquels elle est partagée, et tout le monde pour une disposition globale. Toute autre disposition est signalée comme inconnue. La restauration d’une version rétablit les colonnes et les filtres de la disposition, et conserve son propriétaire et les personnes avec lesquelles elle est partagée. Restaurer toutes les dispositions enregistrées d’une table exige un administrateur de l’espace de travail. Lorsque son propriétaire supprime une disposition enregistrée, toutes ses versions sont également supprimées, y compris les versions conservées.

En plus de ce suivi automatique, les projets et leurs éléments permettent aussi la gestion de versions. Non seulement la création d’une version est simple, mais vous pouvez aussi fusionner les modifications d’une version vers une autre. C’est un moyen simple de suivre des instantanés ou de créer une version de développement, puis de fusionner ces modifications dans la version hors développement lorsque vous le souhaitez. Consultez Collaborer : versions, comparaison et partage pour la gestion de versions, la comparaison et la fusion en pratique.

Les données de table ont leur propre historique, des instantanés pris par le Lakehouse à chaque écriture, décrit dans Instantanés de table.

Restauration et conservation via l’assistant IA ou MCP

Section intitulée « Restauration et conservation via l’assistant IA ou MCP »

Via l’assistant IA ou MCP, dimension_versions restaure, conserve et libère une version de dimension grâce à son version_id, et restore_project rétablit chaque dimension du projet à sa dernière sauvegarde ; chaque liste *_versions (étapes, UDF, workflows, dimensions, projets) affiche le version_id de chaque version et indique si elle est conservée. Une action restore via n’importe quel outil *_versions, ou via l’API REST, restaure l’élément sur place : omettez la cible, ou définissez-la sur l’élément lui-même. Pour les dispositions enregistrées, identity_me_flashback liste, restaure, conserve, libère et sauvegarde les versions des dispositions que vous pouvez utiliser, et n’accepte aucune cible. project_upsert peut déverrouiller un projet verrouillé et honore if_match : il échoue plutôt que d’écraser une modification effectuée depuis votre dernière lecture du projet.

La sécurité des projets a été simplifiée en trois types d’accès :

  • Tous les membres de l’espace de travail
  • Membres spécifiques uniquement
  • Groupes de sécurité spécifiques uniquement

Définir la sécurité du projet est simple :

  1. Ouvrez Analyze
  2. Sélectionnez « Projets »
  3. Cliquez sur l’icône de modification du projet que vous souhaitez restreindre
  4. Choisissez la restriction souhaitée sous « Access Control »
  5. Cliquez sur « Update »

Seul un Architecte du projet ou un administrateur du tenant peut modifier qui a accès à un projet : son type d’accès, les membres et les groupes de sécurité associés, ainsi que ses partages de données. Toute autre personne voit ces panneaux en lecture seule, avec la remarque « Only project Architects can change access. »

L’accès « Tous les membres de l’espace de travail » est l’option la plus simple, car il donne accès à tous les membres de l’espace de travail et ne nécessite aucune attribution supplémentaire de membres.

Le paramètre d’accès « Membres spécifiques uniquement » exige d’attribuer chaque membre au projet. Pour attribuer des membres à un projet :

  1. Ouvrez Analyze
  2. Sélectionnez « Projets » dans la barre de menus supérieure
  3. Cliquez sur l’icône des membres
  4. Accordez l’accès aux membres en cochant la case en regard de leur nom dans la colonne « Access »
  5. Cliquez sur « Update »

Pour les clouds comptant un grand nombre de membres, cette approche peut demander plus d’efforts que souhaité, et c’est là que les groupes de sécurité deviennent utiles.

L’option « Groupes de sécurité spécifiques uniquement » permet d’accorder à des groupes de sécurité précis l’autorisation d’accéder au compte. Les restrictions d’accès reposant sur l’association à un ou plusieurs groupes de sécurité, l’administration de l’accès au compte pour des groupes plus importants est beaucoup plus simple. C’est particulièrement utile lorsqu’elle est combinée à l’association automatique de groupes par authentification unique. En utilisant l’authentification unique pour définir les attributions de groupes des membres, ces groupes peuvent aussi activer et désactiver implicitement l’accès aux projets.

Pour modifier les groupes attribués :

  1. Ouvrez Analyze
  2. Sélectionnez « Projets » dans la barre de menus supérieure
  3. Cliquez sur l’icône des groupes de sécurité
  4. Accordez l’accès aux groupes de sécurité en cochant la case en regard de leur nom dans la colonne « Access »
  5. Cliquez sur « Update »

Un partage de données permet à un projet d’accéder aux tables d’un autre projet, par exemple pour que les étapes Import Project Table et Export Project Table puissent déplacer des données entre eux. Un partage est accordé par le projet dont les données sont partagées, à un autre projet :

  1. Ouvrez le projet dont vous souhaitez partager les données, puis accédez à son accueil du projet.
  2. Ouvrez Access & sharing. Sous Partages de données, cliquez sur Nouveau partage de données.
  3. Sous Sélectionner un projet, choisissez le projet autorisé à utiliser les données de ce projet.
  4. Sous Opérations autorisées, cochez Lecture, Écriture ou les deux, puis cliquez sur Ajouter un partage de données.

Supprimer le partage de données supprime un partage, après confirmation. Seul un Architecte du projet ou un administrateur du tenant peut ajouter ou supprimer les partages de données d’un projet.

Un partage est accordé à un projet ; il ne vaut donc que pour les membres de ce projet et ses workflows :

  • La lecture via un partage exige un rôle dans le projet auquel il a été accordé. Une personne sans rôle dans ce projet n’obtient rien du partage.
  • L’écriture via un partage (création d’une table, d’un dossier ou d’une dimension dans le projet qui partage) exige un partage en Écriture et le rôle Gestionnaire ou Architecte dans votre propre projet, c’est-à-dire le rôle qui pourrait y effectuer la même modification. Toute autre personne reçoit le message « Writing to this project through a data share needs a write share from it to your project, and the Manager or Architect role in your project. »

Les workflows s’exécutent avec l’identité propre à leur projet ; les étapes Import Project Table et Export Project Table fonctionnent donc via un partage, quelle que soit la personne qui lance l’exécution.

Un projet nécessite souvent plusieurs transformations et tables pour réaliser des étapes intermédiaires, alors que le résultat final peut ne comporter que quelques tables. Les membres n’ont pas toujours besoin de voir tous les éléments du projet, parfois seulement le produit final. PlaidCloud vous permet de définir différents rôles de consultation pour alléger facilement l’affichage et contrôler la visibilité de chaque membre.

Il existe trois rôles de consultation intégrés : Architecte, Gestionnaire et Explorateur

Le rôle Architecte est le plus simple, car il offre une visibilité et un contrôle complets sur les projets, les workflows, les tables, les variables, les éditeurs de données, les hiérarchies et les fonctions définies par l’utilisateur.

Les rôles Gestionnaire et Explorateur n’ont pas de privilèges d’accès spécifiques mais peuvent être personnalisés. Autrement dit, vous pouvez choisir quels éléments sont visibles pour chaque groupe.

Vous pouvez faire de tout le monde un Architecte si vous estimez que la visibilité de tout le contenu du projet est nécessaire ; sinon, vous pouvez désigner des membres du projet comme Gestionnaire et/ou Explorateur et contrôler ainsi la visibilité.

Pour définir le rôle :

  1. Ouvrez Analyze
  2. Sélectionnez « Projets »
  3. Cliquez sur l’icône des membres
  4. Sélectionnez le membre dont vous souhaitez modifier le rôle
  5. Double-cliquez sur son rôle actuel dans la colonne « Role »
  6. Sélectionnez le rôle souhaité
  7. Cliquez sur « Update »

Lors de l’exécution d’un projet ou d’un workflow, il peut être utile de définir des variables pour les tâches récurrentes afin de réduire l’encombrement et de gagner du temps. Ces variables fonctionnent comme une variable algébrique normale : elles vous permettent de définir ce que la variable représente et quelle opération doit la suivre. PlaidCloud vous permet de définir ces variables au niveau du projet, ce qui affectera tous les workflows de ce projet, ou au niveau du workflow, ce qui n’affectera que ce workflow précis.

Pour définir une variable au niveau du projet :

  1. Ouvrez Analyze
  2. Sélectionnez « Projets »
  3. Cliquez sur l’icône Gérer les variables du projet

Depuis la table des variables, vous pouvez afficher les variables et afficher ou modifier leurs valeurs actuelles. Vous pouvez aussi ajouter de nouvelles variables ou supprimer des variables existantes en cliquant sur le bouton « New Project Variable ».

Copier le projet copie un projet, en entier ou seulement les parties que vous choisissez, dans un tout nouveau projet ou dans un projet existant.

Pour copier un projet :

  1. Ouvrez Analyze
  2. Sélectionnez « Projets »
  3. Sélectionnez le projet que vous souhaitez copier
  4. Cliquez sur le bouton Actions et choisissez Copier le projet
  5. Choisissez la cible, sélectionnez ce qu’il faut reprendre et quelles données copier, puis cliquez sur Copier le projet
  6. Vérifiez le récapitulatif Vérifier avant de copier et cliquez sur Démarrer la copie

L’arborescence de sélection liste le contenu du projet, par type : workflows, étapes, tables, dimensions, éditeurs de données, fonctions définies par l’utilisateur. Laissez tout coché pour copier l’ensemble du projet, ou cochez uniquement les parties souhaitées.

Vous n’avez pas à déterminer de quoi ces parties dépendent. Tout ce que vous cochez emporte ses dépendances : les tables qu’une étape lit et écrit, les dimensions qu’elle charge ou par rapport auxquelles elle alloue, les fonctions définies par l’utilisateur qu’elle appelle, ainsi que tout sous-workflow ou toute macro qu’elle invoque. Les capteurs d’un workflow accompagnent le workflow.

Les capteurs copiés arrivent désactivés. Rien ne se déclenche sur la copie tant que vous n’avez pas activé chaque capteur dans le projet de destination. Une importation qui écrase les éléments en double n’ajoute pas de second capteur lorsque le workflow de destination en possède déjà un.

Donnez au nouveau projet un nom et un ID. L’ID devient le nom de son schéma et ne peut pas être modifié par la suite.

Les planifications arrivent suspendues. Lorsque vous copiez un projet entier dans un nouveau projet, les événements planifiés de chaque workflow arrivent suspendus, de sorte que la copie ne commence pas à les exécuter d’elle-même. Une fois la copie terminée, un message liste les événements qui étaient actifs dans l’original. Pour en exécuter un sur la copie, sélectionnez-le dans Outils > Planificateur d’événements et cliquez sur Activer la sélection ; consultez Suspendre un événement.

Choisissez la cible dans la liste des projets. La copie s’ajoute à ce projet au lieu de le remplacer.

Vous devez pouvoir modifier la cible. Une copie vers un projet dans lequel vous n’avez aucun rôle est refusée, tout comme une copie vers un projet verrouillé pour empêcher les modifications ; cette vérification a lieu avant toute lecture ou écriture, de sorte qu’une copie refusée laisse la cible intacte. Un projet ne peut pas non plus être copié dans lui-même.

Copier un projet qui restreint les lignes exige un Architecte du projet. La copie est un nouveau projet sans restriction d’accès aux lignes, et la copie vous l’indique : « This copy is not row-restricted. » Configurez Accès aux lignes sur la copie avant de la partager. Copier vers un projet existant qui restreint les lignes exige de même l’un de ses Architectes ou un administrateur du tenant.

La cible conserve ses propres paramètres. Son nom, son ID, son environnement de connexion de données, ses valeurs de stockage par défaut, son compte de documents, son type d’accès, ses listes d’accès et ses droits d’accès aux lignes restent tels quels. Seul le contenu que vous avez sélectionné est importé.

Une étape définie sur Valeur par défaut du projet transporte ce paramètre, et non un compte : une fois copiée, elle utilise la valeur par défaut du projet cible, et non celle qu’elle avait dans la source.

Lorsqu’un élément entrant est le même élément que celui déjà présent dans la cible, vous choisissez ce qui se passe :

  • Écraser les éléments en double avec les données entrantes : la version entrante remplace celle de la cible.
  • Créer une copie des éléments en double : la cible conserve ce qu’elle a, et l’élément entrant est ajouté à côté, avec copy ajouté à son nom, et un compteur si ce nom est déjà pris.

Les variables de projet et de workflow font exception à Créer une copie : une variable est identifiée par son nom ; il est donc impossible d’en ajouter une seconde copie sans la renommer en quelque chose auquel rien ne fait référence. Lorsque la cible définit déjà une variable que la copie transporte aussi, la valeur propre à la cible est conservée et la copie vous indique quelles variables elle a laissées intactes. Écraser traite les variables comme tout le reste et les remplace.

Cette correspondance se fait par identité, et non par nom : un élément issu à l’origine du même projet est reconnu comme le même élément, tandis que deux éléments qui portent simplement le même nom sont traités comme des éléments différents et seront tous deux présents ensuite.

Sous Data to copy, deux paramètres déterminent quelles données accompagnent votre sélection.

Données de la table définit combien de lignes de chaque table sont copiées :

Choix Ce qui est copié
No table data Les tables, les étapes et le reste de la sélection, sans lignes. C’est la valeur par défaut.
Complet Toutes les lignes de chaque table, sur le même Lakehouse et entre Lakehouses.
Échantillon Jusqu’au nombre de lignes par table que vous saisissez, pour un nouveau projet uniquement. Le nombre peut aller de 1 à 1 000 000.

Une table échantillonnée contient jusqu’à ce nombre de lignes, ou toutes ses lignes si elle en compte moins. Une copie Complet ou Échantillon copie plusieurs tables à la fois ; un projet comptant beaucoup de tables se termine donc plus vite.

Copy dimension members copie les membres de chaque dimension de la sélection, quel que soit le choix Données de la table. Cette option est activée par défaut ; une copie sans données de table arrive donc avec des dimensions renseignées et se fait rapidement. Désactivez-la pour copier les dimensions sans leurs membres.

Via l’API REST (POST /rest/v1/analyze/project/copy) ou l’outil MCP project_copy, définissez data_mode sur structure, full ou sample, et dimension_members sur true ou false. Si vous omettez dimension_members, les membres ne sont copiés que lorsque les lignes de table le sont. project_copy renvoie aussi les avertissements de la copie, par exemple les autorisations d’écriture ERP qui n’ont pas été copiées.

Avant toute copie, Vérifier avant de copier récapitule la copie : le projet source, la destination, le choix Données de la table, l’inclusion ou non des Membres de dimension, le nombre de tables et de vues, la taille, une durée estimée, le Lakehouse source et cible, ainsi que tout avertissement sous À noter. Cliquez sur Démarrer la copie pour commencer, ou sur Annuler pour revenir en arrière et modifier la sélection.

Une copie réalisée avec des données (lignes de table, membres de dimension, ou les deux) est privée pour la personne qui l’a effectuée. Partagez-la depuis le nouveau projet lorsque vous êtes prêt. Une copie d’un projet doté d’une sécurité au niveau des lignes reste privée pour la même raison.

Copier des données dans un projet existant exige un accès en écriture à ce projet.

Une nouvelle copie privée pour vous conserve les autorisations d’écriture ERP du projet source, de sorte que vous pouvez tester ses workflows de comptabilisation sans autoriser de nouveau la copie. Cela concerne toute copie vers un nouveau projet réalisée avec des données de table (Complet ou Échantillon), des membres de dimension, ou les deux. Les autorisations sont copiées lorsque :

  • Vous êtes Architecte du projet source ou administrateur de l’espace de travail.
  • Vous effectuez la copie vous-même, et non via un agent ou un compte de service.

Chaque autorisation n’est copiée que si vous pourriez l’accorder vous-même aujourd’hui : sa connexion et son environnement existent toujours, et vous avez un accès en écriture à la connexion. Les autorisations copiées sont enregistrées comme étant les vôtres.

La copie arrive en Simulate. Si le Mode d’écriture ERP du projet source est Live, celui de la copie est défini sur Simulate ; ses workflows construisent donc et vérifient ce qu’ils comptabiliseraient sans contacter l’ERP. Une source définie sur Simulate ou Off conserve ce paramètre. Lorsque vous êtes prêt à comptabiliser pour de bon depuis la copie, définissez Mode d’écriture ERP sous Écriture ERP sur la page d’accueil de la copie sur Live ; consultez Choisir un mode de comptabilisation. Les planifications et les capteurs arrivent toujours suspendus et désactivés comme décrit plus haut ; rien ne s’exécute donc sur la copie tant que vous ne l’activez pas.

Une copie vers un projet existant, ou une copie sans données de table ni membres de dimension, démarre sans les autorisations de la source. Autorisez-la sous Écriture ERP > Autorisations d’écriture ERP sur sa page d’accueil avant qu’elle ne comptabilise.

Copier les résultats indique ce qui s’est passé, par exemple « 2 ERP write authorizations copied; ERP posting is in Simulate », ainsi que le nombre d’autorisations non copiées.

Lorsque la copie est terminée, une fenêtre Copier les résultats récapitule les tables et les membres de dimension copiés et liste chaque table et chaque dimension par son nom avec son résultat (Copié, Copié avec modifications, Échantillonné, Ignoré ou Échec) et la raison de tout élément ignoré ou en échec. Cliquez sur Retry failed items pour copier de nouveau les tables et dimensions en échec ; leur contenu actuel dans la copie est remplacé. Vous êtes averti, par message et par e-mail, lorsqu’une copie se termine ou échoue, et vous pouvez rouvrir les résultats depuis le message, ou plus tard en sélectionnant la copie dans l’onglet Projets et en choisissant Voir le résultat de l’importation ou de la copie dans le menu Actions.

Les résultats restent sur la copie tant que personne ne les ignore. Une fois la copie terminée, cliquez sur Ignorer le résultat pour les supprimer pour toutes les personnes qui peuvent ouvrir le projet. Rien ne change dans le projet, mais ses éléments en échec ne peuvent plus être relancés depuis la fenêtre. Ignorer exige un accès en modification au projet, et le projet ne doit pas être verrouillé.

Les étapes de workflow d’un projet font référence à des tables et à d’autres objets de ce projet. Mettre à jour les références réécrit ces références pour qu’elles pointent vers la copie plutôt que vers l’original, ce qui est presque toujours le but recherché et explique pourquoi cette option est activée par défaut. La désactiver laisse les étapes copiées pointer vers le projet d’origine.

Lorsqu’un projet ou un workflow est dynamique, tenir une documentation détaillée devient un défi. Pour y remédier, PlaidCloud permet de générer un rapport au niveau du projet qui documente en détail les workflows, les étapes de workflow, les transformations définies par l’utilisateur, les variables et les tables. Ce rapport est généré à la demande et reflète l’état actuel du projet.

Pour télécharger le rapport :

  1. Ouvrez Analyze
  2. Sélectionnez « Projets »
  3. Cliquez sur l’icône du rapport