# ДДБ Клиничар за упитнику / ЈаваСцрипт
Потпуна документација пакета ddb-js, који поједностављује приступ ДДБ АПИ-у помоћу уврштавања.
Напомена за спољне кориснике - Многе везе у следећем одељку односе се на интерне апликације. Молимо разговарајте са својим пројектним тимом за подршку.
# Предуслови
Требаће вам софтвер испод инсталиран на вашем окружењу
Ноде ЈС в16.к
НПМ в8.к +
Погледајте како преузети ове пакете овде (opens new window)
# Аутентификација Азуре НПМ регистра
ddb-js Пакети су домаћини на (приватном) регистру Азуре НПМ пакета. Да бисте га инсталирали, морате да се потврдите, погледајте доле наведене могућности.
# Прозори
Да бисте користили НПМ пакете, набавите НПМ (који долази са чворовима.ЈС) и vsts-npm-auth помагачем.
Корак 1
Корак 2
Покрените ову наредбу
npm install -g vsts-npm-auth --registry https://registry.npmjs.com --always-auth false
Корак 3
Додајте А .НПМРЦ на свој пројекат, у истом директоријуму као и ваш пакет.јсон
@ddb:registry=https://pkgs.dev.azure.com/ovearup/_packaging/ddb/npm/registry/
always-auth=true
Затим, покрените ВСТС-НПМ-АУХ да бисте добили Азуре Артефацтс токен додан у ваш кориснички ниво .НПМРЦ датотеку.
vsts-npm-auth -config .npmrc
НАПОМЕНА: Не морате то да радите сваки пут. НПМ ће вам дати 401 неовлашћену грешку када је потребно да је поново покренете.
Имате проблема? Погледајте упутства за употребу личног приступа токен за аутентификацију .
# Други
Корак 1
Корак 2
Додајте А .НПМРЦ на свој пројекат, у истом директоријуму као и ваш пакет.јсон
@ddb:registry=https://pkgs.dev.azure.com/ovearup/_packaging/ddb/npm/registry/
always-auth=true
Корак 3
Копирајте код испод свог корисника .НПМРЦ (~ / .НПМРЦ).
; begin auth token
//pkgs.dev.azure.com/ovearup/_packaging/ddb/npm/registry/:username=ovearup
//pkgs.dev.azure.com/ovearup/_packaging/ddb/npm/registry/:_password=[BASE64_ENCODED_PERSONAL_ACCESS_TOKEN]
//pkgs.dev.azure.com/ovearup/_packaging/ddb/npm/registry/:email=[EMAIL]
//pkgs.dev.azure.com/ovearup/_packaging/ddb/npm/:username=ovearup
//pkgs.dev.azure.com/ovearup/_packaging/ddb/npm/:_password=[BASE64_ENCODED_PERSONAL_ACCESS_TOKEN]
//pkgs.dev.azure.com/ovearup/_packaging/ddb/npm/:email=[EMAIL]
; end auth token
Корак 4
Генерисање а Лични приступни токен (opens new window) са амбалажним прочитаним и писањем опсега.
Корак 5
Басе64 кодира лични приступни токен из корака 4.
Једна сигурна и сигурна метода Басе64 кодира низ је:
Из промптова командне / шкољке:
node -e "require('readline') .createInterface({input:process.stdin,output:process.stdout,historySize:0}) .question('PAT> ',p => { b64=Buffer.from(p.trim()).toString('base64');console.log(b64);process.exit(); })"
Залепите своју личну вредност приступне вредности и притисните Ентер / Ретурн
Копирајте басе64 кодирану вредност
Корак 6
Замените и BASE64_ENCODED_PERSONAL_ACCESS_TOKEN вредности у вашем кориснику .НПМРЦ датотека са својим личним токеном приступа из корака 5.
Замените и [е-маил] вредности у свом кориснику .нпмрц датотеку са својим путем е-поште.
# Уградња
Након аутентификације као што је описано горе, пакети се могу поставити путем НПМ-а. Све микросервисе се могу постављати одвојено
npm install @ddb/comments-service
npm install @ddb/environment-context-service
npm install @ddb/parameter-metadata-service
npm install @ddb/parameter-service
npm install @ddb/qa-service
npm install @ddb/reference-data-service
npm install @ddb/user-service`
# Корак по корак водич
# Конфигурација
Овај ЕКСМАПЛЕ је за @ ддб / цомментс-сервице
import { CommentsApi, Configuration, Environment } from "@ddb/comments-service";
// created a new configuration class
const config = new Configuration()
// specify the required environment, the default is production if the basepath isnt set
config.basePath = Environment.sandbox
// pass in the access token, note only pass in the accessToken, it will prefix with 'Bearer'
config.accessToken = 'token'
// Initialise the new class, with the config
const commentsAPI = new CommentsApi(config)
# Коришћење АПИ-ја
Све методе се покрећу на класи и пример како да их назовете су испод
const comments = await commentsAPI.getComments()
Погледајте интерфејсе за упис да бисте разумели параметре, потребне у захтеву, а такође и одговори назад са функције.
Напомена: Ако имате ИнтеллиСисенсе инсталиран, усмерени сте
# Информације о програмеру
Складиште је смештено овде (opens new window) . Погледати како то допринети (opens new window) .