Python SDK: Documents: открытие файлов
ctx.documents() читает разрешённые файлы. Получение файла синхронно; методы уже полученного Document работают локально.
Примеры являются фрагментами тела def run(ctx):. Все методы SDK синхронны, await не нужен.
Методы
from_url
ctx.documents().from_url(url, name='document') -> Document
| Аргумент | Тип | Обязателен | Назначение |
|---|---|---|---|
url |
str |
Да | Разрешённый HTTP(S)-адрес источника. |
name |
str |
Нет, default в сигнатуре | Имя поля, заголовка, файла, секрета или метрики по назначению метода. |
Результат: Document. Объект SDK: используйте его методы, не передавайте целиком в emit.
Скачать файл до 10 MiB через сетевые настройки текущего источника. Действуют ограничения адресов, перенаправлений, robots.txt, частоты запросов и прокси. Имя определяется из URL; для адреса без расширения передайте его вторым аргументом.
result = ctx.documents().from_url(ctx.param('file_url'), 'report.csv')
from_bytes
ctx.documents().from_bytes(content, name) -> Document
| Аргумент | Тип | Обязателен | Назначение |
|---|---|---|---|
content |
str | bytes |
Да | Переданное содержимое; см. ограничения метода. |
name |
str |
Да | Имя поля, заголовка, файла, секрета или метрики по назначению метода. |
Результат: Document. Объект SDK: используйте его методы, не передавайте целиком в emit.
Разобрать уже полученные байты до 8 MiB. Имя помогает определить текстовые и старые Office-форматы; содержимое также проверяется по сигнатуре.
result = ctx.documents().from_bytes('sku,price\nA-1,1250', 'report.csv')
coordinates
ctx.documents().coordinates() -> SheetCoordinates
Аргументы не нужны.
Результат: SheetCoordinates. Объект SDK: используйте его методы, не передавайте целиком в emit.
Утилиты адресации Excel, без загрузки документа и сетевого вызова.
result = ctx.documents().coordinates()
Ошибки и контекст выполнения
Все вызовы синхронны. Неверный аргумент или формат данных может вызвать ValueError/TypeError; отказ платформы или недоступность сервиса вызывает RuntimeError. Отсутствие элемента/значения даёт None либо пустой список только там, где это явно описано. Не превращайте любое исключение в пустой успешный результат. Методы внешних сервисов недоступны в преобразовании выгрузки; см. ограничения преобразований и среду.