Mavim-iMprove

Este conector está disponível nos seguintes produtos e regiões:

Serviço	Class	Regiões
Estúdio Copiloto	Premium	Todas as regiões do Power Automatic , exceto as seguintes:      - Governo dos EUA (CCG)      - Governo dos EUA (GCC High)      - China Cloud operado pela 21Vianet      - Departamento de Defesa dos EUA (DoD)
Aplicações Lógicas	Standard	Todas as regiões do Logic Apps , exceto as seguintes:      - Regiões do Azure Government      - Regiões do Azure China      - Departamento de Defesa dos EUA (DoD)
Aplicações Power	Premium	Todas as regiões do Power Apps , exceto as seguintes:      - Governo dos EUA (CCG)      - Governo dos EUA (GCC High)      - China Cloud operado pela 21Vianet      - Departamento de Defesa dos EUA (DoD)
Automatize o poder	Premium	Todas as regiões do Power Automatic , exceto as seguintes:      - Governo dos EUA (CCG)      - Governo dos EUA (GCC High)      - China Cloud operado pela 21Vianet      - Departamento de Defesa dos EUA (DoD)

Contato
Nome	Central de serviços Mavim
URL	https://my.mavim.com
Email	servicedesk@mavim.com

Metadados do conector
Editora	Mavim
Sítio Web	https://www.mavim.com/
Política de privacidade	https://trustcenter.mavim.com/
Categorias	Gestão Empresarial; Colaboração

Usando o conector Mavim iMprove Power Platform você é capaz de criar; Recuperar; Tópico Atualizar e excluir. Atualização de campos e Criar; Recuperar; Atualizar e excluir relações.

Os tópicos do Mavim são armazenados de forma hierárquica. Onde o "banco de dados Mavim" é chamado de tópico raiz. Abaixo do tópico raiz existem três crianças, onde o armário amarelo é a área de trabalho; O gabinete verde contém as versões criadas (somente leitura) (como crianças) e o gabinete roxo contém as versões importadas (somente leitura) (como crianças).

Apenas no gabinete amarelo você pode mudar os tópicos; campos e relações. Todos os temas; relações e campos têm o identificador único chamado código DCV. Apenas o tópico raiz tem um indentificador estático (d0c2v0). Todos os outros itens recebendo um número gerado fornecido pelo banco de dados Mavim.

Observe que para alguns tópicos (como "Lixeira" e "Categorias de relacionamento") aplicam-se regras de negócio.

Para ver os dados de uma forma mais visual, você pode fazer login no aplicativo Web Mavim iMprove usando suas credenciais também usadas para a Microsoft Power Platform e a seguinte URL: https://improve.mavimcloud.com/

Pré-requisitos

Para poder usar o conector Mavim Power Platform, você precisa ter um banco de dados Mavim Cloud e um login Microsoft Entra ID do seu próprio locatário.

• Você precisa do identificador de banco de dados Mavim Cloud (dbid);
• A conta de utilizador deve ter um endereço de correio eletrónico válido associado à sua conta.

Como obter credenciais

Durante o processo de integração, pedimos um nome de login do Microsoft Entra ID. Este será registrado como o usuário administrador do banco de dados em nuvem Mavim. Quando o banco de dados Cloud estiver pronto, o Mavim fornecerá o identificador de banco de dados também chamado dbid.

Introdução ao conector

A ação GetRootTopic é obter o ponto de partida da sua árvore hierárquica. Isso retornará o tópico raiz e todas as suas propriedades. As ações simulares são GetTopic para obter um tópico específico; GetTopicChildren para obter todos os tópicos infantis; GetBrothers para obter todos os irmãos de um tópico.

Todas as chamadas para as ações exigem que o dbid se conecte ao seu próprio banco de dados Mavim e um código de linguagem. Os idiomas de dados suportados para a API são inglês (en) e holandês (nl). Os tópicos no banco de dados Mavim têm um código DCV exclusivo, este é o identificador de um tópico específico também chamado topicid.

MavimiMprove.GetTopicRoot(dbid, datalanguage);

Obtenha o tópico raiz.

Resposta (exemplo)

{
    "business": {
        "canCreateChildTopic": false,
        "canCreateTopicAfter": false,
        "canDelete": false,
        "isReadOnly": true
    },
    "dcv": "d0c2v0",
    "hasChildren": true,
    "icon": "TreeIconID_DbGreen",
    "isInRecycleBin": false,
    "name": "Mavim Database",
    "orderNumber": -1,
    "typeCategory": "mavimElementContainer"
}

MavimiMprove.GetTopic(dbid,datalanguage,topicId)

Obtenha um tópico específico pelo identificador DCV.

Resposta (exemplo)

    "business": {
        "canCreateChildTopic": true,
        "canCreateTopicAfter": true,
        "canDelete": true,
        "isReadOnly": false
    },
    "dcv": "d16730231c28607v0",
    "hasChildren": true,
    "icon": "TreeIconID_YellowOpen",
    "isInRecycleBin": false,
    "name": "PowerApps topic",
    "orderNumber": 20,
    "parent": "d16730231c24017v0",
    "resources": [
        {
            "Value": "subTopics"
        },
        {
            "Value": "fields"
        }
    ],
    "typeCategory": "mavimElementContainer"
}

MavimiMprove.GetTopicChildren(dbid, datalanguage, topicId)

Obter os tópicos infantis do tópico

Resposta (exemplo)

[
    {
        "business": {
            "canCreateChildTopic": true,
            "canCreateTopicAfter": true,
            "canDelete": true,
            "isReadOnly": false
        },
        "dcv": "d16730231c28632v0",
        "hasChildren": false,
        "icon": "TreeIconID_YellowOpen",
        "isInRecycleBin": false,
        "name": "Subtopic 1",
        "orderNumber": 1,
        "parent": "d16730231c28607v0",
        "typeCategory": "unknown"
    },
   {
        "business": {
            "canCreateChildTopic": true,
            "canCreateTopicAfter": true,
            "canDelete": true,
            "isReadOnly": false
        },
        "dcv": "d16730231c28633v0",
        "hasChildren": false,
        "icon": "TreeIconID_YellowOpen",
        "isInRecycleBin": false,
        "name": "Subtopic 2",
        "orderNumber": 2,
        "parent": "d16730231c28607v0",
        "typeCategory": "unknown"
    }
]

Outras ações apoiadas são:

Tópico

• CreateTopicAfter
• CreateChildTopic
• UpdateTopic
• DeleteTopic

Estrutura do tópico

• MoveTopicToTop
• MoveTopicToBottom
• MoveTopicUp
• MoveTopicDown
• MoveTopicLevelUp
• MoveTopicLevelDown
• GetPathToRoot

Campos

• GetTopicFields
• GetFieldByDcvAndFieldsetId
• UpdateFields
• UpdateBooleanSingleField
• UpdateTextSingleField
• UpdateTextMultiField
• UpdateNumberSingleField
• UpdateNumberMultiField
• UpdateDecimalSingleField
• UpdateDecimalMultiField
• UpdateDateSingleField
• UpdateDateMultiField
• UpdateListSingleField
• UpdateRelationshipSingleField
• UpdateRelationshipMultiField
• UpdateRelationshipListField
• UpdateSingleHyperlinkField
• UpdateMultiHyperlinkField

Relações

• GetTopicRelations
• SalvarRelação
• DeleteRelation
• GetRelationCategories

Other

• GetTopicCharts
• GetTopicTypes
• GetTopicIcons
• Versão

Problemas conhecidos e limitações

• A atualização da descrição de um tópico só pode ser feita pela nossa API WOPI (Office for the Web). No Portal My Mavim você pode encontrar mais informações sob a API do desenvolvedor Mavim.
• A API do Mavim iMprove suporta os idiomas de dados inglês e holandês.
• No momento, permitimos que apenas um locatário acesse o banco de dados em nuvem Mavim. Os usuários convidados não são suportados a partir de agora.

Erros e soluções comuns

401 Não athorized

• Verifique se os usuários têm acesso ao banco de dados em nuvem Mavim. Vá para o gerenciamento de usuários do Mavim iMprove para garantir que os usuários corretos tenham acesso.
• Verifique se a conta de usuário tem um endereço de e-mail válido.

404 Não Encontrado

• Verifique se o tópico existe no banco de dados em nuvem Mavim. Você pode usar o Mavim iMprove ou o Mavim Manager para valdidate, se ele ainda existir.

FAQ

Onde posso adicionar mais utilizadores? Adicione outros usuários usando a seção de gerenciamento de usuários no aplicativo Mavim iMprove. Aqui você pode adicionar todos os usuários que precisam de acesso. Fornecer acesso ao Mavim iMprove significa que o usuário tem permissão para usar o Mavim iMprove e o acesso à API.

Contas Serivce/API O acesso ao banco de dados Mavim só é permitido conectando-se com um usuário nomeado. O Mavim não fornece um método de autenticação secreta e clientid para se conectar à API.

A criar uma ligação

O conector suporta os seguintes tipos de autenticação:

Predefinição	Parâmetros para criar conexão.	Todas as regiões	Não compartilhável

Padrão

Aplicável: Todas as regiões

Parâmetros para criar conexão.

Esta conexão não é compartilhável. Se o aplicativo avançado for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Limites de Limitação

Name	Chamadas	Período de Renovação
Chamadas de API por conexão	100	60 segundos

Ações

Atualiza o nome do tópico	Atualiza o nome de um tópico específico.
Atualiza os campos do tópico	Atualiza vários tipos de campos para um tópico específico.
Atualiza um campo de hiperlink de valor único	Atualiza um campo de hiperlink de valor único para um tópico específico.
Atualiza um campo de hiperlink de vários valores	Atualiza um campo de hiperlink de vários valores para um tópico específico.
Atualizar campo booleano do tópico	Atualiza um campo booleano específico por campo e identificador de conjunto de campos para um tópico específico.
Atualizar campo da lista do tópico	Atualiza uma lista específica campo por campo e identificador de conjunto de campos para um tópico específico.
Atualizar campo de data de vários valores do tópico	Atualiza um identificador específico de data de vários valores por campo e conjunto de campos para um tópico específico.
Atualizar campo de lista de relacionamentos do tópico	Atualiza uma relação de valor único específica campo por campo e identificador de conjunto de campos para um tópico específico.
Atualizar campo de número de vários valores do tópico	Atualiza um campo booleano específico por campo e identificador de conjunto de campos para um tópico específico.
Atualizar campo de relacionamento do tópico	Atualiza uma relação de valor único específica campo por campo e identificador de conjunto de campos para um tópico específico.
Atualizar campo de relação de vários valores do tópico	Atualiza uma relação de vários valores específica campo por campo e identificador de conjunto de campos para um tópico específico.
Atualizar campo de texto de vários valores do tópico	Atualiza um campo de texto específico de vários valores por campo e identificador de conjunto de campos para um tópico específico.
Atualizar campo de texto do tópico	Atualiza um valor único específico campo de texto por campo e identificador de conjunto de campos para um tópico específico.
Atualizar campo decimal de vários valores do tópico	Atualiza um campo decimal de vários valores específico por campo e identificador de conjunto de campos para um tópico específico.
Atualizar campo decimal do tópico	Atualiza um valor único específico campo decimal por campo e identificador de conjunto de campos para um tópico específico.
Campo de data de atualização do tópico	Atualiza um único campo de data-valor específico por campo e identificador de conjunto de campos para um tópico específico.
Campo de número de atualização do tópico	Atualiza um número de valor único específico campo por campo e identificador de conjunto de campos para um tópico específico.
Criar novo tópico filho	Um novo tópico é criado como filho do tópico referenciado.
Criar relação	Cria uma relação entre dois tópicos.
Criar um novo tópico	Um novo tópico é criado como um irmão após o tópico referenciado.
Excluir relação do tópico	Exclui a relação por topic id e relationId.
Excluir um tópico	O tópico específico solicitado pelo id do tópico é excluído.
Mover um tópico para a parte inferior da ramificação	Mover um tópico específico para a parte inferior da ramificação.
Mover um tópico para a parte superior da ramificação	Mover um tópico específico para a parte superior da ramificação.
Mover um tópico para baixo na ramificação	Mova um tópico específico um lugar para baixo na ramificação.
Mover um tópico para baixo na ramificação	Mova um tópico específico um lugar para baixo na ramificação.
Mover um tópico para cima na ramificação	Mova um tópico específico um lugar para cima na ramificação.
Mover um tópico para cima na ramificação	Mova um tópico específico um lugar para cima na ramificação.
Obtenha uma coleção de tópicos	Obter as categorias de relacionamento do tópico
Obter a versão da API	Recupere o número da versão da API.
Obter as crianças af um tópico	Obter os tópicos infantis do tópico
Obter as relações do tópico	Obtenha as Relações do tópico fornecido pelo tópico DCV ID.
Obter campo do tópico	Obtenha um identificador específico campo por campo e conjunto de campos para um tópico específico.
Obter o caminho da ID do tópico fornecido para a raiz	Obtenha todos os tópicos no caminho para o tópico raiz.
Obter o tópico raiz	Obtenha o tópico raiz.
Obter os campos do tópico	A partir de um tópico específico solicitado com a ID do tópico, uma coleção de campos é retornada.
Obter os gráficos do tópico	A partir de um tópico específico solicitado com a ID do tópico, uma coleção de gráficos é retornada.
Obter os tópicos irmãos do tópico	Obtenha os tópicos irmãos do tópico fornecidos pelo ID do tópico.
Obter tipos para um tópico	Obtenha uma coleção de tipos para um tópico específico fornecido pela ID do tópico.
Obter tópico	Obtenha um tópico específico pelo identificador DCV.
Obter ícones disponíveis para um tipo de tópico	Obtenha uma coleção de ícones para um tipo de tópico específico.

Atualiza o nome do tópico

Atualiza os campos do tópico

Atualiza um campo de hiperlink de valor único

Atualiza um campo de hiperlink de vários valores

Atualizar campo booleano do tópico

Atualizar campo da lista do tópico

Atualizar campo de data de vários valores do tópico

Atualizar campo de lista de relacionamentos do tópico

Atualizar campo de número de vários valores do tópico

Atualizar campo de relacionamento do tópico

Atualizar campo de relação de vários valores do tópico

Atualizar campo de texto de vários valores do tópico

Atualizar campo de texto do tópico

Atualizar campo decimal de vários valores do tópico

Atualizar campo decimal do tópico

Campo de data de atualização do tópico

Campo de número de atualização do tópico

Criar novo tópico filho

Criar relação

Criar um novo tópico

Excluir relação do tópico

Excluir um tópico

Mover um tópico para a parte inferior da ramificação

Mover um tópico para a parte superior da ramificação

Mover um tópico para baixo na ramificação

Mover um tópico para baixo na ramificação

Mover um tópico para cima na ramificação

Mover um tópico para cima na ramificação

Obtenha uma coleção de tópicos

Obter a versão da API

Obter as crianças af um tópico

Obter as relações do tópico

Obter campo do tópico

Obter o caminho da ID do tópico fornecido para a raiz

Obter o tópico raiz

Obter os campos do tópico

Obter os gráficos do tópico

Obter os tópicos irmãos do tópico

Obter tipos para um tópico

Obter tópico

Obter ícones disponíveis para um tipo de tópico

Definições

Tipo de categoria

Tipo de campo

IChart

IField

IPathItem

IRelationship

IRelationshipElement

ISimpleDispatchInstruction

ITopic

ITopicBusiness

ITopicPath

Tipo de Relacionamento

TópicoRecurso

Tipo de tópico

cadeia (de caracteres)

objecto