REST API 'si ile veri içe aktarma ve dışa aktarma

You can use REST APIs to export data from your C system into an external system or application and to import data from an external system or application into your Yönet system. JSON, XML ' i dışa aktarabilir ve içe aktarabilirsiniz. ya da CSV dosyalarına bakın.

Verilerin içe aktarılması

Verileri içe aktarmak için, verileri tüketen Manage (Yönet) iş nesnelerine gönderme yapan bir Manage (Yönet) nesne yapısı seçmeniz gerekir. Bir CSV dosyası kullanıyorsanız, düz dosyalar için etkinleştirilen bir nesne yapısı seçmeniz gerekir. Birincil API için olan tüm nesne yapıları düz dosya etkindir.

Veriler, bir iç Yönet havuzunda saklanmadan önce, veriler için sözdizim doğrulanır.

Aşağıdaki tabloda, REST API ' ları kullanılarak veri içe aktarıma örnekleri yer almaktadır:

Tablo 1. Veri içe aktarmaya ilişkin örnekler
Kullanım senaryosu	REST API çağrıları ve yanıtları
Veriler, 10 kayıt içeren bir CSV dosyasından zamanuyumlu olarak içe aktarılır.	Aşağıdaki arama kullanılır: `POST /maximo/api/os/object structure?action=importfile CSV file content` Şu yanıt döndürüldü: `{ “validdocs”:10 }`
Varlık ve site verileri, bir JSON dosya dizisinden zamanuyumlu olarak içe aktarıldı	Aşağıdaki arama kullanılır: `POST /maximo/api/os/object structure?action=importfile Filetype: JSON [ { “assetnum”:”asset number”, “siteid”:”site ID” }, { “assetnum”:”asset number”, “siteid”:”site ID” } ]`
Veriler, zamanuyumsuz olarak bir CSV dosyasından içe aktarılır.	Aşağıdaki arama kullanılır: `POST /maximo/api/os/object structure?action=importfile&name=filename.csv&async=1 CSV file content`

Not: .notation özniteliğini ya da diğer adını kullanan bir CSV dışa aktarımını yaparken, çıkış küçük harfle olur. Bu sorun artık Maximo® Manage 8.5 ' ta sabittir ve çıkış şu anda büyük harfle olur.

APIFILEIMPORT sıralanmış görevi, içe aktarılan verileri alır ve içeriği işler. Sıralanmış görev her 30 dakikada bir çalıştırılır ve sıralanmış görevin ne sıklıkta çalıştırılacağını yapılandırabilirsiniz.

Verileri içe aktardıktan sonra, APIFILEIMPORT sıralanmış görevi durumunu içeren bir konum URL 'si sağlanır. Sıralanmış görev verileri işlerken bir hata oluşursa, konum URL 'sine yanıt, karşıdan yükleyebileceğiniz bir hata dosyasına bağlanan bir URL ile katıştırılmış olur. Hata çözüldüğünde, dosyayı yeniden içe aktarın. name sorgu parametresi için yeni bir ad belirtmeye dikkat edin.

Bu hata yanıtını etkinleştirmek için bir JSON dosyası kullanıyorsanız, Filetype istek üstbilgisinin JSONolması gerekir.

Aşağıdaki yanıt, bir hata oluştuğunda konum URL 'sine verilen yanıtın bir örneğidir. Dosya tipi JSON ' dır.


{
 "iscomplete": true,
 "totalcount": 3,
 "errcount": 1,
 "requser": "Username",
 "fileimportreqqueueid": 3,
 "format": "JSON",
 "errorfile": "http://host:port/maximo/api/fileimporterrfile/3",
 "_rowstamp": "1521573",
 "iscancelled": false,
 "reqdatetime": "2019-02-20T14:08:22-05:00",
 "name": "testloc3.json",
 "href": "http://host:port/maximo/api/os/mxapifileimportqueue/_dGVzdGxvYzMuanNvbg--",
 "pindex": 3,
 "osname": "MXAPIOPERLOC"
}

Verilerin dışa aktarılması

Bir makine-makine bütünleştirmesi için REST API ' lerini kullanarak verileri dışa aktarırsanız, dış istemci için bir API anahtarı oluşturmanız gerekir.

Verileri dışa aktarmak için varsayılan dosya biçimi JSON 'tır.

Örneğin, aşağıdaki REST API çağrısı, MXAPIASSET nesne yapısından bir CSV dosyası olarak varlık, site ve konum verilerini dışa aktarır:

GET /api/os/mxapiasset?oslc.select=assetnum,siteid,status,location&oslc.pageSize=100&
oslc.where=status=”OPERATING”&_format=csv&apikey=API key

Yeni REST API 'leri hakkında daha fazla bilgi için Maximo REST API' sına bakın.