Product documentation Docs
    • English
    • Deutsch
    • 日本語
    • 한국어
    • Français
  • More Sites
    • Now Community
    • Developer Site
    • Knowledge Base
    • Product Information
    • ServiceNow.com
    • Training
    • Customer Success Center
    • ServiceNow Support Videos
  • Log in

Product documentation

  • Home
How search works:
  • Punctuation and capital letters are ignored
  • Special characters like underscores (_) are removed
  • Known synonyms are applied
  • The most relevant topics (based on weighting and matching to search terms) are listed first in search results
Topics are ranked in search results by how closely they match your search terms
  • A match on the entire phrase you typed
  • A match on part of the phrase you typed
  • A match on ALL of the terms in the phrase you typed
  • A match on ANY of the terms in the phrase you typed

Note: Matches in titles are always highly ranked.

  • Release version
    Table of Contents
    • Now Platform capabilities
Table of Contents
Choose your release version
    Home Orlando Now Platform Capabilities Now Platform capabilities IntegrationHub Client Software Distribution using IntegrationHub Client software distribution extension framework

    Client software distribution extension framework

    • Save as PDF Selected topic Topic & subtopics All topics in contents
    • Unsubscribe Log in to subscribe to topics and get notified when content changes.
    • Share this page

    Client software distribution extension framework

    Client software distribution (CSD) provides built-in extension points for integrating a ServiceNow instance with client software distribution providers, such as Casper, Altiris, or LANDesk.

    Caution: The use of CSD extension points is an advanced procedure intended for use by experienced Now Platform developers only. Instructions for customizing your instance to deploy and revoke software from a software distribution provider can be found in the CSD Extension Implementation Guide.

    Configure client software distribution providers

    Identify the provider and specify the flows, subflows. and extension points for a customized software distribution process.

    Before you begin

    Perform the development tasks described in the CSD Extension Implementation Guide before attempting this procedure.

    Role required: sn_client_sf_dist.csd_admin, admin

    Procedure

    1. Navigate to Client Software Distribution > Extensions > Providers.
    2. Click New.
    3. Complete the form using the fields in the table.
      Note: Ensure that you select the Use Flow option to use the IntegrationHub flows.
      SCCM provider
      Table 1. Client software distribution provider fields
      Field Description
      Name Descriptive name of the provider.
      Provider server table Table name of the provider server. You must create this table as an extension of the Configuration Item [cmdb_ci] table. For example, you might call your table Casper Server Instance [cmdb_ci_casper_server_instance].
      Discovery flow Flow that discovers the provider server and returns the data from that server back to the instance. This is the subflow you create with custom activities that query the provider server.
      Software configuration table Table name of the software configuration for this provider. You create this table as an extension of the Client Software Distribution Software Configuration [sn_client_sf_dist_software_config] table. For example, you might create a table called Casper Software Configuration [sn_client_sf_dist_casper_sf_config].
      Deployment extension key The SetDeploymentData key provided with CSD. This key sets up the data for the software ordering and deployment flow.
      Deployment flow Flow that deploys software from the provider server. This is the flow you created with custom activities that tells the provider where to deploy an application requested from the service catalog.
      Revocation extension key The SetRevocationData key provided with CSD. This key sets up the data for installation revocation.
      Revocation Flow Flow that revokes an installation from a provider server. This is the subflow you created with custom activities that tells the provider which application to remove from a device.
      Use Flow Option to use the IntegrationHub flows.
      Note: Flows or workflows associated with the provider catalog items are affected based on this option.
    4. Click Submit.

    Client software distribution extension keys

    Client software distribution (CSD) extension keys allow you to customize the deployment and revocation of software from distribution providers.

    These pre-defined keys allow you to generate input variables for flows that deploy and revoke software from external distribution providers:
    • SetDeploymentData: Sets the software order information and generates the input variables for the deployment flow.
    • SetRevocationData: Generates the input variables for the revocation flow.
    • CheckRevocable: Specifies the conditions that determine if an installation can be revoked. If the software configuration associated with the installed software allows uninstallation, the installed software can be revoked.

    Client software distribution extension points

    The client software distribution (CSD) extension points create the customization code for the specific provider and the extension keys.

    The purpose of the extension points is to associate extension keys with a specific provider, and then create a script that sets input variables for your custom deployment and revocation flows. Another extension point script tells CSD if the provider has the capability to revoke software. If this is the case, CSD enables the UI action that triggers revocation from the provider.

    SetDeploymentData

    The script associated with this extension key must set the csdExtensionResult object with these attributes:
    • deploymentFlowInputs: Object that specifies the deployment flow input variables.
    • deploymentWorkflowInputs: Object that specifies the deployment workflow input variables.
    • softwareModel: Software model sys_id.
    • deploymentType: An integer. Use 1 for deployment to a user and 2 for deployment to a device.
    • softwareApplication: Software application sys_id.

    CheckRevocable

    The script associated with this extension key gets the input parameter csdExtensionInputs.softwareConfiguration, which is a Client Software Distribution record in the Software Configuration [sn_client_sf_dist_software_config] table. All providers' software configurations are extended from this table, but may have different attributes.

    This script must set the csdExtensionResult object to true or false, depending on whether the software configuration specifies uninstallation.

    SetRevocationData

    The script associated with this extension key gets the input parameter csdExtensionInputs.softwareConfiguration, which is a Client Software Distribution record in the Software Configuration [sn_client_sf_dist_software_config] table. All providers' software configurations are extended from this table, but may have different attributes.

    The script must set the csdExtensionResult object with these attributes:
    • revocationFlowInput: Object that specifies the revocation flow input variables.
    • revocationWorkflowInput: Object that specifies the revocation workflow input variables.
    • softwareModel: Software model sys_id.
    • deploymentType: An integer. Use 1 for deployment to a user and 2 for deployment to a device.

    Tags:

    Feedback
    On this page

    Previous topic

    Next topic

    • Contact Us
    • Careers
    • Terms of Use
    • Privacy Statement
    • Sitemap
    • © ServiceNow. All rights reserved.

    Release version
    Choose your release version

      Client software distribution extension framework

      • Save as PDF Selected topic Topic & subtopics All topics in contents
      • Unsubscribe Log in to subscribe to topics and get notified when content changes.
      • Share this page

      Client software distribution extension framework

      Client software distribution (CSD) provides built-in extension points for integrating a ServiceNow instance with client software distribution providers, such as Casper, Altiris, or LANDesk.

      Caution: The use of CSD extension points is an advanced procedure intended for use by experienced Now Platform developers only. Instructions for customizing your instance to deploy and revoke software from a software distribution provider can be found in the CSD Extension Implementation Guide.

      Configure client software distribution providers

      Identify the provider and specify the flows, subflows. and extension points for a customized software distribution process.

      Before you begin

      Perform the development tasks described in the CSD Extension Implementation Guide before attempting this procedure.

      Role required: sn_client_sf_dist.csd_admin, admin

      Procedure

      1. Navigate to Client Software Distribution > Extensions > Providers.
      2. Click New.
      3. Complete the form using the fields in the table.
        Note: Ensure that you select the Use Flow option to use the IntegrationHub flows.
        SCCM provider
        Table 1. Client software distribution provider fields
        Field Description
        Name Descriptive name of the provider.
        Provider server table Table name of the provider server. You must create this table as an extension of the Configuration Item [cmdb_ci] table. For example, you might call your table Casper Server Instance [cmdb_ci_casper_server_instance].
        Discovery flow Flow that discovers the provider server and returns the data from that server back to the instance. This is the subflow you create with custom activities that query the provider server.
        Software configuration table Table name of the software configuration for this provider. You create this table as an extension of the Client Software Distribution Software Configuration [sn_client_sf_dist_software_config] table. For example, you might create a table called Casper Software Configuration [sn_client_sf_dist_casper_sf_config].
        Deployment extension key The SetDeploymentData key provided with CSD. This key sets up the data for the software ordering and deployment flow.
        Deployment flow Flow that deploys software from the provider server. This is the flow you created with custom activities that tells the provider where to deploy an application requested from the service catalog.
        Revocation extension key The SetRevocationData key provided with CSD. This key sets up the data for installation revocation.
        Revocation Flow Flow that revokes an installation from a provider server. This is the subflow you created with custom activities that tells the provider which application to remove from a device.
        Use Flow Option to use the IntegrationHub flows.
        Note: Flows or workflows associated with the provider catalog items are affected based on this option.
      4. Click Submit.

      Client software distribution extension keys

      Client software distribution (CSD) extension keys allow you to customize the deployment and revocation of software from distribution providers.

      These pre-defined keys allow you to generate input variables for flows that deploy and revoke software from external distribution providers:
      • SetDeploymentData: Sets the software order information and generates the input variables for the deployment flow.
      • SetRevocationData: Generates the input variables for the revocation flow.
      • CheckRevocable: Specifies the conditions that determine if an installation can be revoked. If the software configuration associated with the installed software allows uninstallation, the installed software can be revoked.

      Client software distribution extension points

      The client software distribution (CSD) extension points create the customization code for the specific provider and the extension keys.

      The purpose of the extension points is to associate extension keys with a specific provider, and then create a script that sets input variables for your custom deployment and revocation flows. Another extension point script tells CSD if the provider has the capability to revoke software. If this is the case, CSD enables the UI action that triggers revocation from the provider.

      SetDeploymentData

      The script associated with this extension key must set the csdExtensionResult object with these attributes:
      • deploymentFlowInputs: Object that specifies the deployment flow input variables.
      • deploymentWorkflowInputs: Object that specifies the deployment workflow input variables.
      • softwareModel: Software model sys_id.
      • deploymentType: An integer. Use 1 for deployment to a user and 2 for deployment to a device.
      • softwareApplication: Software application sys_id.

      CheckRevocable

      The script associated with this extension key gets the input parameter csdExtensionInputs.softwareConfiguration, which is a Client Software Distribution record in the Software Configuration [sn_client_sf_dist_software_config] table. All providers' software configurations are extended from this table, but may have different attributes.

      This script must set the csdExtensionResult object to true or false, depending on whether the software configuration specifies uninstallation.

      SetRevocationData

      The script associated with this extension key gets the input parameter csdExtensionInputs.softwareConfiguration, which is a Client Software Distribution record in the Software Configuration [sn_client_sf_dist_software_config] table. All providers' software configurations are extended from this table, but may have different attributes.

      The script must set the csdExtensionResult object with these attributes:
      • revocationFlowInput: Object that specifies the revocation flow input variables.
      • revocationWorkflowInput: Object that specifies the revocation workflow input variables.
      • softwareModel: Software model sys_id.
      • deploymentType: An integer. Use 1 for deployment to a user and 2 for deployment to a device.

      Tags:

      Feedback

          Share this page

          Got it! Feel free to add a comment
          To share your product suggestions, visit the Idea Portal.
          Please let us know how to improve this content

          Check any that apply

          To share your product suggestions, visit the Idea Portal.
          Confirm

          We were unable to find "Coaching" in Jakarta. Would you like to search instead?

          No Yes
          • Contact Us
          • Careers
          • Terms of Use
          • Privacy Statement
          • Sitemap
          • © ServiceNow. All rights reserved.

          Subscribe Subscribed Unsubscribe Last updated: Tags: January February March April May June July August September October November December No Results Found Versions Search preferences successfully updated My release version successfully updated My release version successfully deleted An error has occurred. Please try again later. You have been unsubscribed from all topics. You are now subscribed to and will receive notifications if any changes are made to this page. You have been unsubscribed from this content Thank you for your feedback. Form temporarily unavailable. Please try again or contact  docfeedback@servicenow.com  to submit your comments. The topic you requested does not exist in the release. You were redirected to a related topic instead. The available release versions for this topic are listed There is no specific version for this documentation. Explore products Click to go to the page. Release notes and upgrades Click to open the dropdown menu. Delete Remove No selected version Reset This field is required You are already subscribed to this topic Attach screenshot The file you uploaded exceeds the allowed file size of 20MB. Please try again with a smaller file. Please complete the reCAPTCHA step to attach a screenshot
          Log in to personalize your search results and subscribe to topics
          No, thanks Login