setupProject
Referencia de API del método setupProject para iniciar la configuración del proyecto de traducción
Descripción general
El método setupProject inicia el proceso de configuración de un proyecto de traducción utilizando files previamente cargados.
Esto crea una tarea de configuración asíncrona que analiza los files y los prepara para los flujos de trabajo de traducción.
const gt = new GT({ projectId: 'your-project-id', apiKey: 'your-api-key' });
const setupResult = await gt.setupProject(fileRefs, 30000);
console.log(`Trabajo de configuración creado: ${setupResult.setupJobId}`);Debes haber subido previamente los files con uploadSourceFiles antes de llamar a setupProject.
Referencias
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
files | FileUploadRef[] | Array de referencias a archivos de los archivos fuente previamente subidos |
timeoutMs? | number | Tiempo de espera opcional en milisegundos para la solicitud a la API |
Estructura de FileUploadRef
type FileUploadRef = {
fileId: string;
versionId: string;
fileName: string;
fileFormat?: FileFormat;
dataFormat?: DataFormat;
}Devuelve
Promise<SetupProjectResult> - Incluye el identificador de la tarea de configuración y su estado inicial.
type SetupProjectResult = {
setupJobId: string;
status: 'queued';
}| Propiedad | Tipo | Descripción |
|---|---|---|
setupJobId | string | Identificador único del job de configuración |
status | 'queued' | Estado inicial del job de configuración |
Ejemplos
Uso básico
Inicia la configuración del proyecto con files cargados:
import { GT } from 'generaltranslation';
const gt = new GT({
projectId: 'your-project-id',
apiKey: 'your-api-key'
});
// Referencias de archivos de una carga anterior
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(`Configuración iniciada con el ID del job: ${setupResult.setupJobId}`);Notas
- Los files deben subirse con
uploadSourceFilesantes de llamar asetupProject - La configuración del proyecto analiza el contenido y la estructura de los archivos para optimizar los flujos de trabajo de traducción
- La tarea de configuración se ejecuta de forma asíncrona; supervise el progreso con
checkSetupStatus - La configuración suele ser necesaria antes de encolar trabajos de traducción para proyectos nuevos
Próximos pasos
- Consulta
uploadSourceFilespara subir files antes de la configuración - Consulta
checkSetupStatuspara supervisar el progreso de la configuración - Consulta
shouldSetupProjectpara comprobar si se requiere la configuración - Consulta
enqueueFilespara iniciar las traducciones después de la configuración
¿Qué te parece esta guía?