# General Translation Platform: FileToTranslate（レガシー）
URL: https://generaltranslation.com/ja/docs/platform/core/reference/types/file-to-translate.mdx
---

title: FileToTranslate（レガシー）
description: Core v9 で削除されたレガシーのファイル入力と、現在の代替手段について説明します。FileToTranslate の API リファレンス。

---

`FileToTranslate` は、Core 8.x の一括翻訳ワークフローでファイルオブジェクトを表していました。`generaltranslation` 9.x ではエクスポートされていません。

<Callout type="info">
  **v9 での変更点:** `FileToTranslate` は削除されました。[`uploadSourceFiles`](/docs/platform/core/reference/gt-class-methods/translation/upload-source-files) には `FileToUpload` を使用し、返されたファイル参照を [`enqueueFiles`](/docs/platform/core/reference/gt-class-methods/translation/enqueue-files) に渡してください。
</Callout>

## 概要 [#overview]

レガシー型は、ファイルの生の内容、名前、形式をまとめたものでした:

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

## プロパティ [#properties]

| プロパティ                                | 説明              | 型                                                               | 任意  |
| ------------------------------------ | --------------- | --------------------------------------------------------------- | --- |
| [`content`](#content)                | ファイルの生の内容。      | `string`                                                        | いいえ |
| [`fileName`](#file-name)             | ファイル識別子。        | `string`                                                        | いいえ |
| [`fileFormat`](#file-format)         | レガシーなファイル形式識別子。 | string ユニオン                                                     | いいえ |
| [`formatMetadata`](#format-metadata) | 形式固有のメタデータ。     | `Record<string, any>`                                           | はい  |
| [`dataFormat`](#data-format)         | ファイル内のデータ形式。    | [`DataFormat`](/docs/platform/core/reference/types/data-format) | はい  |

### `content` [#content]

**型** `string` · **必須**

ファイルの生の内容。

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

**Type** `string` · **Required**

`common.json` や `docs/start.mdx` などのファイル識別子。

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

**型** string union · **必須**

`'JSON'`、`'PO'`、`'MDX'`、`'HTML'` などのレガシーファイル形式識別子。

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

**型** `Record<string, any>` · **省略可能**

形式固有のメタデータ。

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

**型** [`DataFormat`](/docs/platform/core/reference/types/data-format) · **任意**

ファイル内のデータ形式。`'JSX'`、`'ICU'`、または `'I18NEXT'`。

## レガシー例 [#legacy-example]

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

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

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

## 現在の置換 [#replacement]

9.x では、`generaltranslation/types` から `FileToUpload` をインポートし、ソースをアップロードして、返された参照を後続の操作で使用します。

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