Ez a cikk elmagyarázza, hogyan integrálhatja a Netsuite-példányát a Tulipba a Tulip előre elkészített csomag RESTlet-funkcióinak használatával.
Cél
A Netsuite Bundle Unit teszt célja, hogy a felhasználók ellenőrizhessék a Tulip és a Netsuite platformjuk közötti sikeres kapcsolatot, miközben felfedezhetik a Tulip előre elkészített RESTlet bundle által biztosított közös gyártási funkciókat.
Beállítás
Ehhez az integrációhoz a következőkre lesz szüksége:
- Jogosultságok a Netsuite-példányon belül egy szkript létrehozásához és telepítéséhez.
- Jogosultságok a Netsuite-példányon belül egy integrációs felhasználó létrehozásához.
- Egy Tulip-példány a Netsuite-konnektorral és a Netsuite Unit Test alkalmazással együtt telepítve.
A Netsuite és a Tulip támogatja mind a token alapú hitelesítést (közismert nevén TBA), amely az OAuth1.0 specifikációra épül, mind az OAuth2.0 hitelesítést. Választhatja a TBA alapú hitelesítést, mivel ez a hitelesítési módszer egy hosszú élettartamú tokent biztosít, amely a Netsuite-nál történő hitelesítéshez használható. Az OAuth2.0 hitelesítési lehetőség egy frissítő tokent biztosít, amely 7 napig érvényes, és ha lejárt, a tokenek regenerálásának a Tulipen belül kell megtörténnie, különben a Netsuite-hoz való csatlakozási kísérletek INVALID_GRANT hibával fognak sikertelenül végződni. Az alábbi lépések mindkét hitelesítési lehetőséget ismertetik.
1. lépés - A Tulip Integration Bundle szkript telepítése, létrehozása és telepítése
A Tulip előre elkészített Netsuite RESTlet használatához le kell töltenie a Tulip Bundle integrációs szkriptet, majd létre kell hoznia és telepítenie a Netsuite-példányán belül.
A szkript Netsuite-példányába történő importálásához hozzon létre egy új szkriptet a következő navigációval
Testreszabás -> Szkriptek -> Új
Kattintson a '+' gombra a
{height="" width=""} beviteli mező mellett.
Töltse ki a szükséges mezőket a fent letöltött fájl segítségével. Győződjön meg róla, hogy a fájlnév tartalmazza a .js kiterjesztést, különben a szkript nem fog működni!
Mentsd el és nyomd meg a "Create Script Record" gombot, majd nevezd el a szkriptet és mentsd el.
Helyezze üzembe a szkriptet, majd módosítsa a státuszt release-re, jelölje ki az összes szerepet és az összes alkalmazottat, és mentse el.
2A lépés - Netsuite Token alapú hitelesítési lehetőség
A következő lépések feltételezik, hogy ismeri a token alapú hitelesítés beállítását a Netsuite-ban, amelyről bővebben itt olvashat.
Először keresse meg a letöltött Tulip Netsuite Bundle Connector-t a Tulip példányában, hogy frissítse a csatlakozót a Netsuite környezetének adataival.
A Tulip csatlakozójának a Netsuite TBA használatára történő konfigurálásához válassza az OAuth 1.0-t a HTTP-csatlakozó hitelesítési módjaként.
- Aláírási módnak válassza a HMAC-SHA256-ot.
- A verzió esetében győződjön meg róla, hogy 1.0-ra van beállítva.
- A fogyasztói kulcshoz adja meg a Netsuite-ban beállított Integrációs felhasználó által megadott fogyasztói kulcsot .
- A fogyasztói titok esetében adja meg a Netsuite-ban beállított Integrációs felhasználó által megadott fogyasztói titkot .
- A hozzáférési token esetében adja meg a Netsuite-ban beállított hozzáférési token token azonosítóját. Vegye figyelembe, hogy ezt a hozzáférési tokent a korábban beállított integrációs felhasználóhoz kell rendelni.
- A token titok esetében adja meg a Netsuite-ban beállított hozzáférési token token titkát. Vegye figyelembe, hogy ezt a hozzáférési tokent a korábban beállított integrációs felhasználóhoz kell rendelni.
- A realm esetében adja meg a Netsuite-példány aldomainjét nagybetűvel (például ha a Netsuite-ba való bejelentkezéshez a tstdrv123456.app.netsuite.com címet használja, a realm/aldomainje TSTDRV123456 lesz). Ha a Netsuite-példány aldomainjében kötőjel szerepel, akkor ezt aláhúzásként kell beírnia (például az sb1-123456-ot SB1_123456-ként kell beírni).
A beállítás után nyomja meg a csatlakozó konfigurációján belül a Teszt gombot, és kattintson a Mentés gombra, ha a teszt sikeresen lezajlott. Most már készen áll a RESTlet integrálására a Netsuite TBA módszerével.
2B lépés - Netsuite OAuth2.0 hitelesítési lehetőség
Először keresse meg a letöltött Tulip Netsuite Bundle Connector-t a Tulip példányában, hogy frissítse a csatlakozót a Netsuite környezetének adataival.
A NetSuite Connector Connectors oldalán kattintson a Környezeti beállítások menüpontra, hogy megnyíljon a kapcsolatinformációs modal.
Ezután válassza a fejlécek szerkesztése lehetőséget a megjelenő modálon.
Végül válassza az OAuth 2 (Admin) lehetőséget a hitelesítéshez.
Adja meg a következő értékeket:
Engedélyezési kód URL
https://<YOUR_SITE_ID>.app.netsuite.com/app/login/oauth2/authorize.nl
Hozzáférési token URL
https://<YOUR_SITE_ID>.suitetalk.api.netsuite.com/services/rest/auth/oauth2/v1/token
Terjedelem
restlets
Végül pedig másolja ki a webhelye átirányítási url értékét (fentebb https://prodgroup.tulip.co/oauth-redirect-handler néven látható ), és jegyezze fel az útmutató későbbi részében. Hagyja nyitva ezt az ablakot, mivel most elindulunk a NetSuite-ba, hogy hozzáadjuk az Integrációs rekordunkat.
Kezdjük egy új Integrációs rekord létrehozásával a NetSuite-ban a következő menüpontban:
Beállítás > Integráció > Integrációk kezelése > Új
Az alábbiakban látható képernyő jelenik meg. Győződjön meg róla, hogy az OAuth 2.0 szakasz engedélyezi az Engedélyezési kód megadását, a RESTLET hatókörét, a webhelyére jellemző átirányítási URI-t (amelyet az 1. lépésben másoltunk), és a Nyilvános ügyfél jelölőnégyzet engedélyezve van.
A Mentés gombra kattintás után az alábbi ábrához hasonló szakaszban megjelenik az Integráció ügyfél-azonosítója és titka.
Másolja ki és illessze be ezeket az értékeket a Tulip Connector Modal megfelelő szakaszaiba.
Ezen a ponton a Tulip Connectors modal összes elérhető mezőjének ki kell lennie töltve. Kattintson a Test gombra az engedélyezési folyamat elindításához, majd jelentkezzen be a NetSuite hitelesítő adatai segítségével.
A sikeres befejezést követően kattintson a Vissza gombra a Tulip Connectors modálban, hogy visszatérjen a kapcsolat részleteit tartalmazó képernyőre, majd a mentés gombra a hitelesítés mentéséhez. Most már készen áll a RESTlet integrálására a Netsuite OAuth2.0 módszerének használatával.
3. lépés - Szkript frissítése és a csatlakozófunkciók azonosítójának telepítése
A Tulip Integration Bundle szkriptet ezen a ponton kell telepíteni és telepíteni. A Netsuite RESTleteknek szükségük van az egyedi szkript azonosítóra és a deploy azonosítóra a funkcióhívás részeként. A szkript azonosítókkal kapcsolatos további információk itt találhatók.
Az egyedi azonosítók megtalálásához a Netsuite-példányában navigáljon a szkriptekhez a következő menüpontra:
Testreszabás -> Szkriptek -> Szkriptek.
Keresse meg a Tulip Integration Bundle Scriptle szkriptet, és kattintson a View (Megtekintés) gombra. Az alábbiakban láthatóhoz hasonló képernyő jelenik meg.
Kattintson a Deployments fülre, és válassza ki a Tulip Integration Bundle linket a Title (Cím) alatt. A belső szkript azonosító (ebben az esetben 734) és a telepítési azonosító (1) az alábbi képen az URL részeként jelenik meg. Jegyezze fel ezeket az azonosítókat, és navigáljon vissza a Tulip Netsuite Bundle Connectorhoz.
Nyissa meg a csomagon belüli bármelyik függvényt, és frissítse a szkriptet és a telepítési lekérdezési paramétereket (alább kiemelve) a fent azonosított konkrét azonosítókra. Vegye figyelembe, hogy a csatlakozón belül MINDEN függvényt frissíteni kell az egyedi szkript- és telepítési azonosítókkal. 
Most már készen áll a Netsuite Bundle és Unit Test alkalmazás használatára!
Hogyan működik
Az alkalmazás, a connector funkció és a Tulip Integration Bundle szkript együttesen módot nyújtanak arra, hogy kétirányúan kommunikáljanak alapvető gyártási funkciókat a Tulip és a Netsuite között. A Unit Test alkalmazás bemutatja a Tulip előre elkészített RESTlet által biztosított minden egyes funkcióhívást.
Az egyes kapcsolatok és működésük konkrét részleteiért, valamint a Netsuite Apps and Connector cikkel együtt, kérjük, olvassa el a Library Applicationt.