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
| Nom | Type | Description |
|---|---|---|
files | FileUploadRef[] | Tableau de références vers des fichiers provenant des fichiers sources téléversés précédemment |
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 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 :
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
uploadSourceFilesavant d’appelersetupProject - 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
uploadSourceFilespour téléverser des files avant la configuration - Consultez
checkSetupStatuspour suivre l’état d’avancement de la configuration - Consultez
shouldSetupProjectpour vérifier si une configuration est requise - Consultez
enqueueFilespour lancer les traductions après la configuration
Comment trouvez-vous ce guide ?