Compartilhar via

Adicionar suporte para comandos de suplementos no Outlook em dispositivos móveis

  • Artigo

A utilização de comandos de suplementos no Outlook em dispositivos móveis permite que os seus utilizadores acedam à mesma funcionalidade (com algumas limitações) que já têm no Outlook na Web, no Windows (clássico e novo (pré-visualização)) e no Mac. A adição de suporte para o Outlook Mobile requer a atualização do manifesto do suplemento e, possivelmente, a alteração do código para cenários móveis.

Atualizar o manifesto

O primeiro passo para ativar comandos de suplementos no Outlook Mobile é defini-los no manifesto do suplemento.

  1. Na matriz "extensions.ribbons.requirements.formFactors", adicione "mobile" como um item. Quando tiver terminado, a matriz deverá ter o seguinte aspeto.

    "formFactors": [
    "mobile",
    <!-- Typically there will be other form factors listed. -->
]

  2. Se o seu suplemento utilizar o modo Participante do Compromisso, como um suplemento que integra um fornecedor de uma aplicação de criação de notas ou gestão de relações com o cliente (CRM), adicione "logEventMeetingDetailsAttendee" à matriz "extensions.ribbons.contexts". Apresentamos um exemplo a seguir.

    "contexts": [
    "meetingDetailsAttendee",
    "logEventMeetingDetailsAttendee"
],

  3. Se o seu suplemento utilizar um fornecedor integrado de reuniões online, adicione "onlineMeetingDetailsOrganizer" à matriz "extensions.ribbons.contexts". Apresentamos um exemplo a seguir.

    "contexts": [
    "meetingDetailsOrganizer",
    "onlineMeetingDetailsOrganizer"
],

  4. Na matriz "extensions.ribbons.tabs", localize o separador com "builtInTabId" de "TabDefault". Adicione uma matriz "customMobileRibbonGroups" subordinada à mesma (como elemento da propriedade "grupos" existente). Dentro desta matriz, crie um objeto e faça o seguinte:

    • Defina os valores "id" e "label" adequados.
    • Crie um objeto na matriz "controlos" para representar um botão e configure-o da seguinte forma.
      • Defina os valores "id" e "label" adequados. Para garantir que o botão encaixa corretamente no friso, recomendamos que limite a "etiqueta" a 16 carateres.
      • Defina "buttonType" como "MobileButton".
      • Atribua uma função à propriedade "actionId". Isto deve corresponder ao "ID" do objeto na matriz "extensions.runtimes.actions".
      • Certifique-se de que tem os nove ícones necessários.

    Apresentamos um exemplo a seguir.

    "tabs": [
    {
        "builtInTabId": "TabDefault",
        "groups": [
            <-- non-mobile group objects omitted -->
        ],
        "customMobileRibbonGroups": [
            {
                "id": "mobileApptComposeGroup",
                "label": "Contoso Meeting",
                "controls": [
                    { 
                        "id": "mobileInsertMeetingButton",
                        "label": "Add meeting",
                        "buttonType": "MobileButton",
                        "actionId": "insertContosoMeeting",
                        "icons": [
                            {
                                "scale": 1,
                                "size": 25,
                                "url": "https://contoso.com/assets/icon-25.png"
                            },
                            {
                                "scale": 1,
                                "size": 32,
                                "url": "https://contoso.com/assets/icon-32.png"
                            },
                            {
                                "scale": 1,
                                "size": 48,
                                "url": "https://contoso.com/assets/icon-48.png"
                            },                                
                            {
                                "scale": 2,
                                "size": 25,
                                "url": "https://contoso.com/assets/icon-25.png"
                            },
                            {
                                "scale": 2,
                                "size": 32,
                                "url": "https://contoso.com/assets/icon-32.png"
                            },
                            {
                                "scale": 2,
                                "size": 48,
                                "url": "https://contoso.com/assets/icon-48.png"
                            },                                
                            {
                                "scale": 3,
                                "size": 25,
                                "url": "https://contoso.com/assets/icon-25.png"
                            },
                            {
                                "scale": 3,
                                "size": 32,
                                "url": "https://contoso.com/assets/icon-32.png"
                            },
                            {
                                "scale": 3,
                                "size": 48,
                                "url": "https://contoso.com/assets/icon-48.png"
                            }
                        ]
                    }
                ]
            }
        ]
    }
]

Considerações sobre código

Criar um suplemento para o Mobile traz algumas considerações adicionais.

Usar REST em vez de Serviços Web do Exchange

O método Office.context.mailbox.makeEwsRequestAsync não é suportado no Outlook mobile. Os suplementos devem preferir obter as informações da API Office.js sempre que possível. Se os suplementos exigem informações que não são expostas pela API Office.js devem usar as APIs REST do Outlook para acessar as caixas de correio do usuário.

O conjunto de requisitos da caixa de correio 1.5 introduziu uma nova versão do Office.context.mailbox.getCallbackTokenAsync que pode pedir um token de acesso compatível com as APIs REST e uma nova propriedade Office.context.mailbox.restUrl que pode ser utilizada para encontrar o ponto final da API REST para o utilizador.

Pinçar e zoom

Por predefinição, os utilizadores podem utilizar o gesto de "aproximar os dedos" para ampliar os painéis de tarefas. Se isto não fizer sentido para o seu cenário, certifique-se de que desativa o zoom de aproximar os dedos no HTML.

Fechar painéis de tarefas

No Outlook mobile, os painéis de tarefas ocupam todo o ecrã e, por predefinição, exigem que o utilizador os feche para regressar à mensagem. Considere utilizar o método Office.context.ui.closeContainer para fechar o painel de tarefas quando o seu cenário estiver concluído.

Modo de redação e compromissos

Atualmente, os suplementos no Outlook Mobile só suportam a ativação ao ler mensagens. Os suplementos não são ativados ao compor mensagens ou ao visualizar ou compor compromissos. No entanto, existem algumas exceções.

  1. Os suplementos integrados do fornecedor de reuniões online são ativados no modo Organizador de Compromissos. Para obter mais informações sobre esta exceção (incluindo as APIs disponíveis), consulte Criar um suplemento móvel do Outlook para um fornecedor de reuniões online.
  2. Os suplementos que registam notas de compromisso e outros detalhes para a gestão de relações com os clientes (CRM) ou os serviços de tomada de notas são ativados no modo Participante do Compromisso. Para obter mais informações sobre esta exceção (incluindo as APIs disponíveis), veja Registar notas de compromisso para uma aplicação externa em suplementos móveis do Outlook.
  3. Os suplementos baseados em eventos são ativados quando o OnNewMessageCompose evento ocorre. Para obter mais informações sobre esta exceção (incluindo APIs suportadas adicionais), veja Implementar ativação baseada em eventos em suplementos móveis do Outlook.

APIs suportadas

Apesar de o Outlook mobile suportar o requisito de Caixa de Correio definido como 1.5, agora pode implementar APIs adicionais a partir de conjuntos de requisitos posteriores para expandir ainda mais a capacidade do seu suplemento no Outlook Mobile. Para obter orientações sobre as APIs que pode implementar no seu suplemento móvel, consulte ApIs JavaScript do Outlook suportadas no Outlook em dispositivos móveis.

Confira também