노드 사용법 익히기 - 슬립 텍스트 치환(Slip Text Replace) 노드

슬립 텍스트 치환(Slip Text Replace) 노드는 슬립 본문에서 정확히 한 번만 일치하는 텍스트를 찾아 다른 텍스트로 바꾸는 노드입니다.

슬립 필드 수정 노드가 제목·요약·본문을 필드 단위로 통째로 덮어쓰는 노드라면, 슬립 텍스트 치환 노드는 본문 안의 특정 문장이나 단어만 부분적으로 바꾸고 싶을 때 사용하는 노드입니다.

이 튜토리얼에서는 이미 만들어진 슬립의 본문 중 제목 문구 하나를 다른 문구로 치환하는 어빌리티 워크플로를 완성합니다.

왜 "유일하게 일치하는 텍스트"여야 할까요?

이 노드에서 가장 중요한 제약은, old_text로 지정한 텍스트가 슬립 본문 안에서 정확히 한 번만 나타나야 한다는 점입니다. 일치하는 곳이 없거나 두 곳 이상이면 치환은 실패합니다.

예를 들어 슬립 본문에 아래 두 문장이 있다고 가정해봅시다.

이 상태에서 old_text에 에이전트리아라고만 입력하면 어떻게 될까요? "에이전트리아"라는 문자열은 두 문장 모두에 한 번씩, 총 두 번 등장합니다. 노드는 이 중 어느 위치를 바꿔야 할지 판단할 수 없으므로 치환에 실패합니다.

반면 old_text에 에이전트리아를이라고 입력하면, 이 표현은 첫 번째 문장에만 존재하고 본문 전체에서 단 한 번만 나타나므로 정확히 그 위치를 찾아 치환할 수 있습니다.

즉, old_text는 짧고 일반적인 단어보다 앞뒤 문맥을 포함해 본문 전체에서 고유하게 식별되는 표현으로 지정해야 합니다. 또한 old_text는 공백이나 줄바꿈까지 포함해 본문과 글자 그대로 정확히 일치해야 하므로, 대상 슬립의 실제 본문을 확인한 뒤 그대로 복사해 사용하는 것이 안전합니다.

사전 준비

이 튜토리얼을 시작하기 전에 프로젝트에 슬립박스가 구축되어 있고, 수정할 대상 슬립이 이미 만들어져 있어야 합니다.

슬립박스 만들기

슬립박스가 아직 없다면 슬립박스 화면의 +슬립박스 만들기 버튼으로 이름만 입력해 간단히 만들 수 있습니다. 슬립박스 구성 방법은 🔗슬립박스 가이드를 참고하시기 바랍니다.

이 튜토리얼을 완료하면 다음을 수행할 수 있습니다.

1. 슬립 텍스트 치환 노드로 슬립 본문의 특정 텍스트만 부분적으로 치환할 수 있습니다.

2. old_text를 본문 안에서 유일하게 식별되는 텍스트로 지정하는 방법을 이해할 수 있습니다.

3. 슬립 텍스트 치환 노드의 각 입력 변수를 시작 노드의 입력값과 연결할 수 있습니다.

4. 노드 테스트와 실제 슬립 확인으로 치환이 정상적으로 반영됐는지 확인할 수 있습니다.

워크플로 개요

이 튜토리얼의 핵심은 슬립 텍스트 치환 노드입니다.

슬립 텍스트 치환 노드는 대상 슬립의 공개 UUID(slip_public_uuid)로 수정할 슬립을 지정하고, 본문에서 old_text와 정확히 일치하는 부분을 찾아 new_text로 바꿉니다. new_text를 빈 문자열로 두면 일치한 부분을 삭제하는 용도로도 사용할 수 있습니다.

슬립 텍스트 치환 노드 기본 정보

슬립 텍스트 치환 노드는 아래 옵션을 제공합니다.

이 튜토리얼에서는 모든 항목을 사용합니다.

1단계: 어빌리티 생성

새 어빌리티를 생성합니다. 이름에 슬립 텍스트 치환 노드, 설명에 슬립 본문 수정을 입력합니다.

2단계: 시작 노드 설정

시작 노드를 더블 클릭하여 노드 편집기로 진입합니다. String 타입의 변수 세 개를 추가합니다.

• uuid: 치환을 적용할 슬립의 공개 UUID를 입력받습니다.

• old: 교체할 기존 텍스트를 입력받습니다.

• new: 교체할 새 텍스트를 입력받습니다.

3단계: 슬립 텍스트 치환 노드 설정

슬립 텍스트 치환 노드를 더블 클릭하여 노드 편집기로 진입합니다. 슬립박스 공개 UUID에서 수정할 슬립이 속한 슬립박스를 선택합니다.

나머지 항목에는 아래와 같이 시작 노드의 입력값을 드래그 앤 드롭으로 바인딩합니다.

노드가 정상 실행되면 slip_public_uuid, current_version, error_code, error_message를 출력합니다.

4단계: 종료 노드 설정

종료 노드를 더블 클릭하여 노드 편집기로 진입합니다. String 타입의 result 출력변수를 추가하고 슬립 텍스트 치환 노드의 error_code를 드래그 앤 드롭으로 바인딩합니다. result_message 변수도 추가로 선언해 error_message를 바인딩합니다.

5단계: 치환할 슬립의 UUID와 원문 확인

슬립박스에서 치환할 슬립을 열고, 우측 세부 정보 패널에서 페이지 ID 값을 복사해둡니다. 이 값은 노드 테스트에서 uuid 입력값으로 사용합니다.

이때 본문에서 실제로 바꾸고 싶은 텍스트를 눈으로 확인하고, old_text로 사용할 표현이 본문 전체에서 유일하게 식별되는지 미리 확인해두는 것이 좋습니다. 이 튜토리얼에서는 "에이전트리아에 오신 것을 환영합니다"라는 제목 문구를 "에이전트리아란?"으로 치환합니다.

6단계: 노드 테스트 실행

uuid에는 앞서 복사한 슬립의 공개 UUID를, old에는 에이전트리아에 오신 것을 환영합니다를, new에는 에이전트리아란?을 입력하고 테스트 실행(Cmd+Enter)을 클릭합니다.

세 노드가 모두 정상 실행되고, result 출력값으로 SUCCESS가 반환되면 성공입니다.

7단계: 실제 슬립에서 치환 결과 확인

슬립박스로 이동해 해당 슬립을 열어보면, 새 버전이 생성되고 본문의 제목 문구가 에이전트리아란?으로 바뀐 것을 확인할 수 있습니다.

다음 단계

🎉 축하합니다! 에이전트리아를 사용해 '슬립 텍스트 치환' 워크플로를 완성했습니다.

old_text에 슬립 안에서 유일하게 식별되는 표현을 지정하는 원리를 응용하면, 여러 슬립을 순회하며 특정 용어나 링크만 골라 일괄 치환하는 워크플로로도 확장할 수 있습니다.

에이전트리아는 아이디어를 현실로 바꾸는 가능성의 공간입니다.

당신의 상상력으로 워크플로는 무한히 확장될 수 있습니다.

• 더 많은 노드 활용 예제가 궁금하다면 🔗노드 사용법 페이지를 확인하세요.

자주 묻는 질문

슬립 텍스트 치환 노드는 무엇을 하는 노드인가요?

슬립 텍스트 치환 노드는 슬립박스(Slipbox)에 저장된 슬립의 본문에서 지정한 텍스트를 찾아 다른 텍스트로 바꾸는 노드입니다. 대상 슬립을 공개 UUID로 지정하고, old_text와 정확히 일치하는 부분을 new_text로 치환합니다.

왜 old_text가 본문에 정확히 한 번만 나타나야 하나요?

이 노드는 본문 안에서 바꿀 위치를 텍스트 일치만으로 찾기 때문에, old_text가 두 곳 이상에서 발견되면 어느 위치를 바꿔야 할지 판단할 수 없어 치환에 실패합니다. 예를 들어 본문에 "에이전트리아"가 여러 번 등장한다면, "에이전트리아"만으로는 검색이 실패하고 "에이전트리아를"처럼 문맥을 포함해 본문 전체에서 한 번만 나타나는 표현으로 지정해야 합니다.

슬립 텍스트 치환 노드와 슬립 필드 수정 노드는 어떻게 다른가요?

슬립 필드 수정 노드는 제목·요약·본문 같은 필드 전체를 새 값으로 한 번에 교체합니다. 반면 슬립 텍스트 치환 노드는 본문 전체를 바꾸지 않고, 본문 안에서 유일하게 일치하는 특정 문장이나 단어만 부분적으로 바꿉니다. 필드 전체를 새로 쓰고 싶다면 슬립 필드 수정 노드를, 본문의 일부만 고치고 싶다면 슬립 텍스트 치환 노드를 사용합니다.

텍스트를 삭제하고 싶을 때도 이 노드를 사용할 수 있나요?

네, 가능합니다. new_text를 빈 문자열로 두면 old_text와 일치한 부분이 삭제됩니다. 이 경우에도 old_text는 본문 안에서 유일하게 일치해야 합니다.