OMCURL: OMNIS CURL COMPONENT
OmCURL is a wrapper for standard famous CURL Open Source Library
that provides access to many Web Services
by Omnis Studio and Omnis 7 too.
for Omnis Studio
and for Omnis 7
Main functions:
CURLGetURL(url, localfile, follow): downloads the content at given URL, and saves it to a local file (if provided) or into the returned variable; optional parameter “follow” enables automatic redirect in case the remote server returns “302 Moved”
CURLGetURLAuth(url, user, pasw, localfile, extraurl): downloads the data at given URL, performing authentication (method automatically chosen) with provided credentials; then it stores data into a local file or in the returned variable; optionally a second URL is accessed and retrieved before the connection is closed.
CURLGetURLCert(url, certificate, localfile): downloads data at given URL, using the provided certificate; then the data are stored into a local file or to the returned variable
CURLGetURLXML(url, parameter): downloads the XML file at given URL, and parses it, retrieving the value for given XML variable (beta)
CURLPutURL(url, file): sends the content from local file to the remote server
CURLGetGmail(url, user, pasw): gets emails from GoogleMail accessing it with given credentials (beta)
CURLCmdLine(cline, var): performs all given tasks in “cline” as if CURL.EXE command had been invoked by the OS command-line; received data can be stored to a file (using standard CURL.EXE options) or to given variable.
(THIS is the most flexible function, parameters examples are at https://curl.haxx.se/docs/manpage.html )
Helper functions:
CURLGetVersion(): returns CURL.DLL version, and if SSL DLL is present too (and active)
CURLGetTempFile(name, number): returns a temporary filename (for use by CURL or else)
CURLANSIToUniCode(string, codepage): converts an ANSI string to an UNICODE (default page: UTF8)
CURLUniCodeToANSI(string, codepage, defchar): converts an UNICODE string into an ANSI (default page: UTF8; default char: blank)
CURLGetLastError(type): returns erros and warning messages generates by CURL library during last operation performed.
Example
Curl is an open source command line tool and library for transferring data with URL syntax, supporting DICT, FILE, FTP, FTPS, Gopher, HTTP, HTTPS, IMAP, IMAPS, LDAP, LDAPS, POP3, POP3S, RTMP, RTSP, SCP, SFTP, SMB, SMTP, SMTPS, Telnet and TFTP. curl supports SSL certificates, HTTP POST, HTTP PUT, FTP uploading, HTTP form based upload, proxies, HTTP/2, cookies, user+password authentication (Basic, Plain, Digest, CRAM-MD5, NTLM, Negotiate and Kerberos), file transfer resume, proxy tunneling and more. Curl project