Udostępnij przez


Dostosowywanie formularzy jednostek

Formularze udostępniają interfejs użytkownika używany przez użytkowników do tworzenia, wyświetlania lub edytowania rekordów jednostek. Użyj projektanta formularzy w narzędziach dostosowywania, aby tworzyć i edytować formularze jednostek. Więcej informacji: Tworzenie i projektowanie formularzy dotyczących zadań związanych z pracą z formularzami w aplikacji.

Ten temat zawiera informacje niezbędne do programowego tworzenia lub edytowania formularzy.

Uzyskiwanie dostępu do definicji formularzy

Formularze jednostek są przechowywane w jednostce SystemForm wraz z pulpitami nawigacyjnymi i wizualizacjami. Istnieją dwa sposoby inspekcji definicji formularzy dla jednostki:

  • Uwzględnij jednostkę w rozwiązaniu niezarządzanym i wyeksportuj rozwiązanie.

  • Wykonywanie zapytań względem SystemForm jednostki

Wyświetlanie formatu FormXML z wyeksportowanej jednostki

Tylko definicje formularzy jednostek systemowych, które zostały dostosowane, są uwzględniane w wyeksportowanym rozwiązaniu zarządzanym. Aby wyświetlić definicję formularza jednostki systemowej, musisz zmienić go w jakiś sposób lub utworzyć nowy formularz, zapisując istniejący formularz z nową nazwą.

Po wyeksportowaniu rozwiązania wyodrębnij zawartość i wyświetl plik customizations.xml. Definicję formularzy znajdziesz w pliku ImportExportXml>Entities>Entity>FormXml. W węźle <FormXml> znajdziesz każdy typ formularza jest grupowany w <forms> elemecie z atrybutem type określającym typ formularza.

Właściwości formularza

W poniższej tabeli opisano atrybuty jednostki klucza SystemForm i odpowiednie dane zawarte w elementach XML wyeksportowanych z rozwiązaniem.

Właściwość SystemForm FormXML, element Description
AncestorFormId <ancestor> Unikatowy identyfikator formularza nadrzędnego. Jest on ustawiany podczas tworzenia nowego formularza przy użyciu polecenia Zapisz jako dla istniejącego formularza lub przy użyciu polecenia CopySystemFormRequest.
CanBeDeleted <CanBeDeleted> Informacje określające, czy można usunąć ten składnik. Ta właściwość zarządzana jest stosowana tylko wtedy, gdy formularz został utworzony przez zaimportowanie rozwiązania zarządzanego.
Description <Descriptions> Description jest ciągiem i <Descriptions> zawiera wszystkie zlokalizowane etykiety opisu formularza.

Zlokalizowane etykiety można pobrać przy użyciu elementu RetrieveLocLabelsRequest.
FormActivationState <FormActivationState> Określa stan formularza.

Można dezaktywować tylko formularze typu "main".

Prawidłowe wartości:

- 0: Nieaktywne
- 1: Aktywne
FormId <formid> Unikatowy identyfikator formularza
FormPresentation <FormPresentation> Określa, czy ten formularz znajduje się w zaktualizowanym układzie interfejsu użytkownika w usłudze Dynamics 365 for Customer Engagement.
FormXml <form> Reprezentacja XML układu formularza.
IntroducedVersion <IntroducedVersion> Wersja rozwiązania, w ramach którego został dodany formularz.
IsAIRMerged N/A Określa, czy ten formularz jest scalany ze zaktualizowanym układem interfejsu użytkownika w usłudze Dynamics 365 for Customer Engagement.
IsCustomizable <IsCustomizable> Informacje określające, czy można dostosować ten składnik.

Ta właściwość zarządzana jest stosowana tylko wtedy, gdy formularz został utworzony przez zaimportowanie rozwiązania zarządzanego.
IsDefault N/A Informacje określające, czy formularz, czy pulpit nawigacyjny jest domyślnym systemem.
Name <LocalizedNames> Name jest ciągiem i <LocalizedNames> zawiera wszystkie zlokalizowane etykiety dla nazwy formularza.

Zlokalizowane etykiety można pobrać przy użyciu elementu RetrieveLocLabelsRequest.
ObjectTypeCode Formularz jest decedentem Entity elementu. Wartość ObjectTypeCode jest nazwą logiczną jednostki.
Type <forms>atrybut elementu type Prawidłowe wartości formularzy to:

- 2: main
- 5: mobile
- 6: quick
- 7: quickCreate

Tworzenie i edytowanie formularzy

Można tworzyć tylko nowe formularze dla jednostki, w której EntityMetadata. CanCreateForms pozwala na to.

Nowe formularze można tworzyć przy użyciu elementu CreateRequest lub CopySystemFormRequest. W przypadku używania lub używania CopySystemFormRequest funkcji Zapisz jako w edytorze formularzy nie ma dziedziczenia między formularzami. W związku z tym zmiany w formularzu podstawowym nie są automatycznie stosowane do żadnych formularzy utworzonych na jego podstawie.

Edytowanie definicji formularzy z wyeksportowanego rozwiązania zarządzanego, a następnie ponowne zaimportowanie rozwiązania jest obsługiwaną metodą edytowania formularzy jednostek. Podczas ręcznego edytowania formularzy zdecydowanie zalecamy użycie edytora XML, który umożliwia weryfikację schematu. Więcej informacji: Edytowanie pliku XML dostosowywania przy użyciu walidacji schematu

Zobacz także

Dostosowywanie usługi Microsoft Dynamics 365 Customer Engagement
Tworzenie i projektowanie formularzy
Jednostka SystemForm
Tworzenie lub edytowanie sposobu inicjowania reguł biznesowych
Schemat XML formularza