Oracle APEX (REST 통합 코드 스니펫)

Source: Dev.to

(A) APEX에서 APEX_WEB_SERVICE를 사용해 REST API 호출하기

예시: OCI Functions 또는 임의의 REST 엔드포인트 호출

DECLARE
    l_url    VARCHAR2(2000) := 'https://api.example.com/process';
    l_body   CLOB := '{"id":123, "action":"submit"}';
    l_result CLOB;
BEGIN
    l_result := APEX_WEB_SERVICE.make_rest_request(
        p_url         => l_url,
        p_http_method => 'POST',
        p_body        => l_body,
        p_wallet_path => 'file:/u01/app/oracle/wallet',
        p_wallet_pwd  => 'password'
    );

    -- Log or parse the JSON response
    dbms_output.put_line(l_result);
END;

사용 시점

• 서버리스 함수(OCI Functions) 호출
• 외부 API 연동
• 마이크로서비스에 데이터 전송

---

(B) OCI Object Storage에 파일 업로드

문서, 이미지, 청구서, 업로드 등을 처리하는 APEX 앱에 유용합니다.

DECLARE
    l_url  VARCHAR2(4000) := 'https://objectstorage..oraclecloud.com/n/namespace/b/bucket/o/myfile.pdf';
    l_blob BLOB;
BEGIN
    SELECT file_blob INTO l_blob
    FROM my_docs
    WHERE id = :P1_DOC_ID;

    APEX_WEB_SERVICE.make_rest_request(
        p_url         => l_url,
        p_http_method => 'PUT',
        p_body_blob   => l_blob,
        p_wallet_path => 'file:/u01/app/oracle/wallet',
        p_wallet_pwd  => 'password'
    );
END;

사용 시점

• 이력서, 청구서, PDF 업로드
• 이미지, 문서, 보고서 저장
• 파일을 안전하게 아카이브

---

(C) OCI AI Language 또는 Vision 서비스 호출

AI Language 예시: 감성 / 핵심 구문

DECLARE
    l_body CLOB := '{
        "documents": [
            {"text": "The service was excellent!", "id": "1"}
        ]
    }';
    l_response CLOB;
BEGIN
    l_response := apex_web_service.make_rest_request(
        p_url         => 'https://.../language/sentiment',
        p_http_method => 'POST',
        p_body        => l_body,
        p_wallet_path => 'file:/u01/app/oracle/wallet'
    );

    :P1_AI_RESULT := l_response;
END;

사용 시점

• 고객 피드백 분석
• 지원 티켓 우선순위 지정
• 챗봇 인텔리전스 및 라우팅

---

(D) ORDS를 사용한 REST‑enabled 테이블 또는 뷰 호출

테이블을 ORDS를 통해 노출하면 APEX에서 일반 REST 엔드포인트처럼 읽을 수 있습니다.

SELECT *
FROM apex_web_service.g_response_clob;

사용 시점

• 마이크로서비스 스타일 데이터 공유
• 여러 APEX 앱 통합
• 파트너에게 데이터 노출

---

Use‑Case‑Based Recommendations

A. 문서 처리 사용 사례

자동 PDF 추출 및 분류

적합 대상: 인사 onboarding, 청구서, 영수증, 양식
OCI 서비스: Object Storage, AI Document Understanding, Functions
APEX 역할: 업로드 UI + 결과 뷰어

흐름

1. 사용자가 APEX에서 문서를 업로드합니다.
2. 문서는 OCI Object Storage에 저장됩니다.
3. AI Document Understanding이 엔터티를 추출합니다.
4. APEX가 구조화된 결과(날짜, 금액, 공급업체 등)를 표시합니다.

APEX 내 이미지 인식

적합 대상: 현장 점검, 자산 관리
OCI 서비스: Vision AI

흐름

1. 사진 업로드 → OCI Vision에 전송.
2. Vision이 라벨 및 이상 징후를 반환.
3. APEX가 워크플로를 트리거하거나 이슈를 표시합니다.

자동 PDF 생성

적합 대상: 보고서, 증명서, 영수증
OCI 서비스: OCI Functions + 오픈소스 라이브러리 또는 APEX 내장 PDF 출력

B. 챗봇 및 인텔리전트 어시스턴트

LLM 기반 채팅 어시스턴트 (APEX 내)

적합 대상: 고객 포털, 인사 헬프데스크
OCI 서비스: OCI Generative AI, OCI Language
APEX 역할: 채팅 UI + 히스토리 로그

흐름

1. APEX가 사용자 메시지를 OCI Generative AI에 전송합니다.
2. 구조화된 응답을 수신합니다.
3. 채팅 히스토리를 저장합니다.
4. 챗봇 형태 UI에 표시합니다.

스마트 티켓 분류

적합 대상: IT 서비스 데스크, 지방자치단체 민원
OCI 서비스: AI Language (감성, 분류)

흐름

1. APEX 폼 → AI Language → 자동으로 우선순위/팀 할당.

C. 대시보드 및 분석

실시간 운영 대시보드

적합 대상: 물류, 금융, 소매
OCI 서비스: Streaming (Kafka‑like), API Gateway

흐름

1. 데이터가 DB로 스트리밍됩니다.
2. APEX가 라이브 폴링으로 대시보드를 새로 고칩니다.

경영진 KPI 대시보드

적합 대상: 경영 보고
OCI 서비스: Oracle Analytics Cloud(선택), ADW

흐름

1. APEX가 정제된 ADW 모델을 소비합니다.
2. 인터랙티브 차트와 드릴다운 제공.

감사 및 보안 대시보드

적합 대상: 컴플라이언스, 보안 팀
OCI 서비스: Data Safe, Logging, Monitoring

흐름

1. APEX가 Data Safe 로그를 조회합니다.
2. 위험 사용자, 이상 징후, 감사 알림을 표시합니다.