molamola.log https://velog.io/ Wed, 14 May 2025 00:51:57 GMT https://validator.w3.org/feed/docs/rss2.html https://github.com/jpmonette/feed molamola.log https://velog.velcdn.com/images/hwan2-dev/profile/c6930498-3847-4a32-bbb0-4658635a882e/image.png https://velog.io/ Copyright (C) 2019. molamola.log. All rights reserved. <![CDATA[Salesforce OAuth 2.0 Access Token 획득 방식 총정리]]> https://velog.io/@hwan2-dev/Salesforce-OAuth-2.0-Access-Token-%ED%9A%8D%EB%93%9D-%EB%B0%A9%EC%8B%9D-%EC%B4%9D%EC%A0%95%EB%A6%AC https://velog.io/@hwan2-dev/Salesforce-OAuth-2.0-Access-Token-%ED%9A%8D%EB%93%9D-%EB%B0%A9%EC%8B%9D-%EC%B4%9D%EC%A0%95%EB%A6%AC Wed, 14 May 2025 00:51:57 GMT Salesforce API와 통합하기 위해서는 가장 먼저 Access Token을 발급받아야 합니다. Salesforce는 OAuth 2.0 표준을 따르며, 다양한 인증 방식(Grant Type)을 제공합니다.

✅ OAuth 2.0 Access Token이란?

Access Token은 Salesforce에 API 요청을 보낼 수 있게 해주는 인증된 키입니다. 하지만 이 토큰은 사용자 인증 방식에 따라 얻는 방법이 다르며, 단기 또는 장기 세션 유지 여부에도 영향을 줍니다.

📦 Salesforce OAuth 2.0 인증 방식 정리

인증 방식 (Grant Type) 설명 Refresh Token 사용자 로그인 필요 사용 예시
authorization_code 사용자가 로그인하여 승인 코드를 받아 토큰 발급 ✅ 지원 ✅ Web App
password 사용자 ID, PW 직접 입력 ✅ (조건부) ❌ 백오피스, 테스트
client_credentials 앱 자체 인증 (M2M) ❌ ❌ 백엔드 to Salesforce
jwt_bearer JWT로 서명된 토큰으로 인증 ❌ ❌ 서버 자동화, CI/CD
device_code 디바이스에서 브라우저 없는 인증 ✅ ✅ IoT, TV 앱 등
refresh_token 기존 토큰으로 새 토큰 재발급 🔁 ❌ 세션 연장
saml2-bearer SAML 기반의 인증 연동 ❌ ❌ SSO 시스템

🔍 주요 인증 방식 자세히 보기

1️⃣ Authorization Code Flow (authorization_code)

사용자 로그인을 통해 Salesforce가 승인 코드를 발급 → 이를 통해 Access Token 획득

특징:

  • 가장 안전하고 표준적인 방식
  • 사용자 인증이 필요
  • refresh_token도 함께 받을 수 있어 장기 세션 유지 가능

사용 예시:

  • Salesforce를 연동하는 웹앱
  • 마케팅/고객 관리 SaaS

2️⃣ Username-Password Flow (password)

사용자 ID, 비밀번호, 보안 토큰을 직접 입력하여 Access Token 발급

특징:

  • 로그인 UI 없이 토큰 발급 가능
  • 보안상 위험도가 높아 실제 서비스에서는 권장되지 않음
  • refresh_token 발급은 Connected App 설정에 따라 가능

사용 예시:

  • 테스트 자동화
  • 내부 관리툴

3️⃣ Client Credentials Flow (client_credentials)

앱 자체가 Salesforce 리소스에 접근할 수 있도록 인증 (사용자 없음)

특징:

  • Machine-to-Machine 인증
  • 사용자 개입 없이 서버 간 통신
  • refresh_token 없음

사용 예시:

  • 서버 백엔드에서 Salesforce 데이터를 주기적으로 조회

주의:

  • Salesforce에서는 이 Flow를 사용하려면 Connected App에서 Client Credentials Flow 허용 + 사용자 연결 필요

4️⃣ JWT Bearer Flow (jwt_bearer)

사전에 등록된 사용자와 비밀 키를 사용하여 서명된 JWT를 제출 → Access Token 발급

특징:

  • 사용자 로그인 없이 무인 인증 가능
  • refresh_token 없음
  • 고도화된 자동화/보안에 적합

사용 예시:

  • CI/CD 파이프라인
  • 서버-to-Salesforce 인증 연동

5️⃣ Device Flow (device_code)

디바이스(예: TV, 콘솔)에서 브라우저 없이 인증 수행

특징:

  • 사용자 브라우저에서 인증 진행
  • 디바이스는 승인 여부만 폴링
  • refresh_token 발급 가능

사용 예시:

  • POS, IoT, 터치스크린 등에서 Salesforce 인증

6️⃣ Refresh Token Flow (refresh_token)

기존에 받은 Refresh Token을 사용하여 새 Access Token을 재발급

특징:

  • 사용자가 다시 로그인하지 않아도 됨
  • 자동 로그인/세션 유지에 필수

사용 예시:

  • 모바일 앱의 자동 로그인
  • 토큰 만료 후 자동 재인증

🧭 어떤 Flow를 써야 할까?

사용 환경 추천 Flow
웹/프론트엔드 앱 authorization_code
내부 관리자용 툴 password (단, 주의)
CI/CD 서버, 배치 작업 jwt_bearer
백엔드 서비스 (M2M) client_credentials
IoT/디바이스 앱 device_code

✅ Refresh Token 지원 여부 정리

Grant Type Refresh Token 지원
authorization_code ✔️ 지원
password ✔️ 조건부
device_code ✔️ 지원
jwt_bearer ❌
client_credentials ❌

🚨 참고: Connected App 설정에 따라 영향 받는 항목

  • refresh_token 발급 여부 → OAuth Scopes에 offline_access 필수
  • password flow 허용 여부 → "Permitted Users" 설정 필요
  • client_credentials flow 사용 시 → 사용자 연결 필요

🔚 마무리

Salesforce OAuth 2.0은 강력하지만 복잡합니다. 각 Flow는 사용 환경과 보안 요구사항에 따라 신중하게 선택해야 합니다. 가장 일반적이고 권장되는 방식은 authorization_code이며, 자동화나 서버 작업에는 jwt_bearer가 탁월한 선택이 될 수 있습니다.

]]> <![CDATA[Salesforce REST API – HTTP 메서드 정리]]> https://velog.io/@hwan2-dev/Salesforce-REST-API-HTTP-%EB%A9%94%EC%84%9C%EB%93%9C-%EC%A0%95%EB%A6%AC https://velog.io/@hwan2-dev/Salesforce-REST-API-HTTP-%EB%A9%94%EC%84%9C%EB%93%9C-%EC%A0%95%EB%A6%AC Mon, 12 May 2025 05:26:26 GMT Salesforce에서는 REST API를 통해 오브젝트를 생성, 조회, 수정, 삭제하는 다양한 HTTP 메서드를 제공합니다.
또한 Upsert라는 매우 강력한 기능도 함께 지원되며, 외부 시스템과의 연동에 유용하게 사용됩니다.

✅ 1. GET – 데이터 조회

항목 설명
목적 오브젝트 또는 레코드의 데이터를 조회할 때 사용
예시 1 /sobjects/Account/001Hu00000ABC123 → 특정 Account 조회
예시 2 /query?q=SELECT+Name+FROM+Account → SOQL 쿼리 실행
응답 JSON 형식의 레코드 정보 반환

✅ 2. POST – 레코드 생성

항목 설명
목적 새 레코드 생성
예시 /sobjects/Account
Body:
```json
{
"Name": "New Company"
}
````

| 응답 | 생성된 레코드 ID 반환 |

✅ 3. PATCH – 레코드 수정 & Upsert

🔹 기본 사용 (수정)

항목 설명
목적 기존 레코드의 일부 필드만 수정
예시 /sobjects/Account/001Hu00000ABC123
특징 전체가 아닌 일부 필드만 전송 가능 (PATCH는 PUT보다 유연함)

🔹 Upsert (존재하면 수정, 없으면 생성)

PATCH 요청에 External ID 필드 기반 경로를 사용하면 Upsert가 동작합니다.

예시 
PATCH /services/data/v58.0/sobjects/Order__c/External_Order_Id__c/ORD-001
{
  "Status__c": "Confirmed",
  "AccountId": "001Hu00000XXXXXX"
}
  • External_Order_Id__c = 'ORD-001'인 레코드가 있으면 수정
  • 없으면 새로 생성

❗ Upsert 시 주의사항: External ID 필드 필수

Upsert 시 경로에 사용되는 필드는 반드시 External ID로 지정된 필드여야 합니다.

✅ External ID란?

  • Salesforce가 레코드를 식별하기 위해 사용하는 필드
  • 오브젝트 설정에서 필드 생성 또는 수정 시 체크 가능
  • Text, Number, Email 타입만 가능

✅ 사용 가능한 필드 타입

타입 External ID 지정 가능
Text ✅
Number ✅
Email ✅
Lookup, Picklist, Date 등 ❌

❌ 일반 필드로는 Upsert 불가

예:

PATCH /sobjects/Order__c/OrderNumber__c/ORD001

→ ❌ 실패 (OrderNumber__c가 External ID가 아니면 사용 불가)

✅ 4. DELETE – 레코드 삭제

항목 설명
목적 레코드 삭제
예시 /sobjects/Account/001Hu00000ABC123
응답 상태 코드 204 (No Content) 반환

✅ 5. PUT – 전체 덮어쓰기 (잘 안 씀)

항목 설명
목적 전체 레코드 교체
Salesforce에서는 거의 사용되지 않음. 대부분 PATCH로 처리

✅ 기타 기능

기능 경로
SOQL 쿼리 실행 /query?q=SELECT+Name+FROM+Account
SOSL 검색 /search?q=FIND+{John}
오브젝트 정보 조회 /sobjects/Account/describe
오브젝트 목록 /sobjects

🔐 인증 방식 요약

방식 설명
OAuth 2.0 Authorization Code 사용자 로그인 기반
OAuth 2.0 Client Credentials 백엔드 시스템 간 통신용
Username-Password Flow 테스트/비추천 (보안상 취약)

📌 전체 요약표

메서드 기능 특징
GET 조회 쿼리 또는 ID 기반 조회
POST 생성 새 레코드 삽입
PATCH 수정 / Upsert 일부 필드 수정 / External ID 기반 Upsert
DELETE 삭제 레코드 제거
PUT 전체 수정 거의 안 씀

🧠 정리

  • PATCH + External ID 경로를 사용하면 Upsert 가능
  • 일반 필드는 Upsert에 사용할 수 없음
  • External ID는 반드시 Text / Number / Email 필드에 직접 지정해야 함
  • API 통합 시 외부 시스템의 고유 ID를 External ID로 맞추는 것이 매우 중요
]]> <![CDATA[Java Exception & Error 정리 총정리]]> https://velog.io/@hwan2-dev/Java-Exception-Error-%EC%A0%95%EB%A6%AC-%EC%B4%9D%EC%A0%95%EB%A6%AC https://velog.io/@hwan2-dev/Java-Exception-Error-%EC%A0%95%EB%A6%AC-%EC%B4%9D%EC%A0%95%EB%A6%AC Fri, 02 May 2025 02:09:52 GMT Java의 예외(Exception)와 오류(Error)는 모두 Throwable 클래스를 상속받으며, 프로그램 실행 중 발생할 수 있는 비정상적인 상황을 처리하기 위해 사용됩니다.

📚 전체 계층 구조

Throwable
├── Exception (예외)
│   ├── CheckedException (체크 예외)
│   └── UncheckedException (언체크 예외, RuntimeException)
└── Error (오류 - 시스템/VM 레벨)

✅ Exception (예외)

1. Checked Exception (컴파일러가 반드시 처리 요구)

예외 클래스 설명
IOException 입출력 실패 또는 인터럽트 (파일, 네트워크 등)
FileNotFoundException 지정한 파일을 찾을 수 없음
SQLException DB 작업 도중 발생하는 예외
ParseException 날짜/시간 파싱 오류
ClassNotFoundException 클래스 로딩 실패
InterruptedException 스레드가 인터럽트됨
NoSuchMethodException 지정한 메서드가 존재하지 않음
InstantiationException 클래스 인스턴스화 실패

✔ try-catch 또는 throws 선언 필요

2. Unchecked Exception (= RuntimeException 하위 클래스)

예외 클래스 설명
NullPointerException null 객체 접근 시 발생
IllegalArgumentException 잘못된 매개변수 전달 시
IndexOutOfBoundsException 인덱스 초과 접근 시
NumberFormatException 숫자 형식이 잘못됐을 때
ArithmeticException 산술 오류 (예: 0으로 나누기)
IllegalStateException 잘못된 상태에서 메서드 호출 시
ClassCastException 잘못된 타입 변환 시
UnsupportedOperationException 구현되지 않은 기능 호출 시

❗ 예외 처리 선택 가능 (throws 없이 사용 가능)

❌ Error (오류 - 거의 처리하지 않음)

오류 클래스 설명
OutOfMemoryError JVM의 메모리 부족
StackOverflowError 스택 오버플로우 (무한 재귀 등)
VirtualMachineError JVM 내부 문제 발생
NoClassDefFoundError 클래스 정의를 찾을 수 없음
InternalError JVM 내부 오류
ThreadDeath 스레드 강제 종료

❌ 대부분 try-catch로 처리하지 않고, JVM이 종료되거나 복구 불가 상황

🧠 Exception vs Error vs Throwable 차이

항목 Throwable Exception Error
정의 예외/오류의 최상위 클래스 개발자가 처리 가능한 예외 시스템 수준의 치명적 오류
사용 목적 예외나 오류 포괄적 처리 로직 오류/외부 문제 처리 시스템/메모리 문제 대응
예외 처리 강제 여부 - Checked는 강제, Unchecked는 선택 거의 처리하지 않음
예시 - IOException, NullPointerException OutOfMemoryError

📌 실무에서의 사용 팁

  • 외부 환경(DB, 파일, API 등): Checked Exception → 반드시 처리
  • 내부 로직/개발 실수: Unchecked Exception → 가독성 위해 선택적 처리
  • 시스템 오류: Error → 복구 불가, 보통 로그만 남기고 종료

📎 자주 사용하는 처리 방식

try {
    FileReader reader = new FileReader("data.txt");
} catch (FileNotFoundException e) {
    System.err.println("파일을 찾을 수 없습니다: " + e.getMessage());
}

📘 마무리

자바에서 예외는 단순히 "오류"가 아니라 정상적인 흐름을 벗어난 상태를 통제하기 위한 메커니즘입니다. 예외를 잘 이해하고 적절히 처리하면, 프로그램의 안정성과 유지보수성이 훨씬 향상됩니다.

]]> <![CDATA[Spring Boot 테스트 시 로그인 페이지가 나올 때 (Postman 인증 문제 해결법)]]> https://velog.io/@hwan2-dev/Spring-Boot-%ED%85%8C%EC%8A%A4%ED%8A%B8-%EC%8B%9C-%EB%A1%9C%EA%B7%B8%EC%9D%B8-%ED%8E%98%EC%9D%B4%EC%A7%80%EA%B0%80-%EB%82%98%EC%98%AC-%EB%95%8C-Postman-%EC%9D%B8%EC%A6%9D-%EB%AC%B8%EC%A0%9C-%ED%95%B4%EA%B2%B0%EB%B2%95 https://velog.io/@hwan2-dev/Spring-Boot-%ED%85%8C%EC%8A%A4%ED%8A%B8-%EC%8B%9C-%EB%A1%9C%EA%B7%B8%EC%9D%B8-%ED%8E%98%EC%9D%B4%EC%A7%80%EA%B0%80-%EB%82%98%EC%98%AC-%EB%95%8C-Postman-%EC%9D%B8%EC%A6%9D-%EB%AC%B8%EC%A0%9C-%ED%95%B4%EA%B2%B0%EB%B2%95 Wed, 30 Apr 2025 02:16:52 GMT 최근에 Spring Boot로 Webhook API를 만들고, Postman을 이용해 아래와 같이 테스트를 진행했습니다.

POST http://localhost:8001/webhook/save?param=hello

그런데 응답 결과가 의외였습니다:

<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="utf-8">
    <title>Please sign in</title>
    ...
  </head>
  <body>
    <h2>Login with OAuth 2.0</h2>
  </body>
</html>

Spring Boot 프로젝트에서 REST API를 만들었는데, 갑자기 로그인 페이지?

📌 원인

이건 Spring Boot에서 spring-boot-starter-security 또는 spring-boot-starter-oauth2-client를 사용 중일 때 발생하는 기본 동작입니다.

  • Spring Security는 기본적으로 모든 요청에 인증을 요구합니다.
  • Postman이나 외부 요청이 인증되지 않은 상태로 들어오면 → 자동으로 로그인 페이지를 반환합니다.

🛠 해결 방법: Security 설정 커스터마이징

이 문제를 해결하려면 특정 엔드포인트(/webhook/**)는 인증 없이 접근할 수 있도록 SecurityFilterChain을 설정해야 합니다.

✅ 예제 코드: 모든 요청 허용

@Configuration
public class SecurityConfig {

    @Bean
    public SecurityFilterChain securityFilterChain(HttpSecurity http) throws Exception {
        http
            .csrf().disable() // 테스트용으로만 사용! 운영 시 주의
            .authorizeHttpRequests()
                .anyRequest().permitAll(); // 모든 요청을 인증 없이 허용
        return http.build();
    }
}

✅ 일부 경로만 허용 (예: /webhook/**)

@Configuration
public class SecurityConfig {

    @Bean
    public SecurityFilterChain securityFilterChain(HttpSecurity http) throws Exception {
        http
            .csrf().disable()
            .authorizeHttpRequests()
                .requestMatchers("/webhook/**").permitAll()
                .anyRequest().authenticated();
        return http.build();
    }
}

⚠ 주의사항

  • csrf().disable()은 POST 요청을 테스트용으로만 허용할 때 사용하는 설정입니다.
  • 운영환경에서는 보안을 강화하기 위해 CSRF 보호나 세션 관리 정책도 함께 설정해줘야 합니다.

✅ 결론

Spring Boot에 보안 의존성이 포함되면, Postman이나 외부 시스템에서 API를 호출할 때 기본 로그인 페이지 응답이 나올 수 있습니다.
이 문제는 SecurityFilterChain 설정으로 간단하게 해결할 수 있으니, 개발 초기에는 필수로 설정해두는 걸 추천합니다.

]]> <![CDATA[Flask란 무엇인가? 설치부터 실행까지 쉽게 정리!]]> https://velog.io/@hwan2-dev/Flask%EB%9E%80-%EB%AC%B4%EC%97%87%EC%9D%B8%EA%B0%80-%EC%84%A4%EC%B9%98%EB%B6%80%ED%84%B0-%EC%8B%A4%ED%96%89%EA%B9%8C%EC%A7%80-%EC%89%BD%EA%B2%8C-%EC%A0%95%EB%A6%AC https://velog.io/@hwan2-dev/Flask%EB%9E%80-%EB%AC%B4%EC%97%87%EC%9D%B8%EA%B0%80-%EC%84%A4%EC%B9%98%EB%B6%80%ED%84%B0-%EC%8B%A4%ED%96%89%EA%B9%8C%EC%A7%80-%EC%89%BD%EA%B2%8C-%EC%A0%95%EB%A6%AC Tue, 29 Apr 2025 00:39:12 GMT ✅ Flask란?

Flask는 파이썬으로 만든 아주 가벼운 웹 서버 프레임워크입니다.
몇 줄 코드만으로 빠르게 웹 서버나 API를 만들 수 있게 도와줍니다.

  • 가볍고 빠른 웹 프레임워크
  • 복잡한 설정 없이 바로 실행 가능
  • 학습용, 실습용, 소규모 프로젝트에 최적

✅ Flask 설치 방법

1. Python 설치

  • Python 3.x 버전을 설치합니다.
  • 설치할 때 "Add Python to PATH" 옵션을 꼭 체크하세요.

2. pip로 Flask 설치

터미널(명령어창)에서 아래 명령어를 입력합니다.

pip install flask

✅ 이 명령어 한 줄로 Flask 설치 완료!

✅ Flask 기본 서버 만들기

1. app.py 파일 생성

아래처럼 코드를 작성합니다.

from flask import Flask

app = Flask(__name__)

@app.route('/')
def hello():
    return "Hello, Flask!"

if __name__ == '__main__':
    app.run(port=5000)
  • / 주소로 접속하면 "Hello, Flask!"를 보여줍니다.

✅ Flask 서버 실행 방법

터미널에서 app.py가 있는 폴더로 이동한 뒤, 실행합니다.

python app.py

성공적으로 실행되면 다음과 같은 메시지가 뜹니다.

* Running on http://127.0.0.1:5000/

브라우저에서 http://localhost:5000에 접속하면
"Hello, Flask!" 라는 문구를 볼 수 있습니다!

✅ Flask 서버 종료 방법

  • 터미널 창에서 CTRL + C를 눌러 서버를 종료합니다.

✅ Flask 특징 정리

항목 설명
초간단 서버 파일 하나로 웹 서버 만들기 가능
빠른 개발 코드 수정 → 바로 실행
경량 프레임워크 필요한 기능만 최소한으로 제공
확장성 필요시 데이터베이스, 인증 등 추가 가능

✅ Flask로 할 수 있는 것

  • Webhook 요청 받는 서버 만들기
  • REST API 서버 만들기
  • 간단한 개인 웹사이트 개발
  • 프로젝트용 백엔드 서버 구축
]]> <![CDATA[[Salesforce] LWC에서 사용하는 어노테이션 완전 정복]]> https://velog.io/@hwan2-dev/Salesforce-LWC%EC%97%90%EC%84%9C-%EC%82%AC%EC%9A%A9%ED%95%98%EB%8A%94-%EC%96%B4%EB%85%B8%ED%85%8C%EC%9D%B4%EC%85%98-%EC%99%84%EC%A0%84-%EC%A0%95 https://velog.io/@hwan2-dev/Salesforce-LWC%EC%97%90%EC%84%9C-%EC%82%AC%EC%9A%A9%ED%95%98%EB%8A%94-%EC%96%B4%EB%85%B8%ED%85%8C%EC%9D%B4%EC%85%98-%EC%99%84%EC%A0%84-%EC%A0%95 Thu, 24 Apr 2025 09:02:27 GMT Lightning Web Components(LWC)에서는 JavaScript 상단에서 사용하는 특수한 어노테이션들을 데코레이터(Decorator)라고 부릅니다.
이 데코레이터들은 Salesforce 플랫폼과의 연동, 데이터 바인딩, 컴포넌트 통신 등에 중요한 역할을 합니다.

이 글에서는 LWC에서 사용 가능한 모든 데코레이터를 깔끔하게 정리했습니다.

✅ 1. @api

항목 설명
역할 공개 속성(Public Property) 또는 메서드로 외부 컴포넌트(LWC, Aura)에서 접근 가능하게 만듦
주 사용 위치 부모 → 자식 컴포넌트 간 데이터 전달
사용 대상 변수, 메서드
예시 용도 부모가 자식 컴포넌트에 데이터를 전달하거나 메서드를 직접 호출할 때 사용

✅ 2. @track (⚠️ Deprecated)

항목 설명
역할 컴포넌트 내에서 반응형 상태 추적(리액티브) 을 위해 사용되던 속성
현재 상태 ⚠️ 최신 버전에서는 대부분 자동 추적됨. 객체/배열의 일부 요소만 업데이트할 경우에만 필요
사용 대상 변수

✅ 3. @wire

항목 설명
역할 Apex, Lightning Data Service, Platform Resource 등에서 데이터를 자동으로 가져오는 바인딩 방식
특징 자동 호출 + 자동 반응형 처리
사용 대상 Apex 메서드, LDS 객체, Schema 등
예시 용도 Apex에서 @AuraEnabled(cacheable=true) 메서드를 가져와 LWC에 자동 연결

✅ 4. @readonly (내부용, 공식 지원 X)

항목 설명
상태 과거 일부 컴포넌트 라이브러리 내부에서만 사용되던 비공식 데코레이터
일반 개발자 사용 여부 ❌ 지원되지 않으며 일반적으로 사용할 필요 없음

✅ 5. @track vs 일반 변수 (비교)

속성 설명
일반 변수 LWC는 대부분의 변수 변경을 자동 감지함
@track 배열/객체의 일부 속성 변경을 감지시키고 싶을 때 수동으로 지정
예외 케이스 this.data.name = 'abc' 처럼 객체의 내부만 변경하는 경우 @track 필요할 수 있음 (구버전 기준)

⚠️ 사용 시 주의사항

데코레이터 주의사항
@api 부모가 접근하는 속성/메서드는 꼭 @api로 선언되어야 함
@wire 사용하려는 Apex 메서드는 반드시 @AuraEnabled(cacheable=true) 설정 필요
@track LWC의 최신 버전에서는 대부분의 상태 추적이 자동화됨 → 특별한 경우에만 사용

✅ 요약 표

데코레이터 역할 대상 비고
@api 외부 접근 가능 속성/메서드 변수, 메서드 부모 → 자식 통신
@wire 데이터 바인딩 (Apex, LDS) 변수, 메서드 자동 호출 + 자동 반응형
@track 객체/배열 내부 속성 추적 변수 최신 버전에서는 거의 불필요
(비공식) @readonly 내부용 변수 사용 비권장, 공식 미지원

✨ 마무리

LWC는 React나 Vue처럼 반응형 프론트엔드 개발을 가능하게 해주는 컴포넌트 기반 프레임워크입니다.
여기서 사용하는 데코레이터들은 Salesforce의 서버(Apex), UI, 컴포넌트 간 통신을 부드럽게 연결해주는 핵심 역할을 합니다.

정확한 의미와 사용 목적을 이해하면, 더 유연하고 강력한 LWC 컴포넌트를 만들 수 있습니다.

]]> <![CDATA[[Salesforce] Apex 어노테이션 완전 정리]]> https://velog.io/@hwan2-dev/Salesforce-Apex-%EC%96%B4%EB%85%B8%ED%85%8C%EC%9D%B4%EC%85%98-%EC%99%84%EC%A0%84-%EC%A0%95%EB%A6%AC https://velog.io/@hwan2-dev/Salesforce-Apex-%EC%96%B4%EB%85%B8%ED%85%8C%EC%9D%B4%EC%85%98-%EC%99%84%EC%A0%84-%EC%A0%95%EB%A6%AC Thu, 24 Apr 2025 08:59:34 GMT 🔖 Salesforce Apex 어노테이션 완전 정리

Apex에서 어노테이션은 클래스, 메서드, 변수 등에 특정한 역할이나 실행 조건을 지정해주는 메타정보입니다.
이 글에서는 Salesforce Apex에서 사용할 수 있는 모든 어노테이션을 분류별로 깔끔하게 정리했습니다.

✅ 1. LWC / Aura 통신용

어노테이션 설명
@AuraEnabled Apex 메서드나 변수에 Aura 또는 LWC에서 접근 가능하게 함
@AuraEnabled(cacheable=true) 클라이언트 측 캐싱을 허용함 (@wire 방식에서만 사용 가능)

✅ 2. Flow 통합용

어노테이션 설명
@InvocableMethod Flow에서 호출 가능한 Apex 메서드로 선언
@InvocableVariable Flow에서 접근 가능한 변수로 선언

✅ 3. 비동기/배치 관련

어노테이션 설명
@future 메서드를 비동기 처리 (즉시 반환, 서버에서 나중에 실행됨)
@Reentrancy Flow 또는 프로세스에서 재진입 허용을 명시 (동시성 충돌 방지)

✅ 4. 테스트 전용

어노테이션 설명
@isTest 테스트 전용 클래스 또는 메서드로 지정
@testSetup 테스트 실행 전 공통 셋업 데이터를 구성하는 메서드
@TestVisible private 변수나 메서드를 테스트 클래스에서 접근 가능하게 함

✅ 5. REST API / Visualforce 연동

어노테이션 설명
@RemoteAction Visualforce에서 Apex 메서드를 Ajax로 호출 가능하게 함
@RestResource Apex 클래스를 REST API 엔드포인트로 공개함
@HttpGet / @HttpPost / @HttpPatch / @HttpDelete REST API 메서드에서 HTTP 동작을 매핑함 (@RestResource 내부에서 사용됨)

✅ 6. 보안 / 성능 제어

어노테이션 설명
@ReadOnly 트랜잭션을 읽기 전용으로 제한 (조회 성능 향상, 대용량 조회용)
@NamespaceAccessible Managed Package 외부에서도 클래스/메서드 접근 가능하게 설정
@Deprecated 더 이상 사용하지 말아야 할 항목으로 표시 (경고만, 실행은 가능)

✅ 7. JSON 직렬화

어노테이션 설명
@JsonAccess JSON 직렬화/역직렬화 시 특정 변수 포함 여부 지정 (실사용 빈도 낮음)

✅ 부가적인 메모

어노테이션 상태
@WithSharing / @WithoutSharing 공유 설정 제어용 키워드 (@ 없이 사용되지만 어노테이션처럼 보일 수 있음)
@codeCoverageIgnore 비공식 테스트 커버리지 제외 표시 (공식 Apex에는 없음)

✅ 정리 요약

분류 대표 어노테이션
LWC 연동 @AuraEnabled
Flow 연동 @InvocableMethod, @InvocableVariable
비동기 처리 @future, @Reentrancy
테스트용 @isTest, @testSetup, @TestVisible
API 연동 @RestResource, @RemoteAction, @Http*
성능/보안 @ReadOnly, @NamespaceAccessible, @Deprecated

✨ 마무리

Salesforce Apex에서 어노테이션은 단순히 코드의 부가기능이 아닌, 플랫폼과 완벽하게 통합되도록 돕는 핵심 요소입니다.
LWC, Flow, Visualforce, REST API 등 Salesforce의 다양한 계층과 연결되는 만큼, 각각의 어노테이션 목적을 명확히 이해해두면 훨씬 강력한 Apex 개발자가 될 수 있습니다.

]]> <![CDATA[[개발] DOM이란? 웹 개발자를 위한 완벽 정리]]> https://velog.io/@hwan2-dev/%EA%B0%9C%EB%B0%9C-DOM%EC%9D%B4%EB%9E%80-%EC%9B%B9-%EA%B0%9C%EB%B0%9C%EC%9E%90%EB%A5%BC-%EC%9C%84%ED%95%9C-%EC%99%84%EB%B2%BD-%EC%A0%95%EB%A6%AC https://velog.io/@hwan2-dev/%EA%B0%9C%EB%B0%9C-DOM%EC%9D%B4%EB%9E%80-%EC%9B%B9-%EA%B0%9C%EB%B0%9C%EC%9E%90%EB%A5%BC-%EC%9C%84%ED%95%9C-%EC%99%84%EB%B2%BD-%EC%A0%95%EB%A6%AC Thu, 24 Apr 2025 07:51:49 GMT 웹 개발을 하다 보면 DOM이라는 단어를 자주 듣게 됩니다.
HTML을 작성할 때도, JavaScript로 버튼을 눌렀을 때 무언가를 바꿀 때도 사실 우리는 DOM을 다루고 있습니다.

이 글에서는 DOM이 무엇인지, 왜 필요한지, 그리고 어떻게 동작하는지 쉽고 명확하게 정리합니다.

✅ DOM이란?

DOM (Document Object Model)은 웹 페이지를 트리 형태로 구조화한 객체 모델입니다.

간단히 말해서:

  • HTML 문서를 브라우저가 이해할 수 있는 객체(오브젝트) 구조로 만든 것입니다.
  • JavaScript로 쉽게 조작할 수 있게 해줍니다.

📄 HTML → DOM 변환 예시

HTML 문서가 있으면:

<html>
  <body>
    <h1>Hello</h1>
    <p>Welcome to my website.</p>
  </body>
</html>

브라우저는 이걸 내부적으로 다음처럼 구조화합니다:

Document
 └── html
      └── body
          ├── h1
          │    └── "Hello"
          └── p
               └── "Welcome to my website."

✨ 이 구조가 바로 DOM 트리입니다.

🔧 DOM 조작 예시

JavaScript를 통해 DOM을 조작할 수 있습니다.

document.querySelector('h1').textContent = 'Hi there!';
  • h1 요소를 선택하고
  • 그 안의 텍스트를 "Hi there!"로 변경하는 코드입니다.

➡️ 사용자가 보는 화면이 즉시 업데이트 됩니다.

🧠 DOM을 왜 써야 할까?

이유 설명
브라우저와 소통 브라우저가 화면에 표시하는 모든 것은 DOM을 통해 제어됨
인터랙티브 웹 구현 버튼 클릭, 데이터 입력 등 사용자 액션에 반응하려면 DOM을 조작해야 함
UI 변경 DOM 조작으로 화면 내용을 동적으로 수정 가능

⚙️ DOM 관련 주요 용어

용어 설명
Document 현재 웹 페이지 전체를 대표하는 객체
Element HTML 요소 (div, p, h1 등) 하나하나
Node DOM 트리의 모든 점 (텍스트, 태그, 속성 등 포함)
Parent/Child DOM은 부모-자식 관계로 연결된 트리 구조

📦 DOM과 현대 프레임워크

React, Vue, LWC 같은 현대적인 프론트엔드 프레임워크들은 DOM을 더 효율적으로 다루기 위해 등장했습니다.

  • Virtual DOM: 실제 DOM에 바로 적용하지 않고 메모리상 가상 DOM에서 먼저 비교하고 최적화하여 적용
  • Shadow DOM: 컴포넌트 단위로 독립된 DOM 영역을 생성해서 외부로부터 격리

➡️ 결국, 모두 DOM 조작을 효율적으로 하려는 것입니다.

✨ 요약

항목 설명
DOM이란? HTML을 브라우저가 이해하고 조작할 수 있게 만든 트리 구조
왜 필요? 웹 페이지를 동적으로 수정하거나 사용자 입력에 반응하기 위해
어떻게 쓰나? JavaScript로 요소를 선택하고 수정
현대 프레임워크와의 관계 DOM을 더 빠르고 효율적으로 다루기 위한 기술 (Virtual DOM, Shadow DOM 등)

#태그
#DOM #웹개발 #프론트엔드 #JavaScript #HTML #LWC

]]> <![CDATA[[VS Code] Salesforce Playground + VS Code 연결 방법]]> https://velog.io/@hwan2-dev/VS-Code-Salesforce-Playground-VS-Code-%EC%97%B0%EA%B2%B0-%EB%B0%A9%EB%B2%95 https://velog.io/@hwan2-dev/VS-Code-Salesforce-Playground-VS-Code-%EC%97%B0%EA%B2%B0-%EB%B0%A9%EB%B2%95 Thu, 24 Apr 2025 07:15:46 GMT

  • 플레이 그라운드를 생성한다.

  • Setup -> Users -> Users 들어간다.

  • 본인 계정을 클릭한다.

  • User Detail 에서 Reset Password 를 누른다. 그러면 등록된 이메일로 메일이 보내진다. 거기서 비밀번호 설정하면 됨.

  • 만약 메일이 오지 않는다면 해당 유저를 다시 들어가면 Reset Password 버튼이 Change Password 로 바뀌어있을거임. 그거 누르고 새 비밀번호 설정하면 됨.

  • VS Code 에서 Authorize an Org 해서 해당 계정으로 로그인하면 됨.

    • 끝.

    ]]>         <![CDATA[[VS Code] Salesforce LWC 에서 Jest 사용 방법]]> https://velog.io/@hwan2-dev/VS-Code-Salesforce-LWC-%EC%97%90%EC%84%9C-Jest-%EC%82%AC%EC%9A%A9-%EB%B0%A9%EB%B2%95 https://velog.io/@hwan2-dev/VS-Code-Salesforce-LWC-%EC%97%90%EC%84%9C-Jest-%EC%82%AC%EC%9A%A9-%EB%B0%A9%EB%B2%95 Thu, 24 Apr 2025 05:33:55 GMT VS Code 에서 JS 파일을 테스트 하는 방법

    우선 Node.js가 있어야 함. Node.js 가 없다면 설치하고 오시오.

    그 다음 npm으로 해당 프로젝트에 Jest 를 위한 라이브러리를 설치한다.

    ✅ 전체 명령어:

    npm install --save-dev sfdx-lwc-jest

    💡 해석:

    npm install

    → sfdx-lwc-jest라는 npm 패키지를 설치하겠다

    --save-dev

    → 이 패키지를 개발할 때만 필요한 도구(devDependency)로 설치하겠다

    ✅ 그럼 --save-dev는 왜 쓰는 건가?

    📦 --save-dev로 설치한 패키지는:

    • package.json의 "devDependencies"에 등록됨
    • 배포할 때 포함되지 않음
    • 예: 테스트 도구, 빌드 도구, 린터, 번들러 등

    ✅ 반대로 --save는?

    • (요즘은 생략 가능)
    • "dependencies"에 등록됨
    • 실제 서비스 구동에도 필요한 라이브러리용
    구분 쓰임 예시
    --save-dev 개발 전용 도구 Jest, ESLint, Webpack 등
    --save or 생략 앱에서 직접 쓰는 라이브러리 React, Axios 등

    🔍 예시: package.json에 반영되는 모습

    "devDependencies": {
  "sfdx-lwc-jest": "^12.0.0"
}

    이렇게 되면 다른 개발자들도 npm install 한 번이면 자동 설치되니까 협업에도 좋아요.

    🔧 요약 정리

    명령어 의미
    npm install 모듈 설치
    --save-dev 개발용으로만 쓰겠다는 뜻
    sfdx-lwc-jest Salesforce LWC 유닛 테스트 도구

    이렇게 설치를 하면 테스트 할 수 있는 라이브러리 준비는 끝이다.

    테스트 방법은 다음과 같다.

    방법 1. LWC 폴더에 __tests__ 폴더가 있다. 그 안에 있는 파일명.test.js 파일을 들어가서 sum.js 를 불러와서 해당 js 안에 sum() 이라는 함수를 테스트하는 과정이다. 회색 글씨로 Run Test 있는데 저걸 클릭하면 알아서 테스트를 진행한다.

    방법 2. 터미널 명령어로 npm run test:unit 을 치면 프로젝트에 있는 모든 .test.js 파일이 테스트 실행한다. 그래서 해당 방법으로 특정 .test.js 만 실행하고 싶다면 저렇게 "test:one" 을 추가해서 파일 경로를 지정한 뒤 npm run test:one 명령어를 치면된다. 저기서 one 은 그냥 임의로 만든 스크립트 이름이다. 맘대로 정하면 됨.

    방법 3. 명령어로 바로 테스트하는 방법인데 이 방법이 젤 간편한 거 같다. 명령어로

    npx jest 파일명.test.js

    또는

    npx sfdx-lwc-jest -- 파일명.test.js

    치면 된다.

    만약 같은 이름의 파일명.test.js 파일이 두 개 이상 있다면? -> 둘 다 실행됨.

    끝.

    ]]>         <![CDATA[[Node.js] npm vs npx 차이]]> https://velog.io/@hwan2-dev/npm-vs-npx-%EC%B0%A8%EC%9D%B4 https://velog.io/@hwan2-dev/npm-vs-npx-%EC%B0%A8%EC%9D%B4 Thu, 24 Apr 2025 05:27:57 GMT 🔍 npm vs npx 차이, 한 번에 이해하기

    개발을 하다 보면 자주 등장하는 두 명령어 npm과 npx. 비슷하게 생겼지만 용도는 완전히 다릅니다.
    이 글에서는 둘의 정확한 차이, 언제 어떤 걸 써야 하는지, 그리고 실무에서의 활용법까지 정리해드립니다.

    ✅ 간단 요약

    구분 npm npx
    주 목적 패키지 설치 & 관리 패키지 즉시 실행
    설치 여부 필요 ✅ 설치 필요 ❌ 설치 없이도 실행 가능
    사용 위치 주로 프로젝트 내부에서 로컬 또는 글로벌 어디서나
    대표 용도 npm install, npm run CLI 실행, 일회성 명령어 실행

    📦 npm이란?

    npm (Node Package Manager)는 패키지를 설치하고 관리하는 도구입니다.

    🔧 예시

    npm install jest --save-dev
    • jest를 프로젝트에 설치
    • node_modules에 저장
    • 나중에 npm run test로 사용

    🚀 npx란?

    npx는 설치하지 않아도 즉시 실행할 수 있는 실행 도구입니다.

    🔧 예시

    npx jest
    • 프로젝트에 jest가 설치되어 있다면 그것을 실행
    • 없다면 임시로 다운로드해서 실행
    • 실행 후 자동 삭제

    💬 쉽게 비교해보면

    상황 npm 사용 npx 사용
    CLI 도구를 설치하고 계속 쓸 때 ✅ npm install eslint ❌
    CLI 도구를 한 번만 실행하고 말 때 ❌ ✅ npx create-react-app my-app
    특정 테스트 파일을 바로 실행할 때 ❌ ✅ npx sfdx-lwc-jest -- sum.test.js

    🧪 실전 예시: Salesforce LWC 테스트

    npm run test:unit

    "scripts": {
  "test:unit": "sfdx-lwc-jest"
}
    • 전체 테스트 실행
    • 사전에 스크립트 등록 필요

    npx sfdx-lwc-jest -- [파일경로]

    npx sfdx-lwc-jest -- force-app/main/default/lwc/myComp/__tests__/myComp.test.js
    • 특정 테스트 파일만 실행
    • 경로만 알면 스크립트 없이 바로 실행 가능

    ✨ 결론

    요약 설명
    npm은 설치 & 관리용 패키지를 가져와서 나중에 쓸 수 있도록 저장
    npx는 실행 전용 설치하지 않아도 즉시 실행 가능 (특히 CLI에 유용)
    ]]>         <![CDATA[Loyalty와 Royalty의 차이]]> https://velog.io/@hwan2-dev/Loyalty%EC%99%80-Royalty%EC%9D%98-%EC%B0%A8%EC%9D%B4 https://velog.io/@hwan2-dev/Loyalty%EC%99%80-Royalty%EC%9D%98-%EC%B0%A8%EC%9D%B4 Thu, 24 Apr 2025 02:27:35 GMT Loyalty와 Royalty는 비즈니스, 마케팅, 콘텐츠 산업에서 자주 등장하는 단어입니다.
    발음은 비슷하지만 의미는 완전히 다르며, 헷갈릴 경우 실제 업무에서 혼선을 줄 수 있습니다.

    이번 글에서는 두 개념을 명확히 구분하고, 헷갈리지 않도록 정리해드립니다.

    ✅ Loyalty(로열티): 고객의 충성도

    Loyalty는 고객이 브랜드나 서비스에 대해 애착을 갖고 지속적으로 이용하는 정도를 말합니다.

    🎁 대표 개념: Loyalty Program (멤버십, 포인트, 마일리지 등)

    고객의 반복 구매를 유도하기 위해 포인트, 쿠폰, 등급 등의 혜택을 제공하는 마케팅 전략입니다.

    📌 예시

    • 커피숍에서 10잔 사면 1잔 무료
    • 항공사 마일리지 적립
    • 네이버페이 포인트, 롯데멤버스 리워드

    ✅ Royalty(로열티): 자산 사용에 대한 대가

    Royalty는 콘텐츠, 기술, 상표 등 지식재산을 사용할 때 발생하는 사용료 또는 수익 분배를 말합니다.

    💡 대표 개념: 저작권료, 특허 사용료, 라이선스 비용

    창작물이나 브랜드, 기술을 사용하는 사람은 소유자에게 로열티를 지급하게 됩니다.

    📌 예시

    • 작가의 책 판매 수익 중 인세
    • 유튜브·멜론 등의 음원 스트리밍 수익 정산
    • 캐릭터나 로고 사용 시 브랜드 라이선스 비용
    • 특허 기술을 사용한 제품의 수익 분배

    📊 Loyalty vs Royalty 비교표

    항목 Loyalty Royalty
    📘 의미 고객의 애착, 반복 이용 자산(저작권, 기술 등)의 사용료
    🙋‍♀️ 대상 고객, 사용자 창작자, 권리자, 소유자
    🎁 예시 포인트, 쿠폰, 마일리지 인세, 특허료, 스트리밍 수익
    💬 맥락 마케팅, 고객 보상, CRM 라이선스 계약, 콘텐츠 수익 정산
    🔤 발음 /ˈlɔɪ.əl.ti/ /ˈrɔɪ.əl.ti/

    ❗ 자주 헷갈리는 표현 예시

    ❌ 잘못된 표현 ✅ 올바른 표현 설명
    로열티 포인트 Loyalty 포인트 고객 보상은 Royalty가 아니라 Loyalty
    로열티 프로그램 Loyalty 프로그램 멤버십은 충성도 관리 전략
    로열티 적립 포인트 적립 사용료 개념이 아님

    🧠 기억하세요!

    Loyalty는 "고객 충성도",
    Royalty는 "사용 대가(저작권료)"입니다.

    두 단어는 비슷해 보여도 의미, 대상, 목적이 완전히 다릅니다.
    기획서나 미팅에서 "로열티"라는 말을 쓸 때, 이게 충성도인지 사용료인지 정확히 구분해보세요!

    ]]>         <![CDATA[[VS Code] 자주 쓰는 Salesforce Org 명령어 모음표]]> https://velog.io/@hwan2-dev/VS-Code-%EC%9E%90%EC%A3%BC-%EC%93%B0%EB%8A%94-Salesforce-Org-%EB%AA%85%EB%A0%B9%EC%96%B4-%EB%AA%A8%EC%9D%8C%ED%91%9C https://velog.io/@hwan2-dev/VS-Code-%EC%9E%90%EC%A3%BC-%EC%93%B0%EB%8A%94-Salesforce-Org-%EB%AA%85%EB%A0%B9%EC%96%B4-%EB%AA%A8%EC%9D%8C%ED%91%9C Tue, 22 Apr 2025 07:43:37 GMT 🧩 Salesforce Org 명령어 모음표
    구분 설명 sf 명령어 (최신) sfdx 명령어 (기존)
    ✅ Org 로그인 브라우저로 Org 인증 sf org login web --alias [별칭] sfdx auth:web:login -a [별칭]
    ✅ Org 샌드박스 로그인 브라우저로 Org 인증 sf org login web --alias [별칭] --instance-url https://test.salesforce.com
    🧾 Org 목록 보기 연결된 모든 Org 확인 sf org list sfdx force:org:list
    ⭐ 디폴트 Org 설정 기본으로 사용할 Org 지정 sf config set target-org=[별칭] sfdx force:config:set defaultusername=[별칭]
    ❓ 디폴트 Org 확인 현재 연결된 기본 Org 보기 sf config get target-org sfdx force:config:get defaultusername
    🌐 Org 열기 브라우저에서 Org 열기 sf org open sfdx force:org:open
    🔍 Org 정보 보기 Org ID, 사용자, 도메인 확인 sf org display sfdx force:org:display
    🚪 로그아웃 연결 해제 sf org logout --target-org [별칭] sfdx auth:logout -u [별칭]
    🧪 Scratch Org 생성 임시 개발 Org 생성 sf org create scratch --alias dev1 sfdx force:org:create -f config/project-scratch-def.json -a dev1 -d 7 -s
    ❌ Scratch Org 삭제 Scratch Org 제거 sf org delete scratch --target-org dev1 sfdx force:org:delete -u dev1
    🔃 Org와 연결된 사용자 보기 해당 Org 사용자 목록 출력 – sfdx force:user:list -u [별칭]

    ✨ 실무 팁

    목적 자주 쓰는 명령어
    Org 연결 상태 점검 sf org list 또는 sfdx force:org:list
    브라우저로 빠르게 열기 sf org open
    Org 정보 출력 후 기록 sf org display > org-info.txt
    복수 프로젝트 관리 Org마다 별칭(alias)을 지정해서 구분

    💬 예시 명령어 모음 (복붙용)

    # Org 인증
sf org login web --alias vscodeOrg

# 디폴트 org 설정
sf config set target-org=vscodeOrg

# Org 열기
sf org open

# Org 정보 확인
sf org display

# Org 목록 보기
sf org list

# 연결 해제
sf org logout --target-org vscodeOrg
    ]]>         <![CDATA[[VS Code] Create Project with Manifest에 관하여]]> https://velog.io/@hwan2-dev/VS-Code-Create-Project-with-Manifest https://velog.io/@hwan2-dev/VS-Code-Create-Project-with-Manifest Tue, 22 Apr 2025 07:14:00 GMT 🧩 SFDX 프로젝트 생성 방식 비교
    항목 일반 프로젝트 생성
    SFDX: Create Project    		 매니페스트 포함 생성
    SFDX: Create Project with Manifest
    📂 폴더 구조 force-app/만 생성 force-app/ + manifest/ 폴더 생성
    🧾 package.xml 포함 여부 ❌ 없음 ✅ 포함됨 (모든 메타데이터 타입 포함한 템플릿 제공)
    🔄 retrieve 방식 수동 선택 (-m 옵션 or Org Browser) package.xml 기준으로 자동 가져오기 가능
    Git 관리 편의성 ❌ 가져온 항목 추적 어려움 ✅ 가져올 대상 명확하게 추적 가능
    협업 시 일관성 ❌ 가져온 항목이 사람마다 다를 수 있음 ✅ 동일한 package.xml 사용으로 공통 기반 확보 가능
    반복 배포/백업 ❌ 명령 재사용 어려움 ✅ package.xml 한 번 작성해두면 반복 활용 가능
    추천 대상 빠르게 새 기능을 개발하거나 실습할 때 실무 개발, 팀 협업, Org 메타데이터 관리 목적일 때
    기타 장점 간단하고 빠름 대규모 Org에 최적, 메타데이터 관리 유리

    🔍 두 방식의 retrieve 예시 차이

    ⛔ 일반 프로젝트

    sfdx force:source:retrieve -m ApexClass
    • → ApexClass 전체 또는 일부를 직접 명령어에 입력해야 함
    • → 어떤 항목이 들어오는지 추적 어려움

    ✅ 매니페스트 프로젝트

    sfdx force:source:retrieve -x manifest/package.xml
    • → XML에 적힌 메타데이터만 가져옴
    • → 추적 가능, Git에 함께 보관 가능

    🛠 실무 팁: 매니페스트 관리 전략

    전략 설명
    package.xml을 목적별로 분리 예: package_apex.xml, package_flows.xml, package_ui.xml
    커밋 시 함께 보관 Git에 manifest/ 폴더 그대로 커밋
    팀원 간 공유 → 팀 전체가 동일한 retrieve/배포 대상 사용 가능
    코드 리뷰에도 용이 가져올 대상 명시되어 있어 변경사항 추적 쉬움

    📌 추가로 알면 좋은 내용

    개념 설명
    * 와일드카드 members>*</members>는 해당 타입의 모든 항목을 의미
    retrieve vs deploy retrieve: Org → 로컬
    deploy: 로컬 → Org
    Org Browser 매니페스트 없이도 특정 항목만 클릭으로 가져올 수 있는 도구 (GUI 방식)
    .gitignore와의 관계 package.xml은 가져올 대상 정의, .gitignore은 버전 관리 제외 대상 정의
    package.xml 없이 retrieve 가능하지만 반복 불가하고 추적 어려움 (임시적 활용에 적합)

    ✅ 결론 요약

    목적 추천 생성 방식
    빠르게 코드 실습만 해보려는 경우 SFDX: Create Project (간단하고 가볍게)
    기존 Org에서 코드/구성요소를 체계적으로 가져와서 개발하려는 경우 SFDX: Create Project with Manifest (강력 추천)
    팀 협업, Git 연동, 배포 자동화까지 고려하는 실무 환경 무조건 매니페스트 방식 추천

    실제 실무에서 자주 사용하는 package.xml 예시를 보여드릴게요.

    📦 package.xml 샘플 예시 (대표 메타데이터 포함)

    <?xml version="1.0" encoding="UTF-8"?>
<Package xmlns="http://soap.sforce.com/2006/04/metadata">

  <!-- Apex 클래스 전체 -->
  <types>
    <members>*</members>
    <name>ApexClass</name>
  </types>

  <!-- Apex 트리거 전체 -->
  <types>
    <members>*</members>
    <name>ApexTrigger</name>
  </types>

  <!-- LWC (LightningComponentBundle) 전체 -->
  <types>
    <members>*</members>
    <name>LightningComponentBundle</name>
  </types>

  <!-- 사용자 정의 객체 일부만 가져오기 -->
  <types>
    <members>Account</members>
    <members>CustomObject__c</members>
    <name>CustomObject</name>
  </types>

  <!-- 사용자 정의 필드 일부만 가져오기 -->
  <types>
    <members>Account.My_Custom_Field__c</members>
    <name>CustomField</name>
  </types>

  <!-- 페이지 레이아웃 전체 -->
  <types>
    <members>*</members>
    <name>Layout</name>
  </types>

  <!-- 권한 세트 전체 -->
  <types>
    <members>*</members>
    <name>PermissionSet</name>
  </types>

  <!-- 정적 리소스 전체 -->
  <types>
    <members>*</members>
    <name>StaticResource</name>
  </types>

  <!-- API 버전 -->
  <version>59.0</version>

</Package>

    ✅ 이 예시의 특징

    포함된 항목 용도
    ApexClass, ApexTrigger 백엔드 코드 자동 가져오기
    LightningComponentBundle LWC 전체
    CustomObject, CustomField 객체 및 필드 설정 관리
    Layout, PermissionSet 사용자 UI 및 권한 구성
    StaticResource 이미지, CSS, JS 등 정적 리소스 포함

    🛠 사용하는 방법

    프로젝트 루트에 manifest/package.xml 파일을 만든 뒤, 아래 명령어로 retrieve:

    sfdx force:source:retrieve -x manifest/package.xml

    또는 sf CLI에서는:

    sf project retrieve start --manifest manifest/package.xml

    ✳️ 필요에 따라 커스터마이징 가능

    • 특정 클래스만 가져오려면:

      <members>MyClass</members>

    • 특정 객체만 가져오고 싶다면:

      <members>Contact</members>
    ]]>         <![CDATA[[VS Code] Agentforce for Developers Extension에 관하여]]> https://velog.io/@hwan2-dev/VS-Code-Agentforce-for-Developers-Extension%EC%97%90-%EA%B4%80%ED%95%98%EC%97%AC https://velog.io/@hwan2-dev/VS-Code-Agentforce-for-Developers-Extension%EC%97%90-%EA%B4%80%ED%95%98%EC%97%AC Tue, 22 Apr 2025 06:24:35 GMT Agentforce for Developers는 Salesforce가 제공하는 AI 기반 개발 도구로, Visual Studio Code 확장 프로그램으로 제공됩니다. 이 도구는 Salesforce 개발자들이 Apex 및 Lightning Web Components(LWC) 개발을 보다 효율적으로 수행할 수 있도록 지원합니다.​

    🧠 주요 기능

    1. Dev Assistant와의 대화형 지원 코드 작성 중 자연어로 질문하거나 요청하면, Dev Assistant가 실시간으로 도움을 제공합니다.

    예: /explain 명령어를 통해 코드 설명을 요청하거나, /test로 테스트 코드 생성을 요청할 수 있습니다.​

    1. 인라인 코드 자동 완성 Apex 및 LWC(JavaScript, HTML, CSS) 파일에서 코드를 입력할 때, AI가 실시간으로 코드 완성 제안을 제공합니다.

    이 기능은 Salesforce의 커스텀 LLM인 CodeGen2.5를 기반으로 작동합니다.​

    1. 테스트 코드 자동 생성 작성한 Apex 메서드나 LWC 컴포넌트에 대한 단위 테스트 코드를 자동으로 생성하여 코드 커버리지를 향상시킬 수 있습니다.​

    2. 명령 팔레트 기반 코드 생성 VS Code의 명령 팔레트에서 "Agentforce: Generate Code" 명령어를 사용하여, 원하는 기능을 자연어로 설명하면 해당하는 Apex 코드를 생성해줍니다.​

    3. 코드 설명 및 문서화 /explain 명령어로 복잡한 코드를 설명받거나, /document 명령어로 코드에 대한 문서를 자동으로 생성할 수 있습니다.​

    ⚙️ 설치 및 사용 방법

    1. 필수 조건 Visual Studio Code 버전 1.90.0 이상

    Salesforce Extension Pack 설치

    Salesforce CLI 설치 및 설정​

    1. 설치 방법 VS Code의 확장 프로그램 마켓플레이스에서 "Agentforce for Developers"를 검색하여 설치하거나, Salesforce Extension Pack을 설치하면 함께 설치됩니다.​

    2. 사용 방법 VS Code 하단의 상태 표시줄에 있는 Agentforce 아이콘을 클릭하여 활성화하거나 비활성화할 수 있습니다.

    명령 팔레트(Ctrl+Shift+P)에서 "Agentforce"로 시작하는 명령어들을 실행하여 다양한 기능을 사용할 수 있습니다.​

    🔒 주의사항 Agentforce for Developers는 AI 기반 도구이므로, 생성된 코드나 응답이 항상 정확하거나 안전하지 않을 수 있습니다.

    따라서, 생성된 코드를 실제 프로젝트에 적용하기 전에 반드시 검토하고 테스트하는 것이 중요합니다.​

    한글은 못 알아먹음. 영어로 질문해야함.

    답변도 무조건 영어인거같음.

    ]]>         <![CDATA[[Java] Salesforce 개발을 위한 JDK 설치 및 환경변수 설정]]> https://velog.io/@hwan2-dev/Java-Salesforce-%EA%B0%9C%EB%B0%9C%EC%9D%84-%EC%9C%84%ED%95%9C-JDK-%EC%84%A4%EC%B9%98-%EB%B0%8F-%ED%99%98%EA%B2%BD%EB%B3%80%EC%88%98-%EC%84%A4 https://velog.io/@hwan2-dev/Java-Salesforce-%EA%B0%9C%EB%B0%9C%EC%9D%84-%EC%9C%84%ED%95%9C-JDK-%EC%84%A4%EC%B9%98-%EB%B0%8F-%ED%99%98%EA%B2%BD%EB%B3%80%EC%88%98-%EC%84%A4 Tue, 22 Apr 2025 04:58:28 GMT 참고 링크 : https://developer.salesforce.com/docs/platform/sfvscode-extensions/guide/java-setup.html

    1. JDK 21버전을 설치한다. 21버전이 젤 좋다고 함.

    2. https://www.oracle.com/java/technologies/downloads/#jdk21-windows 들어가서 다운 ㄱ

    3. 실행해서 다음 다음 다음 설치.

    4. 환경변수 설정하기 윈도우 하단 바 검색칸에 "시스템 환경 변수 편집" 입력 -> 시스템 속성 창이 뜨면 고급 탭의 하단의 환경 변수를 클릭한다.환경 변수 창이 뜨게되면 하단의 시스템 변수(S)에 환경변수 설정을 진행할 것이다.  

    5. 새로 만들기(W)... 버튼을 클릭한다.새 시스템 변수 창이 뜨면 변수 이름에 JAVA_HOME 을 입력하고,변수 값에 본인이 설치한 자바 경로를 입력한다.입력 후 확인 버튼을 눌러준다.

    1. 환경 변수 창 > 시스템 변수에서 변수 명이 Path인 항목을 찾는다.Path 선택 후 편집 버튼을 클릭한다.

    2. 환경 변수 편집 창에서 새로 만들기(N) 버튼을 클릭하면 입력 줄이 추가된다.%JAVA_HOME%\bin 을 추가 후 확인 버튼을 누른다.확인 버튼을 눌러 시스템 속성창까지 닫아준다.  

    3. window + R 키를 누른 후 cmd를 입력하여 명령 프롬프트 창을 호출한다.java -version 명령어 입력 후 엔터를 치면 자바 버전이 출력된다.

    출처: https://mi2mic.tistory.com/231

    1. VS Code에서 설정하기 설정(setting) -> apex 검색 -> 저 부분에 jdk 설치 경로 입력

    이렇게 하면 VS Code에서 Apex를 쓸 수 있다.(Salesforce Extension 설치했다는 가정하에)

    ]]>         <![CDATA[[Salesforce] Salesforce CLI 설치]]> https://velog.io/@hwan2-dev/Salesforce-Salesforce-CLI-%EC%84%A4%EC%B9%98 https://velog.io/@hwan2-dev/Salesforce-Salesforce-CLI-%EC%84%A4%EC%B9%98 Tue, 22 Apr 2025 04:24:40 GMT

  • https://developer.salesforce.com/tools/salesforcecli 들어가서 운영체제에 맞는 거 설치ㄱ

    • ✅ 각 옵션 설명

    1. @salesforce/cli CLI 2.84.x Salesforce CLI 본체입니다. 필수로 체크되어 있어야 합니다. (기본 체크)

    2. Set PATH to @salesforce/cli sfdx, sf 명령어를 터미널(cmd, PowerShell, VS Code 등) 어디서든 쓸 수 있게 해주는 옵션입니다. ✅ 반드시 체크하는 걸 추천합니다. 체크해야 sfdx force:org:list 같은 명령어를 어디서나 쓸 수 있음

    3. Add %LOCALAPPDATA% 일부 시스템에서 CLI 관련 데이터 저장 위치를 %LOCALAPPDATA% 경로로 설정 특별한 목적이 없다면 선택은 자유입니다. → 일반적으로는 체크하지 않아도 무방

    ✅ 추천 체크 상태

    항목 추천 여부 @salesforce/cli CLI ✅ 필수 Set PATH to CLI ✅ 필수 Add %LOCALAPPDATA% ⭕ 선택 (대부분 비워둬도 무방)

    나는 사진 그대로 진행함.

    1. 다음

    2. Install

    3. Completed 뜨면 Close

    끝.

    ]]>         <![CDATA[[VS Code] VS Code 설치하기]]> https://velog.io/@hwan2-dev/VS-Code-VS-Code-%EC%84%A4%EC%B9%98%ED%95%98%EA%B8%B0 https://velog.io/@hwan2-dev/VS-Code-VS-Code-%EC%84%A4%EC%B9%98%ED%95%98%EA%B8%B0 Tue, 22 Apr 2025 04:14:16 GMT

  • https://code.visualstudio.com/ 들어가서 다운 ㄱㄱ

  • 다음 다음 쭉 하다가 설정부분에서

    • [각 옵션 설명] 🔲 바탕 화면에 바로가기 만들기 바탕화면에 VS Code 아이콘을 생성합니다.

    🔲 “Code”로 열기 - 파일 탐색기 메뉴 파일을 마우스 오른쪽 클릭했을 때 “Code로 열기” 메뉴가 나옵니다. → 개별 파일에 적용

    🔲 “Code”로 열기 - 디렉터리 탐색기 메뉴 폴더를 마우스 오른쪽 클릭했을 때 “Code로 열기” 메뉴가 나옵니다. → 프로젝트 폴더 단위로 열 때 편리

    ✅ Code로 등록 (기본 선택됨) VS Code를 기본 코드 편집기로 등록 (예: .js, .html, .cls 등 더블 클릭 시 VS Code로 열림)

    ✅ PATH에 추가 매우 중요 ⚠️ 이 옵션을 선택하면 cmd 또는 PowerShell에서 code . 명령으로 VS Code 실행이 가능해집니다. Salesforce 개발 시 CLI와 함께 사용할 일이 많기 때문에 반드시 체크하는 걸 추천합니다.

    ✳️ 추천 설정

    항목 추천 여부 이유 바탕화면 바로가기 선택 여부는 자유 습관에 따라 “Code로 열기” 파일 메뉴 ✅ 소스 파일 열기 편리 “Code로 열기” 폴더 메뉴 ✅ 프로젝트 폴더 열기 필수 Code 등록 ✅ (기본값) 대부분의 코드 확장자와 연결 PATH에 추가 ✅ 필수! code . 명령어 실행용 (CLI 필수)

    나는 그냥 저 사진에서 다음 누름.

    1. 설치

    2. 종료

    ]]>         <![CDATA[[Trailhead] 목록 보기 만들기]]> https://velog.io/@hwan2-dev/Trailhead-%EB%AA%A9%EB%A1%9D-%EB%B3%B4%EA%B8%B0-%EB%A7%8C%EB%93%A4%EA%B8%B0 https://velog.io/@hwan2-dev/Trailhead-%EB%AA%A9%EB%A1%9D-%EB%B3%B4%EA%B8%B0-%EB%A7%8C%EB%93%A4%EA%B8%B0 Tue, 22 Apr 2025 02:20:00 GMT 트레일헤드 링크 : https://trailhead.salesforce.com/ko/content/learn/projects/prepare-your-salesforce-org-for-users/create-a-unique-account-list-view

    ]]>         <![CDATA[[Trailhead] Lightning App Builder로 홈페이지 만들기]]> https://velog.io/@hwan2-dev/Trailhead-Lightning-App-Builder%EB%A1%9C-%ED%99%88%ED%8E%98%EC%9D%B4%EC%A7%80-%EB%A7%8C%EB%93%A4%EA%B8%B0 https://velog.io/@hwan2-dev/Trailhead-Lightning-App-Builder%EB%A1%9C-%ED%99%88%ED%8E%98%EC%9D%B4%EC%A7%80-%EB%A7%8C%EB%93%A4%EA%B8%B0 Tue, 22 Apr 2025 02:04:33 GMT 트레일 링크 : https://trailhead.salesforce.com/ko/content/learn/projects/prepare-your-salesforce-org-for-users/customize-the-home-page

    ]]>