Centro de suporte da Workiva

Em Chain Builder, você pode criar uma cadeia para fazer download de dados do Enablon®, como suas emissões de gases de efeito estufa (GHG) para relatórios ambientais, sociais e de governança (ESG) ou de sustentabilidade. 

Pré-requisitos

Para construir essa cadeia, você usará esses conectores principais:

• Solicitação HTTP conector
• Utilitários de arquivo conector
• XML conector
• Workiva conector, se você precisar usar os dados em uma planilha ou tabela Wdata

Observação: Todos os comandos dessa cadeia usam o CloudRunner padrão. Você não precisa do GroundRunner.

Para executar a cadeia, você precisará de detalhes da Enablon para acessar os dados:

• O ponto final da Interface de Programação de Aplicativos (API) do Protocolo de Acesso a Objetos Simples (SOAP) da Enablon a ser usado para fazer download dos dados
• O ID do ambiente da Enablon a ser acessado
• O nome de usuário e a senha a serem usados para acessar o ambiente

Etapa 1. Criar a cadeia

1. Em Cadeias, clique em Criar e selecione Criar cadeia.
   
2. Em Setup, digite um nome e uma descrição para ajudar a identificar a cadeia e sua intenção.
   
3. Em Variables, adicione variáveis para os detalhes do Enablon necessários para acessar os dados:
   • Ponto de extremidade

     Dica: Para a variável Endpoint, insira um valor padrão de ExportData ou, para fazer download dos dados em um formato de codificação de 64 bits, ExportBinaryData.

   • Meio ambiente
   • Nome de usuário
   • Senha
4. Clique em Salvar.

Etapa 2. Comece com o evento de acionamento Runtime Inputs

Para filtrar a saída sempre que a cadeia for executada, inicie com um evento Runtime Inputs para solicitar os critérios dos dados a serem baixados.

1. Mova Runtime Inputs de Trigger Events para Inicie.
2. Selecione o evento Entradas de tempo de execução e clique em Editar.
   
3. Adicione as entradas a serem solicitadas toda vez que a cadeia for executada:

   Nome de exibição	Tipo	Necessário?
   Data de início do período do relatório	DateField	Sim
   Data final do período do relatório	DateField	Sim
   Campanha	TextField ou DropdownField: TextField, para um campo de texto aberto DropdownField, para você selecionar em uma lista específica de opções	Sim
   Entidades	ArrayField	Sim

4. Clique em Salvar.

Etapa 3. Adicionar um comando POST do conector de solicitação HTTP

Para recuperar os dados do ponto de extremidade do Enablon, configure um comando HTTP connector POST:

1. Em Connectors, clique em HTTP e mova o comando POST para a tela.
2. Arraste um link de Inicie para o comando POST .
3. Selecione o comando POST e clique em Editar.
4. Em Propriedades de comando, selecione o conector HTTP a ser usado.
5. Digite as propriedades do comando:
   
   

   Propriedade	Descrição
   Nome do usuário	Selecione a variável Username em Chain.
   Senha	Selecione a variável Password em Chain.
   Mostrar resposta	Marque esta caixa.
   URL	Selecione a variável Endpoint em Chain.
   Tipo de conteúdo	Digite text/xml.

6. No texto do corpo , insira esta sintaxe XML (Extensible Markup Language):

    <soapenv:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:enab="enablon<4> <soapenv:Header> <UserInfo xsi:type="wsdl:AuthHeader" xmlns:wsdl="http://enablon/wsdl/"> <EnaHomeSite xsi:type="xsd:string<6>[Environment]</EnaHomeSite> <EnaUserName xsi:type="xsd:string">[Nome de usuário]</EnaUserName> <EnaPassword xsi:type="xsd:string<8>[Senha]</EnaPassword> </UserInfo> </soapenv:Header> <soapenv:Body> <enab:ExportData soapenv:encoding:Style="http://schemas.xmlsoap.org/soap/encoding/"> <Table>/sd/Entidades/Dados</Table>       <FolderId>0</FolderId> <Fields>FolderPath|ReportingPeriod|Ref|IndicatorName|ValueNumber|LocalUnit|ValueList</Fields> <Filter>ReportingPeriod in ([ReportPeriodEndDate],[ReportPeriodStartDate]) AND Campaign in([Campaign]) AND Entities=[Entities]</Filter> <CSVSeparator>2</CSVSeparator> <FormatOptions>25</FormatOptions> <FormatType>3</FormatType> <ExportOptions>8192</ExportOptions> </enab:ExportData> </soapenv:Body> </soapenv:Envelope>

7. Atualize a sintaxe XML com a entrada de tempo de execução e as variáveis de cadeia:
   • No cabeçalho, substitua [Environment], [Username], e [Password] por suas respectivas variáveis em Chain.
   • No corpo, substitua [ReportPeriodEndDate], [ReportPeriodStartDate], [Campaign], e [Entities] por suas entradas de tempo de execução em Trigger.
8. Clique em Salvar.

Etapa 4. Adicionar comandos Localizar e Substituir do conector de Utilitários de Arquivo

Para preparar os dados XML baixados, adicione File Utilities conector comandos Find and replace para corrigir os colchetes angulares e os pipes.

Dica: Para diferenciar facilmente os comandos Localizar e substituir, insira nomes que identifiquem o caractere que cada comando corrige, como "Localizar e substituir colchetes angulares iniciais" ou "Localizar e substituir tubos".

1. Em Connectors, clique em File Utilities e mova o comando Find and replace para a tela.
2. Arraste um link do comando POST para o comando Find and replace .
3. Selecione o comando Localizar e substituir e clique em Editar.
4. Em Propriedades de comando, selecione o conector Utilidades de arquivos a ser usado.
   
5. Digite as propriedades do comando e clique em Salvar:
   

   Propriedade	Descrição
   Fonte	Selecione a saída Response do comando POST.
   Localizar	Inserir código
   Substituir	Insira um colchete angular inicial ( <).
   Sintaxe de localização	Selecione Exato.

6. Em Connectors, clique em File Utilities e mova outro comando Find and replace para a tela.
7. Arraste um link entre os comandos Localizar e substituir .
8. Selecione o novo comando Find and replace e clique em Edit.
9. Em Propriedades de comando, selecione o mesmo conector Utilitários de arquivo.
   
10. Digite as propriedades do comando e clique em Salvar:
    

    Propriedade	Descrição
    Fonte	Selecione a saída Replaced result do comando Find and replace.
    Localizar	Digite ".".
    Substituir	Insira um colchete angular inicial (>).
    Localizar sintaxe	Selecione Exato.

11. Em Connectors, clique em File Utilities e mova outro comando Find and replace para a tela.
12. Arraste um link entre o segundo e o terceiro comandos Find and replace .
13. Selecione o terceiro comando Find and replace e clique em Edit.
14. Em Command properties, selecione o mesmo conector File Utilities.
    
15. Digite as propriedades do comando e clique em Salvar:
    

    Propriedade	Descrição
    Fonte	Selecione a saída Replaced result do segundo comando Find and replace.
    Localizar	Digite ".".
    Substituir	Insira um pipe (|).
    Sintaxe de localização	Selecione Exact.

Etapa 5. Adicionar uma lista de elementos do conector XML ao comando CSV

Para converter o XML baixado em dados tabulares, adicione um conector XML Lista de elementos para o comando CSV:

1. Em Connectors, clique em XML e mova outro comando Element list to CSV para a tela.
2. Arraste um link do terceiro comando Find and replace para o comando Element list to CSV.
3. Selecione o comando Element list to CSV e clique em Edit.
4. Em Propriedades do comando, selecione o conector XML a ser usado.
   
5. Digite as propriedades do comando:
   

   Propriedade	Descrição
   Fonte	Selecione a saída Replaced result do terceiro comando Find and replace.
   Caminho para a raiz	Digite //Document/Record.
   Resultado da visualização	Marque esta caixa.

6. Em Columns, adicione o nome da coluna e o XPath para cada elemento:
   
   

   Nome da coluna	XPath
   Período	/ReportingPeriod
   Indicador	/Ref
   IndName	/IndicatorName
   ValorNumérico	/ValueNumber
   Unidade	/LocalUnit

7. Em Delimitador de vários valores, insira uma vírgula (,).
8. Clique em Salvar.

Etapa 6. Adicionar um comando Criar arquivo do conector Utilitários de arquivo

Para criar um arquivo de valores separados por vírgula (CSV) a partir dos dados tabulares, adicione um conector File Utilities Create file comando:

1. Em Connectors, clique em File Utilities e mova o comando Create file para a tela.
2. Arraste um link do comando Element list to CSV para o comando Create file .
3. Selecione o comando Criar arquivos e clique em Editar.
4. Em Propriedades de comando, selecione o mesmo conector File Utilities que os comandos Localizar e substituir.
   
5. Digite as propriedades do comando e clique em Salvar:
   

   Propriedade	Descrição
   Texto	Selecione a saída Converted file do comando Element list to CSV.
   Caminho do arquivo	Selecione a variável Chain.Workspace em Runtime e anexe \test.csv.

Etapa 7. Adicionar comandos para usar os dados no Workiva

Para usar os dados CSV na plataforma Workiva, adicione os comandos do conector Workiva para usar a saída da variável Arquivo criado do comando Criar arquivos com uma planilha ou tabela Wdata. Por exemplo, para adicionar os dados do Enablon como um conjunto de dados em uma tabela Wdata, adicione um evento Run chain que use uma cadeia criada a partir de e Update datasets em uma tabela template. 

Etapa 8. Publicar e executar a cadeia

Para permitir a execução da cadeia:

1. Clique em Publicar.
2. Insira qualquer comentário sobre sua publicação e clique em Publicar.

Para executar a corrente:

1. Em Cadeias, selecione Editar no menu da cadeia.
2. Clique em Configurações da cadeia, digite os valores das variáveis e clique em Salvar.

   Observação: Para a variável Endpoint, digite ExportData ou, para fazer download dos dados em um formato de codificação de 64 bits, ExportBinaryData.

3. Clique em Execute.
4. Em Monitor, clique em Run with inputs, insira as entradas de tempo de execução e clique em Start.