Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/volldigital/laravel-navision
Fetch any data from navision using ntlm
https://github.com/volldigital/laravel-navision
laravel laravel-5-package laravel-6-package laravel-framework laravel-navision laravel-ntlm laravel5 laravel6 microsoft navision ntlm package unitop
Last synced: 3 months ago
JSON representation
Fetch any data from navision using ntlm
- Host: GitHub
- URL: https://github.com/volldigital/laravel-navision
- Owner: volldigital
- License: mit
- Created: 2019-07-15T11:11:35.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2023-03-31T07:53:47.000Z (over 1 year ago)
- Last Synced: 2023-12-21T21:03:43.531Z (about 1 year ago)
- Topics: laravel, laravel-5-package, laravel-6-package, laravel-framework, laravel-navision, laravel-ntlm, laravel5, laravel6, microsoft, navision, ntlm, package, unitop
- Language: PHP
- Homepage:
- Size: 133 KB
- Stars: 2
- Watchers: 2
- Forks: 4
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# Laravel Navision Package (For Laravel V5.8 & 6.X)
A small package to communicate with Microsoft Navision. You can fetch collections and single records.
## Install
Run following commands:
```php
composer require volldigital/laravel-navision
```
```php
php artisan vendor:publish --provider="VOLLdigital\LaravelNavision\LaravelNavisionServiceProvider"
```
Edit your "config/ntlm.php" file or use the ENV variables.
## Usage
After setting up your config, load the client via:
```php
$client = app(VOLLdigital\LaravelNavision\Client::class);
```
Now you are ready to recieve data from your Navision.
Examples:
```php
$client = app(VOLLdigital\LaravelNavision\Client::class);
$data = $client->fetchCollection("Events");
$event = $client->fetchOne("Events", 'Key', 'Number');
```
You can also pull data chunk-wise. The data will be written in a text file and after the request finished, it will be parsed and deleted.
```php
$client = app(VOLLdigital\LaravelNavision\Client::class);
// file will be stored in /storage/app/temp/curl_uniqueid.temp
$data = $client->fetchCollection("Events", true);
```
You want to check if your connection to UNITOP is established? You can use the ping function and check it :)
```php
$client = app(VOLLdigital\LaravelNavision\Client::class);
if ($client->ping() === false) {
throw new RunTimeException('No connection available');
}
```
## Write data
Use `$client->writeData(string $url, array $data);` to write data into navision.
Example:
```php
$client->writeData(
'Items',
[
'Item_Code' => 'VD',
'Item_Description' => 'Test data'
]
);
```
## Count items
Use `$client->countCollection("YourCollection")` to recieve the amount of items in this collection.
Example:
```php
dd($client->countCollection('Events')); // Outputs: 100293
```
## Examples
### Query params
* $skip=XXXX - Skip X amount of itmes
```php
$temp = $this->client->fetchCollection('Events?$skip=10000');
```
* $top=XXXX - Recieve X amount of items
```php
$temp = $this->client->fetchCollection('Events?$top=10');
```
### Fetching data
```php
protected function fetchData(string $uri, $key, bool $chunk = false, ?callable $filter = null)
{
$temp = $this->client->fetchCollection($uri, $chunk);
$data = [];
foreach($temp as $ts) {
if (!is_null($filter) && $filter($ts) === false) {
continue;
}
$data[$ts[$key]] = $ts;
}
return collect($data);
}
```
### Pagination
```php
protected function fetchAll()
{
$number = $this->client->countCollection('Events');
$pageLimit = 10000;
$pages = (int)ceil($number / $pageLimit);
$events = [];
for ($i = 0; $i < $pages; $i++) {
$skip = $i * $pageLimit;
$temp = $this->fetchData('Events?$skip='.$skip, 'Number');
$events = array_merge($events, $temp->toArray());
}
return collect($events);
}
```