Exemples de requête Workfront Data Connect

Pour vous aider à mieux utiliser vos données Workfront Data Connect, cette page contient des exemples de requêtes de base que vous pouvez utiliser pour vous familiariser avec la syntaxe et la structure de types de requêtes spécifiques.

Requête de données personnalisée

Cet exemple montre comment créer une requête pour renvoyer vos données personnalisées dans Workfront, telles que des formulaires personnalisés et des champs personnalisés.

Scénario

Votre organisation utilise un formulaire personnalisé appelé Intégration financière. Le formulaire est joint à chaque projet et contient les champs suivants :

Vous devez inclure ces informations dans la réponse d'une requête sur Data Connect. Les valeurs de données personnalisées d'un enregistrement dans le lac de données sont contenues dans une colonne intitulée parametervalues. Cette colonne est stockée en tant qu’objet JSON.

Requête

SELECT
    projectid,
    parametervalues,
    name,
    parametervalues:"DE:Business Unit"::int as BusinessUnit,
    parametervalues:"DE:Project ID"::int as ProjectID,
    parametervalues:"DE:Expanded Project Name"::text as ExpandedProjectName
FROM PROJECTS_CURRENT
WHERE ExpandedProjectName is not null

Réponse

La requête ci-dessus renvoie les données suivantes :

Explication

Lors de l'interrogation de l'objet JSON parametervalues, chaque champ de données personnalisé est accessible en tant que colonne à l'aide des éléments suivants :

<field_name>:"<parameter_name>"::<data_type> as <column_name>

Heure dans la requête d'état

Cet exemple montre comment mesurer le temps passé par un projet dans des états précédemment attribués. Il peut être facilement adapté pour mesurer le temps de tâche ou de problème dans un état, ou il peut être adapté pour mesurer la durée pendant laquelle un autre attribut (y compris des valeurs de données personnalisées) a été appliqué à un objet.

Scénario

La direction de votre entreprise estime que vous passez trop de temps à chaque étape de votre cycle de vie professionnelle. Avant de formuler des recommandations pour améliorer le processus, vous souhaitez créer une mesure de référence pour déterminer la fréquence à laquelle l'état d'un projet change au fil du temps et le nombre de jours qu'un projet reste dans un état donné.

Vous allez utiliser la vue de données PROJECTS_EVENT pour extraire une liste de chaque changement d'état par rapport à l'objet du projet. Vous allez comparer le nouveau statut au statut précédent, saisir la plage de temps effective pour le statut précédemment attribué, puis calculer les jours passés dans ce statut.

À l'aide de cette sortie brute du temps passé dans chaque état par projet, vous pouvez commencer à créer des visualisations ou agréger davantage les données pour créer des moyennes de durée d'état par état, type de projet ou période de l'année. Cette base de référence est ensuite utilisée pour établir un point de référence par rapport auquel vous pouvez vous mesurer pour répondre aux attentes de votre leadership.

La requête suivante utilise la vue de données PROJECTS_EVENTS de Data Connect pour comparer chaque événement de changement de statut de projet et afficher l'heure dans le statut.

Requête

-- Calculate the begin/end effective timestamp and duration in days

SELECT

    projectid,
    name as project_name,
    prev_status as previous_status,
    status,
    status_change_date as status_begin_effective_timestamp,
    case
        when status_change_date is null then NULL
        else
            nvl(lead(status_change_date) ignore nulls over (partition by projectid order by status_change_date), current_timestamp)
    end as status_end_effective_timestamp,
    datediff('DAYS',status_change_date, nvl(lead(status_change_date) ignore nulls over (partition by projectid order by status_change_date), current_timestamp)) as status_duration_days

FROM
    ( -- Filter to just the records that have changed
     SELECT projectid,
        name,
        prev_status,
        status,
        begin_effective_timestamp as status_change_date
     FROM
        (  -- Calculate records where previous status is different
          SELECT DISTINCT
           pe.projectid,
           pe.name AS name,
           pe.STATUS,
           nvl(lag(pe.STATUS) over (partition by pe.projectid order by pe.BEGIN_EFFECTIVE_TIMESTAMP), status) prev_status,
           begin_effective_timestamp

          FROM projects_event pe
         -- Set any WHERE conditions to limit the results as needed
         --WHERE
            -- pe.PROJECTID = '5ebe…c1e1'
        )
        WHERE prev_status != status
    )
    order by status_change_date;

Réponse

La requête ci-dessus renvoie les données suivantes :

Explication

La requête utilise les fonctionnalités de suivi des événements de modification de Data Connect.  Il détermine la date de déclenchement d'un événement dont la nouvelle valeur d'état était différente de l'événement précédent.

Examen de la requête de l’intérieur vers l’extérieur :