HUE Datagate (Önizleme)

Datagate, kullanıcılara iş verilerini depolamak, yönetmek ve iş verilerinden içgörüler oluşturmak için kolaylaştırılmış bir yöntem sağlayan, Works Uygulamaları'nın Hizmet Olarak Yazılım veri yönetimi platformudur. Bu bağlayıcı, Power Platform'dan Datagate'te iş verilerinizden yararlanmanızı sağlar.

Bu bağlayıcı aşağıdaki ürün ve bölgelerde kullanılabilir:

Hizmet	Class	Bölgeler
Logic Apps	Standart	Aşağıdakiler dışında tüm Logic Apps bölgeleri :      - Azure Kamu bölgeleri      - Azure Çin bölgeleri      - ABD Savunma Bakanlığı (DoD)
Power Automate	Premium	Aşağıdakiler dışında tüm Power Automate bölgeleri :      - ABD Kamu (GCC)      - US Government (GCC High)      - 21Vianet tarafından işletilen Çin Bulutu      - ABD Savunma Bakanlığı (DoD)
Power Apps	Premium	Aşağıdakiler dışında tüm Power Apps bölgeleri :      - ABD Kamu (GCC)      - US Government (GCC High)      - 21Vianet tarafından işletilen Çin Bulutu      - ABD Savunma Bakanlığı (DoD)

İletişim
İsim	@SUPPORT
URL	https://support.worksap.co.jp/
E-posta	marketing-info@worksap.co.jp

Bağlayıcı Meta Verileri
Publisher	Works Applications Co., Ltd.
Web sitesi	https://www.worksap.co.jp/
Gizlilik ilkesi	https://www.worksap.co.jp/privacypolicy/
Kategoriler	İş Zekası; Veri

Datagate, kullanıcılara iş verilerini depolamak, yönetmek ve iş verilerinden içgörüler oluşturmak için kolaylaştırılmış bir yöntem sağlayan, Works Uygulamaları'nın Hizmet Olarak Yazılım veri yönetimi platformudur. Verileri depolamak ve yönetmek için merkezi bir platform görevi görebilir

Bu bağlayıcı, Power Platform'dan Datagate'te iş verilerinize erişmeniz için bir API sağlar.

Önkoşullar

Bu bağlayıcıyı kullanmak için aşağıdaki öğeler gerekir:

• OData API'sine erişimi olan bir Datagate API Anahtarı.
• bir Datagate rolünün istenen tabloya erişimi olan kimlik bilgileri (rol kimliği, rol gizli dizisi).
• Datagate'te sorgu oluşturucuya erişmek için Datagate kullanıcı hesabı.

Kimlik bilgilerini alma

Datagate'te datagate API Anahtarı ve Datagate rolü adlı bir tabloya erişmek için iki kimlik doğrulaması ve yetkilendirme katmanı vardır. Aşağıda Datagate API Anahtarı ve Datagate rolü kimlik bilgilerini almak için basitleştirilmiş adımlar verilmiştir. Daha fazla bilgi için lütfen üzerindeki @SUPPORTDatagate kılavuzuna bakın veya danışmanlarımızla iletişime geçin.

Datagate API Anahtarını almak için:

1. Datagate ekranında oturum açın.
2. API Anahtar Yönetimi Sayfasına gidin. API Tuşu düğmesi sayfanın sol gezinti çubuğunda kullanılabilir. Anahtar simgesine tıklayın ve "API Anahtar Yönetimi" öğesini seçerek API Anahtar Yönetimi Sayfasına gidin.
3. Sayfanın sağ üst tarafındaki API tuşu oluştur düğmesine tıklayın.
4. API'yi Düzenle Sayfası boş alanlarla gösterilir.
5. API Anahtarı bilgileri bölümünde, istediğiniz açıklamayı doldurun.
6. API Anahtarını vermek için istediğiniz izinleri seçin.
7. İstediğiniz API Anahtarını oluşturmak için sayfanın sağ üst kısmındaki 'API Anahtarını Kaydet' düğmesine tıklayın.

Datagate rolü kimlik bilgilerini almak için:

1. Datagate ekranında oturum açın.
2. Rol Yönetimi Sayfasına gidin. Rol Yönetimi bağlantısı, sayfanın sol gezinti çubuğunda bulunabilir. Tablo simgesine tıklayın ve Rol Yönetimi Sayfasına gitmek için "Rol Yönetimi" öğesini seçin.
3. Sayfanın sağ üst tarafındaki Rol oluştur düğmesine tıklayın.
4. Rol Oluştur Sayfası gösterilir.
5. Rol bilgileri bölümünde, istediğiniz rol adını doldurun ve izin türünü seçin.
6. Şema veya tablo listesinden rolü vermek için istediğiniz izinleri seçin.
7. Yeni bir rol oluşturmak ve istenen rol kimlik bilgilerini almak için sayfanın sağ üst kısmındaki 'Rolü Kaydet' düğmesine tıklayın.

Bağlayıcınızı kullanmaya başlama

Şu anda, Datagate'te tablo verilerine okuma erişimine izin veren OData API'sinin kullanımı için kullanılabilen bir API vardır. Datagate OData sorgusu aracılığıyla, seçilecek sütunları, sıralama düzenini, Gerekli parametreler sorgu dizesidir ve tabloya erişimi olan bir rolün rol kimlik bilgileridir. Gerekli API Anahtarını ve rol kimlik bilgilerini alma adımları için önceki "Kimlik bilgilerini alma" bölümüne bakın. Sorgu dizesi almak için aşağıdaki adımlara bakın.

1. Datagate ekranında, Tablolar Listesi Sayfasında istediğiniz tabloyu arayın.
2. İstediğiniz tablonun Veri Görüntüleyicisi Sayfasını açın.
3. İstenen parametreleri ayarlayın ve sonuçta elde edilen sorgu dizesini kopyalayın.

Günlük Raporu E-postayla Gönder

Datagate'in bağlayıcısını kullanarak, her gün otomatik olarak satış raporu gönderen bir Güç akışı oluşturun

1. Kullanılacak API anahtarını hazırlayın. (Önceki "Kimlik bilgilerini alma" bölümüne bakın)
2. Rolü hazırlama (rol kimliği ve rol gizli dizisi). (Önceki "Kimlik bilgilerini alma" bölümüne bakın)
3. Çıkış tablosu için sorguyu alın.
4. Zamanlanmış bulut akışı oluşturma.
5. İstediğiniz zamanlamayı ayarlayın.
6. Zamanlama kümesinin doğru olduğunu doğrulayın.
7. Geçerli tarih saatini almak için adım ekleyin ve UTC saat diliminden istenen saat dilimine dönüştürün.
8. OData API adımı ekleyin. Sorgu dizesine değişkenler ekleyerek dinamik sorgu dizeleri oluşturmak mümkündür.
9. JSON Dönüştürme adımı ekleyin. Örnek bir JSON yükü kullanarak şemayı oluşturun.
10. HTML tablosu oluşturmak için adım ekleyin.
11. E-posta göndermek için adım ekleyin ve istediğiniz e-posta gövdesini girin, ardından bağlayıcıyı kaydedin. Akışı el ile çalıştırarak test etmeyi seçebilirsiniz.
12. E-posta, tanımlanan zamanlamaya göre aşağıdaki biçimde gönderilir.

Bilinen sorunlar ve sınırlamalar

Döndürülebilir verilerin maksimum boyutu API çağrısı başına 6 MB'tır.

İstenen veri kümesi boyutu 6 MB'tan büyükse, API çağrısı "413 Yük Çok Büyük" hatasını döndürür.

Yaygın hatalar ve çözümler

Şu anda bağlayıcıda OData API'sinde yalnızca bir API vardır. Aşağıda, API kullanılırken karşılaşabileceğiniz olası hatalardan bazıları verilmiştır.

200 Tamam

"ilişki "public_view.table_name" yok"

Tablo artık mevcut olmayabilir. Tabloya Datagate'in veri görüntüleyicisi aracılığıyla erişilip erişilemeyeceğini denetleyin.

""filtre ayrıştırılamadı (XXX)" (satır X, sütun X)"

Sağlanan sorguyla ilgili bir sorun var. Sorgunun Datagate ekranından doğru şekilde kopyalanıp kopyalanmadığını onaylayın.

413 Yük Çok Büyük

OData API'sinden yük boyutu için 6 MB sınırı vardır. OData sorgusunda "limit" parametresini ayarlayarak satır sayısına daha düşük bir sınır ayarlayın.

500 İç Sunucu Hatası

Sunucu bağlantısı kurulamadı. Sorunun devam edip etmediğini danışmanlarımızla kontrol edin.

FAQ

Aşağıda Datagate kullanıcılarının sık sorulan soruları yer alır. Burada ele alınmayan sorular veya daha fazla ayrıntı için lütfen Works Uygulamaları @SUPPORT platformunda bulunan Datagate kılavuzuna bakın, aksi halde danışmanlarımızla iletişime geçin.

Bağlayıcıdan dış tablo verilerini nasıl alabilirim?

İstenen dış tablonun veri görüntüleyici sayfasına erişin ve sorgu oluşturucusundan ilgili sorgu dizesini alın.

Bağlantı oluşturma

Bağlayıcı aşağıdaki kimlik doğrulama türlerini destekler:

Varsayılan	Bağlantı oluşturmak için parametreler.	Tüm bölgeler	Paylaşılamaz

Temerrüt

Geçerli: Tüm bölgeler

Bağlantı oluşturmak için parametreler.

Bu, paylaşılabilir bir bağlantı değildir. Power app başka bir kullanıcıyla paylaşılıyorsa, başka bir kullanıcıdan açıkça yeni bağlantı oluşturması istenir.

İsim	Türü	Description	Gerekli
Datagate API Anahtarı	securestring	Datagate'ten API Anahtarı	Doğru

Azaltma Sınırları

Name	Çağrılar	Yenileme Dönemi
Bağlantı başına API çağrıları	100	60 saniye

Eylemler

OData API

OData sorgusunu kullanarak Datagate'ten veri almak için bu API'yi kullanın. Veri Görüntüleyicisi sayfasından OData sorgusunu alın.

OData API

İşlem Kimliği:

odata

OData sorgusunu kullanarak Datagate'ten veri almak için bu API'yi kullanın. Veri Görüntüleyicisi sayfasından OData sorgusunu alın.

Parametreler

Name	Anahtar	Gerekli	Tür	Description
OData Sorgusu	query	True	string	Datagate verileri için OData sorgusu. Bunu Datagate'in sorgu oluşturucusundan alabilirsiniz.
Datagate Ana Bilgisayar URL'si	host_url	True	string	Datagate hizmetinizin ana bilgisayar URL'si, örneğin: https://tenant-name.datagate.worksap.com/
Datagate Rol Kimliği	role-id	True	string	Datagate rolünüzün rol kimliği
Datagate Rol Gizli Dizisi	role-secret	True	string	Datagate rolünüzün Rol Gizli Dizisi