Actions sécurisées à travers l'intégration de chat, MCP et Windows¶
Le clavardage sur le Web et le MCP utilisent le même catalogue de capacités et les mêmes services de domaine en version. La lecture et l'écriture suivent donc le même projet, rôle, objet et vérification de version. Les domaines pris en charge comprennent la bibliothèque de test, les exigences, la planification, l'exécution, les résultats, les examens, les relations, les défauts, les pièces jointes, les connaissances sur la libération et le changement, l'administration et l'importation ou l'exportation de Word.
Une réponse AI ou un aperçu du MCP ne modifie pas les données du projet. Les écrits sont préparés, examinés, explicitement confirmés et vérifiés.
Préparer, examiner, engager et vérifier¶
- Préparer : Chat ou MCP transforme l'opération de domaine demandée en une préparation concrète et contrôlée par autorisation.
- Aperçu : Examiner la cible, le changement proposé, les effets, les avertissements et, le cas échéant, la version prévue de l'objet.
- S'engager: Confirmez seulement un aperçu inchangé que vous comprenez. Redémarrer après un conflit d'expiration ou de version.
- Vérification : Examiner le résultat, le lien profond et le dossier de vérification. Idempotency empêche une réessayer technique d'appliquer silencieusement le même changement deux fois.
La permission manquante, la version statique, la capacité inconnue ou les arguments invalides échouent fermés plutôt que d'appliquer une mise à jour partielle.
Configurer MCP avec le moins de privilèges¶
MCP utilise JSON-RPC 2.0 à POST /mcp. Les clés de l'API de projet personnel fonctionnent avec les rôles et les permissions de leur utilisateur actif de projet. Les clés administratives mondiales sont séparées; une clé mondiale doit être expressément approuvée avant d'avoir accès aux outils du projet.
- Créez les clés dans l'administration de la clé API MCP prévue et copiez le secret immédiatement; il ne peut pas être affiché à nouveau.
- Utilisez une durée de vie courte, des champs d'application minimaux et un but clair.
- Passer l'ID unique du projet ou un chemin de projet approuvé au lieu de s'appuyer sur un contexte global implicite.
- Inspectez le catalogue d'outils et l'explorateur de capacités avant d'automatiser une opération.
- Récupérer les clés qui ne sont plus nécessaires ou qui peuvent avoir été exposées.
Étapes d'essai réutilisables au moyen du MCP¶
Pour Étapes d'essai réutilisables, ztm_project_reusable_test_steps utilise la capacité project.reusable-test-step.read :
operation |
Autres arguments | Résultat |
|---|---|---|
list |
option includeArchived |
Blocs autorisés avec leur révision fixe actuelle et leur empreinte digitale |
detail |
blockID |
Contenu, historique de révision et utilisations autorisées |
composition |
testCaseVariantID |
Sections et empreintes digitales actuelles de la bibliothèque |
Les écritures utilisent ztm_project_action_prepare et ztm_project_action_commit. La clé API doit permettre la capacité exacte d'écriture; l'accès général à l'écriture est insuffisant. Fournissez ces arguments :
| Capacité | Arguments |
|---|---|
project.reusable-test-step.save |
block avec ID (vide lors de la création), TestUnitID, Title, StepsRaw, ExpectedRaw, Note, Archived; plus expectedFingerprint (vide lors de la création) |
project.reusable-test-step.composition.save |
testCaseVariantID, le sections complet commandé et expectedFingerprint |
project.reusable-test-step.composition.detach |
testCaseVariantID et expectedFingerprint |
Une section réutilisable contient BlockID et le Revision explicitement sélectionné. Une section locale n'a pas de BlockID et contient StepsRaw plus ExpectedRaw optionnel. Le texte brut suit le mode HTML ou Markdown du projet. Préserver chaque section locale inchangée lors de l'enregistrement d'une composition. Un résultat attendu intentionnellement vide reste vide.
save crée une nouvelle révision fixe ; Archived: true archive le bloc. Il n'y a pas de commande physique ou de mise à jour automatique de tous les usages. Convertir une section en contenu local en remplaçant sa référence par ses textes bruts résolus. La commande détach convertit la composition sauvegardée entière.
Examinez l'ancien et le nouveau contenu avant de lancer, réutiliser le même idempotencyKey pour les requêtes techniques, et validez uniquement le previewToken retourné. Relisez et préparez-vous après un conflit d'empreintes digitales. Le service partagé Runtime vérifie l'accès à la lecture source et à l'écriture cible et rejette les tests rapides. La synchronisation existante renvoie skippedManagedContent pour le contenu historique conservé : les étapes/résultats gérés dans les parcours existants restent gelés tandis que d'autres champs sélectionnés peuvent synchroniser.
Pont local et actions locales contrôlées¶
Zeta Test Local Bridge connecte les workflows Web pris en charge aux fonctions locales contrôlées de Windows. Le serveur web ne peut pas démarrer des processus locaux arbitraires. Chrome ou Edge communique par l'extension du navigateur avec un hôte de messagerie Native installé, tandis qu'une politique de niveau machine permet seulement nommé, actions dactylographiées.
- Un administrateur déploie l'extension Native Host et le navigateur, puis ne connecte que le site Web ZTM prévu.
- La TI du client définit les actions approuvées dans la politique de Pont local. Les lignes de commande gratuites et l'héritage de Lua restent bloqués dans le client web.
- Les outils externes utilisent une référence structurée comme
ztm-local-bridge:action-id. Seule une action installée et approuvée par la politique peut fonctionner. - Utilisez l'administration pour vérifier l'état, la version, le somme de contrôle, les paramètres et les valeurs de politique Chrome ou Edge générées.
Traiter l'extension, l'hôte autochtone, l'association de sites et la politique locale comme une frontière de sécurité. Un pont connecté ne remplace pas les autorisations de projet ou d'objet.
Version des cas d'essai¶
ztm_project_test_case_versions lit Version des scénarios d'essai par project.test-case-version.read. Liste, contenu, comparaison, fichiers historiques et prévisualisation imposent les mêmes permissions d'objet que le client Web. La restauration utilise la capacité d'écriture project.test-case-version.restore préparée et explicitement confirmée; les arguments et le workflow sont également décrits dans le Chapitre REST.
Rapports de qualité en lecture seule¶
Les rapports ztm_library_health_read (project.library-health.read) expliquent les indicateurs d'examen des cas de bibliothèque visibles. ztm_test_stability_read (project.test-stability.read) retourne les changements de résultats et les groupes de défaillances avec les preuves de résultats des exécutions visibles terminées. Les deux utilisent les services Web et ne nécessitent aucune subvention écrite. Les limites de visibilité, les limites d'analyse et les données d'automatisation modifiées demeurent explicites; les indicateurs ne remplacent pas une décision d'entreprise. Les filtres, champs de réponse et exemples REST sont décrits dans le Chapitre API.
ztm_project_planning_tree_read lit l'arborescence de planification filtrée par des états de résultats personnalisés. Voir le contrat de filtrage. Cette opération de lecture ne modifie pas les paramètres de la vue personnelle.
Liens Windows optionnels vers les fonctionnalités Web¶
La capacité project.presentation-settings.update inclut le booléen settings.showWindowsWebLinks. Il est activé par défaut. Lire les paramètres actuels, modifier ce champ, puis préparer et confirmer explicitement la mise à jour. Les charges utiles plus anciennes qui omettent ce champ conservent sa valeur actuelle. Le même contrat s'applique par l'intermédiaire du MCP et de la REST, y compris les droits d'administration des projets, les contrôles de portée et la protection de l'avant-projet.
Ceci contrôle les entrées optionnelles de menu et de boîte de dialogue Windows, et non les permissions d'accès Web. La commande explicite de ruban Ouvrir dans le Web reste disponible. Réouvrir le projet sous Windows après un changement effectué par un autre client.
Importation à partir d'un autre outil de test¶
Dans le développement actuel, utilisez les outils MCP ztm_vendor_migration_preview et ztm_vendor_migration_apply pour migration à partir d'un autre outil. Le REST API décrit leurs paramètres partagés, leur accès à l'écriture et leur comportement de réessayer.