mindzie NetSuite Yöneticiler İçin Kurulum Rehberi

Genel Bakış

Bu rehber, bir NetSuite yöneticisini mindzie'nin NetSuite hesabınıza programatik, salt okunur erişim sağlamak için gereken yapılandırma adımlarında yönlendirir. Böylece mindzie, yapay zeka destekli süreç madenciliği ve analiz için veri çıkarabilir.

Kurulum, NetSuite'nin standart Token Based Authentication (TBA) mekanizmasını kullanır. Hiçbir şifre paylaşılmaz. mindzie, sizin oluşturduğunuz, kapsamını belirlediğiniz ve istediğiniz zaman iptal edebileceğiniz özel token setini alır.

Tüm süreç, gerekli NetSuite izinlerine sahip bir yönetici için genellikle 15-30 dakika sürer.

mindzie'nin Yapabilecekleri

mindzie için oluşturduğunuz rol, tüm hesapta salt okunurdur. mindzie NetSuite’de herhangi bir kayıt oluşturamaz, güncelleyemez veya silemez.

Rol, aynı token kimlik bilgilerini kullanan dört programatik erişim kanalını açar:

Kanal Amaç
REST Web Services HTTPS üzerinden kayıt düzeyinde okuma ve SuiteQL sorguları
SuiteAnalytics Connect Tarihsel veri yüklemeleri için ODBC/JDBC toplu çıktı
SuiteAnalytics Connect - Read All Konsolide analiz için yan kuruluşlar arası okuma
SuiteScript / RESTlets Ekibiniz özel uç noktalar oluşturursa çağrı yapmak

Kimlik doğrulama OAuth 1.0a TBA (NetSuite'in sunucudan sunucuya entegrasyonlar için önerdiği desen) kullanılarak yapılır. Temel kimlik doğrulama ve şifre bazlı erişim kullanılmaz.

Ön Koşullar

Başlamadan önce doğrulayın:

  • Rol, kullanıcı, entegrasyon kaydı ve erişim tokenleri oluşturabilecek Yönetici veya eşdeğer izinlere sahip bir NetSuite rolünüz var.
  • Aşağıda gerekli SuiteCloud özellikleri hesabınızda lisanslanmış (Token Based Authentication, REST Web Services, SuiteAnalytics Connect). Eksik olan varsa devam etmeden önce NetSuite hesap yöneticinizle iletişime geçin.
  • NetSuite Hesap ID’nizi biliyorsunuz (giriş yaptığınızda URL’de görünür, örn. 1234567 veya sandbox için 1234567_SB1).

Yapılandırma Adımları

Beş adımı sırasıyla tamamlayın. 1 ve 2. adımlar NetSuite hesabı başına sadece bir kez yapılır; TBA ve Entegrasyon özellikleri zaten etkinse 1. Adımı atlayabilirsiniz.

Adım 1: Gerekli Özellikleri Etkinleştirin

  1. Setup -> Company -> Enable Features menüsüne gidin.
  2. SuiteCloud sekmesini açın.
  3. Aşağıdakilerin etkin olduğunu doğrulayın (aktif değilse kutucuğu işaretleyip kaydedin):
    • Token-Based Authentication
    • REST Web Services
    • SuiteAnalytics Workbook
    • SuiteAnalytics Connect (SuiteAnalytics altında)
    • Client SuiteScript ve Server SuiteScript
  4. İstenirse SuiteCloud hizmet şartlarını kabul edin.
  5. Save butonuna tıklayın.

Adım 2: Entegrasyon Kaydını Oluşturun

Entegrasyon kaydı, mindzie uygulamasının NetSuite hesabınıza bağlanmasını temsil eder. Consumer Key ve Consumer Secret değerlerini üretir.

  1. Setup -> Integration -> Manage Integrations -> New menüsüne gidin.
  2. Şunları doldurun:
    • Name: mindzie Studio
    • State: Enabled
    • Description: mindzie process mining integration - read only
  3. Authentication bölümünde:
    • Token-Based Authentication seçeneğini işaretleyin.
    • TBA: Authorization Flow seçeneğinin işaretini kaldırın (sunucudan sunucuya için gerekli değil).
    • Authorization Code Grant seçeneğinin işaretini kaldırın (OAuth 2.0, burada kullanılmıyor).
  4. Save butonuna tıklayın.
  5. Önemli: NetSuite, ekranın altında Consumer Key / Client ID ve Consumer Secret / Client Secret değerlerini sadece bir kez gösterir. Her iki değeri hemen güvenli bir parola yöneticisine kopyalayın. Kaybederseniz sıfırlamanız ve yeniden oluşturmanız gerekir.

Adım 3: mindzie Rolünü Oluşturun

Bu rol, mindzie'nin ne görebileceğini kontrol eder. Salt okunurdur.

  1. Setup -> Users/Roles -> Manage Roles -> New menüsüne gidin.

  2. General bölümünü yapılandırın:

    • Name: mindzie Studio Role
    • ID: _mindzie_studio_role (veya otomatik atanması için boş bırakın)
    • Center Type: Classic Center
    • Web Services Only Role seçeneğini işaretleyin
    • Core Administration Permissions seçeneğini işaretleyin

  3. Permissions alt sekmesinde her bölümü yapılandırın:

    Transactions, Lists, Custom Record: Tüm izinleri View (salt okunur) olarak ayarlayın.

    Reports: SuiteAnalytics Workbook'u View seviyesiyle ekleyin.

    Setup: Aşağıdakileri Full seviyede ekleyin (belirtilmezse Full):

    • Log in using Access Tokens -- Full
    • REST Web Services -- Full
    • SuiteAnalytics Connect -- Full
    • SuiteAnalytics Connect - Read All -- Full
    • SuiteScript -- Full
    • User Access Tokens -- Full

  4. Subsidiary Restrictions (Sadece OneWorld hesaplar için): Güvenlik politikanız aksi belirtmedikçe All yan kuruluşları seçin.

  5. Save butonuna tıklayın.

Adım 4: mindzie Kullanıcısını Oluşturun

Dedicated bir çalışan kaydı rol atamasını tutar. mindzie bu kullanıcı ile interaktif giriş yapmaz; kullanıcı sadece erişim tokenını bağlamak için vardır.

  1. Lists -> Employees -> Employees -> New menüsüne gidin.
  2. Gerekli minimum alanları doldurun:
    • Name: mindzie API User
    • Email: ekibinizin kontrol ettiği bir e-posta adresi (NetSuite zorunlu kılar; mindzie gelen kutusuna erişim istemez).
    • Subsidiary: ana yan kuruluş (Sadece OneWorld hesaplar).
  3. Access alt sekmesini açın:
    • Give Access seçeneğini işaretleyin.
    • Send New Access Notification Email seçeneğinin işaretini kaldırın.
    • Roles altında mindzie Studio Role rolünü ekleyin.
  4. Save butonuna tıklayın.

Adım 5: Erişim Tokeni Oluşturun

Bu adım entegrasyon, kullanıcı ve rolü birleştirir ve size Token ID ile Token Secret değerlerini verir.

  1. Setup -> Users/Roles -> Access Tokens -> New menüsüne gidin.
  2. Şunları doldurun:
    • Application Name: mindzie Studio (Adım 2’de oluşturulan entegrasyon)
    • User: mindzie API User (Adım 4’te oluşturulan kullanıcı)
    • Role: mindzie Studio Role (Adım 3’te oluşturulan rol)
    • Token Name: mindzie Studio Token (veya varsayılan bırakın)
  3. Save butonuna tıklayın.
  4. Önemli: NetSuite, size Token ID ve Token Secret değerlerini sadece bir kez gösterir. Her iki değeri hemen güvenli parola yöneticinize kopyalayın.

mindzie'ye Gönderilecekler

Yukarıdaki adımları tamamladıktan sonra aşağıdaki beş değeri mindzie'ye gönderin. Hepsi gereklidir; herhangi biri eksikse mindzie bağlanamaz.

# Öğenin Adı Kaynağı Örnek format
1 Account ID NetSuite URL'niz 1234567 veya 1234567_SB1
2 Consumer Key / Client ID Adım 2 (Entegrasyon Kaydı) 64 karakterlik hex dizi
3 Consumer Secret / Client Secret Adım 2 (Entegrasyon Kaydı) 64 karakterlik hex dizi
4 Token ID Adım 5 (Erişim Tokeni) 64 karakterlik hex dizi
5 Token Secret Adım 5 (Erişim Tokeni) 64 karakterlik hex dizi

Ayrıca faydalı ancak zorunlu olmayan:

  • NetSuite ortamı: Üretim, Sandbox veya Release Preview
  • Ana yan kuruluş (OneWorld hesapları için) ve para birimi
  • İlk yükleme için istediğiniz tarih aralığı
  • NetSuite hesabınızın saat dilimi

Güvenli Gönderim Yöntemleri

Bu dört gizli değer, tüm NetSuite hesabınıza salt okunur erişim verir. Onları bir üretim veri tabanı şifresi gibi saklayın.

Göndermeyin:

  • Düz metin e-posta ile
  • Süresi dolan gizli özellik içermeyen Slack, Teams veya diğer sohbet araçlarıyla
  • Paylaşılan ağ sürücüleri veya şifrelenmemiş dosya paylaşımlarıyla
  • Bilet ya da wiki içindeki ekran görüntüleriyle

Gönderin:

  • Tek kullanımlık gizli bağlantı hizmetleriyle (örn. 1Password "Share", Bitwarden Send, Doppler share veya kurumsal eşdeğer) ve 24 saat veya daha az geçerlilik süresiyle.
  • BT tarafından onaylı kanalınız üzerinden şifreli mesajla.
  • Planlanmış bir çağrıda, siz okurken mindzie mühendisi bağlantıya doğrudan girer.

Teslim yöntemi istiyorsanız, mindzie kontak kişinize sorun; size tek kullanımlık gizli bağlantı gönderebiliriz.

Sonra Ne Olur

mindzie kimlik bilgilerini aldıktan sonra:

  1. mindzie Studio NetSuite bağlayıcısına gireriz.
  2. Bağlantı testi yaparız (hesap meta verisine tek bir okuma).
  3. Bağlantının sağlıklı olduğunu yazılı olarak size bildiririz.
  4. İlk tarihsel veri çıkarmayı sizinle planlarız.

İlk çıkarım yüksek okuma gerektirir; ay sonu kapanışı veya diğer yoğun dönemlerle çakışmaması için zamanlamayı ekibinizle koordine ederiz.

Kurulumu Kendiniz Doğrulama

Kimlik bilgilerini göndermeden önce rolün çalıştığını, mindzie API User olarak NetSuite’e giriş yapıp mindzie Studio Role rolüne geçerek doğrulayabilirsiniz:

  • SuiteAnalytics Workbook menüsünü erişim reddedilmeden açabiliyor musunuz kontrol edin.
  • Herhangi bir işlem veya liste kaydını düzenlemeden görüntüleyebiliyor musunuz test edin.

İnteraktif olarak başka pek bir şey yapamayacaksınız, bu beklenen bir durumdur - bu rol API erişimi içindir, insan kullanımı için değil.

Erişimi İptal Etme

mindzie erişimini kesmeniz gerekirse:

  • En hızlı: Setup -> Users/Roles -> Access Tokens menüsünden mindzie tokenını bulun ve Revoke (İptal Et) tıklayın. Bu bağlantıyı hemen keser.
  • Daha kapsamlı: Entegrasyon kaydını (Adım 2) devre dışı bırakın ve mindzie API User çalışan kaydını pasifleştirin.

İptalden sonra mindzie destek ekibini bilgilendirin, biz de kendi tarafımızda temizleme yapar ve değişikliği onaylarız.

Yardıma mı İhtiyacınız Var?

mindzie destek ile iletişime geçin: support@mindzie.com

İletirken şunları belirtin:

  • NetSuite Hesap ID’niz (gizli bilgileri e-postaya dahil etmeyin)
  • Takıldığınız adım numarası
  • NetSuite’in gösterdiği kesin hata mesajı

Gerekirse yöneticinizle birlikte ekran paylaşımı yaparak belgelenen adımların dışında kalan sorunların üzerinden geçebiliriz.