Mavim-iMprove

Este conector está disponible en los siguientes productos y regiones:

Service	Class	Regions
Copilot Studio	Premium	Todas las regiones de Power Automate excepto las siguientes:      - Gobierno de EE. UU. (GCC)      - Gobierno de EE. UU. (GCC High)      - China Cloud operado por 21Vianet      - Departamento de Defensa de EE. UU. (DoD)
Aplicaciones lógicas	Estándar	Todas las regiones de Logic Apps excepto las siguientes:      - Regiones de Azure Government      - Regiones de Azure China      - Departamento de Defensa de EE. UU. (DoD)
Power Apps	Premium	Todas las regiones de Power Apps excepto las siguientes:      - Gobierno de EE. UU. (GCC)      - Gobierno de EE. UU. (GCC High)      - China Cloud operado por 21Vianet      - Departamento de Defensa de EE. UU. (DoD)
Power Automate	Premium	Todas las regiones de Power Automate excepto las siguientes:      - Gobierno de EE. UU. (GCC)      - Gobierno de EE. UU. (GCC High)      - China Cloud operado por 21Vianet      - Departamento de Defensa de EE. UU. (DoD)

Contacto
Nombre	Servicedesk de Mavim
URL	https://my.mavim.com
Correo Electrónico	servicedesk@mavim.com

Metadatos del conector
Publicador	Mavim
Sitio web	https://www.mavim.com/
Directiva de privacidad	https://trustcenter.mavim.com/
Categorías	Gestión empresarial; Colaboración

Con el conector de Mavim iMprove Power Platform puede crear; Recuperar; Actualizar y eliminar tema. Actualizar campos y Crear; Recuperar; Actualizar y eliminar relaciones.

Los temas de Mavim se almacenan de forma jerárquica. Donde la "base de datos Mavim" se denomina tema raíz. Debajo del tema raíz existen tres niños, donde el gabinete amarillo es el área de trabajo; El gabinete verde contiene las versiones creadas (solo lectura) (como elementos secundarios) y el gabinete púrpura contiene las versiones importadas (solo lectura) (como elementos secundarios).

Sólo en el gabinete amarillo puede cambiar los temas; campos y relaciones. Todos los temas; las relaciones y los campos tienen el identificador único denominado código DCV. Solo el tema raíz tiene un indentifier estático (d0c2v0). Todos los demás elementos que obtienen un número generado proporcionado por la base de datos de Mavim.

Tenga en cuenta que para algunos temas (como "Papelera de reciclaje" y "Categorías de relación") se aplican reglas de negocio.

Para ver los datos de una manera más visual, puede iniciar sesión en la aplicación web Mavim iMprove con sus credenciales también usadas para Microsoft Power Platform y la siguiente dirección URL: https://improve.mavimcloud.com/

Prerrequisitos

Para poder usar el conector de Mavim Power Platform, debe tener una base de datos de Mavim Cloud y un inicio de sesión de Id. de Microsoft Entra desde su propio inquilino.

• Necesita el identificador de base de datos de Mavim Cloud (dbid);
• La cuenta de usuario debe tener una dirección de correo electrónico válida vinculada a su cuenta.

Obtención de credenciales

Durante el proceso de incorporación, solicitamos un nombre de inicio de sesión de Id. de Microsoft Entra. Se registrará como usuario administrador de la base de datos en la nube de Mavim. Cuando la base de datos en la nube esté lista, Mavim proporcionará el identificador de base de datos también denominado dbid.

Introducción al conector

La acción GetRootTopic es obtener el punto inicial del árbol jerárquico. Esto devolverá el tema raíz y todas sus propiedades. Las acciones simular son GetTopic para obtener un tema específico; GetTopicChildren para obtener todos los temas de los niños; GetSiblings para obtener todos los elementos del mismo nivel de un tema.

Todas las llamadas a las acciones requieren el dbid para conectarse a su propia base de datos de Mavim y un código langage. Los idiomas de datos admitidos para la API son inglés (en) y neerlandés (nl). Los temas de la base de datos Mavim tienen un código DCV único, este es el indentifier de un tema específico también denominado topicid.

MavimiMprove.GetTopicRoot(dbid,datalanguage);

Obtenga el tema raíz.

Respuesta (ejemplo)

{
    "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)

Obtenga un tema específico por el indentifier de DCV.

Respuesta (ejemplo)

    "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)

Obtener los temas secundarios del tema

Respuesta (ejemplo)

[
    {
        "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"
    }
]

Otras acciones admitidas son

Tema

• CreateTopicAfter
• CreateChildTopic
• UpdateTopic
• DeleteTopic

Estructura de temas

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

Fields

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

Relations

• GetTopicRelations
• SaveRelation
• DeleteRelation
• GetRelationCategories

Other

• GetTopicCharts
• GetTopicTypes
• GetTopicIcons
• Versión

Problemas y limitaciones conocidos

• La actualización de una descripción de tema solo se puede realizar mediante nuestra API WOPI (Office para la web). En el portal de My Mavim puede encontrar más información en la API para desarrolladores de Mavim.
• La API de Mavim iMprove admite los idiomas de datos inglés y neerlandés.
• En este momento solo se permite que un inquilino acceda a la base de datos en la nube de Mavim. Los usuarios invitados no se admiten a partir de ahora.

Errores y soluciones comunes

401 No estorado

• Compruebe si los usuarios tienen acceso a la base de datos en la nube de Mavim. Vaya a la administración de usuarios de Mavim iMprove para asegurarse de que los usuarios correctos tienen acceso.
• Compruebe si la cuenta de usuario tiene una dirección de correo electrónico válida.

404 No encontrado

• Compruebe si el tema existe en la base de datos en la nube de Mavim. Puede usar Mavim iMprove o el Administrador de Mavim para valdidate si todavía existe.

Preguntas más frecuentes

¿Dónde puedo agregar usuarios adicionales? Agregue usuarios adicionales mediante la sección administración de usuarios en la aplicación IMprove de Mavim. Aquí puede agregar todos los usuarios que necesitan acceso. Proporcionar acceso a Mavim iMprove significa que el usuario puede usar Mavim iMprove y el acceso a la API.

Cuentas de Serivce/API El acceso a la base de datos de Mavim solo se permite mediante la conexión con un usuario con nombre. Mavim no proporciona un método de autenticación clientid y secreto para conectarse a la API.

Creación de una conexión

El conector admite los siguientes tipos de autenticación:

Predeterminado	Parámetros para crear una conexión.	Todas las regiones	No se puede compartir

Predeterminado

Aplicable: Todas las regiones

Parámetros para crear una conexión.

Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.

Limitaciones

Nombre	Llamadas	Período de renovación
Llamadas API por conexión	100	60 segundos

Acciones

Actualiza el nombre del tema.	Actualiza el nombre de un tema específico.
Actualiza los campos del tema	Actualiza varios tipos de campos para un tema específico.
Actualiza un campo de hipervínculo de varios valores	Actualiza un campo de hipervínculo de varios valores para un tema específico.
Actualiza un campo de hipervínculo singlevalue	Actualiza un campo de hipervínculo de valor único para un tema específico.
Actualización del campo booleano desde el tema	Actualiza un campo booleano específico por campo y identificador de conjunto de campos para un tema específico.
Actualización del campo de texto de varios valores del tema	Actualiza un campo de texto multivalor específico por campo y identificador de conjunto de campos para un tema específico.
Actualización del campo decimal de varios valores del tema	Actualiza un campo decimal de varios valores específico por campo y identificador de conjunto de campos para un tema específico.
Actualización del campo decimal desde el tema	Actualiza un campo decimal de valor único específico por campo y identificador de conjunto de campos para un tema específico.
Actualizar campo de fecha del tema	Actualiza un campo de fecha de valor único específico por campo y identificador de conjunto de campos para un tema específico.
Actualizar campo de relación desde el tema	Actualiza un campo de relación de valor único específico por campo y identificador de conjunto de campos para un tema específico.
Actualizar el campo de fecha de varios valores del tema	Actualiza un campo de fecha multivalor específico por campo y identificador de conjunto de campos para un tema específico.
Actualizar el campo de lista del tema	Actualiza un campo de lista específico por campo y identificador de conjunto de campos para un tema específico.
Actualizar el campo de número de varios valores desde el tema	Actualiza un campo booleano específico por campo y identificador de conjunto de campos para un tema específico.
Actualizar el campo de relación de varios valores del tema	Actualiza un campo de relación multivalor específico por campo y identificador de conjunto de campos para un tema específico.
Actualizar el campo de texto del tema	Actualiza un campo de texto de valor único específico por campo y identificador de conjunto de campos para un tema específico.
Actualizar el campo número del tema	Actualiza un campo de número de valor único específico por campo y identificador de conjunto de campos para un tema específico.
Actualizar el campo relationshiplist del tema	Actualiza un campo de lista de relaciones de valor único específico por campo y identificador de conjunto de campos para un tema específico.
Creación de un tema	Se crea un nuevo tema como elemento relacionado después del tema al que se hace referencia.
Creación de un tema secundario	Se crea un nuevo tema como elemento secundario del tema al que se hace referencia.
Crear relación	Crea una relación entre dos temas.
Eliminación de un tema	Se elimina el tema específico solicitado por el identificador del tema.
Eliminar relación del tema	Elimina la relación por identificador de tema y relationId.
Mover un tema a la parte inferior de la rama	Mueva un tema específico a la parte inferior de la rama.
Mover un tema a la parte superior de la rama	Mueva un tema específico a la parte superior de la rama.
Mover un tema hacia abajo en la rama	Mueva un tema específico un lugar hacia abajo en la rama.
Mover un tema hacia abajo en la rama	Mueva un tema específico un lugar hacia abajo en la rama.
Mover un tema hacia arriba en la rama	Mueva un tema específico un lugar hacia arriba en la rama.
Mover un tema hacia arriba en la rama	Mueva un tema específico un lugar hacia arriba en la rama.
Obtención de la ruta de acceso del identificador de tema proporcionado a la raíz	Obtenga todos los temas de la ruta de acceso al tema raíz.
Obtención de la versión de API	Recupere el número de versión de la API.
Obtención de los campos del tema	A partir de un tema específico solicitado con el identificador de tema, se devuelve una colección de campos.
Obtención del tema raíz	Obtenga el tema raíz.
Obtener campo del tema	Obtenga un campo específico por campo y identificador de conjunto de campos para un tema específico.
Obtener iconos disponibles para un tipo de tema	Obtiene una colección de iconos para un tipo de tema específico.
Obtener las relaciones del tema	Obtenga las relaciones del tema proporcionados por el identificador de DCV del tema.
Obtener los elementos secundarios de un tema	Obtener los temas secundarios del tema
Obtener los gráficos del tema	A partir de un tema específico solicitado con el identificador de tema, se devuelve una colección de gráficos.
Obtener los temas del mismo nivel del tema	Obtenga los temas del mismo nivel del tema proporcionado por el identificador del tema.
Obtener tema	Obtenga un tema específico por el indentifier de DCV.
Obtener tipos para un tema	Obtenga una colección de tipos para un tema específico proporcionado por el identificador de tema.
Obtener una colección de temas	Obtener las categorías de relación del tema

Actualiza el nombre del tema.

Actualiza los campos del tema

Actualiza un campo de hipervínculo de varios valores

Actualiza un campo de hipervínculo singlevalue

Actualización del campo booleano desde el tema

Actualización del campo de texto de varios valores del tema

Actualización del campo decimal de varios valores del tema

Actualización del campo decimal desde el tema

Actualizar campo de fecha del tema

Actualizar campo de relación desde el tema

Actualizar el campo de fecha de varios valores del tema

Actualizar el campo de lista del tema

Actualizar el campo de número de varios valores desde el tema

Actualizar el campo de relación de varios valores del tema

Actualizar el campo de texto del tema

Actualizar el campo número del tema

Actualizar el campo relationshiplist del tema

Creación de un tema

Creación de un tema secundario

Crear relación

Eliminación de un tema

Eliminar relación del tema

Mover un tema a la parte inferior de la rama

Mover un tema a la parte superior de la rama

Mover un tema hacia abajo en la rama

Mover un tema hacia abajo en la rama

Mover un tema hacia arriba en la rama

Mover un tema hacia arriba en la rama

Obtención de la ruta de acceso del identificador de tema proporcionado a la raíz

Obtención de la versión de API

Obtención de los campos del tema

Obtención del tema raíz

Obtener campo del tema

Obtener iconos disponibles para un tipo de tema

Obtener las relaciones del tema

Obtener los elementos secundarios de un tema

Obtener los gráficos del tema

Obtener los temas del mismo nivel del tema

Obtener tema

Obtener tipos para un tema

Obtener una colección de temas

Definiciones

CategoryType

FieldType

IChart

IField

IPathItem

IRelationship

IRelationshipElement

ISimpleDispatchInstruction

ITopic

ITopicBusiness

ITopicPath

RelationshipType

TopicResource

TopicType

cuerda / cadena

objeto