Corrige docs/13: roteiro real (Copy), não upload de amostra (inventado)

Confirmado contra prints reais do App Builder: o wizard de criação só
oferece 'From scratch' ou 'As copy of an existing Data Load
Definition' — não existe tela de upload de amostra para autodetectar
colunas, como eu tinha documentado antes sem verificar. Corrige o
roteiro pra seguir exatamente as telas reais (Method -> Application ->
As Copy, renomeando DL_TECH_CMDB_V1 -> DL_TECH_CMDB_V2 e
DL_TECH_VULNERABILIDADE_V2 -> DL_TECH_VULNERABILIDADE_V3 na mesma
tela). Marca explicitamente onde o roteiro ainda não está confirmado
(tela pós-'Copy Data Load Definition') em vez de continuar
adivinhando. Reposiciona os templates/*.xlsx: servem para testar a
carga depois de pronta, não para criar o perfil.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
This commit is contained in:
2026-09-09 19:23:17 -03:00
parent 0e7d75db27
commit 8ef36eb1cc
2 changed files with 53 additions and 26 deletions

View File

@@ -43,16 +43,19 @@ teste — a menos que você peça explicitamente o contrário.
(bloco grande) foi pulado na primeira passada — o checkpoint de compilação deu `VALID`
porque a view *antiga* (46 colunas) já era válida antes. Resolvido rodando o bloco
explicitamente; segunda checagem confirmou as 81 colunas.
- [ ] **Mapeamento pronto + templates de amostra prontos** (ver
[docs/13-v2-perfis-carga.html](docs/13-v2-perfis-carga.html) e `templates/`) — falta criar
os dois perfis no App Builder (uma vez, seu acesso, não do cliente — upload dos templates de
amostra, não preenchimento campo a campo) e depois gerar um export completo novo da
Application 100 (captura os perfis automaticamente, com IDs corretos). O cliente só importa
esse export, nunca toca em Data Load Definitions — mesmo fluxo de sempre. **Achado
importante:** essas definições vivem dentro de `sql/02_ampminsights_apex_app.sql` via API
interna do APEX (`wwv_flow_imp_shared`) — não escrever isso à mão fora de um import
completo, risco de corromper os Shared Components. `RAW_JSON` deliberadamente fora do
escopo deste item — depende do item de staging abaixo.
- [ ] **Em andamento, roteiro sendo confirmado tela a tela** (ver
[docs/13-v2-perfis-carga.html](docs/13-v2-perfis-carga.html)) — mapeamento de colunas
pronto; passo a passo real do App Builder confirmado até "Copy Data Load Definition"
(método = cópia de `DL_TECH_CMDB_V1`/`DL_TECH_VULNERABILIDADE_V2`, renomeadas pra
`DL_TECH_CMDB_V2`/`DL_TECH_VULNERABILIDADE_V3` — **não** "upload de amostra", isso foi um
chute meu já corrigido). Falta confirmar a tela seguinte (adicionar as colunas novas na
cópia) antes de completar o roteiro. Depois de pronto: exportar a Application 100 de novo
(captura os perfis com IDs corretos) — o cliente só importa esse export, nunca toca em Data
Load Definitions. **Achado importante:** essas definições vivem dentro de
`sql/02_ampminsights_apex_app.sql` via API interna do APEX (`wwv_flow_imp_shared`) — não
escrever isso à mão fora de um import completo, risco de corromper os Shared Components.
`RAW_JSON` deliberadamente fora do escopo deste item — depende do item de staging abaixo.
Os `templates/*.xlsx` servem pra testar a carga depois de pronta, não pra criar o perfil.
- [ ] Pipeline de staging: bucket → `TB_26AI_TECH_V2_STG` via `DBMS_CLOUD.COPY_DATA` (tabela nova,
não mexe nas existentes)
- [ ] `MERGE` com histórico (`LOAD_BATCH_ID`, `TB_26AI_TECH_V2_HIST` — tabela nova), honrando o