Я отвечаю на свой вопрос, у кого-то может быть похожая проблема - похоже, приведенная выше цитата из документации Hybris вводит в заблуждение - если вы используете редактор загрузки файлов по умолчанию, он позволит вам выбрать файл с вашего диска.
например, в файле zul вашего виджета:
<editor id="yourCustomEditorId" type="java.io.File" defaultEditor="com.hybris.cockpitng.editor.defaultfileupload" />
создаст две кнопки по умолчанию - выгрузка и сброс
в вашем контроллере вы добавите
private Editor yourCustomEditorId;
из которого вы можете получить FileUploadResult:
FileUploadResult fileUploadResult = (FileUploadResult) yourCustomEditorId.getValue();