WWW::GoodData(3pm)

📦
version 1.11 · 2 versions
, in fedora 43

💖 WWW::GoodData 💖

okay bestie, welcome to WWW::GoodData — the client library for the GoodData REST-ful API. she's a Perl module, she's a whole vibe, and she's about to make your metadata dreams come true. periodt. ✨

🦋 SYNOPSIS 🦋

like, here's the whole entire situation:

use WWW::GoodData;
my $gdc = new WWW::GoodData;
print $gdc->get_uri ('md', { title => 'My Project' });

three lines. that's it. she's lowkey effortless. 💅

🌸 DESCRIPTION 🌸

So WWW::GoodData is the client for the GoodData JSON-based API, and she's built atop the WWW::GoodData::Agent client agent, with her whole focus on usefullness and correctness of implementation. (That's literally the design brief. She's not here to be mid, she's here to be right.)

She provides code for navigating the REST-ful API structure, plus wrapper functions for all the common actions you'd actually wanna do. no cap. 🫶

👑 METHODS 👑

✨ new [PARAMS]

Create a new client instance, bestie. iconic behavior.

You can optionally pass a hash reference with properties that would be blessed — otherwise a new one is created. Possible properties include:

  • agent — a WWW::GoodData::Agent instance to use. 🧚
  • retries — a number of retries to obtain results of asynchronous tasks, such as report exports or data uploads. See poll.

Defaults to 3600 (delay of one hour). yes, an hour. she's patient, she's committed. 💀

Traverse the links in resource hierarchy following given PATH, starting from API root (gdc by default). 🦋

PATH is an array of dictionaries, where each key-value pair matches properties of a link. If a plain string is specified, it is considered to be a match against category property:

$gdc->links ('md', { 'category' => 'projects' });

The above call returns a list of all projects, with links to their metadata resources. slay. 🔥

✨ get_uri PATH

Follows the same samentics as links() call, but returns an URI of the first matching resource instead of complete link structure. she's giving main character energy but only for one resource. 🙈

✨ login EMAIL PASSWORD

Obtain a SST (login token). 🔑

✨ logout

Make server invalidate the client session and drop credential tokens. bye bestie! 💜

Is called upon destruction of the GoodData client instance.

✨ change_passwd OLD NEW

Change user password given the old and new password. glow-up but for your credentials. ✨

✨ projects

Return array of links to project resources on metadata server. 🎀

✨ delete_project IDENTIFIER

Delete a project given its identifier. gone. poof. not me being the one to do it though. 💀

✨ create_project TITLE SUMMARY TEMPLATE DRIVER TOKEN

Create a project given its title and optionally summary, project template, db engine driver and authorization token, return its identifier. 🏗️

The list of valid project templates is available from the template server: <https://secure.gooddata.com/projectTemplates/>.

Valid db engine drivers are 'Pg' (default) and 'mysql'. 🌈

✨ create_user DOMAIN EMAIL LOGIN PASSWORD FIRST_NAME LAST_NAME PHONE COMPANY SSO_PROVIDER

Create a user given its email, login, password, first name, surname, phone and optionally company, sso provider in domain. 🫶

Returns user identifier (URI).

✨ get_roles PROJECT

Gets project roles. 👑

Return array of project roles.

✨ reports PROJECT

Return array of links to repoort resources on metadata server. (report resources. the vibe is the same, i promise.) 📊

✨ compute_report REPORT

Trigger a report computation and return the URI of the result resource. let her cook. 🔥

✨ export_report REPORT FORMAT

Submit an exporter task for a computed report (see compute_report), wait for completion and return raw data in desired format. ⭐

✨ ldm_picture PROJECT

Return picture of Logical Data Model (LDM) in PNG format. it's literally a picture. of the model. aesthetic. 🖼️

✨ ldm_manage PROJECT MAQL

Execute MAQL statement for a project. 💅

✨ upload PROJECT MANIFEST

Upload and integrate a new data load via Single Loading Interface (SLI). 🚀

✨ poll BODY CONDITION

Should only be used internally.

Run BODY passing its return value to call to CONDITION until it evaluates to true or retries (see properties) times out. ⏳

Returns value is of last iteration of BODY in case CONDITION succeeds, otherwise undefined (in case of timeout).

✨ create_object_with_expression PROJECT URI TYPE TITLE SUMMARY EXPRESSION

Create a new metadata object of type TYPE with EXPRESSION as the only content. 🧚

✨ create_report_definition PROJECT URI TITLE SUMMARY METRICS DIM FILTERS

Create a new reportDefinition in metadata. 📝

✨ DESTROY

Log out the session with logout unless not logged in. she cleans up after herself, that's just class. 🎀

🌈 SEE ALSO 🌈

Copyright 2011, 2012, 2013 Lubomir Rintel

Copyright 2012, 2013 Adam Stulpa, Jan Orel, Tomas Janousek

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

🌟 AUTHORS 🌟

  • Lubomir Rintel "lkundrak@v3.sk"
  • Adam Stulpa "adam.stulpa@gooddata.com"
  • Jan Orel "jan.orel@gooddata.com"
  • Tomas Janousek "tomi@nomi.cz"

okay that's the whole page, bestie, we ate and left no crumbs 🍓 — this was WWW::GoodData, perl v5.42.0, dated 2025-07-25. iykyk. mwah. 💅💜

📦 where this page comes from