# General Translation Platform: FileToTranslate (legacy)
URL: https://generaltranslation.com/fr/docs/platform/core/reference/types/file-to-translate.mdx
---
title: FileToTranslate (legacy)
description: Consultez l’entrée de fichier legacy supprimée de Core v9 et son remplacement actuel. Référence de l’API FileToTranslate.

---

`FileToTranslate` représentait un objet fichier dans les workflows de traduction par lots de Core 8.x. Il n’est pas exporté par `generaltranslation` 9.x.

<Callout type="info">
  **Modifié dans v9 :** `FileToTranslate` a été supprimé. Utilisez `FileToUpload` avec [`uploadSourceFiles`](/docs/platform/core/reference/gt-class-methods/translation/upload-source-files), puis transmettez les références de fichiers renvoyées à [`enqueueFiles`](/docs/platform/core/reference/gt-class-methods/translation/enqueue-files).
</Callout>

## Vue d’ensemble [#overview]

Le type legacy regroupait le contenu brut, le nom et le format d’un fichier :

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

## Propriétés [#properties]

| Propriété                            | Description                              | Type                                                            | Facultatif |
| ------------------------------------ | ---------------------------------------- | --------------------------------------------------------------- | ---------- |
| [`content`](#content)                | Contenu brut du fichier.                 | `string`                                                        | Non        |
| [`fileName`](#file-name)             | Identifiant du fichier.                  | `string`                                                        | Non        |
| [`fileFormat`](#file-format)         | Identifiant de format de fichier legacy. | union de string                                                 | Non        |
| [`formatMetadata`](#format-metadata) | Métadonnées spécifiques au format.       | `Record<string, any>`                                           | Oui        |
| [`dataFormat`](#data-format)         | format de données dans le fichier.       | [`DataFormat`](/docs/platform/core/reference/types/data-format) | Oui        |

### `content` [#content]

**Type** `string` · **Obligatoire**

Contenu brut du fichier.

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

**Type** `string` · **Obligatoire**

Identifiant du fichier, par exemple `common.json` ou `docs/start.mdx`.

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

**Type** union de chaînes · **Obligatoire**

Un identifiant legacy de format de fichier, tel que `'JSON'`, `'PO'`, `'MDX'` ou `'HTML'`.

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

**Type** `Record<string, any>` · **Facultatif**

métadonnées spécifiques au format.

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

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

Format de données du fichier : `'JSX'`, `'ICU'` ou `'I18NEXT'`.

## Exemple legacy [#legacy-example]

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

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

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

## Remplacement actuel [#replacement]

Dans la version 9.x, importez `FileToUpload` depuis `generaltranslation/types`, téléversez le fichier source et utilisez la référence renvoyée pour les opérations ultérieures :

```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' }
);
```