Importação em massa de riscos

Importe riscos em massa se precisar evitar a demorada entrada manual de dados ou migrar dados de outro sistema.

Você também pode atualizar vários riscos ao mesmo tempo usando sessões no Importador em Massa. Para obter mais informações, consulte Carregar riscos existentes em massa.

Como funciona?

Abra uma nova sessão do Importador em massa e faça download do modelo em Excel na página do importador no Launchpad. Você deve preparar os dados no modelo e depois fazer upload do modelo na página do Importador em massa.

Onde estão os riscos carregados?

Após o carregamento dos riscos, os dados podem ser acessados no Plano de Projeto ou Matriz de Controle de Riscos do projeto ou estrutura.

Os riscos também estão disponíveis nos relatórios da Matriz de Controle de Riscos para download e no Relatório do Projeto (relatório final de auditoria) da NomeOrganização.

Antes de começar

Antes de começar a importar riscos, você precisa:

1. Criar um projeto com o Importador em massa, preenchendo a planilha Projetos ou com a interface do usuário; OU
   criar uma estrutura com o Importador em massa, preenchendo a planilha Estruturas ou com a interface do usuário.
2. Definir objetivos com o Importador em massa, preenchendo a planilha Objetivos ou com a interface do usuário.

Fluxo de trabalho

Permissões

Apenas os Administradores do Sistema podem usar o Importador em massa para carregamento em massa de recursos do Diligent One.

Carregar novos riscos em massa

Abrir uma nova sessão do Importador em massa e fazer download do modelo em Excel

1. Abra o Launchpad.

   Observação

   Se a sua empresa usa mais de uma instância no Launchpad, verifique se a instância apropriada está ativa.

2. Selecione Configurações da Plataforma > Organização.

   Se a opção Organização não for exibida, a conta usada para fazer login não tem privilégios de Administrador.

3. Em Importador em massa, clique em Gerenciar recursos em massa.

   Uma nova sessão do Importador em massa começa, com o ID da sessão anexado ao URL.

   Cuidado

   Sempre inicie uma nova sessão para adicionar recursos novos, ou você poderá perder os dados enviados anteriormente.

   Saiba mais

   Por exemplo: você quer importar 200 entidades em dois lotes (100 +100). Se você carregar os lotes um após o outro na mesma sessão, os dados carregados no primeiro lote serão substituídos pelos dados do segundo lote. Para evitar a perda de dados, sempre carregue o primeiro lote em uma sessão e inicie uma nova para o próximo lote. Da mesma forma, inicie uma nova sessão para adicionar mais recursos novos.

   Observação

   Você pode usar sessões anteriores para atualizar os dados já carregados. Para obter mais informações, consulte Funcionalidade de atualização no Importador em massa.

4. Em Selecionar recurso, escolha uma destas opções no tipo de recurso:

   • Projetos > Nomes de projetos Para criar riscos para um projeto em particular. O modelo é dinâmico e tem configurações integradas do projeto selecionado. Usando esse método, você pode criar vários recursos do Diligent One (objetivos, riscos, controles e mitigações) que pertencem a um projeto em particular.
   • Estruturas > Nomes de estruturas Para criar riscos para uma estrutura em particular. O modelo é dinâmico e tem configurações integradas da estrutura selecionada. Usando esse método, você pode criar vários recursos do Diligent One (objetivos, riscos, controles e mitigações) que pertencem a uma estrutura em particular.
   • Projetos > Tipos de projetos Para criar riscos para um projeto ou uma estrutura com base em um tipo de projeto. O modelo é dinâmico e tem configurações integradas do tipo de projeto selecionado. Usando esse método, você pode adicionar vários recursos do Diligent One (projetos, estruturas, objetivos, riscos, controles e mitigações) com base em um tipo de projeto. Você pode fazer o mesmo usando a opção Estruturas > Tipos de projeto.
   • Todos os recursos Para importar todos os recursos em massa de uma só vez: projetos, estruturas, objetivos, riscos, controles, mitigações, problemas, ações, solicitações, entidades e mapas de conformidade. O modelo é estático e exige algum esforço para ser concluído, já que você precisará descobrir a configuração dos recursos manualmente.
5. Clique em Baixar modelo .xlsx.

   O modelo em Excel é salvo na máquina local.

Preparar dados no modelo

1. Abra o modelo baixado e acesse a planilha Risks.
2. Copie e cole ou insira os dados no modelo. Para saber como inserir dados, consulte Dicas para preparar conteúdo.
   Observação

   • Se você usa o Add-in para Excel, certifique-se de que a opção ACL Add-In esteja desativada antes de modificar o modelo do Excel. Para saber como fazer isso, consulte Configuração do Add-in para Excel.
   • Não altere o nome da planilha ou dos campos. Eles diferenciam maiúsculas e minúsculas e não devem ser modificados.
   • O número máximo de linhas que podem ser carregadas de uma vez é 2.000 (incluindo todas as planilhas).

   Campo	Descrição
   referenceId obrigatório	Especifica um ID exclusivo para o recurso. Deve ser exclusivo para cada linha na planilha. Ele pode conter uma combinação de texto e números e o comprimento máximo é de 255 caracteres. Esse campo é a chave primária para cada linha no modelo. Você precisará dessa chave se quiser atualizar este recurso novamente. Importante Você pode usar IDs de referência para associar recursos uns aos outros, instantaneamente. Por exemplo, você pode criar um novo projeto e um novo objetivo associado a esse projeto no mesmo upload. Faça isso criando um link entre o projeto e o objetivo informando o referenceId Para saber mais sobre como associar recursos do Diligent One no Importador em massa, consulte Usar IDs de referência para vincular recursos no Importador em massa. Observação Os IDs de referência são necessários ao adicionar ou atualizar recursos usando o Importador em massa. Eles não estão disponíveis quando você adiciona/atualiza recursos na interface de usuário do Diligent One.
   objectiveId obrigatório	Especifica o ID do objetivo ao qual você deseja associar esse risco. É possível encontrar o ID do objetivo na URL quando você navega até um objetivo. Por exemplo: https://stark.projects.highbond.com/ audits/13659/objectives/6616, onde 6616 é o ID do objetivo. Observação Como alternativa, neste campo, você também pode informar o ID de referência de um novo controle que adicionou no modelo atual. Isso associará o risco ao objetivo quando você carregar o modelo. Para saber mais sobre como associar recursos do Diligent One no Importador em massa, consulte Usar IDs de referência para vincular recursos no Importador em massa. Para obter mais informações sobre objetivos, consulte Definindo objetivos .
   title	Especifica o título do risco. Para obter mais informações sobre riscos, Definindo riscos e controles.
   description obrigatório	Especifica uma descrição detalhada do risco. Dica Use tags HTML para formatar o texto. Por exemplo: <b>, <i>, <ol>, <ul>. Para obter mais informações sobre riscos, Definindo riscos e controles.
   riskId	Especifica o número de referência ou código do risco. Para obter mais informações sobre riscos, Definindo riscos e controles.
   impacto	Especifica as consequências da ocorrência do risco. As opções disponíveis dependem do tipo de projeto.
   probabilidade	Especifica a probabilidade da ocorrência do risco. As opções disponíveis dependem do tipo de projeto.
   position	Especifica o valor que determina a ordem na qual o risco é exibido. Dica Preencha os valores em ordem sequencial para que os recursos apareçam na mesma ordem após a importação.
   entidades	Especifica os IDs das entidades marcadas para o risco. É possível encontrar o ID da entidade na URL ao navegar para uma entidade. Por exemplo: https://stark.projects.highbond.com/ auditable_entities/33055, em que 33055 é o ID da entidade. Você pode fornecer vários IDs separados por vírgulas. Observação Como alternativa, neste campo, você também pode informar o ID de referência de uma nova entidade que adicionou no modelo atual. Isso associará o risco à entidade quando você carregar o modelo. Para saber mais sobre como associar recursos do Diligent One no Importador em massa, consulte Usar IDs de referência para vincular recursos no Importador em massa. Para obter mais informações sobre entidades, consulte Configurando a marcação de entidades.
   customAttributes_1_term - customAttributes_n_term	Especifica os campos de atributos personalizados de 1 até n. Os atributos personalizados no modelo em Excel dependem do tipo de modelo, conforme segue: Nomes dos projetos / Nomes das estruturas / Tipos de projeto: por padrão, o modelo incluirá os campos de atributo personalizado definidos no tipo de projeto. Todos os recursos: você precisa verificar e inserir manualmente os campos de atributos personalizados, tanto o termo como o valor. O modelo terá um par de termo e valor de atributo personalizado, sendo possível adicionar nove pares se necessário. Para isso, siga a mesma convenção de nomenclatura incluindo um contador, por exemplo: customAttributes_2_term, customAttributes_2_value, etc. Os atributos personalizados de um projeto, uma estrutura e seus componentes são definidos no tipo de projeto. Para mais informações sobre atributos personalizados, consulte Personalização de termos, campos e notificações.
   customAttributes_1_value - customAttributes_n_value	Especifica os valores de atributos personalizados de 1 até n. Os atributos personalizados no modelo em Excel dependem do tipo de modelo, conforme segue: Nomes dos projetos / Nomes das estruturas / Tipos de projeto: por padrão, o modelo incluirá os campos de atributo personalizado definidos no tipo de projeto. Todos os recursos: você precisa verificar e inserir manualmente os campos de atributos personalizados, tanto o termo como o valor. O modelo terá um par de termo e valor de atributo personalizado, sendo possível adicionar nove pares se necessário. Para isso, siga a mesma convenção de nomenclatura incluindo um contador, por exemplo: customAttributes_2_term, customAttributes_2_value, etc. Os atributos personalizados de um projeto, uma estrutura e seus componentes são definidos no tipo de projeto. Para mais informações sobre atributos personalizados, consulte Personalização de termos, campos e notificações. Observação Se um valor começar com um colchete ou tiver uma vírgula, um ponto e vírgula ou uma quebra de linha, coloque-o entre aspas (" "). Por exemplo: "[2021]", "Primeiro, segundo ativo", "Isto é importante; isto também". Para um campo de múltipla escolha, você pode adicionar diversos valores separando cada um com uma vírgula. Para um campo de lista suspensa ou múltipla escolha, os valores devem ser exatamente os mesmos fornecidos nas opções.
   customFactors_1_term - customFactors_n_term	Especifica os fatores de pontuação de risco de 1 até n. Os fatores personalizados de pontuação de risco no modelo em Excel dependem do tipo de modelo, conforme segue: Nomes dos projetos / Nomes das estruturas / Tipos de projeto: por padrão, o modelo incluirá os fatores personalizados definidos no tipo de projeto. Todos os recursos: você precisa verificar e inserir manualmente os campos de fatores personalizados, tanto o termo como o valor. O modelo terá um par de termo e valor de fator personalizado, e é possível adicionar manualmente mais quatro pares se necessário. Para isso, siga a mesma convenção de nomenclatura incluindo um contador, por exemplo: customFactors_2_term, customFactors_2_value, etc. Os atributos personalizados de um projeto, uma estrutura e seus componentes são definidos no tipo de projeto. Para mais informações sobre atributos personalizados, consulte Personalização de termos, campos e notificações.
   customFactors_1_value - customFactors_n_value	Especifica os fatores de risco personalizados de 1 até n. Os fatores personalizados de pontuação de risco no modelo em Excel dependem do tipo de modelo, conforme segue: Nomes dos projetos / Nomes das estruturas / Tipos de projeto: por padrão, o modelo incluirá os fatores personalizados definidos no tipo de projeto. Todos os recursos: você precisa verificar e inserir manualmente os campos de fatores personalizados, tanto o termo como o valor. O modelo terá um par de termo e valor de fator personalizado, e é possível adicionar manualmente mais quatro pares se necessário. Para isso, siga a mesma convenção de nomenclatura incluindo um contador, por exemplo: customFactors_2_term, customFactors_2_value, etc. Os atributos personalizados de um projeto, uma estrutura e seus componentes são definidos no tipo de projeto. Para mais informações sobre atributos personalizados, consulte Personalização de termos, campos e notificações. Observação Se um valor começar com um colchete ou tiver uma vírgula, um ponto e vírgula ou uma quebra de linha, coloque-o entre aspas (" "). Por exemplo: "[2021]", "Primeiro, segundo ativo", "Isto é importante; isto também". Para um campo de múltipla escolha, você pode adicionar diversos valores separando cada um com uma vírgula. Para um campo de lista suspensa ou múltipla escolha, os valores devem ser exatamente os mesmos fornecidos nas opções.

   Observação

   No modelo dinâmico, para um campo de lista suspensa, as opções na lista suspensa aparecem somente para a primeira linha. Para mostrar essas opções em mais linhas, copie a primeira linha e cole-a nas linhas necessárias.

3. Salvar e fechar o modelo

Dicas para preparar conteúdo

A preparação de conteúdo envolve:

• copiar e colar seus dados de origem no modelo do Excel
• inserir dados, quando aplicável, no modelo do Excel
• salvar o modelo como preparação para o carregamento em massa

Usando IDs de referência para vincular recursos no Importador em massa

ID de referência é um campo no modelo do Excel do Importador em massa. É o primeiro campo em todas as planilhas e está disponível para todos os recursos. É um identificador exclusivo para cada registro na planilha.

Usando IDs de referência, é possível associar recursos do Diligent One uns aos outros, durante o processo. Por exemplo, você pode criar um projeto e um objetivo associado a ele na mesma importação. Você pode fazer isso informando o referenceId no campo obrigatório.

Carregar dados

Execute uma das seguintes ações:

• Arraste e solte o modelo na janela do navegador.
• Clique em Selecionar do seu computador para selecionar o modelo de atualizado.

  Apenas um modelo em Excel pode ser carregado por vez (cada arquivo é validado separadamente).

Resultado Uma mensagem de sucesso ou falha aparece, dependendo do resultado do processo, e a última sessão é atualizada na tabela Sessões.

Sessões no Importador em massa

Uma sessão no Importador em massa é uma série de interações de usuário para importar recursos do Diligent One. Cada sessão do usuário é registrada na tabela Sessões.

A tabela Sessões contém as seguintes informações.

Nome do campo	Descrição
Sessões da web	Mostra a lista de sessões da web. Uma sessão da web se refere a uma sessão concluída usando a interface do usuário Importador em massa. Uma nova sessão começa sempre que você abre a página do Importador em massa.
Sessões da API	Mostra a lista de sessões da API. Uma sessão de API refere-se a uma sessão concluída usando uma plataforma de API, como Postman, etc.
Atualizar	Recarrega a tabela Sessões.
ID da Sessão	Identificador de sessão. Em Sessões da web, você pode clicar no ID da sessão para acessar uma sessão específica. O ID da sessão é anexado à URL. Por exemplo: https://stark.bulkimporter.highbond.com/import/bcc1e04e-4cd3-46d2-a8be-0b9083baccdc, onde bcc1e04e-4cd3-46d2-a8be-0b9083baccdc é o ID da sessão. Observação Os IDs de sessões na web e na API são parecidos. Para evitar erros, tome cuidado para não trocar os IDs.
Data	Mostra a data e a hora da sessão. Você pode ordenar a data em ordem crescente ou decrescente.
Carregado por	Mostra o nome do usuário.
Status	Mostra o status do carregamento, se foi concluído com sucesso ou não. Você pode clicar no status para exibir os detalhes completos da importação.
Nome do Arquivo	Mostra o nome do modelo/log de erros carregados. Por exemplo: HighBond_Template.xlsx, ErrorLog.xlsx. Modelo Você pode clicar e baixar o modelo para corrigir dados carregados anteriormente. Log de erros Um log de erros é gerado quando ocorre falha no upload. Você pode verificar o log de erros para corrigir os erros e carregar o modelo novamente. Observação O modelo e os logs de erros ficarão disponíveis para download por até 18 meses depois da data de upload. O link para baixar o modelo está disponível para sessões do Importador em massa a partir de 13 de maio de 2022. Não é possível baixar o modelo das sessões anteriores a essa data.

Carregar riscos existentes em massa

Você pode atualizar vários itens de uma vez no Importador em Massa usando sessões.

Solução de problemas

Você pode baixar e verificar o log de erros da tabela Sessões. Compreenda erros comuns de carregamento em massa e saiba como corrigir erros.

A tabela a seguir oferece uma lista de erros que podem ocorrer no upload do modelo.

Erro	Solução(ões)
Pode haver mais de 2.000 linhas no arquivo carregado (incluindo todas as planilhas).	Remova as linhas extras do modelo de e carregue novamente.
Os campos obrigatórios podem estar em branco ou ausentes no arquivo carregado.	Verifique se todos os campos obrigatórios (marcados com nomes de coluna vermelha e laranja no modelo) estão preenchidos. Observação Se você não preencher dados nos campos obrigatórios, a linha não será processada.
O formato dos dados pode estar incorreto.	Verifique se os dados nos campos de texto são validos e se não excedem o comprimento máximo do campo: 255 caracteres. Campos de rich texto não têm um limite de caracteres.
Os valores de dados podem ser inválidos ou não corresponder aos valores da lista suspensa.	Por exemplo: O valor para os campos received e sendRecurrentNotifications na planilha Requests deve ser True ou False.
Campos inválidos no modelo.	Não adicione novos campos ao modelo. Não remova campos do modelo.
O modelo pode não estar no formato esperado.	Certifique-se de que o formato do arquivo seja .xlsx.
Nomes de planilhas inválidos.	Não mude o nome da planilha.
A sessão pode ter expirado.	Atualize a página e tente carregar novamente.
O ID de sessão pode ser inválido.	Verifique se você está usando um ID de sessão da web.