Personalizar a interface do usuário do Azure IoT Central

Artigo
10/22/2024

Este artigo descreve como, você pode personalizar a interface do usuário de seu aplicativo usando temas personalizados, alterando o texto e modificando os links de ajuda para apontar para seus recursos de ajuda personalizados.

A seguinte captura de tela mostra uma página usando o tema padrão:

A seguinte captura de tela mostra uma página usando uma captura de tela personalizada com os elementos de interface do usuário personalizados realçados:

Dica

Você também pode personalizar a imagem mostrada na barra de endereços do navegador e na lista de favoritos.

Criar tema

Para criar um tema personalizado, acesse a seção Aparência na página Personalização.

Nesta página, você pode personalizar os seguintes aspectos de seu aplicativo:

Logotipo do aplicativo

Uma imagem PNG de até 1 MB com uma tela de fundo transparente. Esse logotipo é exibido na barra de título do aplicativo do IoT Central.

Se a sua imagem de logotipo incluir o nome do seu aplicativo, você poderá ocultar o texto do nome do aplicativo. Para saber mais, confira Gerenciar seu aplicativo.

Ícone do navegador (favicon)

Uma imagem PNG de até 32 x 32 pixels com uma tela de fundo transparente. Um navegador da Web pode usar essa imagem na barra de endereços, no histórico, nos indicadores e na guia do navegador.

Cores do navegador

Você pode alterar a cor do cabeçalho da página e a cor usada para botões de acentuação e outros destaques. Use um valor de cor hexadecimal de seis caracteres no formato ##ff6347. Para obter mais informações sobre notação de cor de Valor HEXADECIMAL, confira cores HTML.

Observação

É possível reverter para as opções padrão na seção Aparência.

Alterações para operadores

Se um administrador criar um tema personalizado, os operadores e outros usuários do seu aplicativo não poderão mais escolher um tema em Aparência.

Substituir links de ajuda

Para fornecer informações de ajuda personalizadas para seus operadores e outros usuários, você pode modificar os links no menu Ajuda do aplicativo.

Para modificar os links de ajuda, acesse a seção Links da ajuda na página Personalização.

Você também pode adicionar entradas ao menu de ajuda e remover as entradas padrão:

Observação

É possível reverter para os links de ajuda padrão na página Personalizar.

Alterar texto do aplicativo

Para alterar os rótulos de texto no aplicativo, acesse a seção Texto na página Personalização.

Nessa página, você pode personalizar o texto do seu aplicativo para todos os idiomas com suporte. Depois de carregar o arquivo de texto padrão, o texto do aplicativo aparecerá automaticamente com o texto atualizado. Você pode fazer outras personalizações editando e substituindo o arquivo de personalização. Você pode repetir o processo para todos os idiomas que a interface do usuário do IoT Central oferece suporte.

O exemplo a seguir mostra como alterar a palavra Device para Asset ao exibir o aplicativo em inglês:

Selecione Adicionar texto do aplicativo e selecione o idioma inglês no menu suspenso.
Baixar o arquivo de texto padrão. O arquivo contém uma definição de JSON das cadeias de caracteres de texto que você pode alterar.

Para substituir a palavra device por asset, abra o arquivo em um editor de texto e edite as cadeias de caracteres de valor, conforme mostrado no exemplo a seguir:

{
  "Device": {
    "AllEntities": "All assets",
    "Approve": {
      "Confirmation": "Are you sure you want to approve this asset?",
      "Confirmation_plural": "Are you sure you want to approve these assets?"
    },
    "Block": {
      "Confirmation": "Are you sure you want to block this asset?",
      "Confirmation_plural": "Are you sure you want to block these assets?"
    },
    "ConnectionStatus": {
      "Connected": "Connected",
      "ConnectedAt": "Connected {{lastReportedTime}}",
      "Disconnected": "Disconnected",
      "DisconnectedAt": "Disconnected {{lastReportedTime}}"
    },
    "Create": {
      "Description": "Create a new asset with the given settings",
      "ID_HelpText": "Enter a unique identifier this asset will use to connect.",
      "Instructions": "To create a new asset, select an asset template, a name, and a unique ID. <1>Learn more <1></1></1>",
      "Name_HelpText": "Enter a user friendly name for this asset. If not specified, this will be the same as the asset ID.",
      "Simulated_Label": "Simulate this asset?",
      "Simulated_HelpText": "A simulated asset generates telemetry that enables you to test the behavior of your application before you connect a real asset.",
      "Title": "Create a new asset",
      "Unassigned_HelpText": "Choosing this will not assign the new asset to any asset template.",
      "HardwareId_Label": "Hardware type",
      "HardwareId_HelpText": "Optionally specify the manufacturer of the asset",
      "MiddlewareId_Label": "Connectivity solution",
      "MiddlewareId_HelpText": "Optionally choose what type of connectivity solution is installed on the asset"
    },
    "Delete": {
      "Confirmation": "Are you sure you want to delete this asset?",
      "Confirmation_plural": "Are you sure you want to delete these assets?",
      "Title": "Delete asset permanently?",
      "Title_plural": "Delete assets permanently?"
    },
    "Entity": "Asset",
    "Entity_plural": "Assets",
    "Import": {
      "Title": "Import assets from a file",
      "HelpText": "Choose the organization that can access the assets you’re importing, and then choose the file you’ll use to import. <1>Learn more <1></1></1>",
      "Action": "Import assets with an org assignment from a chosen file.",
      "Upload_Action": "Upload a .csv file",
      "Browse_HelpText": "You’ll use a CSV file to import assets. Click “Learn more” for samples and formatting guidelines."
    },
    "JoinToGateway": "Attach to gateway",
    "List": {
      "Description": "Grid displaying list of assets",
      "Empty": {
      "Text": "Assets will send data to IoT Central for you to monitor, store, and analyze. <1>Learn more <1></1></1>",
      "Title": "Create an Asset"
      }
    },
    "Migrate": {
      "Confirmation": "Migrating selected asset to another template. Select migration target.",
      "Confirmation_plural": "Migrating selected assets to another template. Select migration target."
    },
    "Properties": {
      "Definition": "Asset template",
      "DefinitionId": "Asset template ID",
      "Id": "Asset ID",
      "Name": "Asset name",
      "Scope": "Organization",
      "Simulated": "Simulated",
      "Status": "Asset status"
    },
    "Rename": "Rename asset",
    "Status": {
      "Blocked": "Blocked",
      "Provisioned": "Provisioned",
      "Registered": "Registered",
      "Unassociated": "Unassociated",
      "WaitingForApproval": "Waiting for approval"
    },
    "SystemAreas": {
      "Downstreamassets": "Downstream assets",
      "Module_plural": "Modules",
      "Properties": "Properties",
      "RawData": "Raw data"
    },
    "TemplateList": {
      "Empty": "No definitions found.",
      "FilterInstructions": "Filter templates"
    },
    "Unassigned": "Unassigned",
    "Unblock": {
      "Confirmation": "Are you sure you want to unblock this asset?",
      "Confirmation_plural": "Are you sure you want to unblock these assets?"
    }
  }
}

Carregue o arquivo de personalização editado e selecione salvar para exibir o novo texto no aplicativo:

Agora, a interface do usuário usa os novos valores de texto:

Você pode recarregar o arquivo de personalização com alterações adicionais selecionando o idioma relevante na lista na seção Texto na página Personalização.

Próximas etapas

Agora que você viu como personalizar a interface do usuário em seu aplicativo IoT Central, confira algumas sugestões para as próximas etapas:

Compartilhar via