O componente de exibição do calendário

  • Versão de lançamento: Australia
  • Atualizado 12 de mar. de 2026
  • 2 min. de leitura
  • Use o componente de exibição do calendário em CPQ para apresentar opções de configuração baseadas em tempo em uma exibição mensal. Defina conjuntos, campos e configurações de seleção para permitir que os usuários exibam, selecionem e gerenciem registros específicos de data diretamente na interface de configuração.

    CPQ A IU nativa permite que o administrador apresente um componente de exibição de calendário ao usuário para ajudar nas configurações baseadas em tempo. O calendário é exibido no contexto de um mês. Os dados subjacentes à exibição do calendário são um conjunto, com cada dia do calendário representado por um registro no conjunto.

    O exemplo abaixo mostra um conjunto com 30 registros, um para cada dia, representado como um componente de exibição de calendário.

    Interface do calendário

    Os elementos-chave compatíveis com este exemplo incluem um conjunto com o nome da variável Disponíveis . Este conjunto contém os seguintes campos associados:
    • SelecionedDate (Booliano): Captura se o usuário selecionou uma ou mais datas/registros
    • RawDate (Texto): Contém a data bruta formatada para cada registro definido
    • AvailableDate (Texto); contém a data no formato "MM/DD/AAAA" para cada registro definido. Isso é usado para facilitar a data legível na exibição do calendário
    • Tamanho da carga (Lista de seleção): As opções incluem S, M e L. Esta lista de seleção é exibida em cada registro (cada dia no calendário mensal).

      Os registros de calendário (dias) podem exibir qualquer número de campos associados ao conjunto. O administrador deve aplicar um limite prático ao número de campos definidos, com base nos tamanhos de tela dos usuários e na capacidade de resposta fornecida pela aplicação.

    O aprimoramento em Configurar/Reconfigurar inicializa o conjunto com o tamanho apropriado para os meses a serem exibidos e um elemento JSON que contém valores de campo para cada registro. A seguir está a saída do aprimoramento Ao configurar para o calendário bruto acima:

    {
    	"availableDates": {
    			"data": [
    			{
    				"availableDate": { "value": "6/1/2024" },
    				"rawDate": {
    				"value": "2024-06-01T00:00:00.000Z"
    				}
    			}, //skipped interior records for brevity
    			{
    				"availableDate": { "value": "6/30/2024" },
    				"rawDate": {
    				"value": "2024-06-30T00:00:00.000Z"
    				}
    			}
    		],
    		"userEdited": false
    	}
    }

    Observe que o campo loadSize foi deixado de fora do JSON definido porque o administrador não queria preencher previamente o campo.

    No layout do blueprint, o administrador define onde o conjunto será exibido e os subcampos que serão exibidos em cada registro/dia do calendário.

    Demonstração do calendário

    Em Definir propriedades > Configurações de seleção, o administrador define se o usuário deve ter permissão para selecionar um ou vários dias. O campo booliano para seleção (neste caso, selectedDate) armazena se um conjunto específico de registro/dia do calendário foi selecionado.

    Seleçãoconfigurações

    Definir propriedades > Configurações de pesquisa ajuda você a exibir o subconjunto de dias mais relevante para o usuário quando seu calendário permite que o usuário selecione mais de um mês. Para essa finalidade, o campo de origem é o dia (registro) que o administrador deseja incluir no conjunto de calendário mensal. O campo de destino é o campo associado ao conjunto que contém o intervalo completo de datas do calendário.

    Configurações de pesquisa

    A área Definir propriedades > Valor bruto contém a saída JSON pelas seleções na página acima. No entanto, como "calendário" não é selecionável como displayType no momento, o administrador deve editar o JSON para defini-lo explicitamente.

    Código de valor bruto