setupProject
Référence de l’API pour la méthode setupProject, qui initialise la configuration d’un projet de traduction
Vue d’ensemble
La méthode setupProject lance la configuration d’un projet de traduction à partir de fichiers déjà téléversés.
Elle crée une tâche asynchrone qui analyse les fichiers et les prépare pour les flux 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 téléversé les fichiers au préalable à l’aide de uploadSourceFiles avant d’appeler setupProject.
Références
Paramètres
| Nom | Type | Description | 
|---|---|---|
| files | FileUploadRef[] | Tableau de références à des fichiers issus des fichiers source précédemment téléversés | 
| timeoutMs? | number | Dé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é | Type | Description | 
|---|---|---|
| setupJobId | string | Identifiant unique du travail de configuration | 
| status | 'queued' | Statut initial du travail de configuration | 
Exemples
Utilisation de base
Initialisez la configuration du projet avec des fichiers importés :
import { GT } from 'generaltranslation';
const gt = new GT({
  projectId: 'your-project-id',
  apiKey: 'your-api-key'
});
// Références de fichiers d'un 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 fichiers doivent être téléversés à l’aide de uploadSourceFilesavant d’appelersetupProject
- La configuration du projet analyse le contenu et la structure des fichiers afin d’optimiser les workflows de traduction
- La tâche de configuration s’exécute de façon asynchrone — surveillez l’avancement avec checkSetupStatus
- La configuration est généralement requise avant de mettre en file d’attente des jobs de traduction pour les nouveaux projets
Prochaines étapes
- Consultez uploadSourceFilespour téléverser les fichiers avant la configuration
- Consultez checkSetupStatuspour suivre l’avancement de la configuration
- Consultez shouldSetupProjectpour vérifier si une configuration est nécessaire
- Consultez enqueueFilespour lancer les traductions après la configuration
Que pensez-vous de ce guide ?

