Форм модель: Создание форм из моделей — Документация Django 1.9

Содержание

Создание форм из моделей — Документация Django 1.9

ModelForm

class ModelForm

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

По этой причине Django предоставляет вспомогательный класс, который позволит вам создать класс Form по имеющейся модели.

Например:

>>> from django.forms import ModelForm
>>> from myapp.models import Article

# Create the form class.
>>> class ArticleForm(ModelForm):
...     class Meta:
...         model = Article
...         fields = ['pub_date', 'headline', 'content', 'reporter']

# Creating a form to add an article.
>>> form = ArticleForm()

# Creating a form to change an existing article.
>>> article = Article.objects.get(pk=1)
>>> form = ArticleForm(instance=article)

Типы полей

Сгенерированный класс Form будет содержать поле формы для каждого поля модели в порядке указанном в атрибуте fields.

Каждому полю модели соответствует стандартное поле формы. Например, CharField поле модели будет представлено на форме как CharField, а ManyToManyField поле модели будет представлено как MultipleChoiceField. Ниже представлен полный список соответствия полей модели и формы:

Как вы могли ожидать, ForeignKey и ManyToManyField поля модели являются особыми случаями:

Поле ForeignKey модели представлено полем формы ModelChoiceField, которое является обычным ChoiceField, но с вариантами значений, полученными из QuerySet.
Поле ManyToManyField модели представлено полем формы ModelMultipleChoiceField, которое является обычным MultipleChoiceField`, но с вариантами значений, полученными из ``QuerySet.

В дополнение, каждое поле созданной формы имеет следующие атрибуты:

Если у поля модели есть blank=True, тогда к полю формы будет добавлено required=False, иначе – required=True.
Значением атрибута label поля будет значение поля verbose_name модели, причём первый символ этого значения будет преобразован в верхний регистр.
Значением атрибута help_text поля формы будет значение атрибута help_text поля модели.
Если для поля модели установлен атрибут choices, тогда для поля формы будет использоваться виджет Select, который будет отображать содержимое этого атрибута. Варианты выбора обычно содержат пустой вариант, который выбран по умолчанию. Если поле является обязательным, то оно требует от пользователя сделать выбор. Пустой вариант не отображается, если у поля модели есть атрибут blank=False и явное значение default (при этом, это значение будет выбрано по умолчанию).

В конце, следует отметить, что вы можете переопределить поле формы, используемое для определённого поля модели. Переопределение стандартных полей описано ниже.

Полный пример

Рассмотрим этот набор полей:

from django.db import models
from django.forms import ModelForm

TITLE_CHOICES = (
    ('MR', 'Mr.'),
    ('MRS', 'Mrs.'),
    ('MS', 'Ms.'),
)

class Author(models.Model):
    name = models.CharField(max_length=100)
    title = models.CharField(max_length=3, choices=TITLE_CHOICES)
    birth_date = models.DateField(blank=True, null=True)

    def __str__(self):              # __unicode__ on Python 2
        return self.name

class Book(models.Model):
    name = models.CharField(max_length=100)
    authors = models.ManyToManyField(Author)

class AuthorForm(ModelForm):
    class Meta:
        model = Author
        fields = ['name', 'title', 'birth_date']

class BookForm(ModelForm):
    class Meta:
        model = Book
        fields = ['name', 'authors']

Для этих моделей показанные выше классы ModelForm будут аналогичны следующим формам (разница будет только в методе save(), что мы вскоре рассмотрим.):

from django import forms

class AuthorForm(forms.Form):
    name = forms.CharField(max_length=100)
    title = forms.CharField(max_length=3,
                widget=forms.Select(choices=TITLE_CHOICES))
    birth_date = forms.DateField(required=False)

class BookForm(forms.Form):
    name = forms.CharField(max_length=100)
    authors = forms.ModelMultipleChoiceField(queryset=Author.objects.all())

Валидация в

ModelForm

Есть два основных шага при валидации ModelForm:

Валидация форм
Валидация объекта модели

Как и валидация в обычной форме валидация в модельной форме выполняется при вызове is_valid() или при обращении к атрибуту errors, или при явном вызове full_clean(), но на практике вы не будете использовать последний метод.

Валидация модели (Model.full_clean()) выполняется после валидации формы, сразу после завершения метода clean().

Предупреждение

Процесс валидации изменяет объект модели переданный в конструктор ModelForm. Например, поля даты модели преобразуют значения в объект даты. Ошибка валидации может оставить объект в неопределенном состоянии и лучше не использовать его в последующем коде.

Переопределение метода clean()

Вы можете переопределить метод clean() модели для того, чтобы обеспечить дополнительную проверку. Всё это аналогично работе с обычной формой.

Экземпляр модельной формы, привязанный к объекту модели имеет атрибут instance, через который методы модельной формы имеют доступ к соответствующему экземпляру модели.

Предупреждение

Метод ModelForm.clean() устанавливает флаг, который указывает валидации модели провалидировать уникальность полей отмеченных unique, unique_together или unique_for_date|month|year.

Если вы хотите переопределить метод clean(), вызовите метод clean() родительского класса.

Взаимодействие с механизмами модели

В процессе проверки данных ModelForm будет вызывать метод clean() каждого поля вашей модели, соответствующего полю формы. Для полей модели, которые были исключены из формы, проверка данных производиться не будет. Обратитесь к документации по проверке форм для получения информации о том, как работает проверка данных поля.

Метод модели clean() вызывается перед проверкой уникальности полей. Смотрите валидацию объектов модели, чтобы узнать как работает clean().

Определение

error_messages

Сообщения ошибки из form field или form Meta имеют приоритет над сообщениями ошибок из model field.

Error messages defined on model fields are only used when the
ValidationError is raised during the model validation step and no corresponding error messages are defined at
the form level.

Вы можете переопределить сообщения об ошибке для NON_FIELD_ERRORS, который были вызваны при валидации модели, определив ключ NON_FIELD_ERRORS в атрибут error_messages класса ModelForm.Meta:

from django.forms import ModelForm
from django.core.exceptions import NON_FIELD_ERRORS

class ArticleForm(ModelForm):
    class Meta:
        error_messages = {
            NON_FIELD_ERRORS: {
                'unique_together': "%(model_name)s's %(field_labels)s are not unique.",
            }
        }

Метод

save()

Каждая форма, созданная с помощью ModelForm, обладает методом save(). Этот метод создаёт и сохраняет объект в базе данных, используя для этого данные, введённые в форму. Класс, унаследованный от ModelForm, может принимать существующий экземпляр модели через именованный аргумент instance. Если такой аргумент указан, то save() обновит переданную модель. В противном случае, save() создаст новый экземпляр указанной модели:

>>> from myapp.models import Article
>>> from myapp.forms import ArticleForm

# Create a form instance from POST data.
>>> f = ArticleForm(request.POST)

# Save a new Article object from the form's data.
>>> new_article = f.save()

# Create a form to edit an existing Article, but use
# POST data to populate the form.
>>> a = Article.objects.get(pk=1)
>>> f = ArticleForm(request.POST, instance=a)
>>> f.save()

Обратите внимание, если форма не была проверена, вызов save() выполнит ее, обратившись к form.errors. Если данные не верны, будет вызвано исключение ValueError – то есть, если form.errors равно True.

Метод save() принимает необязательный именованный аргумент commit, который может иметь значения True или False. При вызове save() с commit=False метод вернёт объект, который ещё не был сохранён в базе данных. В этом случае, вам самостоятельно придётся вызвать метод save() у полученного объекта. Это бывает полезно, когда требуется выполнить дополнительные действия над объектом до его сохранения или если вам требуется воспользоваться одним из параметров сохранения модели. Атрибут commit по умолчанию имеет значение True.

Использование commit=False также полезно в случае, когда ваша модель имеет связь “многие-ко-многим” с другой моделью. Для такой модели, если метод save() вызван с аргументом commit=False, то Django не может немедленно сохранить данные для такой связи, т.к. невозможно создать связи для объекта, который не сохранен в базе данных.

Чтобы решить эту задачу, каждый раз, когда вы сохраняете форму, указывая commit=False, Django добавляет метод save_m2m() к вашему классу ModelForm. После того, как вы вручную сохранили экземпляр формы, вы можете вызвать метод save_m2m() для сохранения данных, связанных через “многие-ко-многим”. Например:

# Create a form instance with POST data.
>>> f = AuthorForm(request.POST)

# Create, but don't save the new author instance.
>>> new_author = f.save(commit=False)

# Modify the author in some way.
>>> new_author.some_field = 'some_value'

# Save the new instance.
>>> new_author.save()

# Now, save the many-to-many data for the form.
>>> f.save_m2m()

Вызов метода save_m2m() требуется только в случае, если вы используете save(commit=False). Если вы просто используете save() для формы, то все данные (включая связи “многие-ко-многим”), будут сохранены, не требуя для этого дополнительных действий. Например:

# Create a form instance with POST data.
>>> a = Author()
>>> f = AuthorForm(request.POST, instance=a)

# Create and save the new author instance. There's no need to do anything else.
>>> new_author = f.save()

Если не принимать во внимание методы save() и save_m2m(), то ModelForm работает аналогично обычной Form. Например, метод is_valid() используется для проверки данных, метод is_multipart() используется для определения загрузки файла (в этом случае request.FILES должен быть передан форме) и так далее. Обратитесь к документу Привязка загруженных файлов к форме для получения подробностей.

Указываем какие поля использовать

Настоятельно рекомендуем явно указать все поля отображаемые в форме, используя параметр fields. Иначе по ошибке, при добавлении нового поля в модель, можно позволить его редактировать пользователям и таким образом создать уязвимость. В зависимости от способа рендеринга формы, такая ошибка может быть не легко заметна на сайте.

Самый простой способ указать поля — автоматически добавить все или исключить определенные. Но такой способ не безопасен (например, случай на GitHub).

Но если вы уверены в том, что делаете, вот как использовать этот подход:

В параметре fields указать специальное значение '__all__', которое указывает использовать все поля модели. Например:
```
from django.forms import ModelForm

class AuthorForm(ModelForm):
    class Meta:
        model = Author
        fields = '__all__'
```
Используйте атрибут exclude внутреннего класса ModelForm.Meta. Этот атрибут, если он указан, должен содержать список имён полей, которые не должны отображаться на форме.
Например:
```
class PartialAuthorForm(ModelForm):
    class Meta:
        model = Author
        exclude = ['title']
```
Так как модель Author содержит три поля: ‘name’, ‘title ‘ и ‘birth_date’, то форма будут отображать поля name и birth_date.

При использовании одного из этих способов, порядок полей в форме будет аналогичен порядку полей в модели, ManyToManyField поля будут в конце.

Если поле модели содержит editable=False, каждая форма, созданная по модели с помощью ModelForm, не будет включать в себя это поле.

Изменено в Django 1.8:

В старых версиях, в форме будут представлены все поля модели, если не определить значения для fields и exclude. Сейчас такое поведение вызовет исключение ImproperlyConfigured.

Примечание

Поля, которые не определены в форме, не будут учитываться при вызове метода save(). Также, если вы вручную добавите в форму исключенные поля, то они не будут заполняться из экземпляра модели.

Django будет препятствовать всем попыткам сохранить неполную модель. Таким образом, если модель требует заполнения определённых полей и для них не предоставлено значение по умолчанию, то сохранить форму для такой модели не получится. Для решения этой проблемы вам потребуется создать экземпляр такой модели, передав ему начальные значения для обязательных, но незаполненных полей:

author = Author(title='Mr')
form = PartialAuthorForm(request.POST, instance=author)
form.save()

В качестве альтернативы, вы можете использовать save(commit=False) и вручную определить все необходимые поля:

form = PartialAuthorForm(request.POST)
author = form.save(commit=False)
author.title = 'Mr'
author.save()

Обратитесь к разделу section on saving forms для подробностей по использованию save(commit=False).

Переопределение стандартных типов полей или виджетов

Стандартные типы полей, описанные выше, имеют целесообразные настройки по умолчанию. Если ваша модель имеет поля типа DateField, то скорее всего вы пожелаете, чтобы форма использовала поле DateField для его отображения. Но класс ModelForm представляет широкие возможности по управлению типами полей формы, а также виджетами для их представления.

Для того, чтобы указать собственный виджет для поля, следует использовать атрибут widgets внутреннего класса Meta. Его значением должен быть словарь, ключами которого являются имена полей, а значениями — классы или экземпляры виджетов.

Например, если необходимо использовать CharField для того, чтобы поле name модели Author было представлено в виде <textarea> вместо стандартного <input type="text">, то вы можете переопределить виджет поля:

from django.forms import ModelForm, Textarea
from myapp.models import Author

class AuthorForm(ModelForm):
    class Meta:
        model = Author
        fields = ('name', 'title', 'birth_date')
        widgets = {
            'name': Textarea(attrs={'cols': 80, 'rows': 20}),
        }

Ещё раз напомним, что аргумент widgets принимает словарь с экземплярами (т.е., Textarea(...)) или классами (т.е., Textarea) виджетов.

Аналогично можно переопределить параметры labels, help_texts и error_messages указав в Meta.

Например, для переопределим параметры поля name:

from django.utils.translation import ugettext_lazy as _

class AuthorForm(ModelForm):
    class Meta:
        model = Author
        fields = ('name', 'title', 'birth_date')
        labels = {
            'name': _('Writer'),
        }
        help_texts = {
            'name': _('Some useful help text.'),
        }
        error_messages = {
            'name': {
                'max_length': _("This writer's name is too long."),
            },
        }

Вы также можете указать field_classes, чтобы настроить типы полей, которые будут использовать формой.

Например, если вы хотите использовать MySlugFormField для поля slug, вы можете сделать следующее:

from django.forms import ModelForm
from myapp.models import Article

class ArticleForm(ModelForm):
    class Meta:
        model = Article
        fields = ['pub_date', 'headline', 'content', 'reporter', 'slug']
        field_classes = {
            'slug': MySlugFormField,
        }

Если вы желаете продолжить настойку поля, включая его тип, метку и так далее, то вы можете декларативно указать поля, как это делается при использовании Form.

Чтобы переопределить валидаторы поля, укажите их в аргументе validators:

from django.forms import ModelForm, CharField
from myapp.models import Article

class ArticleForm(ModelForm):
    slug = CharField(validators=[validate_slug])

    class Meta:
        model = Article
        fields = ['pub_date', 'headline', 'content', 'reporter', 'slug']

Добавлено в Django 1.9:

Был добавлен атрибут Meta.field_classes.

Примечание

Когда вы явно создаете поле формы, необходимо знать как связанны ModelForm и Form.

ModelForm это дочерний класс Form, который может автоматически создавать поля формы. При создании полей учитываются параметры класса Meta и явно определенные поля формы. ModelForm автоматически создаст только те поля, которые отсутствуют в форме.

Явно определенные в классе поля создаются как есть, параметры Meta, такие как widgets, labels, help_texts или error_messages, игнорируются, они учитываются только для создании дополнительных полей.

При явном создании поля, Django предполагает, что вы будете определять поведение формы в целом. Следовательно, стандартные атрибуты модели (такие как max_length или required) не передаются полям формы. Если вам потребуется обеспечить поведение, определённое в модели, вам потребуется явно установить соответствующие аргументы при определении поля формы.

Например, если модель Article выглядит так:

class Article(models.Model):
    headline = models.CharField(max_length=200, null=True, blank=True,
                                help_text="Use puns liberally")
    content = models.TextField()

и вы желаете выполнить свою проверку поля headline, оставляя неизменными атрибуты blank и help_text, вы можете определить ArticleForm следующим образом:

class ArticleForm(ModelForm):
    headline = MyFormField(max_length=200, required=False,
                           help_text="Use puns liberally")

    class Meta:
        model = Article
        fields = ['headline', 'content']

Тип поля формы должен работать с типом значения соответствующего поля модели. Если они не соответствуют — вы получите ValueError.

Обратитесь к документации на поля формы для получения дополнительной информации о полях и их аргументах.

Локализация в полях

По умолчанию поля в ModelForm не локализируют свои данные. Для локализации полей можно использовать параметр localized_fields класса Meta.

>>> from django.forms import ModelForm
>>> from myapp.models import Author
>>> class AuthorForm(ModelForm):
...     class Meta:
...         model = Author
...         localized_fields = ('birth_date',)

Если в localized_fields указать '__all__', будут локализированы все поля.

Наследование форм

Аналогично обычным формам, вы можете наследоваться ModelForm. Это удобно когда надо добавить дополнительные поля или методы к базовому классу и использовать результат для создания других модельных форм. Например, для класса ArticleForm:

>>> class EnhancedArticleForm(ArticleForm):
...     def clean_pub_date(self):
...         ...

Мы создали форму, аналогичную ArticleForm, добавив дополнительную проверку и обработку для поля pub_date.

Вы также можете наследовать внутренний класс Meta, если требуется внести изменения в списки Meta.fields или Meta.excludes:

>>> class RestrictedArticleForm(EnhancedArticleForm):
...     class Meta(ArticleForm.Meta):
...         exclude = ('body',)

Здесь мы добавили метод из EnhancedArticleForm и изменили оригинальный ArticleForm.Meta, убрав одно поле.

Тем не менее, надо уточнить несколько моментов.

Применяются стандартные правила языка Python для разрешения имён. Если ваш класс унаследован от нескольких базовых классов, которые обладают внутренним классом Meta, и для него не определён собственный Meta класс, то этот класс будет унаследован из первого базового.
Можно унаследоваться одновременно от Form и ModelForm, однако, ModelForm должен быть первым в MRO. Т.к. эти классы используют разные мета-классы, а класс может использовать только один метакласс.
Можно декларативно удалить Field родительского класса, указав в названии None в дочернем классе.
Таким способом можно исключить только те поля, которые были декларативно описаны в родительском классе. Поле ModelForm будет в любом случае созданы мета-классом. Чтобы переопределить их, используйте метод описанный в Указываем какие поля использовать.

Передача начальных значений

Аналогично обычным формам, есть возможность указать начальные данные, передав параметр initial при создании экземпляра формы. Предоставленные таким образом начальные данные переопределят начальные данные самих полей формы и значения из подключенного экземпляра модели. Например:

>>> article = Article.objects.get(pk=1)
>>> article.headline
'My headline'
>>> form = ArticleForm(initial={'headline': 'Initial headline'}, instance=article)
>>> form['headline'].value()
'Initial headline'

Функция-фабрика модельных форм

Вы можете создать форму по модели используя функцию modelform_factory(), вместо создания класса. В некоторых случаях это более удобный способ:

>>> from django.forms import modelform_factory
>>> from myapp.models import Book
>>> BookForm = modelform_factory(Book, fields=("author", "title"))

Можно указать определенные настройки для формы, например отображаемые поля:

>>> from django.forms import Textarea
>>> Form = modelform_factory(Book, form=BookForm,
...                          widgets={"title": Textarea()})

Указать используемые поля можно с помощью аргументов fields и exclude. Смотрите описание ModelForm Указываем какие поля использовать.

… или включить локализацию для полей:

>>> Form = modelform_factory(Author, form=AuthorForm, localized_fields=("birth_date",))

Наборы модельных форм

class models.BaseModelFormSet

Аналогично наборам обычных форм, Django представляет ряд расширенных классов наборов форм, которые упрощают взаимодействие с моделями Django. Давайте воспользуемся моделью Author:

>>> from django.forms import modelformset_factory
>>> from myapp.models import Author
>>> AuthorFormSet = modelformset_factory(Author, fields=('name', 'title'))

Использование аргумента«fields« ограничивает набор форм указанным списком полей. В качестве альтернативы можно определить список полей, которые не должны отображаться на формах. Сделать это можно с помощью аргумента exclude:

>>> AuthorFormSet = modelformset_factory(Author, exclude=('birth_date',))

Изменено в Django 1.8:

В старых версиях, в наборе форм будут представлены все поля модели, если не определить значения для fields и exclude. Сейчас такое поведение вызовет исключение ImproperlyConfigured.

Этот код создаст набор форм, которые будут работать с данными модели Author. По функционалу набор модельных форм аналогичен набору обычных форм:

>>> formset = AuthorFormSet()
>>> print(formset)
<input type="hidden" name="form-TOTAL_FORMS" value="1" /><input type="hidden" name="form-INITIAL_FORMS" value="0" /><input type="hidden" name="form-MAX_NUM_FORMS" />
<tr><th><label for="id_form-0-name">Name:</label></th><td><input type="text" name="form-0-name" maxlength="100" /></td></tr>
<tr><th><label for="id_form-0-title">Title:</label></th><td><select name="form-0-title">
<option value="" selected="selected">---------</option>
<option value="MR">Mr.</option>
<option value="MRS">Mrs.</option>
<option value="MS">Ms.</option>
</select><input type="hidden" name="form-0-id" /></td></tr>

Примечание

modelformset_factory() использует фабрику обычных форм formset_factory() для создания набора форм. Это означает, что функционал модельных форм является надстройкой над функционалом набора обычных форм.

Изменение выборки

По умолчанию, при создании набора модельных форм используется выборка, которая содержит все объекты модели (т.е., Author.objects.all()). Такое поведение можно скорректировать, используя аргумент queryset:

>>> formset = AuthorFormSet(queryset=Author.objects.filter(name__startswith='O'))

Также вы можете унаследоваться от класса набора модельных форм и определить self.queryset в конструкторе, указав необходимые параметры выборки:

from django.forms import BaseModelFormSet
from myapp.models import Author

class BaseAuthorFormSet(BaseModelFormSet):
    def __init__(self, *args, **kwargs):
        super(BaseAuthorFormSet, self).__init__(*args, **kwargs)
        self.queryset = Author.objects.filter(name__startswith='O')

Теперь передадим ваш класс BaseAuthorFormSet в функцию фабрики:

>>> AuthorFormSet = modelformset_factory(
...     Author, fields=('name', 'title'), formset=BaseAuthorFormSet)

Если требуется создать пустой набор форм, т.е. который не включает ни одну существующую модель, то передайте в набор пустую выборку:

>>> AuthorFormSet(queryset=Author.objects.none())

Настройка

form

По умолчанию, когда вы используете modelformset_factory, форма будет создана с помощью modelform_factory(). Часто необходимо указать свою форму. Например, форму с собственной валидацией:

class AuthorForm(forms.ModelForm):
    class Meta:
        model = Author
        fields = ('name', 'title')

    def clean_name(self):
        # custom validation for the name field
        ...

Для этого передайте вашу форму в функцию фабрики:

AuthorFormSet = modelformset_factory(Author, form=AuthorForm)

Вам не обязательно создавать свою форму. Функция modelformset_factory принимает различный аргументы, которые будут переданы в modelform_factory.

Включить локализацию для полей с помощью

localized_fields

Используя localized_fields можно включить локализацию для полей формы.

>>> AuthorFormSet = modelformset_factory(
...     Author, fields=('name', 'title', 'birth_date'),
...     localized_fields=('birth_date',))

Если в localized_fields указать '__all__', будут локализированы все поля.

Передача начальных значений

Аналогично набору обычных форм, есть возможность указать начальные данные для форм набора, передав параметр initial при создании экземпляра набора, возвращенного modelformset_factory(). Тем не менее, в случае набора модельных форм, начальными значениями заполняются только пустые, т.е. новые, формы.

Сохранение объектов набора форм

Аналогично ModelForm, вы можете сохранять данные в модели. Для этого надо использовать метод save() набора форм:

# Create a formset instance with POST data.
>>> formset = AuthorFormSet(request.POST)

# Assuming all is valid, save the data.
>>> instances = formset.save()

Метод save() возвращает экземпляры объектов, которые были сохранены в базе данных. Те объекты, данные которых не изменились, не сохраняются в базе данных и не отображаются в возвращаемом значении (instances из предыдущего примера).

Когда форма содержит не все поля модели (например, потому что некоторые из них были явно исключены), то отсутствующие поля не будут сохранены через метод save(). Подробнее об этом ограничении модельных форм написано в Указываем какие поля использовать.

Передайте commit=False, чтобы получить экземпляры моделей, которые ещё не сохранены в базе данных:

# don't save to the database
>>> instances = formset.save(commit=False)
>>> for instance in instances:
...     # do something with instance
...     instance.save()

Это позволяет вам добавлять данные к экземплярам моделей перед их сохранением в базе данных. Если ваш набор форм содержит ManyToManyField, вам также потребуется вызвать метод formset.save_m2m() для того, чтобы обеспечить сохранение связей «многие-ко-многим».

После вызова save(), в класс набора форм будут добавлены атрибуты, содержащие все изменения:

models.BaseModelFormSet.changed_objects

models.BaseModelFormSet.deleted_objects

models.BaseModelFormSet.new_objects

Ограничение количества редактируемых объектов

Как и в случае набора обычных форм, вы можете использовать аргументы max_num и extra функции modelformset_factory() для ограничения числа дополнительно отображаемых форм.

Аргумент max_num не препятствует отображению существующих объектов:

>>> Author.objects.order_by('name')
[<Author: Charles Baudelaire>, <Author: Paul Verlaine>, <Author: Walt Whitman>]

>>> AuthorFormSet = modelformset_factory(Author, fields=('name',), max_num=1)
>>> formset = AuthorFormSet(queryset=Author.objects.order_by('name'))
>>> [x.name for x in formset.get_queryset()]
['Charles Baudelaire', 'Paul Verlaine', 'Walt Whitman']

Если значение max_num больше чем количество существующих объектов, то к будет добавлено extra пустых форм к набору. Так будет происходить до достижения максимального количества форм, ограниченного параметром max_num:

>>> AuthorFormSet = modelformset_factory(Author, fields=('name',), max_num=4, extra=2)
>>> formset = AuthorFormSet(queryset=Author.objects.order_by('name'))
>>> for form in formset:
...     print(form.as_table())
<tr><th><label for="id_form-0-name">Name:</label></th><td><input type="text" name="form-0-name" value="Charles Baudelaire" maxlength="100" /><input type="hidden" name="form-0-id" value="1" /></td></tr>
<tr><th><label for="id_form-1-name">Name:</label></th><td><input type="text" name="form-1-name" value="Paul Verlaine" maxlength="100" /><input type="hidden" name="form-1-id" value="3" /></td></tr>
<tr><th><label for="id_form-2-name">Name:</label></th><td><input type="text" name="form-2-name" value="Walt Whitman" maxlength="100" /><input type="hidden" name="form-2-id" value="2" /></td></tr>
<tr><th><label for="id_form-3-name">Name:</label></th><td><input type="text" name="form-3-name" maxlength="100" /><input type="hidden" name="form-3-id" /></td></tr>

Присвоение max_num значения None (по умолчанию) устанавливает ограничение на количество отображаемых набором форм равное 1000. На практике это аналогично безлимитному количеству.

Использование набора модельных форм в представлении

Наборы модельных форм во многом похожи на наборы обычных форм. Для отображения набора форм для редактирования экземпляров модели Author:

from django.forms import modelformset_factory
from django.shortcuts import render_to_response
from myapp.models import Author

def manage_authors(request):
    AuthorFormSet = modelformset_factory(Author, fields=('name', 'title'))
    if request.method == 'POST':
        formset = AuthorFormSet(request.POST, request.FILES)
        if formset.is_valid():
            formset.save()
            # do something.
    else:
        formset = AuthorFormSet()
    return render_to_response("manage_authors.html", {
        "formset": formset,
    })

Как вы можете видеть, логика представления не сильно отличается отличается логики обычного набора. Отличием является вызов formset.save() для сохранения данных. (Это было описано ранее в Сохранение объектов набора форм.)

Переопределение

clean() у ModelFormSet

Подобно ModelForms, по умолчанию метод clean() класса ModelFormSet будет проверять все данные на нарушение ограничений уникальности, определённых в вашей модели (unique, unique_together или unique_for_date|month|year). Желая сохранить данный функционал при переопределении метода clean(), следует вызывать метод clean() базового класса:

from django.forms import BaseModelFormSet

class MyModelFormSet(BaseModelFormSet):
    def clean(self):
        super(MyModelFormSet, self).clean()
        # example custom validation across forms in the formset
        for form in self.forms:
            # your custom formset validation
            ...

На этом этапе уже будут созданы экземпляры модели для каждой формы. Поменяв form.cleaned_data, вы не поменяете сохраняемые значения. Для этого в ModelFormSet.clean() необходимо изменить form.instance:

from django.forms import BaseModelFormSet

class MyModelFormSet(BaseModelFormSet):
    def clean(self):
        super(MyModelFormSet, self).clean()

        for form in self.forms:
            name = form.cleaned_data['name'].upper()
            form.cleaned_data['name'] = name
            # update the instance value.
            form.instance.name = name

Использование собственной выборки

Как было сказано ранее, в можете переопределить стандартную выборку, которая используется набором модельных форм:

from django.forms import modelformset_factory
from django.shortcuts import render_to_response
from myapp.models import Author

def manage_authors(request):
    AuthorFormSet = modelformset_factory(Author, fields=('name', 'title'))
    if request.method == "POST":
        formset = AuthorFormSet(request.POST, request.FILES,
                                queryset=Author.objects.filter(name__startswith='O'))
        if formset.is_valid():
            formset.save()
            # Do something.
    else:
        formset = AuthorFormSet(queryset=Author.objects.filter(name__startswith='O'))
    return render_to_response("manage_authors.html", {
        "formset": formset,
    })

Следует отметить, что мы передаём аргумент queryset в обе ветки POST и GET в этом примере.

Использование набора форм в шаблоне

Существует три способа отображения набора форм в шаблоне Django.

Во-первых, вы можете позволить набору форм самому сделать всю работу:

<form method="post" action="">
    {{ formset }}
</form>

Во-вторых, в можете вручную вывести набор форм, но позволить его формам отображаться самостоятельно:

<form method="post" action="">
    {{ formset.management_form }}
    {% for form in formset %}
        {{ form }}
    {% endfor %}
</form>

При самостоятельном отображении форм, не забудьте отобразить техническую форму, как было показано выше. Обратитесь к документации на технические формы.

В-третьих, вы можете вывести все поля:

<form method="post" action="">
    {{ formset.management_form }}
    {% for form in formset %}
        {% for field in form %}
            {{ field.label_tag }} {{ field }}
        {% endfor %}
    {% endfor %}
</form>

Если вы предпочтёте третий способ и не будете использовать {% for %} для итерации по полям, то вам понадобится вывести поле для первичного ключа. Рассмотрим случай, когда требуется вывести поля name и age модели:

<form method="post" action="">
    {{ formset.management_form }}
    {% for form in formset %}
        {{ form.id }}
        <ul>
            <li>{{ form.name }}</li>
            <li>{{ form.age }}</li>
        </ul>
    {% endfor %}
</form>

Обратите внимание на то, как мы явно выводим {{ form.id }}. Это гарантирует, что набор модельных форм, в случае POST, будет работать правильно. (Этот пример предполагает, что первичный ключ имеет имя id. Если вы изменили имя первичного ключа, то учтите это в данном примере.)

Встраиваемые наборы форм

class models.BaseInlineFormSet

Встраиваемые наборы форм являются небольшим абстрактным слоем над набором модельных форм. Они упрощают работу со связанными через внешний ключ объектами. Предположим, у вас есть следующие две модели:

from django.db import models

class Author(models.Model):
    name = models.CharField(max_length=100)

class Book(models.Model):
    author = models.ForeignKey(Author, on_delete=models.CASCADE)
    title = models.CharField(max_length=100)

Если вам требуется создать набор форм для редактирования книг, принадлежащих определенному автору, вы можете сделать следующее:

>>> from django.forms import inlineformset_factory
>>> BookFormSet = inlineformset_factory(Author, Book, fields=('title',))
>>> author = Author.objects.get(name='Mike Royko')
>>> formset = BookFormSet(instance=author)

Переопределение методов в

InlineFormSet

Переопределяя методы InlineFormSet, лучше наследоваться от BaseInlineFormSet, чем от BaseModelFormSet.

Например, если вы хотите переопределить clean():

from django.forms import BaseInlineFormSet

class CustomInlineFormSet(BaseInlineFormSet):
    def clean(self):
        super(CustomInlineFormSet, self).clean()
        # example custom validation across forms in the formset
        for form in self.forms:
            # your custom formset validation
            ...

Смотрите также Переопределение clean() у ModelFormSet.

Потом при создании набора форм укажите аргумент formset:

>>> from django.forms import inlineformset_factory
>>> BookFormSet = inlineformset_factory(Author, Book, fields=('title',),
...     formset=CustomInlineFormSet)
>>> author = Author.objects.get(name='Mike Royko')
>>> formset = BookFormSet(instance=author)

Более одного внешнего ключа к одной модели

Если ваша модель имеет больше одного внешнего ключа на одну и ту же модель, вам следует разрешить эту путаницу, указав fk_name. Например, рассмотрим следующую модель:

class Friendship(models.Model):
    from_friend = models.ForeignKey(
        Friend,
        on_delete=models.CASCADE,
        related_name='from_friends',
    )
    to_friend = models.ForeignKey(
        Friend,
        on_delete=models.CASCADE,
        related_name='friends',
    )
    length_in_months = models.IntegerField()

Чтобы разрешить эту неопределенность, вы можете использовать fk_name в inlineformset_factory():

>>> FriendshipFormSet = inlineformset_factory(Friend, Friendship, fk_name='from_friend',
...     fields=('to_friend', 'length_in_months'))

Использование вторичного набора форм в представлении

Вам может понадобиться создать представление, которое позволит пользователю редактировать связанные объекты модели. Вот как это можно сделать:

def manage_books(request, author_id):
    author = Author.objects.get(pk=author_id)
    BookInlineFormSet = inlineformset_factory(Author, Book, fields=('title',))
    if request.method == "POST":
        formset = BookInlineFormSet(request.POST, request.FILES, instance=author)
        if formset.is_valid():
            formset.save()
            # Do something. Should generally end with a redirect. For example:
            return HttpResponseRedirect(author.get_absolute_url())
    else:
        formset = BookInlineFormSet(instance=author)
    return render_to_response("manage_books.html", {
        "formset": formset,
    })

Следует отметить, что мы передаём instance в обоих (POST и GET) случаях.

Материалы для форм: силиконы, полиуретаны, гидрофобизаторы, декоративные краски

Добро пожаловать на FORMODEL.BY! На нашем сайте в широком ассортименте представлены высококачественные материалы для изготовления форм, силикон, полиуретан, технологические и красящие добавки к ним, высокопрочный гипс, акриловые краски, полимерная глина, прозрачные эпоксидные смолы, пропитки, герметики, системы хранения, инструменты и многое другое для творческих людей.

Магазин партнеров в г.Минск, ул.Есенина, д.6

тел.+375-29-610-45-42

Будем рады вас видеть!

ПОЛИМЕРНАЯ ГЛИНА (ПЛАСТИКА) —

У нас вы найдёте широкий выбор полимерной и самоотверждающей глины ведущих производителей. Также представляем новинку — жидкую пластику АРТЕФАКТ.

АЭРОЗОЛИ И СПРЕИ CRAMOLIN

Очистители, защитные и смазочные средства, специальные аэрозоли, лаки.

А ВЫ ЛЮБИТЕ СКИДКИ?

Магазин formodel.by предлагает Вам очень простой способ получить скидку на ЛЮБОЙ товар из нашего ассортимента. Вы спросите «как?»

Читать далее…

Купить силикон для форм в Минске Вы можете сделав заказ на нашем сайте. Наши специалисты всегда помогут выбрать силикон для форм, который оптимально подходит для Вашего производства.

Для создания эластичных форм при производстве заборов, архитектурных форм, искусственного камня рекомендуем Вам приобрести полиуретан. На Ваш выбор предлагаем компаунды любой твердости.

Декор, создание декора, декоративные материалы, декоративная отделка, фасад, интерьер — любые идеи для Вашего дома легко воплотяться благодаря материалу пенополиуретан.

Сувенирная продукция, художественные изделия легко изготовить с помощью жидкого пластика. А незаменимым материалом для изготовления садовых скульптур и искусственного камня является пластикрит.

Для эффективной и надежной герметизации различных соединений многие предпочитают купить силиконовый герметик.

Приобретая водоотталкивающие пропитки для бетона, кирпича и камня, очистители высолов, Вы защитите свой дом, сделаете его красивым и изящным.

Акриловые краски, грунтовки, колеровочные пасты — всегда нужны при любом строительстве и ремонте. Купить краски стало проще — заказав у нас на сайте. А доступные цены Вас приятно удивят.

Представляем Вам всё, что необходимо для обработки, покрытия и защиты древесины. Любители бани и сауны найдут много полезного для себя: лаки, лазури, пропитки и многое другое.

Высококачественный инструмент от всемирно известного производителя — фирмы DREMEL. Инструмент DREMEL подходит для самых разных сфер деятельности или хобби.

Новые поступления

Подробнее о материалах, представленных на сайте:

Силиконы – современные уникальные материалы, устойчивые к повышенной влажности и температурам. К характеристикам данного материала можно отнести высокую долговечность, экологичность и биоинертность. Эти свойства являются причинами постоянного повышения популярности силиконов в как в промышленности, так и в ручном производстве изделий.

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

Пенополиуретаны для ручной заливки представляет собой двухкомпонентный материал для изготовления элементов декора. Его применение дает возможность производить отделку строения на любом этапе его возведения.

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

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

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

Краска интерьерная предназначена для декоративного окрашивания потолков и стен внутри помещений с гипсокартонными, бетонными, кирпичными или деревянными поверхностями. Среди характеристик данного покрытия можно выделить гладкость поверхности, устойчивость к многоразовому мытью или сухому протиранию, а также экологическую безопасность.

Древесная косметика применяется для защитно-декоративной отделки внутри и снаружи помещений. Пропитки по дереву предохраняют от плесени, синевы, грибка и насекомых. Для защиты потолка стен и полка саун применяется защитный состав.

Контакты

+375 (29) 742-45-42

+375 (44) 742-45-42

ИП Зомова Т.А.
Адрес регистрации: 212029, РБ, г. Могилев, пр-кт Шмидта, д. 68А, кв. 7

Почтовый адрес: 220007, г. Минск, ул. Левкова, д. 45, оф. 154
УНП 790306659
Свидетельство о госрегистрации 790306659 от 20.01.2006 г.

Адреса пункта самовывоза:

г. Минск, ул. Левкова, 45, 1 этаж

Телефоны: +375 29 742-45-42 (МТС), +375 44 742-45-42 (Velcom)

Режим работы: ПН-ПЯТ с 9.00 до 17.30;

СБ-ВС — выходной

г. Минск, пр-т Независимости, 85 Б, цокольный этаж

Телефоны: +375 33 616-25-99 (МТС), +375 29 616-25-99 (Velcom), гор. +375 17 355-45-42

Режим работы: ПОН-ПЯТ с 10.00 до 20.00;

СБ с 10.00 до 18.00;

ВС — выходной

Магазин наших партнеров — ХоббиХит:

г. Минск, ул.Есенина, д.6 (р-н Малиновка)

Телефон: +375 29 610-45-42 (А1)

Режим работы: ПОН-ПЯТ с 10.00 до 20.00;

СБ с 10.00 до 18.00;

ВС с 10.00 до 18.00

г. Могилев, ул. Первомайская, 27, 1 этаж

Телефон: +375 29 842-45-42 (МТС)

Режим работы: ПН-ПЯТ с 10.00 до 19.00;

СБ с 10.00 до 18.00;

ВС с 10.00 до 17.00

Один из крупнейших интернет-магазинов в Беларуси, который предлагает Вам высококачественные материалы для изготовления форм, товары для хобби, товары для дома и дачи, а также материалы и инструменты для любых Ваших творческих решений.

Наш дружный коллектив всегда готов помочь Вам в выборе материалов, а также проконсультировать Вас по всем интересующим вопросам. Мы зарекомендовали себя как надежный магазин, поэтому всегда предлагаем Вам только качественную продукцию от мировых производителей. С каждым днем количество наших покупателей растет, и мы делаем всё, чтобы покупки с нашим магазином стали проще и доступнее.

РЕЖИМ РАБОТЫ

Заказы на сайте: принимаются круглосуточно. Обрабатываются в рабочее время с понедельника по субботу.

Звонки и отгрузка товаров: с понедельника по пятницу, с 9 00 до 17 30.

МЫ НАХОДИМСЯ:

ул.Левкова, 45

Если у Вас в автомобиле установлен GPS-навигатор, то предлагаем Вам найти нас по координатам.

КООРДИНАТЫ: 53°52′23″N 27°33′24″E

Вы можете к нам добраться:

1. С ост. ДС Дружная или ост. Академия Управления (ст. м. Институт Культуры) автобусами 4, 4д или 10 до ост. ул. Левкова

2. Со стороны пр. Жукова автобусами 84, 124 до ост. ул. Левкова

3. Со стороны Восточного автовокзала (ул. Ванеева) 82с, 84, 93 до ост. ул. Левкова

4. От Игуменского тракта на автобусе 124 до ост.ул. Левкова

пр-т Независимости,85 Б

Создание модели обработки форм | Microsoft Docs

20.03.2021

Чтение занимает 4 мин

В этой статье

Использование AI Builder — функция в Microsoft PowerApps — пользователи SharePoint Syntex могут создавать модель обработки форм непосредственно из библиотеки документов SharePoint.Using AI Builder — a feature in Microsoft PowerApps — SharePoint Syntex users can create a form processing model directly from a SharePoint document library.

Создание модели обработки форм состоит из следующих действий:Creating a form processing model involves the following:

Шаг 1. Создание модели обработки для создания типа контентаStep 1: Create the from processing model to create the content type
Шаг 2. Добавление и анализ примеров файловStep 2: Add and analyze example files
Шаг 3. Выбор полей формыStep 3: Select your form fields
Шаг 4. Обучение и тестирование моделиStep 4: Train and test your model
Шаг 5. Публикация моделиStep 5: Publish your model
Шаг 6. Использование моделиStep 6: Use your model

ТребованияRequirements

Модель обработки форм можно создать только в библиотеках документов SharePoint, для которых она включена.You can only create a form processing model in SharePoint document libraries for which it is enabled. Если обработка формы включена, вы можете просмотреть AI Builder «Создать модель обработки форм» в меню Автоматизация в библиотеке документов.If form processing is enabled, you are able to see the AI Builder «Create a form processing model’ under the Automate menu in your document library. Если вам требуется обработка в библиотеке документов, необходимо обратиться к администратору SharePoint.If you need processing enabled on your document library, you must contact your SharePoint administrator.

Шаг 1. Создание модели обработки формStep 1: Create a form processing model

Первым шагом в создании модели обработки формы является присвоение ей имени и создание нового типа содержимого и создание нового представления библиотеки документов.The first step in creating a form processing model is to name it and create the define the new content type and create a new document library view for it.

В библиотеке документов выберите меню Автоматизация, выберите AI Builder и щелкните Создать модель обработки форм.From the document library, select the Automate menu, select AI Builder, and then select Create a Form Processing model.
В области Новая модель обработки форм, в поле Имя введите имя модели (например, Заказы на покупку).In the New form processing model pane, in the Name field, type a name for your model (for example, Purchase Orders).
При создании модели обработки форм создается новый тип содержимого SharePoint.When you create a form processing model, you create a new SharePoint content type. Тип содержимого SharePoint представляет собой категорию документов, имеющих общие характеристики и использующих коллекцию столбцов или свойств метаданных для определенного содержимого.A SharePoint content type represents a category of documents that have common characteristics and share a collection of columns or metadata properties for that particular content. Управление типами контента SharePoint осуществляется с помощью Коллекции типов содержимого.SharePoint Content Types are managed through the Content types gallery.
Выберите Дополнительные параметры, если вы хотите сопоставить эту модель с существующим типом содержимого в коллекции типов содержимого SharePoint, чтобы использовать ее схему.Select Advanced settings if you want to map this model to an existing content type in the SharePoint Content types gallery to use its schema.
Ваша модель создает новое представление в вашей библиотеке документов для извлеченных данных.Your model creates a new view in your document library for your extracted data. Если вы не хотите использовать это представление по умолчанию, снимите флажок Задать представление по умолчанию.If you do not want it to the default view, deselect Set the view as default.
Нажмите Создать.Select Create.

Шаг 2. Добавление и анализ документовStep 2: Add and analyze documents

После создания новой модели обработки форм браузер открывает новую страницу модели обработки форм PowerApps AI Builder.After you create your new form processing model, your browser opens a new PowerApps AI Builder forms processing model page. На этой странице вы можете добавить и проанализировать примеры документов.On this page you can add and analyze your example documents.

Выберите Добавить документы, чтобы начать добавление примеров документов, проанализированных для определения именованных пар значений, которые могут быть извлечены.Select Add documents to begin adding example documents analyzed to determine the named value pairs that can be extracted. После этого можно выбрать либо Загрузить из локального хранилища, SharePoint или из хранилища BLOB-объектов Azure.You can then choose either Upload from local storage, SharePoint, or Azure Blob storage. Для обучения необходимо использовать не менее пяти файлов.You need to use at least five files for training.
После добавления файлов нажмите кнопку Анализировать, чтобы проверить наличие общих сведений для всех файлов.After adding files, select Analyze to check for any information common is all files. Это может занять несколько минут.This may take several minutes to complete.
После анализа файлов на странице Выберите поля формы, которые хотите сохранить выберите файл, чтобы просмотреть найденные поля.After the files have been analyzed, in the Select the form fields you want to save page select the file to view the detected fields.

Шаг 3. Выбор полей формыStep 3: Select your form fields

После анализа документов для полей можно увидеть найденные поля и определить те, которые вы хотите сохранить.After analyzing the documents for fields, you can now see the fields that were found, and identify the ones that you want to save. Сохраненные поля отображаются в виде столбцов в представлении библиотеки документов вашей модели и показывают значения, извлеченные из каждого документа.Saved fields display as columns in your model’s document library view and show the values extracted from each document.

На следующей странице выводится один из примеров файлов и выделяются все общие поля, которые были автоматически обнаружены системой.The next page displays one of your sample files and will highlight all common fields that were automatically detected by the system.
Выберите поля, которые вы хотите сохранить, и установите флажок, чтобы подтвердить выбор.Select the fields that you want to save and select the checkbox to confirm your selection. Например, в модели «Заказ на покупку» можно выбрать поля Дата, Заказ на покупку, и Итоги.For example, in the Purchase Order model, choose to select the Date, PO, and Total fields. Обратите внимание, что вы также можете выбрать переименование поля, если вы выберете.Note that you can also choose to rename a field if you choose.
Если поле не было обнаружено в результате анализа, его все равно можно добавить.If a field was not detected by analysis, you can still choose to add it. Выделите сведения, которые вы хотите извлечь, и в поле «Имя» введите нужное вам имя.Highlight the information you want to extract, and in the name box type in the name you want. Затем установите флажок.Then select the check box. Обратите внимание, что вам необходимо подтвердить необнаруженные поля в оставшихся примерах файлов.Note that you need to confirm undetected fields in your remaining sample files.
Нажмите кнопку Подтвердить поля после выбора полей, которые вы хотите сохранить.Click Confirm fields after you have selected the fields that you want to save.
На странице Выбор полей формы, которые вы хотите сохранить будет указано количество выделенных полей.On the Select the form fields you want to save page, it shows the number of fields you have selected. Нажмите кнопку Готово.Select Done.

Шаг 4. Обучение и тестирование моделиStep 4: Train and test your model

После выбора полей, которые вы хотите сохранить, на странице Сведения о модели можно начать обучение и протестировать модель.After selecting the fields you want to save, the Model Summary page lets you train and test your model.

На странице Сведения о модели сохраненные поля будут показаны в разделе Выбранные поля.On the Model Summary page, the saved fields will show in the Selected fields section. Чтобы начать обучение по примерам файлов, выберите Обучение .Select Train to begin training on your example files. Обратите внимание, что это займет несколько минут.Note that this may take a few minutes to complete.
Когда появится уведомление о том, что обучение завершено, выберите Перейти на страницу «сведения».When you see the notification that training has completed, select Go to details page.
На странице Сведения о модели можно проверить, как ваша модель работает, выбрав Быстрый тест.On the Model details page, you can choose to test how your model works by selecting Quick test. Это позволяет перетаскивать файлы на страницу и проверять, обнаружены ли поля.This lets you drag and drop files to the page and see if the fields are detected.
Когда появится уведомление о том, что обучение завершено, выберите Перейти на страницу «сведения».When you see the notification that training has completed, select Go to details page.
На странице Сведения о модели проверьте, как ваша модель работает, выбрав Быстрый тест.On the Model details page, choose to test how your model works by selecting Quick test. Это позволяет перетаскивать файлы на страницу и проверять, обнаружены ли поля.This lets you drag and drop files to the page and see if the fields are detected.

Шаг 5. Публикация моделиStep 5: Publish your model

Если вы удовлетворены результатами вашей модели, выберите Опубликовать, чтобы сделать ее доступной для использования.If you are satisfied with the results of your model, select Publish to make it available for use.
После того как модель будет опубликована, выберите Использовать модель.After the model is published, select Use model. Это создает поток PowerAutomate, который может быть запущен в вашей библиотеке документов SharePoint, и который извлекает поля, которые были определены в модели, а затем выберите Создать поток.This creates a PowerAutomate flow that can run in your SharePoint document library and extracts the fields that have been identified in the model, then select Create Flow.
После завершения вы увидите сообщение о том, что Поток успешно создан.When completed, you will see the message Your flow has been successfully created.

Шаг 6. Использование моделиStep 6: Use your model

После публикации модели и создания потока PowerAutomate вы можете использовать модель в библиотеке документов SharePoint.After publishing your model and creating it’s PowerAutomate flow, you can use your model in your SharePoint document library.

После публикации модели выберите Перейти в SharePoint, чтобы перейти в библиотеку документов.After publishing your model, select Go to SharePoint to go to your document library.
В представлении модели библиотеки документов обратите внимание, что выбранные вами поля теперь отображаются в виде столбцов.In the document library model view, notice that the fields you selected now display as columns.
Обратите внимание, что информационная ссылка рядом с документами указывает на то, что к этой библиотеке документов применяется модель обработки форм.Notice that the information link next to Documents notes that a forms processing model is applied to this document library.
Отправка файлов в вашу библиотеку документов.Upload files to your document library. Все файлы, которые модель определяет как тип содержимого, содержат список файлов в вашем представлении и отображают извлеченные данные в столбцах.Any files that the model identifies as it’s content type lists the files in your view and displays the extracted data in the columns.

См. такжеSee Also

Документация Power AutomatePower Automate documentation

Учебный курс. Повышение продуктивности бизнеса с помощью AI BuilderTraining: Improve business performance with AI Builder

Использование модели обработки форм в Power Automate — AI Builder

04/05/2021

Чтение занимает 3 мин

В этой статье

Войдите в Power Automate.
Выберите Мои потоки в левой области, а затем выберите Создать поток > Мгновенный облачный поток.
Присвойте своему потоку имя, в разделе Выбор способа запуска для этого потока щелкните Активировать поток вручную и нажмите кнопку Создать.
Разверните Активация потока вручную и выберите +Добавить входные данные > Файл в качестве типа входных данных.
Замените слово Ввод на Содержимое файла (также называется «заголовок»).
Выберите + Создать шаг > AI Builder, а затем выберите Обработка и сохранение информации из форм в списке действий.
Выберите модель обработки форм, которую необходимо использовать, и затем выберите тип документа.
В поле Форма добавьте Содержимое файла из триггера:
В дальнейших действиях можно использовать любые столбцы и таблицы, извлеченные моделью AI Builder. Например, предположим, что модель обучена извлекать значение параметров из значения Номер счета и Общая сумма, и необходимо отправить их в канал Microsoft Teams. Просто добавьте действие Опубликовать сообщение в группы, а затем выберите столбцы в списке токенов.
Примечание
- Чтобы получить значение столбца, выберите <field_name> значение. Например для столбца СЧЕТ выберите Значение СЧЕТА.
- Чтобы получить оценку достоверности для столбца, выберите <field_name> оценка достоверности. Например для столбца СЧЕТ выберите Оценка достоверности СЧЕТА.

Параметры

Ввод

Имя (название)	Обязательные	Тип	Описание	Значения
Модель ИИ	Да	модель	Модель обработки форм для использования для анализа	Обученные и опубликованные модели для обработки форм
Тип документа	Да	Список	Тип файла формы для анализа	PDF-документ (.pdf), Изображение JPEG (.jpeg), Изображение PNG (.png)
Форма	Да	Файл	Форма для обработки

Вывод

Имя (название)	Тип	Описание	Значения
Значение {field}	string	Значение, извлеченное моделью ИИ
Степень достоверности {field}	с плавающей запятой	Степень уверенности модели в своем прогнозе	Значение в диапазоне от 0 до 1. Значения, близкие к 1, свидетельствуют о большей уверенности в том, что извлеченное значение точно
Значение {table}{column}	string	Значение, извлеченное моделью ИИ для ячейки в таблице
Степень достоверности {table}{column}	с плавающей запятой	Степень уверенности модели в своем прогнозе	Значение в диапазоне от 0 до 1. Значения, близкие к 1, свидетельствуют о большей уверенности в том, что извлеченное значение ячейки точно

Примечание

Могут быть предложены дополнительные параметры вывода, такие как координаты поля, многоугольники, ограничивающие прямоугольники и номера страниц. Они не указаны специально, поскольку предназначены в основном для расширенного использования.

Распространенные варианты использования

Итерация выходных данных таблицы обработки формы в Power Automate

Чтобы проиллюстрировать эту процедуру, мы используем следующий пример, в котором мы обучили модель обработки формы извлекать таблицу, которую мы назвали Позиции с тремя столбцами: Количество, Описание и Всего. Мы хотим сохранить каждую позицию из таблицы в файл Excel.

Выберите поле, в которое хотите записать ячейку таблицы. Откроется панель динамического содержимого, на которой будет показано все, что модель обработки формы умеет извлекать. Найдите {имя вашей таблицы} {имя вашего столбца} значение. В нашем примере сверху это значение количества позиций.

После добавления этого значения действие, в которое вы его добавили, автоматически вставляется в элемент управления Применить к каждому. Таким образом, каждая строка в таблице будет обработана при запуске потока.
Продолжайте добавлять столбцы, которые хотите итерировать.

Удалите символы валюты (€, $, …) в выходных данных обработки формы в Power Automate

Представим, что значение Итого, извлеченное моделью обработки форм, имеет символ валюты, например: $54. Чтобы удалить знак $ или любые другие символы, которые вы хотите опустить, используйте выражение replace, чтобы удалить его. Вот как это сделать:

replace(<form processing output>, '$', '')

Преобразование строки выходных данных обработки форм в число в Power Automate

Обработка форм AI Builder возвращает все извлеченные значения в виде строк. Если место назначения, в котором вы хотите сохранить значение, извлеченное обработкой формы AI Builder, требует числа, вы можете преобразовать значение в число, используя выражение int или float. Используйте int, если число не имеет десятичных знаков. Используйте float, если у числа есть десятичные знаки. Вот как это сделать:

float('<form processing output>')

Удаление пустых символов из выходных данных обработки формы в Power Automate

Чтобы удалить пробелы из выходных значений, используйте функцию replace:

replace(<form processing output>, ' ', '')

Преобразование строки выходных данных обработки форм в дату в Power Automate

Обработка форм AI Builder возвращает все извлеченные выходные данные в виде строк. Если место назначения, в котором вы хотите сохранить значение, извлеченное при обработке формы, должно быть в формате даты, вы можете преобразовать значение, содержащее дату, в формат даты, используя выражение formatDateTime. Вот как это сделать:

formatDateTime(<form processing output>)

Фильтр подписи электронной почты из потока, чтобы она не обрабатывалась моделью обработки формы (Office 365 Outlook)

Для входящих сообщений электронной почты из соединителя Office 365 Outlook подписи сообщений электронной почты собираются Power Automate как вложения. Чтобы они не обрабатывались моделью обработки форм, добавьте в свой поток условие, которое проверяет, выводятся ли выходные данные из соединителя Office 365 Outlook с именем Вложения встроены, равным false. В ветви Если да условия добавьте действие обработки формы. При этом будут обрабатываться только вложения электронной почты, не являющиеся встроенными подписями.

См. также

Общие сведения о модели обработки форм

Мастер модель своими руками для снятия силиконовой формы для отливки гипсом

Что такое мастер-модель

Мастер-моделью называют образцовую деталь или изделие, которая используется для последующего ее копирования.

Например, вы решили украсить дом десятью фигурками. Можно десять раз вырезать их из дерева или слепить из пластилина, но, во-первых, это долго, во-вторых, крайне сложно сделать десять одинаковых фигурок. Гораздо проще сделать одну и затем скопировать ее.

Вот эта первая, «идеальная» фигурка и называется мастер-моделью.

Варианты использования мастер модели в гипсовой отрасли

Гипс простой в обработке, удобный и распространенный материал, замены которому пока не существует.

Он используется в строительстве, ювелирной и керамической отраслях, архитектуре, скульптуре и медицине..

Понадобятся мастер-модели для создания украшений, купажа, при производстве керамики или предметов интерьера: ваз, подставок. Скульптур и даже лепного декора.

Разумеется, для разных нужд нужны разные мастер-модели и специальный гипс. Для стоматологии используется медицинский гипс (https://samaragips.ru/catalog/meditcinskii-gips/), и мастер-модель должна быть идеальна.

Совсем другого отношения требует гипс строительный(https://samaragips.ru/catalog/stroitelnyi-gips/). Хотя даже для создания украшений для дома, например, нескольких декоративных фигурок следует уделить много внимания мастер-модели.

Мастер модель своими руками

Существует много различных вариантов материала для мастер-модели, если вы намерены сделать ее самостоятельно.

Самые распространенные: пластилин или воск, глина, дерево или металл.

Мастер-модели из пластилина, воска и глины часто выбирают для «домашнего» производства. Материалы податливые и легко поддаются дополнительной обработке, то есть если у вас сразу не вышла эталонная модель, вы можете ее доработать.

Тем не менее именно это свойство многие мастера считают также и недостатком материалов: материал податлив и любая дополнительная обработка или неосторожность может испортить модель.

При работе с такими материалами используются наборы для ручной работы: напильники, лобзики, бормашины.

После завершения работы, пластилин и некоторые виды глины оставляют на несколько дней для затвердевания. Глина в основном обжигается в керамической печи (в домашних условиях иногда используются духовые плиты). И для пластилина, и для глины, и для воска нужно учитывать усадку материала после затвердевания или обжига.

С деревом работать немного сложнее. Для сложных или массивных форм нередко нужно использовать станки или создавать модель из нескольких частей при помощи инструментов, склеивая их между собой, обязательно подбирая клей и учитывая его особенности. Финальная обработка поверхности перед заливкой формы с одной стороны проще благодаря прочности материала, с другой – дольше по времени.

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

Мастер модель на 3д принтере

Из-за высоких требований к мастер-модели многие мастера, даже если речь идет об изделиях «для себя», прибегают к современным технологиям и печатают «эталон» на 3D принтерах или создают при помощи фрезерных станков с ЧПУ (числовое программное управление).

В обоих случаях перед работой понадобится 3D-модель изделия, то есть нужно или найти подходящую форму, или создать ее самому, или заказать у специалистов. Разумеется, такой способ дороже описанных выше.

Работа с 3D принтерами становится все популярнее благодаря скорости, простоте и высокой точности моделей, не требующих последующей обработки поверхности.

Для 3D печати используются воск, пластик, полимеры (гипсополимер, фотополимерная смола) или металлы. Выбор материала важен и зависит от ваших целей.

Например, воск или гипсополимер достаточно хрупкие, но позволяют делать очень точные модели. Эти материалы подходят для изготовления предметов искусства, маленьких фигурок, архитектурных элементов.

Пластик или фотополимерная смола прочнее, можно создавать более крупные модели, обычно используются для изготовления сувениров или прототипов каких-нибудь деталей, чтобы проверить их гибкость/прочность.

К металлу же прибегают, когда требуется крайне прочный или сложный по виду образец. Потому металл используется в инженерии или медицинском протезировании.

Почти все компании, занимающиеся 3D печатью, предлагают также и предварительное моделирование или помощь в нем.

Например:

https://www.cubicprints.ru/
https://can-touch.ru/
https://top3dshop.ru/

Мастер модель из готового изделия

Естественно вы можете использовать для литья и уже готовое изделие как в качестве 3D модели, так и для отливки «эталона». То есть для образца берется любая уже готова фигурка, деталь или форма и заливается силиконом. Существуют также специализированные сайты и форумы, где продаются самые разные подходящие изделия, а иногда уже и мастер-модели или даже услуги по их изготовлению.

Например:

https://www.livemaster.ru/
https://freelance.youdo.com/freelancers/frilanseri-3D-modelirovanie/
http://forum.rcdesign.ru/

Проверка набора форм промежуточной модели

Мне интересно, Как указать некоторые ограничения на промежуточный набор форм модели.
У меня есть 3 класса в модели:
Атрибут, продукт и AttributeValuation, который является промежуточным для атрибута и продукта:

class Attribute(models.Model):
    type = models.CharField(max_length = 200)
    pass

class Product(models.Model):
    attribute_values = models.ManyToManyField(Attribute, through='AttributeValuation')

class AttributeValuation(models.Model):
    attribute = models.ForeignKey(Attribute)
    product = models.ForeignKey(Product)

Кроме того, я построил AttributeValuationInline с AttributeFormset и зарегистрировал его на ProductAdmin:

class AttributeValuationInline(admin.TabularInline):
    model = AttributeValuation
    extra = 0
    formset = AttributeFormset

class ProductAdmin(admin.ModelAdmin):
    inlines = (AttributeValuationInline,)

class AttributeFormset(BaseInlineFormSet):
    def clean(self):
        pass

Мой вопрос заключается в следующем: как я могу проверить в чистом методе содержимое каждой встроенной строки (формы)? Я пробовал через каждую форму self.forms в Formset, но не смог получить доступ к конкретным полям атрибутивной модели (представьте себе, что они есть, я не хочу запутывать свой вопрос нерелевантными данными)?

В моем примере я хотел бы иметь максимум один атрибут каждого типа на продукт (чтобы никто не помещал два или более атрибутов с одним и тем же типом, связанных с одним продуктом).

django

django-models

django-forms

Поделиться

Источник

Tomasz Jurkiewicz

13 февраля 2011 в 11:04

2 ответа

Django Данные Набора Форм Модели Всегда Сохраняются
Я чувствую, что, должно быть, упускаю что-то очевидное, но у меня есть проблема, когда мои модельные наборы форм настаивают на сохранении своих данных после отправки. Я создаю страницу, которая позволяет пользователю создать проект, а затем добавить произвольное количество материалов в этот…
Как получить экземпляр модели из набора форм модели
Я создал набор форм из модели, внутри которой есть ImageField. Теперь при редактировании набора форм я хотел бы показать изображение рядом с другими полями в шаблоне, чтобы пользователь мог видеть, какие изображения они загрузили. Из того, что я понимаю, их не так просто сказать: {% for form in…

Я прошел через

   for form in self.forms:
       form.instance

И все в порядке. Почему cleaned_data должна быть лучше?

Поделиться

tomek

17 февраля 2011 в 08:31

self.forms[0].cleaned_data

не получится?

Поделиться

Lakshman Prasad

16 февраля 2011 в 07:31

Изготовление моделей из гладких материалов

Что люди сделали с этими материалами

Формование оригинальной опоры Ghostbusters®

Художник Пол Фрэнсис показывает, как он воспроизводит оригинального Terror Dog из Ghostbusters®

›Просмотреть главную статью