Neo4j

Entitas, operasi, dan tindakan

Semua Konektor Integrasi menyediakan lapisan abstraksi untuk objek aplikasi yang terhubung. Anda hanya dapat mengakses objek aplikasi melalui abstraksi ini. Abstraksi ini ditampilkan kepada Anda sebagai entitas, operasi, dan tindakan.

• Entitas: Entitas dapat dianggap sebagai objek, atau kumpulan properti, dalam aplikasi atau layanan yang terhubung. Definisi entitas berbeda dari konektor ke konektor. Misalnya, di konektor database, tabel adalah entitas, di konektor server file, folder adalah entitas, dan di konektor sistem pesan, antrean adalah entitas.

  Namun, ada kemungkinan konektor tidak mendukung atau tidak memiliki entity apa pun, sehingga daftar Entities akan kosong.

• Operasi: Operasi adalah aktivitas yang dapat Anda lakukan pada entity. Anda dapat melakukan salah satu operasi berikut pada entitas:
  • Daftar
  • Dapatkan
  • Buat
  • Update
  • Hapus

  Memilih entitas dari daftar yang tersedia akan menghasilkan daftar operasi yang tersedia untuk entitas tersebut. Untuk deskripsi mendetail tentang operasi, lihat operasi entitas tugas Konektor. Namun, jika konektor tidak mendukung operasi entitas apa pun, operasi yang tidak didukung tersebut tidak tercantum dalam daftar Operations.

• Tindakan: Tindakan adalah fungsi kelas pertama yang tersedia untuk integrasi melalui antarmuka konektor. Tindakan memungkinkan Anda membuat perubahan pada satu atau beberapa entitas, dan berbeda-beda dari konektor ke konektor. Biasanya, tindakan akan memiliki beberapa parameter input, dan parameter output. Namun, ada kemungkinan konektor tidak mendukung tindakan apa pun, sehingga daftar Actions akan kosong.

Tindakan

Bagian ini mencantumkan tindakan yang didukung oleh konektor. Untuk memahami cara mengonfigurasi tindakan, lihat Contoh tindakan.

Tindakan ExecuteCustomQuery

Tindakan ini memungkinkan Anda menjalankan kueri kustom.

Untuk membuat kueri kustom, ikuti langkah-langkah berikut:

1. Ikuti petunjuk mendetail untuk menambahkan tugas konektor.
2. Saat Anda mengonfigurasi tugas konektor, di jenis tindakan yang ingin Anda lakukan, pilih Tindakan.
3. Dalam daftar Tindakan, pilih Jalankan kueri kustom, lalu klik Selesai.

   

4. Luaskan bagian Input tugas, lalu lakukan hal berikut:
   1. Di kolom Waktu tunggu setelah, masukkan jumlah detik untuk menunggu hingga kueri dieksekusi.

      Nilai default: 180 detik.

   2. Di kolom Jumlah baris maksimum, masukkan jumlah baris maksimum yang akan ditampilkan dari database.

      Nilai default: 25.

   3. Untuk memperbarui kueri kustom, klik Edit Skrip Kustom. Dialog Script editor akan terbuka.

      

   4. Dalam dialog Editor skrip, masukkan kueri SQL, lalu klik Simpan.

      Anda dapat menggunakan tanda tanya (?) dalam pernyataan SQL untuk merepresentasikan satu parameter yang harus ditentukan dalam daftar parameter kueri. Misalnya, kueri SQL berikut memilih semua baris dari tabel Employees yang cocok dengan nilai yang ditentukan untuk kolom LastName:

      SELECT * FROM Employees where LastName=?

   5. Jika Anda telah menggunakan tanda tanya dalam kueri SQL, Anda harus menambahkan parameter dengan mengklik + Tambahkan Nama Parameter untuk setiap tanda tanya. Saat menjalankan integrasi, parameter ini menggantikan tanda tanya (?) dalam kueri SQL secara berurutan. Misalnya, jika Anda telah menambahkan tiga tanda tanya (?), maka Anda harus menambahkan tiga parameter sesuai urutan.

      

      Untuk menambahkan parameter kueri, lakukan hal berikut:

      1. Dari daftar Jenis, pilih jenis data parameter.
      2. Di kolom Nilai, masukkan nilai parameter.
      3. Untuk menambahkan beberapa parameter, klik + Tambahkan Parameter Kueri.

Jika berhasil dieksekusi, tindakan ini akan menampilkan status 200 (OK) dengan isi respons yang memiliki hasil kueri.

Contoh tindakan

Bagian ini menjelaskan cara melakukan beberapa tindakan di konektor ini.

Contoh - Membuat node

Contoh ini menunjukkan cara membuat node baru.

1. Pada dialog Configure Connector, pilih Region, Connection, and Actions.
2. Pilih Execute Custom Query dari tindakan, lalu klik Selesai.
3. Di bagian Task Input pada Connector, klik Edit Custom Script, lalu masukkan nilai yang mirip dengan berikut di kolom Custom Query:

   CREATE (:Movie {title: 'Hey', release_year: 2010})

Jika tindakan berhasil, parameter respons Execute Custom Query tugas connectorOutputPayload akan memberikan payload kosong [ ].

Contoh - Memperbarui node

Contoh ini menunjukkan cara memperbarui node.

1. Pada dialog Configure Connector, pilih Region, Connection and Actions.
2. Pilih Execute Custom Query dari tindakan, lalu klik Selesai.
3. Di bagian Task Input pada Connector, klik Edit Custom Script, lalu masukkan nilai yang mirip dengan berikut di kolom Custom Query:

   match(m:Movie{title: 'Inception'}) set m.release_year=2011 return m

Jika tindakan berhasil, nilai parameter respons connectorOutputPayload tugas Execute Custom Query akan terlihat seperti berikut:

[{ "m": "{\"release_year\":2011,\"title\":\"Inception\"}" }]

Contoh - Menghapus node

Contoh ini menunjukkan cara menghapus node.

1. Pada dialog Configure Connector, pilih Region, Connection and Actions.
2. Pilih Execute Custom Query dari tindakan, lalu klik Selesai.
3. Di bagian Task Input pada Connector, klik Edit Custom Script, lalu masukkan nilai yang mirip dengan berikut di kolom Custom Query:

   match(m:Movie{title: 'hey'}) delete m

Jika tindakan berhasil, parameter respons Execute Custom Query tugas connectorOutputPayload akan memberikan payload kosong [ ].

Contoh - Membuat hubungan

Contoh ini menunjukkan cara membuat hubungan.

1. Pada dialog Configure Connector, pilih Region, Connection and Actions.
2. Pilih Execute Custom Query dari tindakan, lalu klik Selesai.
3. Di bagian Task Input pada Connector, klik Edit Custom Script, lalu masukkan nilai yang mirip dengan berikut di kolom Custom Query:

   CREATE(movie:Movie {title: 'bcon'}), (actor:Actor {name: 'leo'})
   CREATE(actor)-[:ACTED_IN]->(movie)

Jika tindakan berhasil, parameter respons Execute Custom Query tugas connectorOutputPayload akan memberikan payload kosong [ ].

Contoh - Memperbarui hubungan

Contoh ini menunjukkan cara memperbarui hubungan.

1. Pada dialog Configure Connector, pilih Region, Connection and Actions.
2. Pilih Execute Custom Query dari tindakan, lalu klik Selesai.
3. Di bagian Task Input pada Connector, klik Edit Custom Script, lalu masukkan nilai yang mirip dengan berikut di kolom Custom Query:

   match(movie:Movie {title: 'demo'}), (actor:Actor {name: 'first'})
   match(actor)-[r:ACTED_IN]->(movie) set actor.name='second',r.year=2024 return actor,r,movie

Jika tindakan berhasil, nilai parameter respons connectorOutputPayload tugas Execute Custom Query akan terlihat seperti berikut:

[{   "actor": "{\"name\":\"second\"}",   "r": "{\"year\":2024}",   "movie": "{\"title\":\"demo\"}" }]

Contoh - Menghapus hubungan

Contoh ini menunjukkan cara menghapus hubungan.

1. Pada dialog Configure Connector, pilih Region, Connection and Actions.
2. Pilih Execute Custom Query dari tindakan, lalu klik Selesai.
3. Di bagian Task Input pada Connector, klik Edit Custom Script, lalu masukkan nilai yang mirip dengan berikut di kolom Custom Query:

   MATCH(movie:Movie {title: 'bcon44'}), (actor:Actor {name: 'jacky'})
   MATCH(actor)-[r:ACTED_IN]->(movie) delete r

Jika tindakan berhasil, parameter respons Execute Custom Query tugas connectorOutputPayload akan memberikan payload kosong [ ].

Contoh - Memperbarui label node

Contoh ini menunjukkan cara memperbarui label node.

1. Pada dialog Configure Connector, pilih Region, Connection and Actions.
2. Pilih Execute Custom Query dari tindakan, lalu klik Selesai.
3. Di bagian Task Input pada Connector, klik Edit Custom Script, lalu masukkan nilai yang mirip dengan berikut di kolom Custom Query:

   MATCH (n:Person) where id(n)=18 set n:Actor RETURN n

Jika tindakan berhasil, nilai parameter respons connectorOutputPayload tugas Execute Custom Query akan terlihat seperti berikut:

[{ "n": "{\"born\":1962,\"name\":\"Demi Moore\"}" }]

Contoh - Perbarui jenis hubungan

Contoh ini menunjukkan cara memperbarui jenis hubungan.

1. Pada dialog Configure Connector, pilih Region, Connection and Actions.
2. Pilih Execute Custom Query dari tindakan, lalu klik Selesai.
3. Di bagian Task Input pada Connector, klik Edit Custom Script, lalu masukkan nilai yang mirip dengan berikut di kolom Custom Query:

   MATCH (n:Person) where id(n)=18 set n.born=1963 RETURN n

Jika tindakan berhasil, nilai parameter respons connectorOutputPayload tugas Execute Custom Query akan terlihat seperti berikut:

[{ "n": "{\"born\":1963,\"name\":\"Demi Moore\"}" }]

Contoh - Membuat tipe data

Contoh ini menunjukkan cara membuat tipe data.

1. Pada dialog Configure Connector, pilih Region, Connection and Actions.
2. Pilih Execute Custom Query dari tindakan, lalu klik Selesai.
3. Di bagian Task Input pada Connector, klik Edit Custom Script, lalu masukkan nilai yang mirip dengan berikut di kolom Custom Query:

   CREATE (:Product {unitPrice: 109.50,
   unitsInStock: 390,
   supplierID: "1",
   productID: "dumy-2",
   discontinued: false,
   quantityPerUnit: "10 boxes x 20 bags",
   productName: "productName-1",
   unitsOnOrder: 0,
   reorderLevel: 10,
   supplier: ["1"],
   expiry: Duration("P14DT18H12M"),
   categoryID: "1",
   updatedAt: DateTime("1984-11-11T12:31:14Z")})

Jika tindakan berhasil, parameter respons Execute Custom Query tugas connectorOutputPayload akan memberikan payload kosong [ ].

Contoh - Memperbarui jenis data

Contoh ini menunjukkan cara memperbarui jenis data.

1. Pada dialog Configure Connector, pilih Region, Connection and Actions.
2. Pilih Execute Custom Query dari tindakan, lalu klik Selesai.
3. Di bagian Task Input pada Connector, klik Edit Custom Script, lalu masukkan nilai yang mirip dengan berikut di kolom Custom Query:

   match(p:Product{productID: "dumy-1"}) set p.duration = Duration("P15DT19H12M"), p.updatedAt=DateTime("1984-11-12T12:31:14Z") return p

Jika tindakan berhasil, nilai parameter respons connectorOutputPayload tugas Execute Custom Query akan terlihat seperti berikut:

[{ "p": "{\"unitPrice\":109.5,
\"unitsInStock\":390,
\"supplierID\":\"1\",
\"productID\":\"dumy-1\",
\"discontinued\":false,
\"quantityPerUnit\":\"10 boxes x 20 bags\",
\"productName\":\"productName-1\",
\"unitsOnOrder\":0,
\"duration\":\"P15DT19H12M\",
\"reorderLevel\":10,
\"supplier\":[\"1\"],
\"expiry\":\"P14DT18H12M\",
\"categoryID\":\"1\",
\"updatedAt\":\"1984-11-12T12:31:14Z\"}" }, 
{ "p":"{\"unitPrice\":109.5,
\"unitsInStock\":390,
\"supplierID\":\"1\",
\"productID\":\"dumy-1\",
\"discontinued\":false,
\"quantityPerUnit\":\"10 boxes x 20 bags\",
\"productName\":\"productName-1\",
\"unitsOnOrder\":0,
\"duration\":\"P15DT19H12M\",
\"reorderLevel\":10,
\"supplier\":[\"1\"],
\"expiry\":\"P14DT18H12M\",
\"categoryID\":\"1\",
\"updatedAt\":\"1984-11-12T12:31:14Z\"}" }]

Contoh - Menghapus jenis data

Contoh ini menunjukkan cara menghapus jenis data.

1. Pada dialog Configure Connector, pilih Region, Connection and Actions.
2. Pilih Execute Custom Query dari tindakan, lalu klik Selesai.
3. Di bagian Task Input pada Connector, klik Edit Custom Script, lalu masukkan nilai yang mirip dengan berikut di kolom Custom Query:

   match(p:Product{productID: "dumy-2"}) delete p

Contoh ini menunjukkan cara menghapus jenis data. Jika tindakan berhasil, parameter respons Execute Custom Query tugas connectorOutputPayload akan memberikan payload kosong [ ].

Contoh - Mendapatkan jumlah node

Contoh ini menunjukkan cara mendapatkan jumlah node.

1. Pada dialog Configure Connector, pilih Region, Connection and Actions.
2. Pilih Execute Custom Query dari tindakan, lalu klik Selesai.
3. Di bagian Task Input pada Connector, klik Edit Custom Script, lalu masukkan nilai yang mirip dengan berikut di kolom Custom Query:

   MATCH ()  
   RETURN count(*) AS numNodes

Jika tindakan berhasil, parameter respons Execute Custom Query task's connectorOutputPayload akan memberikan payload yang mirip dengan berikut ini:

[{
  "numNodes": 6267.0
}]

Contoh operasi entity

Bagian ini menunjukkan cara melakukan beberapa operasi entitas di konektor ini.

Contoh - Mencantumkan semua bahasa

Contoh ini menunjukkan cara mencantumkan semua bahasa.

1. Dalam dialog Configure connector task, klik Entities.
2. Pilih multilanguage_table dari daftar Entity.
3. Pilih operasi List, lalu klik Selesai.
4. Di bagian Pemeta Data, klik Buka Editor Pemetaan Data dan di sana Anda dapat menetapkan filterClause sesuai kebutuhan Anda.

Contoh - Mendapatkan bahasa

Contoh ini menunjukkan cara mendapatkan bahasa.

1. Dalam dialog Configure connector task, klik Entities.
2. Pilih multilanguage_table dari daftar Entity.
3. Pilih operasi Get, lalu klik Selesai.
4. Setel ID entitas ke Get single Language. Untuk menyetel ID entitas, di bagian Pemetaan Data, klik Buka Editor Pemetaan Data, lalu masukkan 58.0 di kolom Nilai Input dan pilih entityId sebagai Variabel lokal.