Ação Pesquisar anexo

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 2 min. de leitura

    • Pesquisa um anexo associado a um registro e retorna o SYS ID do anexo como uma cápsula de dados.

    Funções e disponibilidade

    Disponível como uma ação principal de Workflow Studio ServiceNow. Usuários com a função flow_designer ou admin podem adicionar uma ação a um fluxo e definir detalhes de configuração.

    Entradas

    Forneça um valor para cada entrada de que o fluxo precisa. Para adicionar valores dinâmicos, você também pode arrastar e soltar pilhas do painel de dados ou selecioná-las no seletor de pilhas.

    Nome de arquivo
    Tipo de dados: String

    O nome do anexo que você deseja pesquisar. Você pode deixar esta entrada em branco para pesquisar todos os anexos de um registro.

    Registro de Origem
    Tipo de dados: Record

    Registro que contém um ou mais anexos a serem pesquisados. Você pode usar Ação Pesquisar registro para encontrar um registro de origem apropriado.

    Saídas

    Essas saídas aparecem no painel de dados. Você pode usá-las como entradas em outro lugar em seu fluxo.

    SYS ID de anexo
    Tipo de dados: String

    SYS ID do primeiro anexo correspondente. Você pode usar o Ação Pesquisar registro para converter este valor de cadeia de caracteres em uma saída de registro.

    Lista de Anexos
    Tipo de dados: String

    Cadeia de caracteres no formato JSON que contém todos os anexos que correspondem à consulta de pesquisa. Cada item correspondente é formatado como um objeto que contém o SYS ID, o nome do arquivo e o tamanho do arquivo em bytes do anexo. Você pode usar uma ação personalizada para analisar este objeto conforme necessário.

    Pesquisar anexos de registros de incidentes

    Configuração da ação Pesquisar anexo em que a entrada Nome do arquivo está vazia e o Registro de origem está mapeado para o incidente do gatilho.

    Este exemplo pesquisa anexos de registros de incidentes para que eles possam ser copiados para registros de problemas relacionados. A entrada Nome do arquivo está vazia para localizar todos os anexos no registro de origem. A entrada Registro de origem usa a cápsula de dados do registro do gatilho de incidente.

    Detalhes de execução da etapa 1 do fluxo mostrando uma cadeia de caracteres de ID do sistema específica retornada como saída.

    Neste exemplo, os detalhes de execução do fluxo mostram que o incidente do gatilho tinha apenas um anexo. A saída do SYS ID do anexo lista o SYS ID do registro de anexo como um valor de cadeia de caracteres. A saída da Lista de anexos está vazia porque havia apenas um anexo associado ao registro de origem.

    Quando o registro de incidente de acionamento tem dois ou mais anexos correspondentes à consulta de pesquisa, a ação preenche a saída da Lista de anexos com uma cadeia de caracteres JSON.
    [
  {
    "sys_id": "a8008849db7e4210497c1a481396193c",
    "file_name": "Root Cause Analysis",
    "file_size_in_bytes": "48955"
  },
  {
    "sys_id": "c0a298356f102100758ecb512e3ee409",
    "file_name": "Pasted Image",
    "file_size_in_bytes": "97236"
  }
]