W tym artykule skupi\u0119 si\u0119 w szczeg\u00f3lno\u015bci na opisaniu procesu pozyskania danych poprzez API<\/strong> (Application Programming Interface) na przyk\u0142adzie danych o zadaniach zaraportowanych w systemie Jira.<\/strong><\/p>\n\n\n\n W tym przypadku wykorzystanie API jest przydatne do uzyskania aktualnych informacji o zadaniach, statusach, przypisanych osobach i innych kluczowych danych projektowych. Do\u015b\u0107 cz\u0119sto API jest jedynym interfejsem pozyskania danych, gdy\u017c bezpo\u015bredni dost\u0119p do bazy danych systemu \u017ar\u00f3d\u0142owego nie zawsze le\u017cy w zasadach bezpiecze\u0144stwa, licencji i administracji w korporacji, a dost\u0119p po\u015bredni poprzez wyeksportowane pliki wi\u0105\u017ce si\u0119 z pewnymi op\u00f3\u017anieniami i innymi problemami.<\/p>\n\n\n\n Matillion oferuje kilka komponent\u00f3w do integracji z API:<\/p>\n\n\n\n R\u00f3\u017cnice mi\u0119dzy API Query a Python z bibliotek\u0105 requests:<\/p>\n\n\n\n API Query component w Matillion ma kilka ogranicze\u0144, kt\u00f3re warto wzi\u0105\u0107 pod uwag\u0119:<\/p>\n\n\n\n Wa\u017cne:<\/strong> Dla cel\u00f3w artyku\u0142u kilka temat\u00f3w zosta\u0142o uproszczonych. Dla bezpieczenstwa i zgodno\u015bci z polityk\u0105 firmy skontaktuj sie z lokalnym dzialem IT.<\/p>\n\n\n\n Scenariusz:<\/strong> Sprawd\u017a, jakie zadania Jira s\u0105 zakomitowane do brancha QA. Nast\u0119pnie pobierz dla nich: numer (key), nazw\u0119 (summary), status oraz przypisan\u0105 osob\u0119 (assignee). Je\u015bli wszystkie zadania maj\u0105 status \u201eDone\u201d, wykonaj operacj\u0119 Merge z QA do PROD, a nast\u0119pnie, wykorzystuj\u0105c numer oraz nazw\u0119, uzupe\u0142nij \u201eRelease Notes\u201d.<\/p>\n\n\n\n Po uruchomieniu, w tabeli Jira_tickets_output powinny znale\u017a\u0107 si\u0119 wszystkie wiersze z tabeli Jira_tickets_input z dodatkowymi informacjami takimi jak:<\/p>\n\n\n\n Dla por\u00f3wnania, skrypt Python z bibliotek\u0105 request, r\u00f3wnie\u017c z wykorzystaniem komponentu [Table Iterator], m\u00f3g\u0142by wygl\u0105da\u0107 mniej wi\u0119cej tak:<\/p>\n\n\n W artykule przedstawi\u0142em, jak wykorzysta\u0107 komponent API Query<\/strong> w Matillion do integracji z Jira API<\/strong>, pokazuj\u0105c krok po kroku, w jaki spos\u00f3b pobra\u0107 dane o zadaniach \u2013 ich numer, nazw\u0119, status oraz przypisan\u0105 osob\u0119.<\/p>\n\n\n\n API Query<\/strong> okaza\u0142 si\u0119 narz\u0119dziem:<\/p>\n\n\n\n Dzi\u0119ki zastosowaniu profilu API i komponentu API Query mo\u017cliwa jest szybka automatyzacja pobierania danych projektowych z Jira, bez konieczno\u015bci pisania kodu. To rozwi\u0105zanie sprawdza si\u0119 szczeg\u00f3lnie dobrze<\/strong> w przypadku standardowych zapyta\u0144, gdzie liczy si\u0119 prostota i szybko\u015b\u0107 wdro\u017cenia.<\/strong><\/p>\n\n\n\n Dla bardziej z\u0142o\u017conych scenariuszy, np. dynamicznych zapyta\u0144, niestandardowej paginacji czy zaawansowanej obs\u0142ugi b\u0142\u0119d\u00f3w, warto rozwa\u017cy\u0107 u\u017cycie komponentu<\/strong> Python Script<\/strong> z bibliotek\u0105 requests.<\/p>\n\n\n\n Integracja Matillion z Jira to \u015bwietny przyk\u0142ad, jak po\u0142\u0105czy\u0107 \u015bwiat zarz\u0105dzania projektami z analiz\u0105 danych,<\/strong> umo\u017cliwiaj\u0105c tworzenie raport\u00f3w, dashboard\u00f3w i automatycznych alert\u00f3w w oparciu o dane z codziennej pracy zespo\u0142\u00f3w.<\/p>\n\n\nIntegracja z API<\/strong><\/h2>\n\n\n\n
\n
Cecha<\/strong><\/strong><\/td> API Query <\/strong><\/strong><\/td> Python Script (requests)<\/strong><\/strong><\/td><\/tr><\/thead> \u0141atwo\u015b\u0107 u\u017cycia<\/td> Wysoka \u2013 interfejs graficzny<\/td> \u015arednia \u2013 wymaga znajomo\u015bci Pythona<\/td><\/tr> Elastyczno\u015b\u0107<\/td> Ograniczona do struktury JSON\/XML<\/td> Bardzo wysoka \u2013 pe\u0142na kontrola<\/td><\/tr> Obs\u0142uga b\u0142\u0119d\u00f3w<\/td> Podstawowa<\/td> Mo\u017cliwo\u015b\u0107 zaawansowanej obs\u0142ugi b\u0142\u0119d\u00f3w<\/td><\/tr> Integracja z Matillion<\/td> Bezpo\u015brednia<\/td> Wymaga r\u0119cznego mapowania danych<\/td><\/tr> Wydajno\u015b\u0107<\/td> Optymalna dla prostych zapyta\u0144<\/td> Lepsza dla niestandardowych API<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n Ograniczenia API Query component w Matillion<\/strong><\/h3>\n\n\n\n
\n
\n
\n
\n
\n
\n
\n
Przyk\u0142ad: Pobieranie danych z Jira API przy u\u017cyciu API Query<\/strong><\/h2>\n\n\n\n
Krok 1: Token API<\/strong><\/h3>\n\n\n\n
\n
\n
![\"New](\"https:\/\/sii.pl\/blog\/wp-content\/uploads\/2025\/10\/image1-3.png\")
Krok 2: Query Profile<\/strong><\/h3>\n\n\n\n
\n
\n
\n
\n
<api:set attr=”uri” value=”” \/><\/li>\n\n\n\n
<api:set attr=”paramname#1″ value=”uri” \/>
<api:set attr=”paramvalue#1″ value=”[_connection.uri]” \/>
Chcemy, \u017ceby URI by\u0142o przekazywane przez zmienn\u0105, kt\u00f3ra b\u0119dzie si\u0119 aktualizowa\u0107 z ka\u017cdym wierszem z tabeli (pobieranym iteratorem).<\/li>\n<\/ul>\n<\/li>\n\n\n\n\n<api:script xmlns:api="http:\/\/apiscript.com\/ns?v1" xmlns:xs="http:\/\/www.w3.org\/2001\/XMLSchema">\n\n <api:info title="jira_tickets_endpoint" desc="Generated schema file." xmlns:other="http:\/\/apiscript.com\/ns?v1">\n <attr name="key" xs:type="string" readonly="false" other:xPath="\/json\/key" \/>\n <attr name="fields.summary" xs:type="string" readonly="false" other:xPath="\/json\/fields\/summary" \/>\n <attr name="fields.status.name" xs:type="string" readonly="false" other:xPath="\/json\/fields\/status\/name" \/>\n <attr name="fields.assignee.displayName" xs:type="string" readonly="false" other:xPath="\/json\/fields\/assignee\/displayName" \/>\n <\/api:info>\n\n <api:set attr="DataModel" value="DOCUMENT" \/>\n <api:set attr="uri" value="" \/>\n\n <api:set attr="JSONPath" value="\/" \/>\n \n <api:set attr="paramname#1" value="uri" \/>\n <api:set attr="paramvalue#1" value="[_connection.uri]" \/>\n \n <api:script method="GET">\n <api:set attr="method" value="GET"\/> \n <api:call op="jsonproviderGet">\n <api:push\/>\n <\/api:call>\n <\/api:script>\n\n<\/api:script>\n<\/pre><\/div>\n\n\n
\n
Krok 3: Orchestration Job<\/strong><\/h3>\n\n\n\n
\n
\n
\n
Poprawno\u015b\u0107 URL mo\u017cna przetestowa\u0107 w przegl\u0105darce internetowej.<\/span><\/li>\n\n\n\n\n
\n
\n
\n
\n
\n
Rezultat<\/strong><\/h3>\n\n\n\n
![\"Wynik](\"https:\/\/sii.pl\/blog\/wp-content\/uploads\/2025\/10\/image2.png\")
\n
\nimport requests\nissue_key = jv_jira_task \nbase_url = "https:\/\/jira.domain.com"\nendpoint = f"{base_url}\/rest\/api\/2\/issue\/{issue_key}"\nheaders = {\n "Authorization": "Bearer API_TOKEN",\n "Accept": "application\/json"\n}\nresponse = requests.get(endpoint, headers=headers)\nif response.status_code == 200:\n data = response.json()\n issue_data = {\n "key": data["key"],\n "summary": data["fields"]["summary"],\n "status": data["fields"]["status"]["name"],\n "assignee": data["fields"]["assignee"]["displayName"] if data["fields"]["assignee"] else "Nieprzypisane"\n }\n print("Dane zadania Jira:")\n for k, v in issue_data.items():\n print(f"{k}: {v}")\nelse:\n print(f"B\u0142\u0105d: {response.status_code} - {response.text}")\n<\/pre><\/div>\n\n\n![\"oferty](\"https:\/\/sii.pl\/blog\/wp-content\/uploads\/2025\/10\/praca-m.jpg\")
<\/a><\/figure>\n\n\n\nPodsumowanie<\/strong><\/h2>\n\n\n\n
\n