Para interagir com o Persefoni, adicione uma etapa em uma cadeia que use um comando de conexão do Persefoni.
Requisitos
Para habilitar esses comandos, um administrador de TI deve primeiro configurar o conector do Persefoni.
Buscar transações
Nota: O comando "Fetch Transactions" foi removido da API do Persefoni no final de junho de 2025.
A Persefoni recomenda que você use o comando Get Activities, pois ele oferece muitas das mesmas funções de "Fetch Transactions", tem maior estabilidade e inclui recursos adicionais, como filtrar datas e melhorar o tempo de resposta.
Substituindo "Fetch Transactions" (Buscar transações)
Se você estiver gerenciando dados do Persefoni por meio do Workiva Persefoni Connector, o nó "Fetch Transactions" provavelmente aparecerá como "Disabled" ou "Legacy".
Para restaurar a função:
- Substitua o nó: Você deve excluir manualmente o nó do comando "Fetch Transactions" do seu fluxo de trabalho.
- Use "Get Activities" (Obter atividades): Insira o comando "Get Activities" para obter os dados atuais de contabilidade de carbono.
- Atualize os mapeamentos: O esquema de saída de "Get Activities" é mais específico do que o de "Fetch Transactions" (veja abaixo); talvez você precise mapear novamente suas variáveis CSV ou JSON para garantir que elas se alinhem aos novos campos baseados em atividades.
Obter atividades
Para obter todas as atividades aplicáveis a uma conta, adicione um comando Get activities.
Propriedades
| Propriedade | Detalhes |
|---|---|
| Consulta nomeada |
Selecione no menu suspenso:
|
| ID da organização |
Insira um ID de organização para obter as atividades de pegada da organização principal especificada no Persefoni. Para incluir organizações dependentes em seu resultado, ative a opção Include children organizations abaixo. Se nenhum ID de organização for fornecido, o padrão será a organização do usuário associado. |
| Incluir organizações filhas | Ative essa opção para incluir organizações infantis no resultado. |
| Ano de relatório |
Insira um ano no formato AAAA (por exemplo, 2022) para ver somente as atividades que ocorreram durante esse ano. Observação: Isso substitui todos os filtros de data subsequentes. |
| Data de modificação em ou após | Inclua apenas os registros que foram modificados pela última vez na data fornecida ou depois dela. Com base na data no fuso horário UTC. Exemplo: 2023-12-26. |
| Data de modificação em ou antes de | Inclua apenas os registros que foram modificados pela última vez na data fornecida ou antes dela. Com base na data no fuso horário UTC. Exemplo: 2023-12-26. |
| Data de início da atividade em ou após | Inclua apenas registros com uma data de início de atividade na data fornecida ou depois dela. Exemplo: 2023-12-26. |
| Data de início da atividade em ou antes | Inclua apenas registros com uma data de início de atividade igual ou anterior à data fornecida. Exemplo: 2023-12-26. |
| Data de término da atividade em ou após | Inclua apenas registros com uma data de término de atividade na data fornecida ou depois dela. Exemplo: 2023-12-26. |
| Data de término da atividade em ou antes | Inclua apenas registros com uma data de término de atividade igual ou anterior à data fornecida. Exemplo: 2023-12-26. |
Saídas
| Saída | Tipo de saída |
|---|---|
| Atividades buscadas | Arquivo CSV |
| Tamanho do arquivo (Bytes) | Inteiro |
| Contagem de linhas | Inteiro |
Códigos de saída
| Código | Tipo | Detalhes |
|---|---|---|
| 0 | Com sucesso | Com sucesso |
| 1 | Erro | Erro |