Cenário de utilização
Você pretende adicionar dois campos de data à subseção e eles devem ter um calendário no diálogo de entradas possíveis. Além disso, você pretende ampliar o campo de entrada individual para um campo de entrada de várias linhas. Além disso, adicione um texto de caractere de preenchimento que é exibido se o campo estiver vazio.
Fluxo de tarefas
Neste exercício, você realizará as seguintes tarefas utilizando o Editor de páginas:
- Adicione dois campos do tipo Data à subseção da página do objeto.
- Modifique o tipo do campo de entrada e adicione um texto de caractere de preenchimento que é exibido quando o campo está vazio.
Pré-requisitos
Você concluiu o exercício Utilizar a entidade Singleton para valores constantes do microdiagrama Bullet no capítulo Moldar a área do cabeçalho da página do objeto (lição: Utilização da entidade Singleton). Como alternativa, você pode conferir sua ramificação da solução: solution/use-singleton-for-bullet-micro-chart-on-op.
Assista à simulação e execute as etapas
Este exercício contém uma simulação que orienta você por todas as etapas descritas abaixo. Você pode seguir a simulação e executar as etapas utilizando sua própria conta de teste.
Etapas
Abra seu projeto CAP no SAP Business Application Studio.
Na visão Explorer, selecione Projetos\app\webapp.
Clique com o botão direito do mouse no webapp e selecione Mostrar mapa da página. O aplicativo Mapa de páginas das viagens é exibido.
Selecione o ícone Edit da página de objeto Travel. O editor de páginas da TravelObjectPage é exibido.
Adicione dois campos de data na subseção Informações gerais.
No Layout da página, em Seções, expanda Informações gerais.
Expandir subseções\Informações gerais\Formulário\Campos.
Selecione Adicionar.
Selecione Adicionar campos básicos. A caixa de diálogo Adicionar campo básico é exibida.
Na lista de opções, selecione BeginDate e EndDate.
Selecione Adicionar. Os campos Data final e Data de início aparecem na árvore de controle do Editor de páginas.
Nota
No painel à direita, o usuário pode ver as configurações que pode modificar para o campo selecionado.
Modifique o tipo do campo Descrição para multilinha. Adicione um texto de espaço reservado a ele.
Execute as etapas 1 e as subetapas a até b da etapa 2.
Selecione Descrição.
No painel à direita, em Tipo de exibição, escolha o menu suspenso.
Selecione Área de texto.
Selecione o ícone Editar no texto fonte. O arquivo layout.cds é exibido. A anotação @UI.MultiLineText é gerada pelo editor de páginas.
Adicione a anotação @UI.Placeholder à anotação @UI.MultiLineText.
Code Snippet1234annotate TravelService.Travel with { Description @UI.MultiLineText: true @UI.Placeholder : '{i18n>DescrPlcehlder}' }Na visão Explorer, selecione Projetos\_i18n\i18n.properties. O arquivo i18n.properties é aberto. Adicione o seguinte texto de espaço reservado ao arquivo:
Code Snippet1DescrPlcehlder=Put your description for the travel
Visualize os dois campos de data na aplicação Administrar viagens.
Abra a aplicação Administrar viagens. Na subseção Informações gerais, você pode ver os campos Data final e Data de início.
Selecione Editar.
Selecione o ícone de calendário correspondente ao campo Data final.
Resultado
O calendário é adicionado automaticamente como entradas possíveis aos campos de entrada do tipo Data.
Nota
Você pode ver na ramificação da solução para este exercício que o Editor de páginas adicionou dois valores do tipo UI.DataField à anotação existente para a subseção ( @UI.FieldGroup#TravelData).
Visualize o campo de entrada de várias linhas e o texto de caractere de preenchimento para o campo Descrição.
Abra a aplicação Administrar viagens.
Selecione Editar.
Resultado
O campo de entrada individual é ampliado para o campo de texto de várias linhas. Além disso, se o campo de texto estiver vazio, você poderá ver o texto substituído pelo espaço reservado recém-adicionado. Coloque a descrição da viagem aqui.
Resultado
Nesta lição, você aprendeu a adicionar um campo a uma seção ou subseção na página do objeto com a ajuda do Editor de páginas. Você também pode modificar as configurações para os campos, como um denominador de campo, um tipo de campo, e adicionar restrições utilizando o Editor de páginas.
Nota
Você pode encontrar a solução para este exercício no GitHub.
- A ramificação da solução é solução/add-date-multiline-text-placeholder.
Você pode ver as modificações de código em comparação com a ramificação anterior no GitHub.
Etapas seguintes
Para mais informações, consulte