GT ClassMethodsTranslation

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

NombreTipoDescripción
filesFileUploadRef[]Array de referencias a archivos de los archivos fuente previamente subidos
timeoutMs?numberTiempo 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';
}
PropiedadTipoDescripción
setupJobIdstringIdentificador ú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:

index.ts
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 uploadSourceFiles antes de llamar a setupProject
  • 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

¿Qué te parece esta guía?