setIniFileDirectory method added at addon level, to set the sapnwrfc.…

…ini file directory

CHANGES

@@ -1,11 +1,12 @@
 Change log
 ==========
 
-2.2.1 (XXXX-XX-XX)
+2.3.0 (XXXX-XX-XX)
 ------------------
 
 - NAPI v7
-- The client parameter set to optional in RfcConnectionParameters interface
+- The client parameter set to optional in RfcConnectionParameters interface 8e7bb8f
+- setIniFileDirectory method added at addon level, to set the sapnwrfc.ini file directory
 
 2.2.0 (2020-10-13)
 ------------------

doc/api.md

@@ -1,3 +1,5 @@
+-   **[addon](#addon)**
+    -   [setIniFileDirectory](#setinifiledirectory)
 -   **[Client](#client)**
     -   [Properties](#client-properties)
     -   [Constructor](#client-constructor)
@@ -15,6 +17,16 @@
     -   [Constructor](#throughput-constructor)
     -   [API](#throughput-api)
 
+## Addon
+
+### setIniFileDirectory
+
+Usage: [usage/addon](usage.md#addon)
+
+```ts
+setIniFileDirectory(iniFileDirectory: string)
+```
+
 ## Client
 
 Usage: [usage/client](usage.md#client)

doc/usage.md

@@ -4,7 +4,12 @@
     -   [Date/Time types](#datetime-types)
     -   [UTCLONG](#utclong)
 -   **[ABAP Function Module](#abap-function-module)**
+-   **[Addon](#addon)**
+
+    -   [setIniFileDirectory](#setinifiledirectory)
+
     <a name="client-toc"></a>
+
 -   **[Client](#client)**
 
     -   [Using `sapnwrfc.ini` file](api.md/#setIniPath)
@@ -116,6 +121,19 @@ Using ABAP transaction SE37 in ABAP backend system, you can enter the input data
 
 To consume this function module from NodeJS, first the node-rfc client connection shall be instantiated, using ABAP backend system connection parameters.
 
+## Addon
+
+API: [api/addon](api.md#addon)
+
+### setIniFileDirectory
+
+Sets the directory in which the NWRFC SDK shall search for the `sapnwrfc.ini` file, exposing the `RfcSetIniPath` NWRFC SDK method. The default is the current working directory of the process. After the directory is set, the NW RFC lib automatically loads the contents of the new `sapnwrfc.ini` file from that directory. The exception is thrown if `sapnwrfc.ini` not found in the new directory.
+
+```ts
+const noderfc = require("node-rfc");
+noderfc.setIniFileDirectory("/some/folder");
+```
+
 ## Client
 
 API: [api/client](api.md#client)

lib/index.d.ts

@@ -3,3 +3,4 @@ export * from "./wrapper/sapnwrfc-client";
 export * from "./wrapper/sapnwrfc-pool";
 export * from "./wrapper/sapnwrfc-throughput";
 export * from "./wrapper/sapnwrfc-server";
+export declare function setIniFileDirectory(iniFileDirectory: string): void;

lib/wrapper/noderfc-bindings.d.ts

@@ -24,9 +24,10 @@ export interface NWRfcBinding {
     Pool: RfcPoolBinding;
     Throughput: RfcThroughputBinding;
     Server: RfcServerBinding;
-    verbose(): this;
     bindingVersions: NodeRfcBindingVersions;
     environment: NodeRfcEnvironment;
+    setIniFileDirectory(iniFileDirectory: string): any | undefined;
+    verbose(): this;
 }
 declare let noderfc_binding: NWRfcBinding;
 declare const environment: {

lib/wrapper/sapnwrfc-client.d.ts

@@ -22,7 +22,7 @@ export interface RfcConnectionParameters {
     trace?: EnumTrace;
     user?: string;
     passwd?: string;
-    client: string;
+    client?: string;
     lang?: string;
     mysapsso2?: string;
     getsso2?: string;
@@ -104,7 +104,6 @@ export interface RfcClientBinding {
     close(callback: Function): void;
     resetServerContext(callback: Function): void;
     ping(callback: Function): void;
-    setIniPath(pathName: string): void;
     invoke(rfmName: string, rfmParams: RfcObject, callback: Function, callOptions?: object): void;
     release(oneClientBinding: [RfcClientBinding], callback: Function): void;
 }
@@ -121,9 +120,8 @@ export declare class Client {
     get config(): Object;
     get _id(): string;
     get connectionInfo(): RfcConnectionInfo;
-    checkCallbackArg(method: string, callback?: Function): void;
+    static checkCallbackArg(method: string, callback?: Function): void;
     connect(callback?: Function): void | Promise<Client>;
-    setIniPath(pathName: string, callback?: Function): void | Promise<void>;
     open(callback?: Function): void | Promise<Client>;
     ping(callback?: Function): void | Promise<boolean>;
     close(callback?: Function): void | Promise<void>;