Acesso ao SQL

O arquivo config.json é obrigatório para a execução do scripts. Nele você deve

1. Definir qual banco de dados vai utilizar.
2. Definir o schema de dados que será utilizado pela sua extensão.
3. Definir a sequência das pastas para execução dos scripts.

{
   "sqlite":"plugins\\extensao\\database\\extensao.db",
   "schema":"dbo",
   "pastas":[
      “inicializacao”,
      “1.0”,
      "dados"
   ]
}

{
  "pgsql": "ncrsolution",
  "schema":"<nome da extensao>",
  "pastas":[
    “inicializacao”,
    “1.0”,
    "dados"
  ]
}

{     
  "sqlserver": "<produto>",
  "schema": "<nome da extensao>",
  "pastas":[
    "inicializacao",
    "1.0",
    "dados"
  ]
}

Banco de dados

Os scripts pode ser aplicados em 3 servidores de banco de dados.

Para rodar os scripts no PGSQL.

Sempre utilize a chave "pgsql": "ncrsolution". Como nome do schema, utilize o nome da sua extensão para fácil localização e também para evitar colisão com outros schemas já criados.

"pgsql": "ncrsolution",
"schema":"<nome da extensao>"

Para rodar os scripts no SQLite3.

O SQLite não tem suporte a schemas, por isso não é necessário incluir a chave schema para esse engine.

"sqlite":"plugins\\extensao\\database\\<nome da extensao>.db",

Para rodar os scripts no Sql Server.

Utilize a chave "sqlserver": "<produto>" para indicar em qual banco de dados os scripts devem ser aplicados. Como nome do schema, utilize o nome da sua extensão para fácil localização e também para evitar colisão com outros schemas já criados.

"sqlserver": "pos",
"schema":"<nome da extensao>"

A tabela script é necessária sempre que você utilizar scripts que são versionados no banco. Os scripts versionados não são reaplicados quando um pacote é atualizado com novos scripts.

Somente scripts em pastas no formato X.Y (onde X e Y são números) são versionados. Se sua extensão possui scripts desse tipo, será necessário criar um schema (exceto sqlite3) e a tabela script, dentro desse schema.

Abaixo temos exemplos da criação da tabela script nos engines de banco de dados suportados. Estes scripts devem ser colocados na pasta inicializacao. Repare que em todos os exemplos verificamos antes se o schema e a tabela existem antes de criá-los.

CREATE TABLE IF NOT EXISTS 'script' 
(
  'versao'	TEXT NOT NULL,
  'script'	TEXT NOT NULL,
  'dt_exec' TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP
)
GO

CREATE INDEX IF NOT EXISTS 'script_pk' ON 'script' 
(
  'versao',
  'script'
);

create schema if not exists extensao;
go

create table if not exists extensao.script
(
  versao character varying(10) not null,
  script character varying(100) not null,
  dt_exec timestamp not null default current_timestamp,
  constraint script_pkey primary key (versao, script)
);

if not exists(select * from sys.schemas where name = 'extensao') 
  exec('create schema extensao')
go

if object_id('extensao.script') is not null
return 

create table [extensao].[script]
( 
  [versao] [varchar](10) not null, 
  [script] [varchar](100) not null, 
  [dt_exec] [datetime] not null default getdate(), 
  constraint [script_pk] primary key clustered 
  ( 
    [versao] asc, 
    [script] asc 
  ) on [PRIMARY] 
) 
go

Caso você precise de acesso às tabelas criadas por você, pode obter as credenciais de acesso aos bancos de dados utilizando uma das formas apresentadas abaixo.

Dados de conexão nos terminais padrão

Nos terminais normais, consultar o arquivo <pasta NCR Solution>\client\config\launcher.conexao

{
  "dados_conexao": {
    "usuario": "ncrcolibri",
    "senha": "!23465479280e1e5f2f574f",
    "servidor": "PC-PITTYBULL",
    "banco": "colibri-master",
    "banco_pos": "pos-neemo",
    "banco_cbo": "cbo-sandiego"
  },
  "dados_pgsql": {
    "usuario": "ncrmaster",
    "senha": "!0346545d7f5940007f4340",
    "pgsql": true,
    "banco": "ncrsolution",
    "servidor": "localhost",
    "porta": 4500
  },
  "portas": {
    "colibri_catalogo": 4100,
    "d-connect": 5600,
    "ncr_lock": 27272,
    "colibri_server": 4300,
    "ncr_master": 4000,
    "mensagens": 4200,
    "pgsql": 4500
  }
}

Dados de conexão nos terminais Master

No terminal master, consultar o arquivo <pasta NCR Solution>\master\config\ncrmaster.cfg

[Banco]
servidor = localhost
usuario = ncrcolibri
senha = !23465479280e1e5f2f574f
estado_base = 
banco_pos = pos-neemo
banco_cbo = cbo-sandiego

[BancoPG]
usuario = ncrmaster
senha = !0346545d7f5940007f4340
banco = ncrsolution

[Portas]
colibri_server = 4300
ncr_lock = 27272
colibri_catalogo = 4100
ncr_master = 4000
mensagens = 4200
pgsql = 4500
d-connect = 5600

Em ambos será possível obter as seguintes informações

• Nome ou endereço do servidor MSSQL;

• Nomes dos bancos;
• Usuários;
• Senhas de acesso (criptografadas);
• Portas IP (Pgsql e Master).

As senhas de usuário do banco de dados são criptografadas. Para descriptografá-las utilize o endpoint disponível na API do Master.;

Para usar o endpoint de descriptografia você precisa 

• Do servidor e porta do Master, que podem ser obtidos dos arquivos citados acima.
• Da chave de licença da sua extensão, também conhecida como api key. Ela foi gerada automaticamente para você ao cadastrar sua extensão no Market Place.
• Da licença do Colibri atualizada no Master, com sua extensão ativada na licença.