Retransmissão de Alerta (versão prévia)
A Retransmissão de Alertas ajuda a substituir a desativação de alertas do SharePoint por notificações mais avançadas e modernas. Ele retorna alterações detalhadas no nível do campo, bem como HTML de alerta pronto para uso, para que você possa mostrar exatamente o que foi alterado em vez de notificações modificadas genéricas. Você também pode usar informações de alteração e versão em condições e decisões de fluxo.
Esse conector está disponível nos seguintes produtos e regiões:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas as regiões 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: – Azure Governamental regiões - Azure regiões da China - Departamento de Defesa dos EUA (DoD) |
| Power Apps | Premium | Todas as regiões 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 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 | |
|---|---|
| Name | Suporte independNET |
| URL | https://independnet.com.au/alert-relay/support |
| support@alertbridge.com.au |
| Metadados do conector | |
|---|---|
| Publicador | Software independNET |
| Site da Web | https://independnet.com.au/alert-relay/ |
| Política de privacidade | https://independnet.com.au/alert-relay/privacy |
| Categorias | Colaboração; Produtividade |
Retransmissão de
Retransmissão de Alerta para Power Platform e Microsoft 365 Copilot
A Retransmissão de Alertas ajuda as organizações a substituir alertas clássicos de SharePoint por soluções modernas de Power Automate e Copilot Studio. Ele compara SharePoint itens, arquivos e páginas com versões anteriores e retorna informações de alteração estruturadas, histórico de versão e conteúdo de notificação pronto para uso sem exigir que os criadores criem lógica de comparação de versão SharePoint complexa.
Visão geral
SharePoint gatilhos podem identificar que um item, arquivo ou página foi alterado, mas eles não fornecem uma comparação completa dos valores anteriores e atuais.
Criar essa comparação geralmente exige que os criadores recuperem versões, interpretem tokens de alteração, comparem campos e formatem resultados para notificações ou processamento downstream.
A Retransmissão de Alerta centraliza que funcionam por meio de ações reutilizáveis para Power Automate e Copilot Studio.
Principais características
A Retransmissão de Alerta centraliza que funcionam por meio de ações reutilizáveis que podem:
- identificar alterações detalhadas no nível do campo
- retornar valores de campo anteriores e atuais
- gerar HTML pronto para uso para emails de alerta SharePoint
- recuperar histórico de versões de item, arquivo e página
- comparar de um token de gatilho, token de alteração, rótulo de versão ou data
- formatar tipos de campo SharePoint complexos com suporte
- retornar informações estruturadas para Power Automate e Microsoft 365 Copilot
A Retransmissão de Alertas dá suporte a listas de SharePoint, bibliotecas de documentos e bibliotecas de Páginas do Site.
Introdução
Um fluxo de alerta de SharePoint típico inclui:
- Um gatilho SharePoint, como quando um item é criado ou modificado.
- Uma ação de Retransmissão de Alerta, como Obter Item ou Alterações de Arquivo como HTML de Alerta.
- Um email ou outra ação de notificação que usa o assunto retornado e o corpo HTML.
Para condições, formatação personalizada ou cenários de agente Microsoft Copilot Studio, use Get Detailed Item or File Changes e trabalhe com as informações de alteração estruturadas retornadas.
Para versões de SharePoint históricas, use Obter Histórico de Versões de Item ou Arquivo.
Documentation
Documentação, informações de referência de ação, exemplos e diretrizes de introdução estão disponíveis em:
Documentação da Retransmissão de
Tutoriais de vídeo
Instruções passo a passo, exemplos e vídeos de instruções estão disponíveis no canal da Retransmissão de Alertas no YouTube:
Retransmissão de Alertas no YouTube
Licenciamento e avaliação
O licenciamento da Retransmissão de Alertas é em todo o locatário. Uma única avaliação ou assinatura se aplica ao locatário Microsoft Entra e suas unidades de uso são compartilhadas por fluxos de Retransmissão de Alertas e usuários nesse locatário.
A avaliação de 90 dias é iniciada automaticamente quando qualquer ação de Retransmissão de Alerta é executada pela primeira vez no locatário e inclui 300 unidades de uso compartilhadas na avaliação. Para obter planos atuais e mais detalhes, consulte preços e licenciamento da Retransmissão de Alertas.
Ações
Obter alterações detalhadas de item ou arquivo
Retorna alterações detalhadas no nível do campo entre a versão atual de um item, arquivo ou página SharePoint e uma versão anterior.
A ação retorna informações estruturadas, incluindo valores anteriores e atuais, valores formatados e metadados de comparação. Use-o quando um fluxo ou Microsoft Copilot Studio agente precisar inspecionar, resumir ou agir sobre alterações individuais.
Obter alterações de item ou arquivo como HTML de alerta
Gera HTML pronto para uso mostrando o que foi alterado em um item SharePoint, arquivo ou página.
A ação também retorna um assunto de email sugerido, título do item e link do item. Use-o para criar emails de alerta mais avançados SharePoint sem criar expressões de comparação de html e de versão complexas em todos os fluxos.
Obter histórico de versões de item ou arquivo
Retorna o histórico de versão delimitado e paginável para um item, arquivo ou página SharePoint.
A ação pode retornar campos SharePoint selecionados e dá suporte a limites de versão, data e SharePoint token de gatilho. Use-o para cenários históricos de revisão, auditoria, relatório, aprovação e fluxo de trabalho com reconhecimento de versão.
Analisar informações de versão do SharePoint
Decodifica SharePoint informações de janela de gatilho e token de alteração.
Use essa ação para recuperar o carimbo de data/hora do token, aplicar decisões baseadas em data ou versão e filtrar gatilhos de versão secundária ou de rascunho indesejados antes de chamar uma ação de alteração detalhada.
Usos Típicos
A Retransmissão de Alertas pode ajudá-lo a:
- substituir alertas de SharePoint clássicos por fluxos de Power Automate
- enviar notificações formatadas mostrando exatamente o que foi alterado
- comparar valores anteriores e atuais para campos de negócios importantes
- controlar alterações em metadados de documentos e páginas de SharePoint
- recuperar SharePoint histórico de versões do arquivo e do item
- criar fluxos de trabalho de aprovação, revisão, governança e auditoria
- fornecer informações de alteração de SharePoint estruturadas para Microsoft 365 Copilot
Autenticação e acesso
A Retransmissão de Alerta usa Microsoft Entra ID autenticação delegada.
SharePoint acesso é executado no contexto do usuário conectado. A Retransmissão de Alertas não concede aos usuários permissões adicionais de SharePoint, portanto, os usuários já devem ter acesso ao site, lista, biblioteca, item ou arquivo relevantes do SharePoint.
Requisitos e escopo com suporte
- A Retransmissão de Alerta dá suporte ao SharePoint Online. Servidor do SharePoint local não tem suporte.
- As ações são executadas quando chamadas por Power Automate ou outro cliente com suporte. Para notificações de alteração, use um gatilho de SharePoint apropriado para iniciar o fluxo.
- Comparações usando tokens de gatilho SharePoint são baseadas na janela de gatilho SharePoint. A linha de base resultante pode ser diferente de um limite de versão específico do item.
- A formatação detalhada está disponível para tipos de campo de SharePoint com suporte. Consulte a documentação da Retransmissão de Alerta para a referência do tipo de campo atual.
Suporte
Site: https://independnet.com.au/alert-relay/
Suporte: https://independnet.com.au/alert-relay/support
E-mail: support@alertrelay.com.au
Política de privacidade: https://independnet.com.au/alert-relay/privacy
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.
Limitações
| Nome | Chamadas | Período de renovação |
|---|---|---|
| Chamadas à API por conexão | 100 | 60 segundos |
Ações
|
Analisar informações de versão do Share |
Decodifica um token SharePoint Compare From. Quando o Número de Versão e a Data Modificada também são fornecidos, ele determina se o item ou arquivo é uma nova versão. Use essa ação não faturável em condições de fluxo antes de chamar ações faturáveis da Retransmissão de Alerta. |
| Obter alterações de item ou arquivo como HTML de alerta |
Retorna HTML de Retransmissão de Alerta pronto para uso para SharePoint alterações de item, projetadas principalmente para emails de alerta, mas também utilizáveis em qualquer lugar em que o HTML tenha suporte. Os resultados podem incluir uma avaliação, assinatura ou aviso de uso importante da Retransmissão de Alertas para o usuário. |
| Obter alterações detalhadas de item ou arquivo |
Recupera alterações detalhadas no nível do campo formatadas para um item ou arquivo SharePoint list, comparando a versão atual com uma versão anterior. Use isso quando quiser dados avançados de alteração, não apenas os indicadores de alteração SharePoint verdadeiros/falsos. Os resultados podem incluir uma avaliação, assinatura ou aviso de uso importante da Retransmissão de Alertas para o usuário. |
| Obter histórico de versões de item ou arquivo |
Retorna até o número solicitado de versões para um item ou arquivo SharePoint list, o mais recente primeiro. Cada versão inclui detalhes da versão, valores de coluna, valores de texto formatados e indicadores mostrando quais colunas foram alteradas da versão disponível anterior. Selecione o site e a lista ou a biblioteca ao configurar essa ação para disponibilizar suas colunas como conteúdo dinâmico. Os resultados podem incluir uma avaliação, assinatura ou aviso de uso importante da Retransmissão de Alertas para o usuário. |
Analisar informações de versão do SharePoint
Decodifica um token SharePoint Compare From. Quando o Número de Versão e a Data Modificada também são fornecidos, ele determina se o item ou arquivo é uma nova versão. Use essa ação não faturável em condições de fluxo antes de chamar ações faturáveis da Retransmissão de Alerta.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Comparar de
|
compareFrom | True | string |
TriggerWindowStartToken ou token de alteração bruto do SharePoint para decodificar. Os rótulos de versão e os valores de data/data e hora iso não são compatíveis com essa ação. |
|
Número de Versão
|
versionNumber | string |
Número de versão do SharePoint gatilho ou ação, como 0.1, 1.0 ou 1.5. Usado para identificar versões secundárias/de rascunho. |
|
|
Data de Modificação
|
modifiedDate | date-time |
Data modificada do SharePoint gatilho ou ação. Usado para detectar se a versão de SharePoint visível foi alterada durante a janela de gatilho. |
|
|
Incluir versões secundárias
|
includeMinorVersions | boolean |
Se os números de versão secundária/rascunho devem contar como novas versões. O padrão é false. |
|
|
Timezone
|
timezone | string |
Fuso horário opcional para valores de comparação local, como "América/New_York", "Europa/Londres" ou "Austrália/Sydney" (ID de fuso horário IANA). Se omitido, somente o valor UTC será retornado. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Êxito
|
success | boolean |
True quando as informações de versão foram analisadas com êxito; false quando a validação ou o processamento falharam. |
|
Message
|
message | string |
Mensagem voltada para o usuário que descreve o resultado da operação. Agentes e co-pilotos devem mostrar essa mensagem ao usuário quando ela contiver informações de avaliação, assinatura, uso, aviso ou processamento de versão. |
|
Hora da data do token UTC
|
tokenDateTimeUTC | date-time |
Data e hora do token Compare From, retornado em UTC. |
|
Hora da Data do Token Local
|
tokenDateTimeLocal | date-time |
Data e hora do token Compare From, convertido no Fuso Horário selecionado. |
|
Token decodificado
|
decodedToken | string |
Token de alteração de SharePoint bruto após a decodificação. Se Compare From já for um token bruto, isso corresponderá ao valor fornecido. |
|
É o token Base64
|
isBase64Token | boolean |
True quando o token de entrada foi codificado em base64. |
|
Sequence
|
sequence | integer |
Valor da sequência de alterações do SharePoint inserido no token. |
|
Guid de lista
|
listGuid | uuid |
Guid de lista ou biblioteca inserido no token. |
|
Versão do token
|
tokenVersion | integer |
Número da versão do token. |
|
Tipo de token
|
tokenType | integer |
Número do tipo de token do SharePoint. |
|
É detectada uma nova versão
|
isNewVersionDetected | boolean |
True quando os metadados de gatilho/ação fornecidos mostram uma nova versão de SharePoint visível deve ser processada. False quando a versão deve ser ignorada. Nulo quando não há metadados suficientes para determinar. |
|
É uma versão secundária
|
isMinorVersion | boolean |
True quando o número de versão fornecido é uma versão secundária/rascunho. Nulo quando o Número de Versão não foi fornecido. |
|
É a primeira versão secundária
|
isFirstMinorVersion | boolean |
True quando o número de versão fornecido é a primeira versão secundária/rascunho, normalmente 0.1. Nulo quando o Número de Versão não foi fornecido. |
|
É a primeira versão principal
|
isFirstMajorVersion | boolean |
True quando o número de versão fornecido é a primeira versão principal/publicada, normalmente 1.0. Nulo quando o Número de Versão não foi fornecido. |
|
Data da Modificação UTC
|
modifiedDateUtc | date-time |
Data modificada fornecida normalizada para UTC. Nulo quando a Data Modificada não foi fornecida. |
|
Data local modificada
|
modifiedDateLocal | date-time |
Data modificada fornecida convertida no Fuso Horário selecionado. Nulo quando data modificada ou fuso horário não foi fornecido. |
|
Erro
|
error | string |
Detalhes do erro se o êxito for falso. |
Obter alterações de item ou arquivo como HTML de alerta
Retorna HTML de Retransmissão de Alerta pronto para uso para SharePoint alterações de item, projetadas principalmente para emails de alerta, mas também utilizáveis em qualquer lugar em que o HTML tenha suporte. Os resultados podem incluir uma avaliação, assinatura ou aviso de uso importante da Retransmissão de Alertas para o usuário.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
URL do site
|
siteUrl | True | string |
Selecione um site de SharePoint ou insira a URL do site. |
|
Lista ou biblioteca
|
listId | True | string |
Selecione uma lista ou biblioteca ou insira seu título ou GUID. |
|
ID do Item
|
itemId | True | integer |
ID do item ou arquivo do SharePoint a ser analisado para obter alterações. |
|
Comparar de
|
triggerWindowStartToken | string |
Ponto de partida para a comparação. Use triggerWindowStartToken do gatilho SharePoint quando disponível. Você também pode inserir um rótulo de versão, um token de alteração bruto ou uma data/hora da linha de base. Os valores somente data usam meia-noite no fuso horário selecionado ou UTC se nenhum fuso horário estiver selecionado. Deixe em branco para comparar com a versão anterior. |
|
|
Incluir versões secundárias
|
includeMinorVersions | boolean |
Se deve incluir versões secundárias ou de rascunho ao comparar alterações. O padrão é false, portanto, somente as versões principais são comparadas. |
|
|
Incluir campos inalterados
|
includeUnchangedFields | boolean |
Se os campos inalterados devem ser incluídos no HTML gerado. O padrão é true. |
|
|
Formato de data
|
dateFormat | string |
Formato usado para campos DateTime (por exemplo, 'yyy-MM-dd', 'dd/MM/yyyyy'). O padrão é 'yyy-MM-dd'. |
|
|
Formato de hora
|
timeFormat | string |
Formato usado para a parte de hora dos campos DateTime (por exemplo, HH:mm:ss, HH:mm, hh:mm tt). O padrão é HH:mm:ss. |
|
|
Timezone
|
timezone | string |
Fuso horário usado ao formatar datas e horas (por exemplo, América/New_York, Europa/Londres, Austrália/Sydney). O padrão é UTC. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Êxito
|
success | boolean |
True quando a ação foi concluída com êxito; false quando a validação ou o processamento falharam. |
|
Message
|
message | string |
Mensagem voltada para o usuário que descreve o resultado da operação. Agentes e co-pilotos devem mostrar essa mensagem ao usuário quando ela contiver informações de avaliação, assinatura, uso, aviso ou processamento de versão. |
|
Exibir Aviso do Usuário
|
shouldDisplayUserNotice | boolean |
Indica se a Retransmissão de Alerta retornou um aviso de avaliação, assinatura ou uso importante para o usuário. |
|
Código de aviso do usuário
|
userNoticeCode | string |
Motivo legível pelo computador estável para o aviso do usuário. |
|
Severidade do Aviso de Usuário
|
userNoticeSeverity | string |
Severidade da apresentação para o aviso do usuário: informações, aviso ou críticas. |
|
Aviso do usuário
|
userNotice | string |
Informações importantes sobre a avaliação, assinatura ou uso da Retransmissão de Alerta. |
|
Ação de Chamada de Aviso de Usuário
|
userNoticeCallToAction | string |
O que o usuário pode fazer em seguida, incluindo o site de Retransmissão de Alertas e o email de suporte. |
|
Corpo HTML
|
htmlBody | string |
Corpo HTML para a mensagem de alerta, pronto para uso em email ou em qualquer lugar em que HTML tenha suporte. |
|
Assunto de alerta gerado
|
subject | string |
Linha de assunto sugerida para o alerta |
|
Nome do item ou arquivo
|
itemTitle | string |
Título ou nome do arquivo do arquivo ou item alterado. |
|
URL de item ou arquivo
|
itemUrl | string |
Link direto para o arquivo ou item de SharePoint alterado. |
|
É Novo Item
|
isNewItem | boolean |
Determina se o alerta gerado descreve o item ou arquivo como adicionado ou alterado. |
|
Erro
|
error | string |
Detalhes do erro se o êxito for falso |
Obter alterações detalhadas de item ou arquivo
Recupera alterações detalhadas no nível do campo formatadas para um item ou arquivo SharePoint list, comparando a versão atual com uma versão anterior. Use isso quando quiser dados avançados de alteração, não apenas os indicadores de alteração SharePoint verdadeiros/falsos. Os resultados podem incluir uma avaliação, assinatura ou aviso de uso importante da Retransmissão de Alertas para o usuário.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
URL do site
|
siteUrl | True | string |
Selecione um site de SharePoint ou insira a URL do site. |
|
Lista ou biblioteca
|
listId | True | string |
Selecione uma lista ou biblioteca ou insira seu título ou GUID. |
|
ID do Item
|
itemId | True | integer |
ID do item ou arquivo do SharePoint a ser analisado para obter alterações. |
|
Comparar de
|
triggerWindowStartToken | string |
Ponto de partida para a comparação. Use triggerWindowStartToken do gatilho SharePoint quando disponível. Você também pode inserir um rótulo de versão, um token de alteração bruto ou uma data/hora da linha de base. Os valores somente data usam meia-noite no fuso horário selecionado ou UTC se nenhum fuso horário estiver selecionado. Deixe em branco para comparar com a versão anterior. |
|
|
Incluir versões secundárias
|
includeMinorVersions | boolean |
Se deve incluir versões secundárias ou de rascunho ao comparar alterações. O padrão é false, portanto, somente as versões principais são comparadas. |
|
|
Incluir campos inalterados
|
includeUnchangedFields | boolean |
Se os campos inalterados devem ser incluídos na resposta. O padrão é true. |
|
|
Formato de data
|
dateFormat | string |
Formato usado para campos DateTime (por exemplo, 'yyy-MM-dd', 'dd/MM/yyyyy', 'MM/dd/yyyy'). O padrão é 'yyy-MM-dd'. |
|
|
Formato de hora
|
timeFormat | string |
Formato usado para a parte de hora dos campos DateTime (por exemplo, HH:mm:ss, HH:mm, hh:mm tt). O padrão é HH:mm:ss. |
|
|
Timezone
|
timezone | string |
Fuso horário usado ao formatar datas e horas (por exemplo, América/New_York, Europa/Londres, Austrália/Sydney). O padrão é UTC. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Êxito
|
success | boolean |
True quando a ação foi concluída com êxito; false quando a validação ou o processamento falharam. |
|
Message
|
message | string |
Mensagem voltada para o usuário que descreve o resultado da operação. Agentes e co-pilotos devem mostrar essa mensagem ao usuário quando ela contiver informações de avaliação, assinatura, uso, aviso ou processamento de versão. |
|
Exibir Aviso do Usuário
|
shouldDisplayUserNotice | boolean |
Indica se a Retransmissão de Alerta retornou um aviso de avaliação, assinatura ou uso importante para o usuário. |
|
Código de aviso do usuário
|
userNoticeCode | string |
Motivo legível pelo computador estável para o aviso do usuário. |
|
Severidade do Aviso de Usuário
|
userNoticeSeverity | string |
Severidade da apresentação para o aviso do usuário: informações, aviso ou críticas. |
|
Aviso do usuário
|
userNotice | string |
Informações importantes sobre a avaliação, assinatura ou uso da Retransmissão de Alerta. |
|
Ação de Chamada de Aviso de Usuário
|
userNoticeCallToAction | string |
O que o usuário pode fazer em seguida, incluindo o site de Retransmissão de Alertas e o email de suporte. |
|
Campos alterados
|
changedFields | array of object |
Lista de campos SharePoint comparados, incluindo o nome de cada campo, o valor anterior, o valor atual e se ele foi alterado. |
|
O valor da coluna foi alterado
|
changedFields.hasChanged | boolean |
True se o valor desse campo foi alterado entre a versão anterior e a atual |
|
Valor da coluna anterior (texto)
|
changedFields.previousAsString | string |
Valor anterior formatado como uma cadeia de caracteres legível por humanos |
|
Nome interno do campo
|
changedFields.internalName | string |
Nome do campo interno do SharePoint |
|
Nome do campo
|
changedFields.displayName | string |
Nome de exibição amigável para o campo |
|
Valor da coluna anterior (detalhado)
|
changedFields.previous |
Valor anterior bruto. Essa propriedade é dinâmica e pode ser uma cadeia de caracteres, número, booliano, objeto, matriz ou nulo, dependendo do tipo de campo do SharePoint. |
|
|
Valor da coluna atual (texto)
|
changedFields.currentAsString | string |
Valor atual formatado como uma cadeia de caracteres legível por humanos |
|
Valor da coluna atual (detalhado)
|
changedFields.current |
Valor atual bruto. Essa propriedade é dinâmica e pode ser uma cadeia de caracteres, número, booliano, objeto, matriz ou nulo, dependendo do tipo de campo do SharePoint. |
|
|
Tem linha de base de comparação
|
hasComparisonBaseline | boolean |
True se uma versão de linha de base distinta foi resolvida para comparação com a versão atual. |
|
É a primeira versão da linha de base
|
isBaselineFirstVersion | boolean |
True se a versão de linha de base resolvida for a primeira versão já registrada para o item ou arquivo. |
|
É Novo Item
|
isNewItem | boolean |
True quando o item ou arquivo deve ser tratado como novo para a janela de comparação resolvida em vez de como uma atualização. |
|
Rótulo de versão atual
|
currentVersionLabel | string |
Rótulo de versão da versão atual (por exemplo, '2.0', '5.0') |
|
Rótulo de versão anterior
|
previousVersionLabel | string |
Rótulo de versão usado para comparação (por exemplo, '1.0', '4.0') |
|
Nome do item ou arquivo
|
itemTitle | string |
Título ou nome do arquivo do arquivo ou item alterado. |
|
URL de item ou arquivo
|
itemUrl | string |
Link direto para o arquivo ou item de SharePoint alterado. |
|
Data de Modificação
|
modifiedDate | date-time |
Data e hora da modificação mais recente. |
|
Modificado por
|
modifiedBy | string |
Nome de exibição do usuário que modificou o item pela última vez |
|
Erro
|
error | string |
Detalhes do erro se o êxito for falso |
Obter histórico de versões de item ou arquivo
Retorna até o número solicitado de versões para um item ou arquivo SharePoint list, o mais recente primeiro. Cada versão inclui detalhes da versão, valores de coluna, valores de texto formatados e indicadores mostrando quais colunas foram alteradas da versão disponível anterior. Selecione o site e a lista ou a biblioteca ao configurar essa ação para disponibilizar suas colunas como conteúdo dinâmico. Os resultados podem incluir uma avaliação, assinatura ou aviso de uso importante da Retransmissão de Alertas para o usuário.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
URL do site
|
siteUrl | True | string |
Selecione um site de SharePoint ou insira a URL do site. |
|
Lista ou biblioteca
|
listId | True | string |
Selecione a lista ou a biblioteca cujas colunas de versão devem estar disponíveis como conteúdo dinâmico no fluxo. |
|
ID do Item
|
itemId | True | integer |
SharePoint list ID do item. Isso pode ser fornecido dinamicamente em runtime, por exemplo, de um gatilho SharePoint ou de uma ação de fluxo anterior. |
|
Unidades de uso máximas
|
maximumUsageUnits | True | integer |
Limite selecionado pelo chamador necessário nas unidades de uso que essa chamada pode consumir. O valor padrão é 1. Esse é um guarda de cobrança, não um limite de contagem de versão; uma unidade de uso pode retornar várias versões completas. Use o Máximo de Versões para limitar o número de linhas de versão. |
|
Máximo de versões
|
maximumVersions | integer |
Número total máximo de linhas de versão completas a serem retornadas em todas as páginas. Deixe em branco para continuar até que o intervalo selecionado, o histórico disponível ou o orçamento da unidade de uso terminem. Cada resposta contém no máximo 100 versões. |
|
|
Campos a serem retornados
|
fieldsToReturn | array of string |
SharePoint colunas a serem incluídas em cada versão. Adicione uma coluna por item. Deixe Campos para Retornar vazio para retornar todas as colunas com suporte. Selecionar menos colunas pode reduzir o tamanho da resposta e o trabalho de unidade de uso. |
|
|
Comparar de
|
fromVersion | string |
Ponto de partida para o intervalo de histórico de versões. Use triggerWindowStartToken do gatilho SharePoint quando disponível. Você também pode inserir um rótulo de versão, um token de alteração bruto ou uma data/hora da linha de base. Os valores somente data usam meia-noite no fuso horário selecionado ou UTC se nenhum fuso horário estiver selecionado. Deixe em branco para nenhum limite mais antigo. |
|
|
Comparar com
|
toVersion | string |
Ponto final para o intervalo de histórico de versões. Use o GatilhoWindowEndToken do gatilho SharePoint quando disponível. Você também pode inserir um rótulo de versão, um token de alteração bruto ou uma data/hora. Os valores somente data usam meia-noite no fuso horário selecionado ou UTC se nenhum fuso horário estiver selecionado. Deixe em branco para nenhum limite mais recente. |
|
|
Token de paginação
|
continuationToken | string |
Token usado para recuperar a próxima página do histórico de versões, se um tiver sido retornado por uma chamada anterior. |
|
|
Incluir versões secundárias
|
includeMinorVersions | boolean |
Se deve incluir versões secundárias ou de rascunho ao recuperar o histórico de versões. O padrão é false, portanto, somente as versões principais são retornadas. |
|
|
Formato de data
|
dateFormat | string |
Formato usado para campos DateTime (por exemplo, 'yyy-MM-dd', 'dd/MM/yyyyy', 'MM/dd/yyyy'). O padrão é 'yyy-MM-dd'. |
|
|
Formato de hora
|
timeFormat | string |
Formato usado para a parte de hora dos campos DateTime (por exemplo, HH:mm:ss, HH:mm, hh:mm tt). O padrão é HH:mm:ss. |
|
|
Timezone
|
timezone | string |
Fuso horário usado ao formatar datas e horas (por exemplo, América/New_York, Europa/Londres, Austrália/Sydney). O padrão é UTC. |