Überblick

Die Methode setupProject startet die Einrichtung eines Übersetzungsprojekts auf Basis zuvor hochgeladener Dateien. Dabei wird ein asynchroner Einrichtungsauftrag erstellt, der die Dateien analysiert und für Übersetzungs-Workflows vorbereitet.

const gt = new GT({ projectId: 'your-project-id', apiKey: 'your-api-key' });

const setupResult = await gt.setupProject(fileRefs, 30000);
console.log(`Setup-Job erstellt: ${setupResult.setupJobId}`);

Referenz

Parameter

Struktur von FileUploadRef

type FileUploadRef = {
  fileId: string;
  versionId: string;
  fileName: string;
  fileFormat?: FileFormat;
  dataFormat?: DataFormat;
}

Rückgabe

Promise<SetupProjectResult> – Enthält die Kennung des Setup-Jobs und den initialen Status.

type SetupProjectResult = {
  setupJobId: string;
  status: 'queued';
}

Beispiele

Grundlegende Verwendung

Initialisieren Sie die Projekteinstellungen mit hochgeladenen files:

import { GT } from 'generaltranslation';

const gt = new GT({
  projectId: 'your-project-id',
  apiKey: 'your-api-key'
});

// Dateireferenzen aus vorherigem Upload
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(`Setup initiiert mit Job-ID: ${setupResult.setupJobId}`);

Hinweise

• Dateien müssen mit uploadSourceFiles hochgeladen werden, bevor setupProject aufgerufen wird
• Die Projekteinrichtung analysiert Inhalte und Struktur der Dateien, um Übersetzungsworkflows zu optimieren
• Der Setup-Job läuft asynchron – überwachen Sie den Fortschritt mit checkSetupStatus
• Die Einrichtung ist in der Regel erforderlich, bevor Übersetzungsaufträge für neue Projekte in die Warteschlange gestellt werden

Nächste Schritte

• Siehe uploadSourceFiles, um Dateien vor der Einrichtung hochzuladen
• Siehe checkSetupStatus, um den Einrichtungsfortschritt zu überwachen
• Siehe shouldSetupProject, um zu prüfen, ob eine Einrichtung erforderlich ist
• Siehe enqueueFiles, um nach der Einrichtung Übersetzungen zu starten