GT ClassMethodsTranslation

setupProject

Référence de l’API pour la méthode setupProject, utilisée pour initialiser la configuration du projet de traduction

Vue d’ensemble

La méthode setupProject initialise la configuration d’un projet de traduction à partir de files déjà téléversés. Elle crée une tâche de configuration asynchrone qui analyse les files et les prépare pour les workflows de traduction.

const gt = new GT({ projectId: 'your-project-id', apiKey: 'your-api-key' });

const setupResult = await gt.setupProject(fileRefs, 30000);
console.log(`Tâche de configuration créée : ${setupResult.setupJobId}`);

Vous devez avoir importé au préalable les files à l’aide de uploadSourceFiles avant d’appeler setupProject.

Références

Paramètres

NomTypeDescription
filesFileUploadRef[]Tableau de références vers des fichiers provenant des fichiers sources téléversés précédemment
timeoutMs?numberDélai d’attente facultatif, en millisecondes, pour la requête à l’API

Structure de FileUploadRef

type FileUploadRef = {
  fileId: string;
  versionId: string;
  fileName: string;
  fileFormat?: FileFormat;
  dataFormat?: DataFormat;
}

Renvoie

Promise<SetupProjectResult> - Contient l’identifiant de la tâche de configuration et son état initial.

type SetupProjectResult = {
  setupJobId: string;
  status: 'queued';
}
PropriétéTypeDescription
setupJobIdstringIdentifiant unique de la tâche de configuration
status'queued'Statut initial de la tâche de configuration

Exemples

Utilisation de base

Initialisez la configuration du projet avec des files téléversés :

index.ts
import { GT } from 'generaltranslation';

const gt = new GT({
  projectId: 'your-project-id',
  apiKey: 'your-api-key'
});

// Références de fichiers du téléchargement précédent
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);
console.log(`Configuration initiée avec l'ID de tâche : ${setupResult.setupJobId}`);

Remarques

  • Les files doivent être téléversés à l’aide de uploadSourceFiles avant d’appeler setupProject
  • La configuration du projet analyse le contenu et la structure des files afin d’optimiser les flux de travail de traduction
  • La tâche de configuration s’exécute de manière asynchrone — surveillez l’avancement avec checkSetupStatus
  • La configuration est généralement requise avant de mettre en file d’attente des tâches de traduction pour de nouveaux projets

Prochaines étapes

  • Consultez uploadSourceFiles pour téléverser des files avant la configuration
  • Consultez checkSetupStatus pour suivre l’état d’avancement de la configuration
  • Consultez shouldSetupProject pour vérifier si une configuration est requise
  • Consultez enqueueFiles pour lancer les traductions après la configuration

Comment trouvez-vous ce guide ?