Visión xeral dos comandos modernos
Os comandos impulsan o comportamento das aplicacións básicas para aplicacións baseadas en modelos. Son os botóns cos que interactúan os usuarios ao reproducir aplicacións e as accións resultantes que se realizan cando se selecciona un botón. Cada comando vaise dispoñer en relación con outros comandos e están asociados a unha localización da barra de comandos dentro da aplicación.
A un alto nivel, a personalización de comandos encaixa nas seguintes categorías. Existen varias capacidades dentro de cada categoría e están cubertas con máis profundidade na documentación de mando moderna:
- Visualización. Como aparece o botón e onde se atopa nunha aplicación. Por exemplo, a etiqueta do botón, a icona e as etiquetas de accesibilidade, así como a localización e posición da barra de comandos dentro dunha barra de comandos.
- Acción. A lóxica que se executa cando se selecciona un botón. Por exemplo, crear e actualizar datos ou interactuar con varios controis e páxinas dentro da aplicación.
- Visibilidade. Condicións lóxicas que especifican cando un botón está visible ou oculto para un usuario. Por exemplo, pode querer que o botón sexa visible para algúns usuarios e oculto para outros. Ou quizais o botón só debería estar visible cando se cumpran determinados criterios dos rexistros de datos.
Localizacións da barra de comandos
Grade principal. Esta barra de comandos aparece ao usar a navegación esquerda dunha aplicación para ver a lista completa de páxinas de rexistros desta táboa.
Formulario principal. Esta barra de comandos aparece nos formularios principais da táboa. Isto aparece na parte superior do formulario e non é o mesmo que a vista asociada ou a subgrade que aparecerán en diferentes áreas do formulario.
Visualización de subgrade. Esta barra de comandos aparece nos formularios doutras táboas que procesan os datos desta táboa nunha subgrade. Por exemplo, o formulario principal da conta ten un control de subgrade que lista os rexistros de contacto relacionados co rexistro da conta. Para editar a barra de comandos seguinte, edite a barra de comandos da táboa de contactos e despois a vista de subgrade.
Visualización asociada. Esta barra de comandos aparece como unha táboa primaria ao ver os datos relacionados desta táboa. Por exemplo, no formulario principal dun rexistro de conta, seleccione o separador Relacionado e, a continuación, seleccione unha táboa relacionada, como contactos.
Accións rápidas. As accións rápidas están asociadas coa localización principal da grella. Para engadir ou editar comandos tanto para accións rápidas como para as localizacións principais da grella, seleccione a táboa desexada desde o deseñador de aplicacións moderno, despois edite a barra de comandos e escolla a localización da grella principal. Os primeiros cinco comandos, determinados por orde, tamén se mostrarán como accións rápidas ao xogar á aplicación.
Nota
No deseñador de comandos non se admiten as localizacións das barras de comandos personalizadas con menos frecuencia. Vexa as seccións de Barra de comandos globais e outras cintas para obter máis información sobre a personalización dos comandos para estas localizacións.
Tipos de comandos
- Comando. Botón estándar. Realiza unha acción cando se selecciona. Tamén se pode aniñar en grupos dentro de menús despregables e botóns divididos. Teña en conta que estes foron chamados menús emerxentes no comando clásico.
- Menú despregable. Crea un menú no que pode organizar os comandos nun grupo.
- Grupo. Engada mosaicos aos grupos de comandos aniñados en menús despregables e botóns de división.
- Botón de división. Similar a un menú despregable, pero ten un comando principal. Cando se selecciona o botón de división, execútase a acción do comando principal. Se se selecciona o botón de contido adicional de expandir, o comando principal non se executará. Pola contra, unha lista expandirase para mostrar grupos adicionais, menús flotantes e comandos.
Diferenzas clave entre os comandos clásicos e os modernos
Os comandos clásicos (antes coñecidos como cinta) non se podían personalizar usando apenas código. Co código, as personalizacións de comandos eran difíciles, tediosas e propensas a erros. Para escalar os comandos ao uso de pouco código, así como ao uso de páxinas personalizadas para converxer aplicacións baseadas en lenzo e modelos, era vital reinventar e reconstruír a infraestrutura dos comandos.
O comando moderno ofrece moitas novas capacidades e é moito máis sinxelo de usar.
| Capacidade | Clásico | Moderno |
|---|---|---|
| Compatible no tempo de execución dunha aplicación controlada por modelos | Si | Si, admite ademais o tempo de execución de Power Fx. |
| Personalizado mediante | Edición manual de XML dentro de ficheiros de solución ou utilizando ferramentas de terceiros. Operacións de exportación e importación de solucións que requiren moito tempo. | Deseñador de comandos así como soporte de API de Dataverse. |
| Admite Power Fx. | No | Si. Por accións e visibilidade. |
| Tempo necesario para personalizar | Lento, propenso a erros. | Rápido |
| Rendemento e fiabilidade | Fácil de cometer erros. A mala personalización e a falta de alcance adoitan afectar o rendemento da aplicación | O tratamento de erros en liña evita erros. Power Fx optimizado para un mellor rendemento en tempo de execución. |
| Compartir | Seguranza baseada en roles de Dataverse estándar. | Os comandos distintos de Power Fx usan a seguridade baseada en roles de Dataverse estándar. Os comandos de Power Fx actualmente requiren que a biblioteca de compoñentes de comandos se comparta ademais de ter un rol de seguranza axeitado. |
| Comportamento da solución e ALM | Estratificación de solucións inconsistente e problemática, sen presenza na interface da solución. Moitos comportamentos de solución estándar non son compatibles, como parches, segmentación, actualización da solución, propiedades xestionadas e moitos máis. | Capas de solución estándar xestionadas de forma centralizada para varios tipos de obxectos de solución dentro de Dataverse. Presente na interface da solución. Admítense todos os comportamentos de solución estándar. |
| Localización | Non estándar | Estandarizado mediante traducións de exportación e importación para toda a solución. |
| Modelo de datos | Complexo. Optimizado para cintas clásicas e contén moitas propiedades que xa non son necesarias. | Simple, optimizado para as barras de comandos das aplicacións baseadas en modelos actuais. |
| Usar JavaScript | Si | Si. Agora máis sinxelo. Nota: Pódese usar o mesmo JavaScript para comandos clásicos e modernos. |
| Personalizar os comandos listos para usar | Si | Os comandos fanse editables no deseñador de comandos unha vez migrados ao marco moderno. |
| Engadir comandos específicos | No | Si. Usar un deseñador de comandos moderno garante que os comandos só sexan visibles na aplicación seleccionada. |
| Comandos específicos da táboa que se mostrarán en todas as aplicacións que conteñan a táboa | Si | Si. Require modificar a definición de appaction dentro do ficheiro de solución. |
| Comandos globais que se mostrarán para todas as táboas e aplicacións para a localización da barra de comandos especificada | Si | Si. Require modificar a definición de appaction dentro do ficheiro de solución. |
| Crear botóns divididos, menús flotantes e grupos | Si | Si |
| Encher dinámicamente un menú flotante con código | Si | Non. Recomendamos crear comandos de forma declarativa. |
| Personalizar os comandos de cabeceira das aplicacións globais | Si | No |
| Personalizar os comandos para outras localizacións da barra de comandos / pouco comúns ou obsoletas | Si | No |
| Executar un fluxo ou fluxo de traballo moderno | Uso de JavaScript | Uso de JavaScript. Tamén compatible usando unha páxina personalizada. |
Comparación de regras de visibilidade clásicas versus modernas
As regras clásicas de visibilidade tiñan moitas veces unha regra específica para cada escenario. Con Power Fx, unha función declarativa substitúe moitas regras clásicas. E é moito máis sinxelo de usar.
Teña en conta que as regras clásicas de visibilidade tamén serán compatibles en breve nos comandos modernos. Non obstante, o soporte para as regras clásicas era necesario para migrar de forma fiable os comandos clásicos aos comandos modernos e non se admite a personalización de regras clásicas no deseñador de comandos. Recomendámoslle que use Power Fx no sucesivo.
| Caso de uso | Regra clásica | Opcións clásicas | Propiedade visible de Power Fx |
|---|---|---|---|
| Mostrar/ocultar en función dos valores dos datos | CustomRule | Usar JavaScript | !IsBlank(Self.Selected.Item.Email) |
| Mostrar/ocultar segundo o permiso da táboa | EntityPrivilegeRule | Varias | DataSourceInfo() |
| Mostrar/ocultar segundo o permiso do rexistro | RecordPrivilegeRule | Varias | RecordInfo() |
| Consultar o contexto de control para as táboas primarias e relacionadas | EntityRule | PrimaryEntity. SelectedEntity | Self.Selected |
| Referencia ao contexto de control | EntityRule | Formulario. HomePageGrid. SubGridStandard. SubGridAssociated | Self.Selected |
| Propiedades dos metadatos da táboa | EntityPropertyRule | DataSourceInfo() | |
| Mostrar/ocultar segundo o estado do formulario. Por exemplo, mostrar para o formulario de creación | FormStateRule | Crear. Existente. ReadOnly. Desactivado. BulkEdit | Self.Selected.State = FormMode.New |
| Mostrar cando se seleccionan > 1 rexistros nunha cuadrícula | SelectionCountRule | CountRows(Self.Selected.Items) > 1 | |
| Mostrar/ocultar unha táboa relacionada nunha busca polimórfica. Por exemplo, comprobe se a busca é un usuario OU un equipo | CustomRule | PrimaryEntityTypeCode | IsType(), AsType |
| Propiedades dun ambiente de referencia (org) | CustomRule | OrgName. OrgLcid. UserLcid | Non dispoñible actualmente |
Preguntas máis frecuentes
- Por que vexo máis comandos no deseñador que os que vexo na miña aplicación?
- Hai varias razóns. Ás veces hai lóxica de visibilidade que ocultará o comando ao executar a aplicación. Noutras ocasións estes comandos inxéctanse de forma dinámica mediante JavaScript personalizado durante o tempo de execución e non se poden configurar.
- Por que vexo comandos duplicados no deseñador?
- Este era un padrón común empregado cos comandos clásicos. Ambos os comandos non aparecían no tempo de execución xa que estaban controlados por regras de visibilidade. O deseñador de comandos amosará todos os comandos, independentemente das súas regras de visibilidade.
Consulte tamén
Personalizar a barra de comandos co deseñador de comandos
Xestionar os comandos nas solucións
Limitacións coñecidas dos comandos modernos