Перевод Excel на арабский API | Сохранение формул | Руководство для разработчиков

Проблемы программного перевода файлов Excel

Интеграция автоматизированного решения для перевода функциональности API Excel с английского на арабский в ваши приложения — обманчиво сложная задача.
Этот процесс выходит далеко за рамки простой замены строк, включая множество технических препятствий.
Разработчики должны учитывать кодировку символов, сложные структуры файлов и сохранение целостности данных.

Кодировка символов является основным препятствием, особенно при работе с арабским письмом.
Неправильная обработка может привести к «модзибаке», когда символы отображаются как неразборчивые знаки.
Кроме того, необходимо обеспечить, чтобы механизм перевода должным образом поддерживал UTF-8 для размещения полного диапазона арабских символов и диакритических знаков.
Это является основным требованием для любого успешного рабочего процесса локализации.

Сохранение макета электронной таблицы — еще одна важная задача для разработчиков.
Файлы Excel часто содержат объединенные ячейки, определенную ширину столбцов, высоту строк и сложную структуру форматирования, которые имеют решающее значение для читабельности.
Неопытный подход к переводу может легко нарушить эту визуальную структуру, что приведет к дезорганизованному и непригодному для использования документу.
Программное сохранение этого макета требует глубокого понимания формата файла XLSX.

Возможно, самой важной задачей является обработка встроенных формул и функций.
Эти формулы являются логической основой многих электронных таблиц, выполняя вычисления, которые должны оставаться нетронутыми.
Перевод текста в строковом литерале формулы без нарушения самой функции — тонкая операция.
Любая ошибка в этом процессе может повредить весь набор данных и сделать документ непригодным для использования по назначению.

Представляем API Doctranslate для перевода Excel

API Doctranslate предоставляет надежное и элегантное решение этих сложных проблем.
Это мощный RESTful API, специально разработанный для высокоточного перевода документов, включая сложные электронные таблицы Excel.
Абстрагируясь от низкоуровневых сложностей, он позволяет разработчикам сосредоточиться на интеграции, а не на синтаксическом анализе и манипулировании файлами.
Вы можете без труда добавить мощные возможности перевода в свои приложения.

Наш API разработан для обеспечения превосходного качества, когда вам требуется перевести документы с английского на арабский.
Он интеллектуально обрабатывает нюансы формата XLSX, гарантируя, что ваши переведенные файлы являются точными копиями оригинала.
Это включает сохранение всего форматирования ячеек, диаграмм и визуальных элементов без какого-либо ручного вмешательства.
Результатом является бесперебойный рабочий процесс, который каждый раз создает локализованные документы профессионального уровня.

Одной из выдающихся особенностей является его способность точно обрабатывать сложную логику электронных таблиц.
Когда вы пользуетесь нашим сервисом, вы не просто переводите текст; вы сохраняете всю функциональную структуру рабочей книги.
Именно здесь наш API превосходит конкурентов, предлагая решение для перевода файлов Excel с идеальным сохранением всех формул и форматирования.
Ваши формулы SUM, VLOOKUP и пользовательские формулы будут продолжать корректно работать в переведенном на арабский документ.

Пошаговое руководство: как перевести Excel с английского на арабский через API

В этом руководстве вы ознакомитесь со всем процессом интеграции нашего API в ваш проект.
Мы рассмотрим все: от настройки вашей среды до выполнения вызова API и обработки ответа.
В следующих примерах используются Python и Node.js — два самых популярных языка для бэкенд-разработки.
Вы можете легко адаптировать эту логику к любому языку программирования, поддерживающему HTTP-запросы.

Предварительные требования

Прежде чем приступить к написанию кода, вам необходимо подготовить несколько важных элементов.
Во-первых, у вас должна быть активная учетная запись Doctranslate для получения вашего уникального ключа API.
Этот ключ используется для аутентификации всех ваших запросов к нашим серверам.
Во-вторых, убедитесь, что на вашей машине разработки установлена ​​последняя версия Python или Node.js.

Настройка среды

Для взаимодействия с API вам понадобится библиотека для обработки HTTP-запросов.
Для разработчиков на Python библиотека requests является стандартным выбором благодаря своей простоте и мощности.
Вы можете легко установить ее с помощью pip, запустив pip install requests в своем терминале.
Для Node.js axios — популярный HTTP-клиент на основе промисов, который упрощает выполнение запросов и обработку ответов.

Выполнение запроса API на Python

Настроив среду, вы можете написать скрипт для вызова API Doctranslate.
Процесс включает чтение исходного файла Excel, создание запроса multipart/form-data и отправку его на конечную точку /v2/document/translate.
Обязательно замените 'YOUR_API_KEY' на ваш фактический ключ и укажите правильный путь к файлу Excel.

import requests

# Replace with your actual API key and file path
api_key = 'YOUR_API_KEY'
file_path = 'path/to/your/document.xlsx'
api_url = 'https://developer.doctranslate.io/v2/document/translate'

# Define the languages for translation
source_language = 'en'
target_language = 'ar'

# Set up the headers for authentication
headers = {
    'Authorization': f'Bearer {api_key}'
}

# Prepare the files and data for the multipart/form-data request
with open(file_path, 'rb') as f:
    files = {
        'file': (file_path.split('/')[-1], f, 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet')
    }
    data = {
        'source_language': source_language,
        'target_language': target_language
    }

    # Make the POST request to the API
    print("Submitting translation request...")
    response = requests.post(api_url, headers=headers, files=files, data=data)

    # Check the response from the server
    if response.status_code == 200:
        print("Successfully received translated file URL.")
        # The response JSON contains the URL to the translated file
        translated_file_url = response.json()['translated_file_url']
        print(f"Download your translated file from: {translated_file_url}")
    else:
        print(f"Error: {response.status_code}")
        print(response.json())


Обработка ответа API
После успешного вызова API сервер ответит кодом состояния 200 OK.
 Тело ответа будет представлять собой объект JSON, содержащий URL-адрес вашего недавно переведенного документа.
 Ваше приложение должно проанализировать этот JSON для извлечения translated_file_url, а затем загрузить файл по этому местоположению.
 Крайне важно реализовать обработку ошибок для управления ответами, отличными от 200, которые могут указывать на проблемы с ключом API или параметрами запроса.
Пример использования Node.js с Axios
Для разработчиков JavaScript интеграция API так же проста с помощью Node.js.
 В этом примере используются axios для HTTP-запроса и form-data для создания полезной нагрузки.
 Логика остается той же: аутентифицировать, отправить файл и параметры, а также обработать ответ.
 Это демонстрирует универсальность REST API в разных технологических стеках.

const axios = require('axios');
const fs = require('fs');
const FormData = require('form-data');

// Replace with your actual API key and file path
const apiKey = 'YOUR_API_KEY';
const filePath = 'path/to/your/document.xlsx';
const apiUrl = 'https://developer.doctranslate.io/v2/document/translate';

// Create a new form data instance
const form = new FormData();
form.append('file', fs.createReadStream(filePath));
form.append('source_language', 'en');
form.append('target_language', 'ar');

// Set up the headers, including the form-data headers and Authorization
const headers = {
    ...form.getHeaders(),
    'Authorization': `Bearer ${apiKey}`
};

// Make the POST request using axios
console.log('Submitting translation request...');
axios.post(apiUrl, form, { headers })
    .then(response => {
        if (response.status === 200) {
            console.log('Successfully received translated file URL.');
            const translatedFileUrl = response.data.translated_file_url;
            console.log(`Download your translated file from: ${translatedFileUrl}`);
        } else {
            console.error(`Unexpected status code: ${response.status}`);
        }
    })
    .catch(error => {
        console.error('Error during API call:');
        if (error.response) {
            // The request was made and the server responded with a status code
            // that falls out of the range of 2xx
            console.error(error.response.data);
            console.error(error.response.status);
        } else if (error.request) {
            // The request was made but no response was received
            console.error(error.request);
        } else {
            // Something happened in setting up the request that triggered an Error
            console.error('Error', error.message);
        }
    });


Основные особенности перевода Excel с английского на арабский
Перевод контента на арабский язык вводит уникальные лингвистические и технические особенности.
 Они выходят за рамки простого дословного преобразования и требуют сложного подхода.
 API Doctranslate создан для автоматического управления этими сложностями.
 Это гарантирует, что ваш конечный документ будет не только точным, но также культурно и структурно подходящим.
Макет справа налево (RTL)
Арабский — это язык с письмом справа налево (RTL), что принципиально меняет макет документа.
 В Excel это означает, что ориентация всего листа должна быть изменена: столбец A находится справа.
 Наш API автоматизирует эту корректировку RTL для вас, правильно устанавливая направление листа в переведенном файле.
 Это экономит бесчисленные часы ручного форматирования и предотвращает ошибки макета.
Расширение текста и изменение размера ячеек
При переводе с английского на арабский объем текста может значительно измениться.
 Арабское письмо может быть более компактным по вертикали, но может потребовать больше горизонтального пространства для определенных фраз.
 Наша система интеллектуально анализирует контент и при необходимости корректирует размер ячеек, чтобы предотвратить обрезание текста.
 Эта динамическая адаптация гарантирует, что переведенный контент остается полностью видимым и профессионально представленным.
Форматирование чисел и дат
Локализация распространяется на числа и даты, которые имеют определенные форматы в арабоязычных регионах.
 Хотя стандартные западноарабские цифры (0, 1, 2) распространены, также используются восточноарабские цифры (٠, ١, ٢).
 API правильно обрабатывает локализацию форматов дат и чисел на основе региональных стандартов.
 Важно отметить, что базовые числовые значения в ячейках сохраняются для расчетов формул.
Сохранение формул и функций
Повторяя важный момент: целостность формул имеет первостепенное значение при любом переводе электронных таблиц.
 Наш API тщательно разработан для защиты этой логики, различая переводимый текст и функциональный синтаксис.
 Он корректно переводит строковые литералы внутри формул, оставляя названия функций, такие как SUM или IF, и ссылки на ячейки без изменений.
 Это гарантирует, что вычисления вашей электронной таблицы останутся на 100% точными после перевода.
Заключение и дальнейшие шаги
Использование API Doctranslate для перевода функциональности API Excel с английского на арабский предлагает мощное, надежное и эффективное решение.
 Оно автоматизирует весь сложный процесс, от обработки RTL-макетов до сохранения критически важных формул.
 Интегрируя наш сервис, вы можете создавать сложные рабочие процессы локализации, которые производят высококачественные, готовые к использованию документы.
 Это позволяет вам охватить более широкую аудиторию без бремени ручного перевода и форматирования.
Теперь у вас есть знания и примеры кода, чтобы начать свой путь интеграции.
 Следующий шаг — получить ключ API и изучить все возможности сервиса.
 Для получения более подробной информации обо всех доступных параметрах и функциях мы настоятельно рекомендуем ознакомиться с нашей официальной документацией.
 Вы можете найти наши исчерпывающие руководства и справочник API на портале разработчиков Doctranslate.