checkSetupStatus
Référence de l’API pour la méthode checkSetupStatus permettant de suivre l’avancement de la tâche de configuration du projet
Vue d’ensemble
La méthode checkSetupStatus vérifie l’état actuel d’une tâche de configuration de projet à l’aide de son identifiant unique.
Elle sert à suivre l’avancement des opérations de configuration asynchrones lancées par setupProject.
La configuration prend en charge des tâches telles que l’analyse du corpus, la génération du contexte, la création du glossaire, etc.
La configuration s’exécute automatiquement lorsque des éléments de contexte sont manquants. Concrètement, lors de la première exécution de translate, vous verrez une tâche de configuration en cours.
const gt = new GT({ projectId: 'your-project-id', apiKey: 'your-api-key' });
const status = await gt.checkSetupStatus('setup-job-123');
console.log(`Statut de configuration : ${status.status}`);Pour vérifier l’état d’une tâche de configuration, vous devez d’abord avoir appelé à la fois uploadSourceFiles et setupProject.
Références
Paramètres
| Nom | Type | Description | 
|---|---|---|
| jobId | string | L’identifiant unique de la tâche de configuration à vérifier | 
| timeoutMs? | number | Délai d’attente optionnel, en millisecondes, pour la requête API | 
Renvoie
Promise<CheckSetupStatusResult> - Contient l’état actuel de la tâche et les informations associées.
type CheckSetupStatusResult = {
  jobId: string;
  status: SetupJobStatus;
  error?: { message: string };
}| Propriété | Type | Description | 
|---|---|---|
| jobId | string | L'identifiant de la tâche de configuration qui a été vérifiée | 
| status | SetupJobStatus | État actuel de la tâche de configuration | 
| error? | { message: string } | Informations sur l'erreur si l'état est 'failed' | 
ÉtatDuJobDeConfiguration
type SetupJobStatus = 'queued' | 'processing' | 'completed' | 'failed';- 'queued'- La tâche est en attente de traitement
- 'processing'- La tâche est en cours d’exécution
- 'completed'- La tâche s’est terminée avec succès
- 'failed'- La tâche a rencontré une erreur et a échoué
Exemple
Vérification de l’état de base
import { GT } from 'generaltranslation';
const gt = new GT({
  projectId: 'your-project-id',
  apiKey: 'your-api-key'
});
const fileRefs = [
  {
    fileId: 'file-123',
    versionId: 'version-456',
    fileName: 'app.json',
    fileFormat: 'JSON'
  },
  {
    fileId: 'file-789',
    versionId: 'version-012',
    fileName: 'content.md',
    fileFormat: 'MD'
  }
];
const setupResult = await gt.setupProject(fileRefs);
async function checkJobStatus(jobId: string) {
  const status = await gt.checkSetupStatus(jobId);
  
  console.log(`Travail ${jobId}:`);
  console.log(`  Statut: ${status.status}`);
  
  if (status.error) {
    console.log(`  Erreur: ${status.error.message}`);
  }
  
  return status;
}
const jobStatus = await checkJobStatus(setupResult.setupJobId);Notes
- La configuration s’exécute automatiquement lorsque des éléments de contexte sont manquants.
- La configuration gère l’analyse du corpus, la génération du contexte, la génération du glossaire, etc.
- Les IDs de job sont renvoyés par setupProjectet doivent être conservés pour vérifier l’état
Prochaines étapes
- Consultez setupProjectpour lancer les tâches de configuration
- Consultez shouldSetupProjectpour vérifier si une configuration est nécessaire
- Consultez enqueueFilespour poursuivre après la fin de la configuration
- Consultez getProjectDatapour obtenir des informations sur le projet
Que pensez-vous de ce guide ?
checkFileTranslations
Référence de l’API pour la méthode checkFileTranslations permettant de vérifier l’état des traductions sans télécharger les fichiers
downloadFileBatch
Référence de l’API pour la méthode downloadFileBatch, qui permet de télécharger plusieurs fichiers de traduction en une seule requête

