9.1.1 Math — sayısal sınır sabitleri

Bu paket yalnızca sabit içerir, fonksiyonu yoktur; sabitler parantezsiz okunur (math.INT32_MAX).

9.1.2 Console — süreç akışları

9.1.3 FileSystem — dosya işlemleri ve dosya akışı

İç tip FileSystem.FileStream (Stream'den türer): alanlar Dir, FileName, mode, share; üyeler openFile(), openFile(Dir, FileName, mode, share), openTemp(). Sıralamalar: OpenMode (omRead, omWrite, omReadWrite), ShareMode (smExclusive, smRead, smWrite, smReadWrite, smDelete); öndeğerler omRead ve smExclusive.

9.1.4 Crypto

-- özet metni büyük harf onaltılık; banka imzası ISO-8859-9 baytlarıyla
hex = Crypto.hex_encode(Crypto.hash_sha2_256('abc'));                       -- BA7816BF…15AD
imza = Crypto.base64_encode(Crypto.hmac_sha512(convert(metin using 'ISO88599'), gizliAnahtar));
if (not Crypto.constant_time_equals(Crypto.base64_decode(gelenImza), beklenen)) then ...

9.1.5 WhatsApp — WhatsApp Business Cloud API istemcisi

Meta Graph API üzerinden mesaj gönderir. Asıl kullanım WhatsApp.Client tipidir:

execute block
as
  c WhatsApp.Client;
  id string;
begin
  --// anahtar CREDENTIAL'da: create credential wa type HTTP identity '<numara kimliği>' password '<anahtar>'
  c = WhatsApp.Client.FromCredential('wa');
  id = c.SendText('905551112233', 'Merhaba');
  id = c.SendTemplate('905551112233', 'hello_world', 'en_US');
  id = c.SendDocument('905551112233', 'https://.../fatura.pdf', 'fatura.pdf');
  c.MarkAsRead(id);
end;

create credential wa_webhook type CUSTOM identity '<doğrulama belirteci>' password '<App Secret>'
  tags (MQTOPIC = '/whatsapp/event');
create endpoint whatsapp_verify  method GET  path '/' as call WhatsApp.WebhookVerify;
create endpoint whatsapp_receive method POST path '/' as call WhatsApp.WebhookReceive;
commit;

--// dosyadan ya da tablodaki bir blob'dan medya yükleme
s Stream = Stream();
s.WriteRaw(icerik);                    --// icerik: blob / varbinary
mid = c.UploadMedia('fatura.pdf', 'application/pdf', s);
id = c.SendDocument('905551112233', mid, 'fatura.pdf');
b = c.DownloadMedia(mid);

Bir blob, yukarıdaki gibi Stream() + WriteRaw ile kopyalanarak ya da BlobStream(blob, omRead) ile kopyasız akışa alınır; dosya için FileSystem.FileStream doğrudan verilir.

Medya için mediaRef http:// ya da https:// ile başlıyorsa bağlantı, başlamıyorsa yüklenmiş medyanın kimliği sayılır. mediaType tam olarak image, document, audio, video ya da sticker yazılmalıdır.

Hatalar: WHATSAPP_NOT_CONFIGURED (anahtar ya da numara kimliği boş), WHATSAPP_INVALID_ARGUMENT (zorunlu argüman boş ya da tür geçersiz), WHATSAPP_API_ERROR (2xx dışı yanıt; ileti HTTP kodunu ve Meta'nın iletisini taşır).

9.1.6 OS — makine, kullanıcı ve süreçler

İç tip OS.Command: alanlar Dir, Executable, Parameters, InStream, OutStream, ErrorStream; üyeler Run(), Wait(TimeoutMS), Terminate(ExitCode), GetExitCode(). Dir boş bırakılırsa Executable işletim sisteminin arama yolundan (PATH) bulunur. Firebird yedeği için OS.gbak (Command'dan türer) vardır: alanları (DatabaseFile, BackupFile, Restore, UserName, Password …) Run() sırasında gbak komut satırına çevrilir; gbak arama yolundan bulunur, Firebird'ün bin dizini PATH'te olmalıdır.

9.1.7 Application — motor ve yapılandırma bilgisi

9.1.8 DebugHelper

9.1.9 EventLog — geri alınamayan olay kaydı

EventLog.write(source, source_object_id, source_key, severity, event_type,
               result, message, extra = null, data = null)

Gövdesi kaydı in autonomous transaction do içinde yazar, yani çağıran geri alsa bile kayıt kalır. severity sıralaması (ivd$EventLogSeverity): Critical, Error, Warning, Information, Verbose. Kayıtlar ivd$event_log tablosundadır; zaman ve kullanıcı kimliği otomatik yazılır.

9.1.10 Scheduler — yinelenen PSQL işleri

Scheduler.Job tipinden türetip OnExecute() yordamını geçersiz kılarak bir iş tanımlanır; sonra:

Job alanları: job_name, job_type (varsayılan 'PSQL'), start_date, repeat_interval, schedule_limit, end_date, enabled, auto_disable ('N', 'A' her zaman, 'S' başarıda, 'F' hatada), auto_disable_after, comments, logging_level, execution_log_limit. Geçersiz zamanlama dizgisi invalid_job_schedule, bulunamayan iş job_not_found istisnası verir. Her işlem EventLog'a yazılır. Örnek zamanlama dizgisi: 'secondly; seconds=5,15,25,35,45,55'.

9.1.11 NET — e-posta, TCP ve HTTP

Paketin fonksiyonları HTTP taşıması ve JWT için (http_send, http_send_binary, http_upload, jwt_sign, jwt_verify); asıl kullanım iç tiplerdir.

NET.Http — HTTP istemcisi

NET.HttpRequest nesnesi doldurulur, NET.Http.Send(r) gönderir, NET.HttpResponse döner. Kısayollar: Get(url, headers), PostJson(url, body json, headers), PostForm(url, form json, headers), PostXml(url, body, headers), Download(url, headers) returns blob (2xx dışında NET_HTTP_ERROR).

execute block
as
  r NET.HttpRequest = NET.HttpRequest();
  resp NET.HttpResponse;
begin
  r.method = 'POST';
  r.url = 'https://api.ornek.gov.tr/token';
  r.headers = json_object('X-ClientId', 'credential:turmob.identity', 'X-SecretKey', 'credential:turmob');
  r.form = json_object('grant_type', 'client_credentials', 'token', :mmAnahtari);
  resp = NET.Http.Send(r);

  if (resp.status <> 200) then
    exception net_http_error using (resp.status, left(resp.body, 200));

  resp = NET.Http.Get('https://api.ornek.gov.tr/MukellefBilgisi/' || :vkn,
    json_object('Authorization', 'Bearer ' || json_value(resp.body, '$.access_token')));
end;

• Gizli bilgi credential'da kalır: başlık, form ve anahtar değerlerinde credential:<ad> istek anında o credential'ın PASSWORD'üne çözülür (CREATE CREDENTIAL … TYPE HTTP, çağıranın USAGE hakkı aranır); credential:<ad>.identity IDENTITY'ye, credential:<ad>.tag:<AD> bir etikete; değerin içinde {credential:<ad>} yazımı da geçerlidir ('Bearer {credential:wa}'). Sır PSQL'e, günlüğe ve hata iletisine girmez.
• Güvenlik: TLS sertifikası her zaman doğrulanır, yönlendirme izlenmez; düz http yalnız localhost'a, allowInsecure = true ile yalnız özel ağ IPv4 adresine (10/8, 172.16/12, 192.168/16) gider. NET.Http üyeleri, http_send* / http_upload ve WhatsApp.http_* yalnız SYSADMIN kodunda derlenir (yukarıdaki Yetki notu); paketlerinizi SQL SECURITY DEFINER ile yazın.
• JWT: JwtSign iat yoksa yazar, ttlSec > 0 ise exp ekler; anahtar 'credential:<ad>' olabilir (her TYPE). JwtVerify imzayı sabit süreli karşılaştırır ve exp'i denetler.
• Hatalar: NET_HTTP_INVALID_ARGUMENT (boş istek), NET_HTTP_ERROR (Download 2xx dışı); taşıma hataları (adres, zaman aşımı, boyut sınırı) APPLICATION_ERROR olarak gelir.

9.1.12 MessageQueue, Metadata, Utils

MessageQueue bir zarf tipi (MessageQueue.Message: destination, messageText, MessageBody JSONType) ve tek bir fonksiyon bildirir: MessageQueue.Publish(konu, mesaj) returns integer mesajı sürecin bütün oturum yöneticilerindeki abonelere (/message uygulamasına SUBSCRIBE ile bağlananlar, başka bir işçi süreçte de olabilir) yayınlar ve abone sayısını döndürür; kalıcı değildir, abonesi yoksa düşer. Metadata paketi katalog okuyucusudur: Attribute, Attributes, AllAttributes, EffectiveAttribute, Description, Caption, ObjectInfo, Columns, Relations, Search, UpgradeReportText (bkz. 6.11) ve is_privileged_user() (çağıran bu veritabanında ayrıcalıklı mı: kimliksiz bağlantı, SYSDBA, SYSADMIN üyesi ya da sahip). Utils paketi boştur; üyesi yoktur.