---
sourceDocument: Capacidades da Now Platform da Yokohama
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/yokohama/servicenow-platform

 Release :

    - yokohama

ft:locale :

    - pt-BR

ft:publication_title :

    - Capacidades da Now Platform da Yokohama

ft:clusterId :

    - platcap

bundleId :

    - platcap

workflow :

    - Platform


---

# Atividade Substituir cadeia de caracteres em arquivo

# Atividade Substituir cadeia de caracteres em arquivo {#ariaid-title1}

* Versão de lançamento: Yokohama
* 
* Atualizado 30 de jan. de 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 min. de leitura

A atividade Substituir cadeia de caracteres em arquivo localiza e substitui uma cadeia de caracteres em um arquivo em um computador Linux ou UNIX.
Esta atividade substitui uma atividade SSH com o mesmo nome disponível em versões anteriores à Istambul. Se você tiver um fluxo de trabalho criado em uma versão anterior que usa essa atividade descontinuada, o seu fluxo de trabalho vai continuar funcionando normalmente após atualizar para a versão Istambul. No entanto, todos os novos fluxos de trabalho devem usar a versão personalizada desta atividade. Esta atividade foi criada com o [modelo de atividade do SSH](https://servicenow-prod.fluidtopics.net/WqgJwmfFXVl94NnslmcVLg#t_CreateAnSSHActivity "Crie uma atividade que extraia dados de um host de destino que usa o protocolo de rede SSH."), que permite a administradores de fluxo de trabalho a capacidade de armazenar variáveis de entrada e saída no [databus](https://servicenow-prod.fluidtopics.net/aZwlQOJxnftSzCkxgZ_1eQ#t_ReuseDataInTheActivityDesigner "A guia Dados no Editor de fluxo de trabalho lista todas as atividades personalizadas usadas no fluxo de trabalho atual que produzem dados e exibe esses dados para reutilização em outras atividades personalizadas.").{#r_FileReplaceStringActivity__p_ExplainDeprecation}

## Variáveis de entrada

{#r_FileReplaceStringActivity__table_dpc_r5z_zp__entry__2}

| Variável | Descrição |
|-|-|
| hostname | Nome de host ou endereço IP do servidor de destino para atividade SSH. |
| diretório | Nome do diretório de trabalho (destino). |
| arquivo | Nome do arquivo no qual a cadeia de caracteres deve ser substituída. |
| find_pattern | Uma expressão regular do texto a ser substituído. |
| replace_string | A cadeia de caracteres de substituição para o texto encontrado pela expressão na variável find_pattern. |
| opções | Opções de substituição: * first: substitui a primeira ocorrência do padrão. * all: substitui todas as ocorrências do padrão. {#r_FileReplaceStringActivity__ul_fxk_4mk_pw} |
[Tabela 1. Variáveis de entrada para Substituir cadeia de caracteres em arquivo]

{#r_FileReplaceStringActivity__table_dpc_r5z_zp}

## Variáveis de saída

{#r_FileReplaceStringActivity__table_ufj_vmk_pw__entry__2}

| Variável | Descrição |
|-|-|
| return_code | Indica se a cadeia de caracteres foi substituída ou não no arquivo de destino. |
| ErrorMessage | Mensagem que indica se ocorreu um erro. Qualquer valor diferente de 0 indica uma falha. |
[Tabela 2. Variáveis de saída para Substituir cadeia de caracteres em arquivo]

{#r_FileReplaceStringActivity__table_ufj_vmk_pw}

## Condições

{#r_FileReplaceStringActivity__table_bfc_xmk_pw__entry__2}

| Condição | Descrição |
|-|-|
| Êxito | A atividade conseguiu substituir a cadeia de caracteres no arquivo. |
| Falha | A atividade não conseguiu substituir a cadeia de caracteres no arquivo. |
[Tabela 3. Condições para Substituir cadeia de caracteres em arquivo]

{#r_FileReplaceStringActivity__table_bfc_xmk_pw}