Base de conhecimento

Voltar à visão geral do suporte

Tarefa Buscar Fonte de Dados

Busca uma tarefa de fonte de dados do servidor.

Senha: fetch_datasource_task

Elementos

  • datasource_id: Contém a ID da fonte de dados da qual receber uma tarefa.
    • Tipo: String
  • sheet_revision: Contém a revisão da fonte de dados que você deseja usar.
    • Tipo: Longo
  • payload_variable_name: Contém a carga da tarefa buscada que será convertida e armazenada no contexto com a chave especificada aqui.
    • Tipo: String
  • task_variable_name: Contém o objeto de tarefa que será armazenado no contexto com a chave especificada aqui.
    • Tipo: String
  • datasource_task_id: Contém a ID da tarefa que deve ser buscada.
    • Tipo: String
  • request_new: Indica se uma tarefa nova e vazia deve ser buscada (alternativa à especificação de um datasource_task_id).
    • Tipo: Bool
  • row_count: O número de linhas que uma tarefa nova e vazia deve ter ao solicitar uma nova tarefa.
    • Tipo: Longo
  • connection_timeout: Contém o tempo limite em milissegundos.
    • Tipo: Longo

Saída

A tag de evento deste evento é fetch_datasource_task.

  • OKEY: A tarefa de fonte de dados foi obtida com êxito.
  • ERRO: Ocorreu um erro ao buscar a tarefa. Se o servidor fornecer uma mensagem de erro, ela será encontrada na carga útil. A carga útil está estruturada da seguinte forma:
    • erro
    • erro.mensagem
    • error.class
    • erro.categoria
    • error.code
  • TIMEOUT: O servidor não enviou uma resposta dentro do tempo especificado (connection_timeout)

Exemplo

A tarefa de fonte de dados de busca é normalmente usada em conjunto com uma entrada de fonte de dados:

<fetch_datasource_task id="fetch_datasource_task">
    <param name="datasource_id" type="string">§{ configuration.datasource.value.id }§</param>
    <param name="sheet_revision" type="string">§{ configuration.datasource.value.selectedRevision }§</param><
    param name="payload_variable_name" type="string">ds_§{ replace configuration.datasource.value.id '-' ''  }§</param>
    <param name="task_variable_name" type="string">ds_§{ substitua configuration.datasource.value.id '-' '' }§_task</param>
    <param name="request_next" type="bool">§{ #if configuration.enable_scan.value}§false§{else}§true§{/if}§</param>
    <param name="request_new" type="bool">§{ #if configuration.request_new.value}§true§{else}§false§{/if}§</param>
    <param name="row_count" type="long">§{ configuration.row_count.value }§</param>
    <param name="datasource_task_id" type="string">#{task_id}</param>
    <param name="connection_timeout" type="string">?{ §{configuration.timeout.value}§*1000}?</param>
</fetch_datasource_task>

Tarefa Atualizar Fonte de Dados

Atualiza uma tarefa de fonte de dados no servidor.

Identificador: update_datasource_task

Elementos

  • datasource_task_id: Contém a ID da tarefa a ser alterada. Esse é o valor da coluna configurada como o identificador nas configurações da fonte de dados.
    • Tipo: String
  • linhas: contém o objeto de linha a ser alterado.
    • Tipo: Objeto
  • payload_variable_name: Contém a variável na qual a carga útil da tarefa é armazenada no contexto.
    • Tipo: String
  • connection_timeout: Contém o valor de tempo limite em milissegundos.
    • Tipo: Longo

Saída

A tag de evento deste evento é update_datasource_task.

  • OK: A tarefa de fonte de dados foi obtida com êxito.
  • ERRO: Ocorreu um erro ao buscar a tarefa. Se o servidor fornecer uma mensagem de erro, ela será encontrada na carga útil. A carga útil está estruturada da seguinte forma: erro
    • erro.mensagem
    • error.class
    • erro.categoria
    • error.code
  • TIMEOUT: O servidor não enviou uma resposta dentro do tempo especificado (connection_timeout)

Exemplo

A tarefa de fonte de dados pode ser usada em conjunto com uma entrada de fonte de dados. Os parâmetros para datasource_task_id e payload_variable_name dependem de onde seus dados são salvos. O exemplo abaixo funcionará com o exemplo mostrado na fetch_datasource_task ação de entrada: 

<update_datasource_task id="update_ds_with_row">
    <param name="datasource_task_id" type="string">?{ context.ds_§{ substituir validation.datasource.value.id '-' '' }§_task.id}?</param>
    <param name="rows">#{current_row}</param>
    <param name="payload_variable_name">ds_§{ substitua validation.datasource.value.id '-' ''  }§</param>
</update_datasource_task>

Atualizar Status da Tarefa da Fonte de Dados

Atualiza o status de uma tarefa de fonte de dados.

Identificador: update_datasource_task_status

Elementos

  • datasource_task_id: Contém a ID da tarefa que deve ser buscada. Esse é o valor da coluna configurada como o identificador nas configurações da fonte de dados.
    • Tipo: String
  • status: contém o estágio atual da tarefa (por exemplo,DONE , CANCELED, PAUSEDou ). IN_PROGRESS
    • Tipo: String
  • connection_timeout: Contém o valor de tempo limite em milissegundos.
    • Tipo: Longo

Saída

A tag de evento deste evento é update_datasource_task_status.

  • OK: A tarefa de fonte de dados foi obtida com êxito.
  • ERRO: Ocorreu um erro ao buscar a tarefa. Se o servidor fornecer uma mensagem de erro, ela será encontrada na carga útil. A carga é estruturada da seguinte forma:erro
    • erro.mensagem
    • error.class
    • erro.categoria
    • error.code
  • TIMEOUT: O servidor não enviou uma resposta dentro do tempo especificado (connection_timeout)

Exemplo

Este exemplo mostra que isso pode ser usado em conjunto com uma entrada de fonte de dados:

<update_datasource_task_status id="cancel_ds_task">
    <param name="datasource_task_id" type="string">?{ context.ds_§{ substitua validation.datasource.value.id '-' '' }§_task.id}?</param>
    <param name="status" type="string">CANCELED</param>
    <param name="connection_timeout" type="string">10000</param>
</update_datasource_task_status>