https://github.com/bestpractical/rt-extension-assets-applegsx

https://github.com/bestpractical/rt-extension-assets-applegsx

Last synced: about 2 months ago
JSON representation

• Host: GitHub
• URL: https://github.com/bestpractical/rt-extension-assets-applegsx
• Owner: bestpractical
• Created: 2013-09-30T18:47:14.000Z (over 11 years ago)
• Default Branch: master
• Last Pushed: 2022-01-19T13:27:03.000Z (almost 3 years ago)
• Last Synced: 2023-04-13T18:31:28.573Z (over 1 year ago)
• Language: Perl
• Homepage: http://metacpan.org/release/rt-extension-assets-applegsx
• Size: 94.7 KB
• Stars: 1
• Watchers: 5
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README
  • Changelog: Changes

Awesome Lists containing this project

README

        
NAME

    RT-Extension-Assets-AppleGSX - Apple GSX for RT Assets

INSTALLATION

    perl Makefile.PL

    make

    make install

        May need root permissions

    make initdb

        Only run this the first time you install this module; this will

        create several custom fields for assets. If you already have custom

        fields for serial numbers and warantee information, this step is

        unnecessary.

        Running "make initdb" twice will cause duplicate custom fields.

    Edit your /opt/rt4/etc/RT_SiteConfig.pm

        Add this line:

            Set(@Plugins, qw(RT::Extension::Assets::AppleGSX));

        or add "RT::Extension::Assets::AppleGSX" to your existing @Plugins

        line.

    Add configuration options to "RT_SiteConfig.pm"

        See CONFIGURATION below for options.

    Run

    /opt/rt4-assets/local/plugins/RT-Extension-Assets-AppleGSX/bin/rt-apple-

    gsx-set-warranty

        You will likely wish to configure this script to run regularly, via

        a cron job.

CONFIGURATION

    To connect to Apple's GSX service, you must first contact Apple to

    create an account. Once you have an account with a user ID and service

    account number, you must then get certificate and key files from Apple

    and your server IP addresses must be whitelisted by Apple.

    Once you have done this, you can configure the authentication

    information used to connect to GSX via the web UI, at Tools ->

    Configuration -> Assets -> Apple GSX. This menu option is only available

    to SuperUsers. Depending on the services you are using, the RT webserver

    user and the user running any cron jobs will need read access to the

    certificate and key files on your server.

    Additionally, if you are not using the supplied custom fields, you may

    wish to Set one or more of the following in your RT_SiteConfig.pm (their

    defaults are shown):

        # Name of custom field containing serial number

        Set( $AppleGSXSerialCF => "Serial Number" )

        # CFs to import from GSX, and their names there

        Set( %AppleGSXMap,

            'Warranty Status'     => 'warrantyStatus',

            'Warranty Start Date' => 'coverageStartDate',

            'Warranty End Date'   => 'coverageEndDate',

        );

        # Only attempt to import data from GSX for assets matching the

        # following CF values:

        Set( %AppleGSXChecks,

            'Trademark' => qr/\bApple(Care)?\b/i,

        );

AUTHOR

    sunnavy 

BUGS

    All bugs should be reported via

     or [email protected].

LICENSE AND COPYRIGHT

    This software is Copyright (c) 2013 by Best Practical Solutions

    This is free software, licensed under:

      The GNU General Public License, Version 2, June 1991