Profisee (versão prévia)
O Conector Personalizado do Profisee Power Platform permite que um cliente do Profisee interface com o Microsoft Apps, Copilot Studio ou outro que possa utilizar um conector do Power Platform. É necessário ter acesso a uma instância do Profisee com uma licença de produto atual e uma assinatura ativa do Microsoft Azure. Esse conector personalizado oferece as seguintes operações de dados mestre do Profisee: criar entidade e atributo, criar/atualizar/excluir registros, obter metadados e atualizar um tema de cor.
Esse conector está disponível nos seguintes produtos e regiões:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicativos Lógicos | Standard | Todas as regiões dos Aplicativos Lógicos , exceto as seguintes: – Regiões do Azure Governamental - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Power Apps | Premium | Todas as regiões do Power Apps , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Power Automate | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Contato | |
|---|---|
| Nome | Suporte do Profisee |
| URL | https://profisee.com/support |
| support@profisee.com |
| Metadados do conector | |
|---|---|
| Publicador | Profisee |
| Website | https://profisee.com |
| Política de privacidade | https://profisee.com/privacy/ |
| Categorias | IA; Dados |
Gerenciamento de Dados Mestres do Profisee
Visão geral do conector
O Profisee é uma plataforma de MDM (Master Data Management) que ajuda as organizações a gerenciar seus dados com eficiência. Ele oferece recursos como integração, administração, governança, qualidade de dados e automação de fluxo de trabalho, garantindo consistência e confiabilidade de dados entre sistemas. O Profisee ajuda a proporcionar economia de custos quantificável e eficiência operacional, abordando os desafios de gerenciamento de dados. Ele foi projetado para aceitar dados mestres de qualquer fonte, permitindo correspondência, mesclagem e sincronização de dados.
Esse conector é baseado na API REST do Profisee e fornece a capacidade de executar as seguintes operações:
- Solicite detalhes para um ou mais registros da instância do Profisee, considerando o nome da entidade.
- Crie registros de dados mestres em uma entidade Profisee.
- Atualize os registros de dados mestres em uma entidade Profisee.
- Excluir registros em uma entidade Profisee.
- Crie uma entidade.
- Crie um atributo em uma entidade Profisee.
- Atualize o tema profisee (esquema de cores).
- Solicite problemas de qualidade de dados para uma entidade Profisee.
- Solicite metadados para entidades e atributos do Profisee.
Pré-requisitos
Você precisará do seguinte para continuar:
A Microsoft Azure subscription with permissions to create and/or configure an App Registration.A Profisee license with permissions to perform the actions mentioned above.Access to the Microsoft Power Platform with sufficient permissions to create a connection.
Instruções
Leia e siga estas instruções para registrar um aplicativo na ID do Microsoft Entra. Copie a ID do aplicativo (cliente) da seção 'Visão geral' e o Valor do Segredo do Cliente em 'Certificados &segredos', pois ambos serão usados ao criar a conexão inicial.
Aplicar o URI de Redirecionamento
Selecione Azure Active Directory (ID do Microsoft Entra) e selecione seu aplicativo. Selecione Autenticação no menu esquerdo e, em seguida, selecione Adicionar URI. Adicione o valor copiado do campo URI de Redirecionamento e selecione https://global.consent.azure-apim.net/redirect/profiseeSalvar. Consulte Definir a URL de resposta no Azure para obter mais detalhes caso você a desfazou.
Criar a conexão
Crie um aplicativo do Power Platform, como um fluxo de nuvem automatizado do Power Automate.
- Selecione uma ação profisee, como "Obter registros por nome de entidade".
- Inserir um nome de conexão definido pelo usuário
- Selecione 'Usar Oauth2' para Tipo de Autenticação
- Insira uma ID do cliente, a ID do aplicativo (cliente) da ID do Microsoft Entra(veja acima)
- Inserir um segredo do cliente (veja acima)
- Insira a Instância do Profise (por exemplo, acmecloud.com)
- Insira a URL base do Profisee com o número de versão (por exemplo, /profisee/rest/v1/)
Entre para criar uma conexão com o Profisee.
Suporte do Profisee
Envie perguntas ou solicite ajuda no Suporte do Profisee (requer uma assinatura ativa do Profisee com direitos habilitados).
Criando uma conexão
O conector dá suporte aos seguintes tipos de autenticação:
| Default | 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.
Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.
| Nome | Tipo | Description | Obrigatório |
|---|---|---|---|
| ID do cliente | cadeia | Insira a ID do aplicativo (cliente) do aplicativo no Microsoft Entra ID | Verdade |
| Segredo de Cliente | secureString | Insira o valor do segredo do cliente do aplicativo na ID do Microsoft Entra | Verdade |
| Instância do Profisee | cadeia | Insira o host da instância do Profisee (por exemplo, acmecloud.com) | Verdade |
| Profisee Base URL | cadeia | Insira a URL base do Profisee com o número de versão (por exemplo, /profisee/rest/v1/) | Verdade |
Limitações
| Nome | Chamadas | Período de renovação |
|---|---|---|
| Chamadas à API por conexão | 100 | 60 segundos |
Ações
| Atualizar registros por nome da entidade |
Essa solicitação atualiza um ou mais registros para uma entidade Profisee, considerando o nome da entidade. |
| Atualizar um tema existente |
Essa solicitação atualiza um tema existente com o nome do tema fornecido. |
| Criar registros por nome de entidade |
Essa solicitação cria um ou mais registros para uma entidade Profisee, considerando os valores de nome e código da entidade. |
| Criar um novo atributo |
Essa solicitação cria um novo atributo para a entidade, o tipo de atributo e outros detalhes especificados. |
| Criar uma nova entidade |
Essa solicitação cria uma nova entidade com o nome, a descrição, o nome do ícone e as categorias de arquivo especificados. |
| Excluir um registro de uma entidade |
Essa solicitação exclui um registro de uma entidade Profisee, considerando o nome da entidade e o código de registro. |
| Obter metadados de atributos pelo nome da entidade |
Essa solicitação retorna metadados para atributos que recebem um nome de entidade. |
| Obter metadados de entidade por nome |
Essa solicitação retorna metadados para um determinado nome de entidade. |
| Obter problemas de qualidade de dados pelo nome da entidade |
Essa solicitação retorna um ou mais problemas de qualidade de dados de uma entidade Profisee, considerando o nome da entidade e, opcionalmente, os códigos de registro. |
| Obter registros pelo nome da entidade |
Essa solicitação retorna um ou mais registros de uma entidade Profisee, considerando o nome da entidade. |
Atualizar registros por nome da entidade
Essa solicitação atualiza um ou mais registros para uma entidade Profisee, considerando o nome da entidade.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
O nome da entidade.
|
entityName | True | string |
O nome da entidade Profisee. |
|
Code
|
Code | string |
Código de registro ou valor exclusivo |
|
|
Nome
|
Name | string |
Nome do registro ou descrição |
|
|
Atributo 1
|
Attribute1 | string |
Attribute1 |
|
|
Atributo 2
|
Attribute2 | string |
Attribute2 |
Atualizar um tema existente
Essa solicitação atualiza um tema existente com o nome do tema fornecido.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome do tema.
|
name | True | string |
Nome do tema Profisee. |
|
bannerPrimary
|
bannerPrimary | string |
bannerPrimary |
|
|
bannerFi
|
bannerFi | string |
bannerFi |
|
|
bannerSecondary
|
bannerSecondary | string |
bannerSecondary |
|
|
contentPrimaryBg
|
contentPrimaryBg | string |
contentPrimaryBg |
|
|
contentPrimaryFi
|
contentPrimaryFi | string |
contentPrimaryFi |
|
|
contentSecondaryBg
|
contentSecondaryBg | string |
contentSecondaryBg |
|
|
contentSecondaryFi
|
contentSecondaryFi | string |
contentSecondaryFi |
|
|
accentBg
|
accentBg | string |
accentBg |
|
|
accentFi
|
accentFi | string |
accentFi |
|
|
selectedBg
|
selectedBg | string |
selectedBg |
|
|
hiperlink
|
hyperlink | string |
hiperlink |
Criar registros por nome de entidade
Essa solicitação cria um ou mais registros para uma entidade Profisee, considerando os valores de nome e código da entidade.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
O nome da entidade.
|
entityName | True | string |
O nome da entidade Profisee. |
|
Code
|
Code | True | string |
Código de registro ou valor exclusivo |
|
Nome
|
Name | string |
Nome do registro ou descrição |
|
|
Atributo 1
|
Attribute1 | string |
Attribute1 |
|
|
Atributo 2
|
Attribute2 | string |
Attribute2 |
Criar um novo atributo
Essa solicitação cria um novo atributo para a entidade, o tipo de atributo e outros detalhes especificados.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Nome da entidade
|
Name | True | string |
Nome da entidade |
|
Nome do atributo
|
Name | True | string |
Nome do atributo |
|
AttributeType
|
AttributeType | True | integer |
AttributeType |
|
Tipo de dados
|
DataType | True | integer |
Tipo de dados de atributo |
|
DataTypeInformation
|
DataTypeInformation | integer |
Informações de tipo de dados |
|
|
IsUnique
|
IsUnique | boolean |
O valor do atributo é exclusivo |
|
|
IsRestricted
|
IsRestricted | boolean |
O valor do atributo é restrito à entrada de dados online? |
|
|
IsIndexed
|
IsIndexed | boolean |
O atributo é indexado? |
|
|
DisplayWidth
|
DisplayWidth | True | integer |
Largura de exibição do atributo |
|
LongDescription
|
LongDescription | string |
Descrição do atributo |
|
|
HasDefault
|
HasDefault | boolean |
O atributo tem um valor padrão? |
|
|
ValorPadrão
|
DefaultValue | string |
Valor padrão para o atributo se HasDefault for true |
|
|
IsCascadeDeleteEnabled
|
IsCascadeDeleteEnabled | boolean |
A exclusão em cascata está habilitada para a entidade baseada em domínio? |
|
|
DomainEntityName
|
Name | string |
Nome da entidade de domínio |
Criar uma nova entidade
Essa solicitação cria uma nova entidade com o nome, a descrição, o nome do ícone e as categorias de arquivo especificados.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
id
|
id | string |
ID da entidade |
|
|
nome
|
name | True | string |
Nome da entidade |
|
longDescrição
|
longDescription | string |
Descrição da entidade |
|
|
iconName
|
iconName | string |
Nome do ícone |
|
|
isCodeGenerationEnabled
|
isCodeGenerationEnabled | boolean |
Indica se o código deve ser gerado automaticamente. O padrão é false. |
|
|
codeGenerationSeed
|
codeGenerationSeed | integer |
codeGenerationSeed |
|
|
id
|
id | string |
id |
|
|
nome
|
name | True | string |
Nome da categoria do arquivo |
|
extensions
|
extensions | string |
fileCategories |
Excluir um registro de uma entidade
Essa solicitação exclui um registro de uma entidade Profisee, considerando o nome da entidade e o código de registro.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
O nome da entidade.
|
entityName | True | string |
O nome da entidade Profisee. |
|
Código de registro
|
recordCode | True | string |
Código de registro ou valor exclusivo |
Obter metadados de atributos pelo nome da entidade
Essa solicitação retorna metadados para atributos que recebem um nome de entidade.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
O nome da entidade.
|
entityName | True | string |
O nome da entidade Profisee. |
Obter metadados de entidade por nome
Essa solicitação retorna metadados para um determinado nome de entidade.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
O nome da entidade.
|
entityName | True | string |
O nome da entidade Profisee. |
Obter problemas de qualidade de dados pelo nome da entidade
Essa solicitação retorna um ou mais problemas de qualidade de dados de uma entidade Profisee, considerando o nome da entidade e, opcionalmente, os códigos de registro.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
O nome da entidade.
|
entityName | True | string |
O nome da entidade Profisee. |
|
O número de página usa como padrão 1.
|
PageNumber | integer |
Número da página a ser retornado. O padrão é 1. |
|
|
O tamanho da página é padrão para 50.
|
PageSize | integer |
Número de registros a serem retornados com a página de dados. O padrão é 50. |
|
|
Lista separada por vírgulas de códigos de registro a serem retornados.
|
RecordCodes | string |
Lista separada por vírgulas de códigos de registro que controlam os registros retornados. |
Retornos
- response
- object
Obter registros pelo nome da entidade
Essa solicitação retorna um ou mais registros de uma entidade Profisee, considerando o nome da entidade.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
O nome da entidade.
|
entityName | True | string |
O nome da entidade Profisee. |
|
Lista de atributos separados por vírgulas. Vários níveis têm barras de avanço inbetween.
|
Attributes | string |
Lista separada por vírgulas de nomes de atributo a serem retornados. Cada atributo deve estar cercado por colchetes. Observação: atributos de vários níveis (MLA) podem ser especificados com uma barra de avanço entre cada nível. Exemplo: [ProductSubCategory]/[ProductCategory]/[ProductGroup] |
|
|
Se a resposta incluir somente contagens. Se não for fornecido, o padrão será false.
|
CountsOnly | boolean |
Indique se a resposta inclui apenas contagens. Se não for fornecido, o padrão será false. |
|
|
Filtro de registro no formato OData.
|
Filter | string |
Filtro de registro no formato OData. Exemplo: [Cor] ne 'Red' ou [Color] eq null |
|
|
Lista separada por vírgulas de atributos e direção de classificação para registros retornados.
|
OrderBy | string |
Lista separada por vírgulas de atributos e direções para classificar os registros retornados. Cada atributo deve estar cercado por colchetes. A ordem de classificação padrão será crescente se não for fornecida. Formato: [Nome do Atributo] [ { asc | desc } ] [, ... ]Exemplo: [ProductSubCategory], [SellStartDate] desc, [Color] asc |
|
|
Número da página a ser retornado. O padrão é 1.
|
PageNumber | integer |
Número da página a ser retornado. O padrão é 1. |
|
|
O tamanho da página é padrão para 50.
|
PageSize | integer |
Número de registros a serem retornados com a página de dados. O padrão é 50. |
|
|
Lista separada por vírgulas de códigos de registro a serem retornados.
|
RecordCodes | string |
Lista separada por vírgulas de códigos de registro que controlam os registros retornados. |
Retornos
- response
- object
Definições
objeto
Esse é o tipo 'object'.