# General Translation Platform: FileToTranslate (heredado)
URL: https://generaltranslation.com/es/docs/platform/core/reference/types/file-to-translate.mdx
---
title: FileToTranslate (heredado)
description: Consulte la entrada de archivo heredada eliminada de Core v9 y su reemplazo actual. Referencia de la API de FileToTranslate.

---

`FileToTranslate` representaba un objeto de archivo en los flujos de trabajo de traducción por lotes de Core 8.x. No se exporta desde `generaltranslation` 9.x.

<Callout type="info">
  **Modificado en v9:** se eliminó `FileToTranslate`. Use `FileToUpload` para [`uploadSourceFiles`](/docs/platform/core/reference/gt-class-methods/translation/upload-source-files) y, después, pase las referencias de archivo devueltas a [`enqueueFiles`](/docs/platform/core/reference/gt-class-methods/translation/enqueue-files).
</Callout>

## Descripción general [#overview]

El tipo heredado agrupaba el contenido sin procesar, el nombre y el formato de un archivo:

```typescript
type FileToTranslate = {
  content: string;
  fileName: string;
  fileFormat: FileFormat;
  formatMetadata?: Record<string, any>;
  dataFormat?: DataFormat;
};
```

## Propiedades [#properties]

| Propiedad                            | Descripción                                    | Tipo                                                            | Opcional |
| ------------------------------------ | ---------------------------------------------- | --------------------------------------------------------------- | -------- |
| [`content`](#content)                | Contenido sin procesar del archivo.            | `string`                                                        | No       |
| [`fileName`](#file-name)             | Identificador del archivo.                     | `string`                                                        | No       |
| [`fileFormat`](#file-format)         | Identificador heredado del formato de archivo. | unión de cadenas                                                | No       |
| [`formatMetadata`](#format-metadata) | Metadatos específicos del formato.             | `Record<string, any>`                                           | Sí       |
| [`dataFormat`](#data-format)         | Formato de los datos dentro del archivo.       | [`DataFormat`](/docs/platform/core/reference/types/data-format) | Sí       |

### `content` [#content]

**Tipo** `string` · **Obligatorio**

Contenido sin procesar del archivo.

### `fileName` [#file-name]

**Tipo** `string` · **Obligatorio**

Identificador del archivo, como `common.json` o `docs/start.mdx`.

### `fileFormat` [#file-format]

**Tipo** unión de cadenas · **Obligatorio**

Un identificador heredado de formato de archivo, como `'JSON'`, `'PO'`, `'MDX'` o `'HTML'`.

### `formatMetadata` [#format-metadata]

**Tipo** `Record<string, any>` · **Opcional**

Metadatos específicos del formato.

### `dataFormat` [#data-format]

**tipo** [`DataFormat`](/docs/platform/core/reference/types/data-format) · **Opcional**

Formato de los datos dentro del archivo: `'JSX'`, `'ICU'` o `'I18NEXT'`.

## Ejemplo heredado [#legacy-example]

```typescript
// solo generaltranslation 8.x
import type { FileToTranslate } from 'generaltranslation';

// Archivo JSON
const jsonFile: FileToTranslate = {
  content: JSON.stringify({
    "welcome": "Welcome",
    "save": "Save"
  }),
  fileName: 'common.json',
  fileFormat: 'JSON',
  dataFormat: 'I18NEXT'
};
```

```typescript
// Archivo MDX
const mdxFile: FileToTranslate = {
  content: `# Getting Started\n\nWelcome to our platform!`,
  fileName: 'docs/start.mdx',
  fileFormat: 'MDX',
  dataFormat: 'JSX'
};
```

## Reemplazo actual [#replacement]

En 9.x, importa `FileToUpload` desde `generaltranslation/types`, carga el archivo fuente y usa la referencia devuelta en operaciones posteriores:

```typescript
import { GT } from 'generaltranslation';
import type { FileToUpload } from 'generaltranslation/types';

const gt = new GT({
  apiKey: process.env.GT_API_KEY,
  projectId: process.env.GT_PROJECT_ID,
});

const source = {
  content: JSON.stringify({ welcome: 'Welcome' }),
  fileName: 'common.json',
  fileFormat: 'JSON',
  locale: 'en',
} satisfies FileToUpload;

const { uploadedFiles } = await gt.uploadSourceFiles(
  [{ source }],
  { sourceLocale: 'en' }
);
```